erp-transportistas-v2/PROJECT-STATUS.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

4.1 KiB

PROJECT-STATUS.md - ERP Transportistas

Proyecto: erp-transportistas Tipo: CONSUMER (Vertical ERP) Version: 1.0.0 Actualizado: 2026-01-25


Estado General

Metrica Valor Descripcion
Progreso General 5% Proyecto recien creado
DDL 0% Schemas por definir
Backend 0% Modulos por implementar
Frontend 0% Pendiente
Documentacion 100% Requerimientos completos

Fase Actual: Inicializacion

Completado

  • Estructura de carpetas del proyecto
  • CLAUDE.md con especificaciones del giro
  • CONSTANTS-PROJECT.yml
  • Documentacion de requerimientos (REQ-GIRO-TRANSPORTISTA.md)
  • Definicion de modulos MAI/MAE/MAA

En Progreso

  • Creacion de repositorios Git
  • Registro en inventarios del workspace

Pendiente

  • DDL de schemas principales
  • Entities TypeORM base
  • Services y controllers
  • Frontend inicial

Modulos por Fase

Fase 1 - MAI (Modulo Aplicacion Inicial) - 15 modulos

Codigo Nombre DDL Backend Frontend Estado
MAI-001 Fundamentos - - - Heredado
MAI-002 Clientes y Tarifas - - - Pendiente
MAI-003 Ordenes de Transporte - - - Pendiente
MAI-004 Planeacion TMS - - - Pendiente
MAI-005 Despacho - - - Pendiente
MAI-006 Tracking - - - Pendiente
MAI-007 POD y Cierre - - - Pendiente
MAI-008 Incidencias - - - Pendiente
MAI-009 Facturacion Transporte - - - Pendiente
MAI-010 Liquidaciones - - - Pendiente
MAI-011 Gestion de Flota - - - Pendiente
MAI-012 Combustible y Gastos - - - Pendiente
MAI-013 Mantenimiento Flota - - - Pendiente
MAI-014 Carriers (Terceros) - - - Pendiente
MAI-015 Portal Cliente - - - Pendiente

Fase 2 - MAE (Modulo Aplicacion Extendido) - 3 modulos

Codigo Nombre DDL Backend Frontend Estado
MAE-016 Carta Porte CFDI - - - Pendiente
MAE-017 HOS y Bitacora - - - Pendiente
MAE-018 Reportes y KPIs - - - Pendiente

Fase 3 - MAA (Modulo Aplicacion Avanzado) - 2 modulos

Codigo Nombre DDL Backend Frontend Estado
MAA-019 Optimizacion Rutas - - - Futuro
MAA-020 Integraciones EDI - - - Futuro

Proximos Pasos (Priorizados)

  1. Crear repositorios Git - Padre + backend, frontend, database
  2. Definir DDL transport schema - Tablas principales de OT, embarque, viaje
  3. Definir DDL fleet schema - Unidades, remolques, operadores
  4. Implementar MAI-003 - Ordenes de Transporte (core del negocio)
  5. Implementar MAI-011 - Gestion de Flota (prerequisito para viajes)
  6. Implementar MAI-006 - Tracking (valor diferenciador)

Dependencias Criticas

Modulo Depende de Prioridad
MAI-003 OT MAI-002 Tarifas, MAI-011 Flota Alta
MAI-004 Planeacion MAI-003 OT Alta
MAI-005 Despacho MAI-004 Planeacion, MAI-011 Flota Alta
MAI-006 Tracking MAI-005 Despacho Alta
MAI-007 POD MAI-006 Tracking Media
MAI-009 Facturacion MAI-007 POD Media
MAE-016 Carta Porte MAI-009 Facturacion Alta

Riesgos y Mitigaciones

Riesgo Impacto Mitigacion
Complejidad Carta Porte 3.1 Alto Iniciar MAE-016 temprano, PAC confiable
Integracion GPS multiple Medio Abstraccion de proveedores
Volumen de eventos tracking Alto Redis para buffer, batch processing
Offline en carretera Alto PWA con sincronizacion

Metricas de Avance

DDL:      [                    ] 0%
Backend:  [                    ] 0%
Frontend: [                    ] 0%
Docs:     [████████████████████] 100%
Tests:    [                    ] 0%

Actualizado: 2026-01-25 por META-ORQUESTADOR