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 |
45% |
DDL completo, entities principales |
| DDL |
100% |
8 archivos DDL completos (01-08) |
| Backend |
40% |
24 modulos + entities transporte |
| Frontend |
0% |
Pendiente |
| Documentacion |
100% |
Requerimientos completos |
Fase Actual: Desarrollo Backend
Completado (2026-01-25)
- 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
- Creacion de repositorios Git (Gitea)
- Registro en SUBMODULES-INVENTORY.yml
- DDL 00-schemas-init.sql (8 schemas + ENUMs)
- Fase 0 SIMCO-REUSE: Copia modulos base (419 archivos, ~69k lineas)
- shared/, auth, users, tenants, ai, audit
- notifications, mcp, payment-terminals
- billing-usage, branches, companies, core
- Fase 1: Copia modulos para adaptar
- partners, inventory, financial
- Fase 2: Creacion modulos desde patrones
- ordenes-transporte (de sales)
- gestion-flota (de products)
- viajes (de projects)
- Fase 3: Estructura modulos nuevos
- tracking, tarifas-transporte, combustible-gastos, carta-porte
Completado (Sesión 2)
- DDL completo schemas 01-08 (~2,976 líneas SQL)
- 01-transport: OT, embarques, viajes, POD, incidencias
- 02-fleet: unidades, remolques, operadores, documentos
- 03-tracking: posiciones GPS, eventos, geocercas, alertas
- 04-fuel: cargas combustible, peajes, gastos, anticipos
- 05-maintenance: planes, programacion, ordenes trabajo
- 06-carriers: carriers, documentos, scorecard
- 07-billing: lanes, tarifas, recargos, facturas
- 08-compliance: carta porte CFDI 3.1, HOS, inspecciones
- Adaptar partners → shippers/consignees (TipoPartnerTransporte, ubicaciones, requisitos)
- Entities gestion-flota: Unidad, Operador
- Entity ordenes-transporte: OrdenTransporte
- Entities tracking: EventoTracking, Geocerca
En Progreso
Pendiente
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)
Crear repositorios Git ✅ - Completado
Definir DDL schemas 01-08 ✅ - Completado
Implementar entities principales ✅ - Unidad, Operador, OrdenTransporte, EventoTracking, Geocerca
- Completar entities Viaje - ParadaViaje, POD
- Build y validación backend - npm run build, lint
- Services y controllers - CRUD básico para entities
- Frontend inicial - Dashboard, listados básicos
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: [████████████████████] 100%
Backend: [████████ ] 40%
Frontend: [ ] 0%
Docs: [████████████████████] 100%
Tests: [ ] 0%
Archivos Copiados (Fase 0-1 SIMCO-REUSE)
| Fuente |
Destino |
Archivos |
Lineas |
| erp-core/backend/src/ |
erp-transportistas/backend/src/ |
419 |
~69,484 |
Token savings estimado: ~65% (~10,675 lineas no generadas)
Actualizado: 2026-01-25 por Claude Code - Fase Copia Modulos