erp-transportistas-v2/orchestration/BOOTLOADER.md
Adrian Flores Cortes 37ed0aa919 feat: Initial project structure for ERP Transportistas
Vertical ERP for freight transport and logistics companies.

Includes:
- Project configuration (CLAUDE.md, SIMCO orchestration)
- Backend submodule (NestJS 10.x)
- Frontend submodule (React 18.x + Vite)
- Database submodule (PostgreSQL 15 + PostGIS)
- Requirements documentation (REQ-GIRO-TRANSPORTISTA.md)
- 20 modules defined (MAI/MAE/MAA phases)

Key features:
- Transport orders (OT) management
- Fleet and driver management
- Real-time GPS tracking
- POD (Proof of Delivery)
- CFDI with Carta Porte 3.1 compliance
- Fuel and maintenance control
- Third-party carrier management

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 09:53:54 -06:00

2.9 KiB

BOOTLOADER - ERP Transportistas

Proyecto: erp-transportistas Tipo: CONSUMER (Vertical ERP) Sistema: SIMCO v4.0.0 + NEXUS v4.0


Secuencia de Carga de Contexto

Nivel 0 - Sistema (Heredado)

1. workspace-v2/CLAUDE.md
2. workspace-v2/orchestration/directivas/principios/PRINCIPIO-CAPVED.md
3. workspace-v2/orchestration/directivas/simco/SIMCO-TAREA.md
4. workspace-v2/orchestration/directivas/simco/SIMCO-GIT.md
5. workspace-v2/orchestration/directivas/simco/SIMCO-EDICION-SEGURA.md

Nivel 1 - ERP Core (Heredado)

6. projects/erp-core/CLAUDE.md
7. projects/erp-core/orchestration/directivas/DIRECTIVA-MULTI-TENANT.md
8. projects/erp-core/orchestration/directivas/DIRECTIVA-HERENCIA-MODULOS.md

Nivel 2 - Proyecto (Local)

9. projects/erp-transportistas/CLAUDE.md (ESTE PROYECTO)
10. projects/erp-transportistas/.claude/constants/CONSTANTS-PROJECT.yml
11. projects/erp-transportistas/docs/03-requerimientos/REQ-GIRO-TRANSPORTISTA.md

Aliases Activos

Alias Ruta
@BACKEND backend/src/
@FRONTEND frontend/src/
@DDL database/ddl/
@DOCS docs/
@MODULOS docs/02-definicion-modulos/
@ORCHESTRATION orchestration/
@CONSTANTS .claude/constants/CONSTANTS-PROJECT.yml
@REQS docs/03-requerimientos/REQ-GIRO-TRANSPORTISTA.md

Validaciones Obligatorias

Antes de Implementar

  1. Verificar si funcionalidad existe en erp-core
  2. Consultar REQ-GIRO-TRANSPORTISTA.md
  3. Verificar coherencia DDL <-> Entity

Despues de Implementar

  1. Actualizar PROJECT-STATUS.md
  2. Actualizar INVENTARIO.yml
  3. Verificar build: npm run build && npm run lint

Modulos del Giro Disponibles

Fase 1 - MAI (Prioritarios)

  • MAI-002: Clientes y Tarifas
  • MAI-003: Ordenes de Transporte
  • MAI-004: Planeacion TMS
  • MAI-005: Despacho
  • MAI-006: Tracking
  • MAI-007: POD y Cierre
  • MAI-011: Gestion de Flota

Fase 2 - MAE (Compliance)

  • MAE-016: Carta Porte CFDI
  • MAE-017: HOS y Bitacora

Entidades Criticas

Entidad Schema Descripcion
OrdenTransporte transport Solicitud de servicio
Embarque transport Agrupacion de OTs
Viaje transport Ejecucion operativa
Unidad fleet Tractora/remolque/caja
Operador fleet Conductor
EventoTracking tracking Posiciones y eventos
POD transport Proof of Delivery
CartaPorte compliance CFDI complemento

Workflow Principal

ORDEN DE TRANSPORTE (OT)
        |
        v
    EMBARQUE (agrupacion)
        |
        v
    PLANEACION (asignacion recursos)
        |
        v
    DESPACHO (checklist, salida)
        |
        v
    VIAJE (tracking en tiempo real)
        |
        v
    POD (entrega con evidencias)
        |
        v
    CIERRE (costos, rentabilidad)
        |
        v
    FACTURACION (CFDI + Carta Porte)

Bootloader ERP Transportistas - SIMCO v4.0.0