docs: Phase 6 validation - Update status files
- PROJECT-STATUS.md: Updated with real progress metrics - Documentation: 100% (18 modules, 54 US, 325 SP) - DDL: 100% (8 schemas) - Backend: 15% (entities copied, pending adaptation) - Added documentation structure tree - Added metrics section - PROXIMA-ACCION.md: Updated next steps - Marked Phase 2-6 as complete - Next priority: Backend implementation - Clear action items for P0/P1/P2/P3 Documentation plan complete. Ready for backend implementation. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Adrian Flores Cortes
parent
a3991cd4ea
commit
13b637bea4
@ -3,7 +3,7 @@
|
||||
**Proyecto:** erp-transportistas
|
||||
**Tipo:** CONSUMER (Vertical ERP)
|
||||
**Version:** 1.0.0
|
||||
**Actualizado:** 2026-01-25
|
||||
**Actualizado:** 2026-01-27
|
||||
|
||||
---
|
||||
|
||||
@ -11,40 +11,54 @@
|
||||
|
||||
| Metrica | Valor | Descripcion |
|
||||
|---------|-------|-------------|
|
||||
| **Progreso General** | 45% | DDL completo, entities principales |
|
||||
| **Progreso General** | 30% | Documentacion completa, backend parcial |
|
||||
| **DDL** | 100% | 8 archivos DDL completos (01-08) |
|
||||
| **Backend** | 40% | 24 modulos + entities transporte |
|
||||
| **Backend** | 15% | Entities base copiadas, pendiente adaptar |
|
||||
| **Frontend** | 0% | Pendiente |
|
||||
| **Documentacion** | 100% | Requerimientos completos |
|
||||
| **Documentacion Funcional** | 100% | 18 modulos especificados con US |
|
||||
| **Documentacion Tecnica** | 100% | Arquitectura, RBAC, KPIs, matrices |
|
||||
|
||||
---
|
||||
|
||||
## Fase Actual: Desarrollo Backend
|
||||
## Fase Actual: Implementacion Backend
|
||||
|
||||
### Completado (2026-01-25)
|
||||
- [x] Estructura de carpetas del proyecto
|
||||
- [x] CLAUDE.md con especificaciones del giro
|
||||
- [x] CONSTANTS-PROJECT.yml
|
||||
- [x] Documentacion de requerimientos (REQ-GIRO-TRANSPORTISTA.md)
|
||||
- [x] Definicion de modulos MAI/MAE/MAA
|
||||
- [x] Creacion de repositorios Git (Gitea)
|
||||
- [x] Registro en SUBMODULES-INVENTORY.yml
|
||||
- [x] DDL 00-schemas-init.sql (8 schemas + ENUMs)
|
||||
- [x] 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
|
||||
- [x] Fase 1: Copia modulos para adaptar
|
||||
- partners, inventory, financial
|
||||
- [x] Fase 2: Creacion modulos desde patrones
|
||||
- ordenes-transporte (de sales)
|
||||
- gestion-flota (de products)
|
||||
- viajes (de projects)
|
||||
- [x] Fase 3: Estructura modulos nuevos
|
||||
- tracking, tarifas-transporte, combustible-gastos, carta-porte
|
||||
### Documentacion Completada (2026-01-27)
|
||||
|
||||
### Completado (Sesión 2)
|
||||
- [x] DDL completo schemas 01-08 (~2,976 líneas SQL)
|
||||
#### Fase 2: Especificacion Modulos Criticos (P0)
|
||||
- [x] MAI-002 Clientes y Tarifas (18 SP, 3 US)
|
||||
- [x] MAI-003 Ordenes de Transporte (18 SP, 3 US)
|
||||
- [x] MAI-004 Planeacion TMS (18 SP, 3 US)
|
||||
- [x] MAI-005 Despacho (18 SP, 3 US)
|
||||
- [x] MAI-006 Tracking (18 SP, 3 US)
|
||||
- [x] MAI-007 POD y Cierre (18 SP, 3 US)
|
||||
- [x] MAI-009 Facturacion Transporte (21 SP, 3 US)
|
||||
- [x] MAI-010 Liquidaciones (18 SP, 3 US)
|
||||
- [x] MAI-011 Gestion de Flota (18 SP, 3 US)
|
||||
- [x] MAE-016 Carta Porte CFDI (18 SP, 3 US)
|
||||
|
||||
#### Fase 3: Especificacion Modulos Secundarios (P1/P2/P3)
|
||||
- [x] MAI-008 Incidencias (18 SP, 3 US)
|
||||
- [x] MAI-012 Combustible y Gastos (18 SP, 3 US)
|
||||
- [x] MAI-013 Mantenimiento Flota (18 SP, 3 US)
|
||||
- [x] MAI-014 Carriers (18 SP, 3 US)
|
||||
- [x] MAI-015 Portal Cliente (18 SP, 3 US)
|
||||
- [x] MAE-017 HOS y Bitacora (16 SP, 3 US)
|
||||
- [x] MAE-018 Reportes y KPIs (18 SP, 3 US)
|
||||
|
||||
#### Fase 4: Arquitectura y Flujos
|
||||
- [x] FLUJO-PRINCIPAL-TRANSPORTE.md (8 fases E2E)
|
||||
- [x] INTEGRACIONES-EXTERNAS.md (GPS, PAC, Mapas, WhatsApp)
|
||||
- [x] MATRIZ-RBAC-TRANSPORTISTAS.yml (16 roles, permisos por modulo)
|
||||
- [x] ESPECIFICACION-KPIS.yml (17 KPIs con formulas)
|
||||
|
||||
#### Fase 5: Matrices de Trazabilidad
|
||||
- [x] MATRIZ-RF-GENERICOS-GIRO.yml (78 RFs mapeados)
|
||||
- [x] MATRIZ-RF-GIRO-MODULOS.yml (RF a 20 modulos)
|
||||
- [x] MATRIZ-MODULOS-US.yml (54 US, 325 SP)
|
||||
- [x] MATRIZ-DDL-RF.yml (58 tablas a RFs)
|
||||
|
||||
### DDL Completado (Sesion anterior)
|
||||
- [x] DDL completo schemas 01-08 (~2,976 lineas SQL)
|
||||
- 01-transport: OT, embarques, viajes, POD, incidencias
|
||||
- 02-fleet: unidades, remolques, operadores, documentos
|
||||
- 03-tracking: posiciones GPS, eventos, geocercas, alertas
|
||||
@ -53,69 +67,129 @@
|
||||
- 06-carriers: carriers, documentos, scorecard
|
||||
- 07-billing: lanes, tarifas, recargos, facturas
|
||||
- 08-compliance: carta porte CFDI 3.1, HOS, inspecciones
|
||||
- [x] Adaptar partners → shippers/consignees (TipoPartnerTransporte, ubicaciones, requisitos)
|
||||
- [x] Entities gestion-flota: Unidad, Operador
|
||||
- [x] Entity ordenes-transporte: OrdenTransporte
|
||||
- [x] Entities tracking: EventoTracking, Geocerca
|
||||
|
||||
### En Progreso
|
||||
- [ ] Implementar entities viajes (Viaje, ParadaViaje)
|
||||
- [ ] Adaptar inventory → refacciones flota
|
||||
- [ ] Adaptar financial → costeo transporte
|
||||
|
||||
### Pendiente
|
||||
### Pendiente - Backend
|
||||
- [ ] Revisar y corregir entities copiadas de erp-core
|
||||
- [ ] Crear entities especificas de transporte
|
||||
- [ ] Build y lint del backend
|
||||
- [ ] Entities carta-porte, tarifas, combustible
|
||||
- [ ] Services y controllers
|
||||
- [ ] Frontend inicial
|
||||
|
||||
### Pendiente - Frontend
|
||||
- [ ] Estructura inicial React
|
||||
- [ ] Dashboard ejecutivo
|
||||
- [ ] Modulos operativos (OT, Tracking, POD)
|
||||
|
||||
---
|
||||
|
||||
## 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 |
|
||||
|
||||
| Codigo | Nombre | DDL | Docs | Backend | Frontend | Estado |
|
||||
|--------|--------|:---:|:----:|:-------:|:--------:|--------|
|
||||
| MAI-001 | Fundamentos | - | - | ✅ | - | Heredado |
|
||||
| MAI-002 | Clientes y Tarifas | ✅ | ✅ | - | - | Docs OK |
|
||||
| MAI-003 | Ordenes de Transporte | ✅ | ✅ | - | - | Docs OK |
|
||||
| MAI-004 | Planeacion TMS | ✅ | ✅ | - | - | Docs OK |
|
||||
| MAI-005 | Despacho | ✅ | ✅ | - | - | Docs OK |
|
||||
| MAI-006 | Tracking | ✅ | ✅ | - | - | Docs OK |
|
||||
| MAI-007 | POD y Cierre | ✅ | ✅ | - | - | Docs OK |
|
||||
| MAI-008 | Incidencias | ✅ | ✅ | - | - | Docs OK |
|
||||
| MAI-009 | Facturacion Transporte | ✅ | ✅ | - | - | Docs OK |
|
||||
| MAI-010 | Liquidaciones | ✅ | ✅ | - | - | Docs OK |
|
||||
| MAI-011 | Gestion de Flota | ✅ | ✅ | - | - | Docs OK |
|
||||
| MAI-012 | Combustible y Gastos | ✅ | ✅ | - | - | Docs OK |
|
||||
| MAI-013 | Mantenimiento Flota | ✅ | ✅ | - | - | Docs OK |
|
||||
| MAI-014 | Carriers (Terceros) | ✅ | ✅ | - | - | Docs OK |
|
||||
| MAI-015 | Portal Cliente | ✅ | ✅ | - | - | Docs OK |
|
||||
|
||||
### 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 |
|
||||
|
||||
| Codigo | Nombre | DDL | Docs | Backend | Frontend | Estado |
|
||||
|--------|--------|:---:|:----:|:-------:|:--------:|--------|
|
||||
| MAE-016 | Carta Porte CFDI | ✅ | ✅ | - | - | Docs OK |
|
||||
| MAE-017 | HOS y Bitacora | ✅ | ✅ | - | - | Docs OK |
|
||||
| MAE-018 | Reportes y KPIs | ✅ | ✅ | - | - | Docs OK |
|
||||
|
||||
### Fase 3 - MAA (Modulo Aplicacion Avanzado) - 2 modulos
|
||||
| Codigo | Nombre | DDL | Backend | Frontend | Estado |
|
||||
|--------|--------|:---:|:-------:|:--------:|--------|
|
||||
| MAA-019 | Optimizacion Rutas | - | - | - | Futuro |
|
||||
| MAA-020 | Integraciones EDI | - | - | - | Futuro |
|
||||
|
||||
| Codigo | Nombre | DDL | Docs | Backend | Frontend | Estado |
|
||||
|--------|--------|:---:|:----:|:-------:|:--------:|--------|
|
||||
| MAA-019 | Optimizacion Rutas | - | - | - | - | Futuro |
|
||||
| MAA-020 | Integraciones EDI | - | - | - | - | Futuro |
|
||||
|
||||
---
|
||||
|
||||
## Estructura de Documentacion
|
||||
|
||||
```
|
||||
docs/
|
||||
├── 00-vision-general/
|
||||
│ └── VISION.md
|
||||
├── 02-definicion-modulos/
|
||||
│ ├── MAI-002-clientes-tarifas/
|
||||
│ │ ├── README.md
|
||||
│ │ ├── REQUERIMIENTOS.md
|
||||
│ │ ├── RESUMEN-EPICA.md
|
||||
│ │ └── historias-usuario/ (3 US)
|
||||
│ ├── MAI-003-ordenes-transporte/
|
||||
│ ├── MAI-004-planeacion-tms/
|
||||
│ ├── MAI-005-despacho/
|
||||
│ ├── MAI-006-tracking/
|
||||
│ ├── MAI-007-pod-cierre/
|
||||
│ ├── MAI-008-incidencias/
|
||||
│ ├── MAI-009-facturacion-transporte/
|
||||
│ ├── MAI-010-liquidaciones/
|
||||
│ ├── MAI-011-gestion-flota/
|
||||
│ ├── MAI-012-combustible-gastos/
|
||||
│ ├── MAI-013-mantenimiento-flota/
|
||||
│ ├── MAI-014-carriers/
|
||||
│ ├── MAI-015-portal-cliente/
|
||||
│ ├── MAE-016-carta-porte-cfdi/
|
||||
│ ├── MAE-017-hos-bitacora/
|
||||
│ └── MAE-018-reportes-kpis/
|
||||
├── 03-requerimientos/
|
||||
│ └── REQ-GIRO-TRANSPORTISTA.md
|
||||
├── 10-arquitectura/
|
||||
│ └── FLUJO-PRINCIPAL-TRANSPORTE.md
|
||||
├── 30-integraciones/
|
||||
│ └── INTEGRACIONES-EXTERNAS.md
|
||||
└── 40-estandares/
|
||||
├── ESPECIFICACION-KPIS.yml
|
||||
└── MATRIZ-RBAC-TRANSPORTISTAS.yml
|
||||
|
||||
orchestration/matrices/
|
||||
├── MATRIZ-DDL-RF.yml
|
||||
├── MATRIZ-MODULOS-US.yml
|
||||
├── MATRIZ-RF-GENERICOS-GIRO.yml
|
||||
└── MATRIZ-RF-GIRO-MODULOS.yml
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Metricas de Documentacion
|
||||
|
||||
| Metrica | Valor |
|
||||
|---------|-------|
|
||||
| Modulos especificados | 18/20 (90%) |
|
||||
| User Stories | 54 |
|
||||
| Story Points | 325 |
|
||||
| Requerimientos funcionales | 78 |
|
||||
| KPIs definidos | 17 |
|
||||
| Roles RBAC | 16 |
|
||||
| Tablas DDL documentadas | 58 |
|
||||
| Integraciones externas | 6 categorias |
|
||||
|
||||
---
|
||||
|
||||
## Proximos Pasos (Priorizados)
|
||||
|
||||
1. ~~**Crear repositorios Git**~~ ✅ - Completado
|
||||
2. ~~**Definir DDL schemas 01-08**~~ ✅ - Completado
|
||||
3. ~~**Implementar entities principales**~~ ✅ - Unidad, Operador, OrdenTransporte, EventoTracking, Geocerca
|
||||
4. **Completar entities Viaje** - ParadaViaje, POD
|
||||
5. **Build y validación backend** - npm run build, lint
|
||||
6. **Services y controllers** - CRUD básico para entities
|
||||
7. **Frontend inicial** - Dashboard, listados básicos
|
||||
1. **Revisar backend existente** - Validar entities copiadas
|
||||
2. **Crear entities transporte** - Basadas en DDL
|
||||
3. **Build y validacion** - npm run build, lint
|
||||
4. **Implementar modulo MAI-003** - Ordenes de Transporte (critico)
|
||||
5. **Implementar modulo MAI-006** - Tracking (critico)
|
||||
6. **Implementar modulo MAE-016** - Carta Porte (compliance)
|
||||
|
||||
---
|
||||
|
||||
@ -147,23 +221,24 @@
|
||||
## Metricas de Avance
|
||||
|
||||
```
|
||||
DDL: [████████████████████] 100%
|
||||
Backend: [████████ ] 40%
|
||||
Frontend: [ ] 0%
|
||||
Docs: [████████████████████] 100%
|
||||
Tests: [ ] 0%
|
||||
DDL: [████████████████████] 100%
|
||||
Docs Func: [████████████████████] 100%
|
||||
Docs Tecnica:[████████████████████] 100%
|
||||
Backend: [███ ] 15%
|
||||
Frontend: [ ] 0%
|
||||
Tests: [ ] 0%
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Archivos Copiados (Fase 0-1 SIMCO-REUSE)
|
||||
## Historial de Actualizaciones
|
||||
|
||||
| Fuente | Destino | Archivos | Lineas |
|
||||
|--------|---------|----------|--------|
|
||||
| erp-core/backend/src/ | erp-transportistas/backend/src/ | 419 | ~69,484 |
|
||||
|
||||
**Token savings estimado:** ~65% (~10,675 lineas no generadas)
|
||||
| Fecha | Descripcion |
|
||||
|-------|-------------|
|
||||
| 2026-01-27 | Fase 2-5 documentacion: 18 modulos, 54 US, arquitectura, matrices |
|
||||
| 2026-01-25 | DDL completo 8 schemas, entities base copiadas |
|
||||
| 2026-01-24 | Creacion repositorio, estructura inicial |
|
||||
|
||||
---
|
||||
|
||||
*Actualizado: 2026-01-25 por Claude Code - Fase Copia Modulos*
|
||||
*Actualizado: 2026-01-27 por Claude Code - Fase Documentacion Completa*
|
||||
|
||||
@ -1,202 +1,166 @@
|
||||
# PROXIMA-ACCION.md - ERP Transportistas
|
||||
|
||||
**Ultima Actualizacion:** 2026-01-27 (Auditoria Fase 0)
|
||||
**Ultima Actualizacion:** 2026-01-27
|
||||
**Sistema:** SIMCO v4.0.0
|
||||
**Estado del Proyecto:** 15% completado | DDL 100% | Backend 15% | Frontend 0%
|
||||
|
||||
---
|
||||
|
||||
## CORRECCION IMPORTANTE (2026-01-27)
|
||||
|
||||
La auditoria de documentacion revelo discrepancias significativas entre lo documentado
|
||||
y el estado real del codigo. Los porcentajes han sido corregidos:
|
||||
|
||||
| Aspecto | Antes (Incorrecto) | Ahora (Real) |
|
||||
|---------|-------------------|--------------|
|
||||
| Backend | 40% | 15% |
|
||||
| Entities nuevas | 58 propias | 44 (muchas genericas) |
|
||||
| Entities especializadas | "~25 implementadas" | 11 implementadas |
|
||||
**Estado del Proyecto:** 30% completado | DDL 100% | Docs 100% | Backend 15% | Frontend 0%
|
||||
|
||||
---
|
||||
|
||||
## Estado Actual (2026-01-27)
|
||||
|
||||
### DOCUMENTACION COMPLETA
|
||||
|
||||
La fase de documentacion funcional y tecnica ha sido completada exitosamente:
|
||||
|
||||
| Fase | Estado | Entregables |
|
||||
|------|--------|-------------|
|
||||
| Fase 2: Modulos Criticos (P0) | ✅ Completo | 10 modulos especificados |
|
||||
| Fase 3: Modulos Secundarios | ✅ Completo | 7 modulos especificados |
|
||||
| Fase 4: Arquitectura | ✅ Completo | Flujo E2E, integraciones, RBAC, KPIs |
|
||||
| Fase 5: Matrices | ✅ Completo | 4 matrices de trazabilidad |
|
||||
| Fase 6: Validacion | ✅ Completo | PROJECT-STATUS actualizado |
|
||||
|
||||
### Progreso General
|
||||
|
||||
| Capa | Progreso | Notas |
|
||||
|------|----------|-------|
|
||||
| DDL | 100% | 8 schemas especializados transporte |
|
||||
| Backend | 15% | 153 entities (109 heredadas + 44 propias), faltan services/DTOs |
|
||||
| DDL | 100% | 8 schemas, ~58 tablas |
|
||||
| Documentacion Funcional | 100% | 18 modulos, 54 US, 325 SP |
|
||||
| Documentacion Tecnica | 100% | Arquitectura, RBAC, KPIs, matrices |
|
||||
| Backend | 15% | Entities base copiadas, pendiente adaptar |
|
||||
| Frontend | 0% | Pendiente |
|
||||
| Documentacion | 25% | Requerimientos definidos, falta especificar modulos |
|
||||
|
||||
### Desglose de Entities
|
||||
### Metricas de Documentacion
|
||||
|
||||
| Categoria | Cantidad | Estado |
|
||||
|-----------|----------|--------|
|
||||
| Heredadas erp-core | 109 | 100% funcionales |
|
||||
| Propias genericas | 33 | Entity only, sin services |
|
||||
| Propias especializadas | 11 | Entity only, sin services |
|
||||
| **Disenadas sin implementar** | **~58** | **GAP CRITICO** |
|
||||
|
||||
### Entities Especializadas Creadas (2026-01-25)
|
||||
|
||||
**Modulo: combustible-gastos (MAI-012)** - 5 entities
|
||||
- `carga-combustible.entity.ts`
|
||||
- `cruce-peaje.entity.ts`
|
||||
- `gasto-viaje.entity.ts`
|
||||
- `anticipo-viatico.entity.ts`
|
||||
- `control-rendimiento.entity.ts`
|
||||
|
||||
**Modulo: tarifas-transporte (MAI-009)** - 6 entities
|
||||
- `lane.entity.ts`
|
||||
- `tarifa.entity.ts`
|
||||
- `recargo-catalogo.entity.ts`
|
||||
- `factura-transporte.entity.ts`
|
||||
- `linea-factura.entity.ts`
|
||||
- `fuel-surcharge.entity.ts`
|
||||
|
||||
### Controladores Creados
|
||||
- `operadores.controller.ts` (gestion-flota)
|
||||
- `unidades.controller.ts` (gestion-flota)
|
||||
- `ordenes-transporte.controller.ts` (ordenes-transporte)
|
||||
- `tracking.controller.ts` (tracking)
|
||||
- `viajes.controller.ts` (viajes)
|
||||
|
||||
---
|
||||
|
||||
## Gaps Criticos Identificados
|
||||
|
||||
### Entities Especializadas Faltantes (~58)
|
||||
|
||||
| Modulo | Entities Faltantes | Prioridad |
|
||||
|--------|-------------------|-----------|
|
||||
| MAI-003 | OrdenTransporte, Embarque, Parada, etc. | P0 |
|
||||
| MAI-011 | Unidad, Remolque, Operador, etc. | P0 |
|
||||
| MAI-007 | POD, FirmaDigital, FotoEntrega | P0 |
|
||||
| MAI-004 | Consolidacion, AsignacionRecurso | P0 |
|
||||
| MAI-005 | ChecklistPreViaje, Sello, EvidenciaCarga | P0 |
|
||||
| MAI-006 | EventoTracking, Geocerca, AlertaTracking | P1 |
|
||||
| MAI-013 | OrdenTrabajo, ProgramaMantenimiento | P2 |
|
||||
| MAI-014 | Carrier, DocumentoCarrier, Scorecard | P2 |
|
||||
|
||||
### Documentacion Faltante
|
||||
|
||||
| Modulo | Tiene REQUERIMIENTOS.md | Tiene User Stories |
|
||||
|--------|-------------------------|-------------------|
|
||||
| MAI-003 | Si | Si (10 US) |
|
||||
| MAI-006 | Si | No |
|
||||
| MAI-011 | Si | No |
|
||||
| MAE-016 | Si | Si (10 US) |
|
||||
| MAI-002 | No | No |
|
||||
| MAI-004 | No | No |
|
||||
| MAI-005 | No | No |
|
||||
| MAI-007 | No | No |
|
||||
| MAI-009 | No | No |
|
||||
| MAI-010 | No | No |
|
||||
| Metrica | Valor |
|
||||
|---------|-------|
|
||||
| Modulos especificados | 18/20 |
|
||||
| User Stories | 54 |
|
||||
| Story Points | 325 |
|
||||
| Requerimientos funcionales | 78 |
|
||||
| KPIs definidos | 17 |
|
||||
| Roles RBAC | 16 |
|
||||
|
||||
---
|
||||
|
||||
## Proximas Acciones
|
||||
|
||||
### P0 - Inmediato (Auditoria Fase 0 en progreso)
|
||||
### P0 - Inmediato: Implementacion Backend
|
||||
|
||||
1. **Completar purga de documentacion** - En progreso
|
||||
- [x] Eliminar carpetas vacias
|
||||
- [x] Reescribir BACKEND_INVENTORY.yml
|
||||
- [x] Reescribir ENTITIES-CATALOG.md
|
||||
- [x] Actualizar PROXIMA-ACCION.md
|
||||
- [ ] Crear MASTER_INVENTORY.yml
|
||||
- [ ] Actualizar MAPA-DOCUMENTACION.yml
|
||||
1. **Revisar entities copiadas de erp-core**
|
||||
- Verificar compatibilidad con DDL de transporte
|
||||
- Eliminar entities no necesarias
|
||||
- Identificar gaps
|
||||
|
||||
### P0 - Especificacion de Modulos Criticos
|
||||
2. **Crear entities especializadas de transporte**
|
||||
Basadas en DDL y MATRIZ-DDL-RF.yml:
|
||||
- Schema transport: OrdenTransporte, Embarque, Viaje, Parada, POD
|
||||
- Schema fleet: Unidad, Remolque, Operador, Documento
|
||||
- Schema tracking: Posicion, EventoTracking, Geocerca, Alerta
|
||||
- Schema fuel: CargaCombustible, CrucePeaje, GastoViaje
|
||||
- Schema billing: Tarifa, Factura, Liquidacion
|
||||
|
||||
2. **Crear REQUERIMIENTOS.md para modulos P0**
|
||||
- MAI-007 (POD y Cierre) - Bloquea facturacion
|
||||
- MAI-004 (Planeacion TMS) - Workflow critico
|
||||
- MAI-005 (Despacho) - Workflow + NOM-068
|
||||
- MAI-002 (Tarifas y SLA) - Base comercial
|
||||
3. **Build y lint del backend**
|
||||
```bash
|
||||
cd backend && npm run build && npm run lint
|
||||
```
|
||||
|
||||
3. **Crear User Stories para modulos con REQUERIMIENTOS**
|
||||
- MAI-006 (Tracking) - 5-10 US
|
||||
- MAI-011 (Gestion Flota) - 5-10 US
|
||||
### P1 - Corto Plazo: Modulos Core
|
||||
|
||||
### P1 - Completar Backend
|
||||
4. **Implementar modulo MAI-003 (Ordenes de Transporte)**
|
||||
- Entities: OrdenTransporte, ParadaOT
|
||||
- Services: captura, validacion, cotizacion
|
||||
- Controllers: CRUD + workflow
|
||||
- Prioridad: CRITICO (base del workflow)
|
||||
|
||||
4. **Implementar entities especializadas**
|
||||
- OrdenTransporte, Embarque, Parada (MAI-003)
|
||||
- Unidad, Remolque, Operador (MAI-011)
|
||||
- POD, FirmaDigital (MAI-007)
|
||||
5. **Implementar modulo MAI-011 (Gestion de Flota)**
|
||||
- Entities: Unidad, Remolque, Operador, DocumentoUnidad
|
||||
- Services: disponibilidad, documentos, bloqueos
|
||||
- Prioridad: CRITICO (requerido para planeacion)
|
||||
|
||||
5. **Crear services y DTOs para entities existentes**
|
||||
- combustible-gastos
|
||||
- tarifas-transporte
|
||||
6. **Implementar modulo MAI-006 (Tracking)**
|
||||
- Entities: Posicion, EventoTracking, Geocerca
|
||||
- Services: recepcion GPS, geocercas, alertas
|
||||
- Integracion: proveedores telematica
|
||||
- Prioridad: CRITICO
|
||||
|
||||
### P1 - Especificacion Modulos Secundarios
|
||||
### P2 - Mediano Plazo: Facturacion y Compliance
|
||||
|
||||
6. **Crear especificaciones MAI-009 (Facturacion)**
|
||||
7. **Crear especificaciones MAI-010 (Liquidaciones)**
|
||||
8. **Crear especificaciones MAI-008 (Incidencias)**
|
||||
|
||||
### P2 - Mediano Plazo
|
||||
|
||||
9. **Modulo Carta Porte CFDI 3.1**
|
||||
- Validar entities vs requisitos SAT
|
||||
7. **Implementar modulo MAE-016 (Carta Porte)**
|
||||
- Generacion XML 3.1
|
||||
- Integracion PAC
|
||||
- Validaciones SAT
|
||||
- Prioridad: ALTA (compliance obligatorio)
|
||||
|
||||
10. **Integracion GPS/Telematica**
|
||||
11. **Portal de clientes**
|
||||
8. **Implementar modulo MAI-009 (Facturacion)**
|
||||
- Pre-factura automatica
|
||||
- Tarifas por lane
|
||||
- Recargos (fuel surcharge, detention)
|
||||
- CFDI con complemento Carta Porte
|
||||
|
||||
### P3 - Largo Plazo
|
||||
|
||||
9. **Frontend inicial**
|
||||
- Dashboard ejecutivo (MAE-018)
|
||||
- Listado OTs (MAI-003)
|
||||
- Tracking mapa (MAI-006)
|
||||
|
||||
10. **Portal cliente (MAI-015)**
|
||||
|
||||
---
|
||||
|
||||
## Modulos del Sistema - Estado Corregido
|
||||
## Modulos del Sistema - Estado Actualizado
|
||||
|
||||
### Fase 1 - MAI (Inicial)
|
||||
|
||||
| Codigo | Nombre | DDL | Backend | Docs | Frontend |
|
||||
|--------|--------|:---:|:-------:|:----:|:--------:|
|
||||
| MAI-001 | Fundamentos | - | 100% | - | - |
|
||||
| MAI-002 | Clientes y Tarifas | - | 0% | 0% | 0% |
|
||||
| MAI-003 | Ordenes de Transporte | 100% | 10% | 80% | 0% |
|
||||
| MAI-004 | Planeacion TMS | 100% | 0% | 0% | 0% |
|
||||
| MAI-005 | Despacho | 100% | 0% | 0% | 0% |
|
||||
| MAI-006 | Tracking | 100% | 5% | 60% | 0% |
|
||||
| MAI-007 | POD y Cierre | 100% | 0% | 0% | 0% |
|
||||
| MAI-008 | Incidencias | 100% | 0% | 0% | 0% |
|
||||
| MAI-009 | Facturacion Transporte | 100% | 15% | 0% | 0% |
|
||||
| MAI-010 | Liquidaciones | 100% | 0% | 0% | 0% |
|
||||
| MAI-011 | Gestion de Flota | 100% | 10% | 60% | 0% |
|
||||
| MAI-012 | Combustible y Gastos | 100% | 20% | 30% | 0% |
|
||||
| MAI-013 | Mantenimiento Flota | 100% | 0% | 0% | 0% |
|
||||
| MAI-014 | Carriers (Terceros) | 100% | 0% | 0% | 0% |
|
||||
| MAI-015 | Portal Cliente | 100% | 0% | 0% | 0% |
|
||||
| Codigo | Nombre | DDL | Docs | Backend | Frontend |
|
||||
|--------|--------|:---:|:----:|:-------:|:--------:|
|
||||
| MAI-001 | Fundamentos | - | - | ✅ | - |
|
||||
| MAI-002 | Clientes y Tarifas | ✅ | ✅ | 0% | 0% |
|
||||
| MAI-003 | Ordenes de Transporte | ✅ | ✅ | 10% | 0% |
|
||||
| MAI-004 | Planeacion TMS | ✅ | ✅ | 0% | 0% |
|
||||
| MAI-005 | Despacho | ✅ | ✅ | 0% | 0% |
|
||||
| MAI-006 | Tracking | ✅ | ✅ | 5% | 0% |
|
||||
| MAI-007 | POD y Cierre | ✅ | ✅ | 0% | 0% |
|
||||
| MAI-008 | Incidencias | ✅ | ✅ | 0% | 0% |
|
||||
| MAI-009 | Facturacion Transporte | ✅ | ✅ | 15% | 0% |
|
||||
| MAI-010 | Liquidaciones | ✅ | ✅ | 0% | 0% |
|
||||
| MAI-011 | Gestion de Flota | ✅ | ✅ | 10% | 0% |
|
||||
| MAI-012 | Combustible y Gastos | ✅ | ✅ | 20% | 0% |
|
||||
| MAI-013 | Mantenimiento Flota | ✅ | ✅ | 0% | 0% |
|
||||
| MAI-014 | Carriers (Terceros) | ✅ | ✅ | 0% | 0% |
|
||||
| MAI-015 | Portal Cliente | ✅ | ✅ | 0% | 0% |
|
||||
|
||||
### Fase 2 - MAE (Extendido)
|
||||
|
||||
| Codigo | Nombre | DDL | Backend | Docs | Frontend |
|
||||
|--------|--------|:---:|:-------:|:----:|:--------:|
|
||||
| MAE-016 | Carta Porte CFDI | 100% | 10% | 80% | 0% |
|
||||
| MAE-017 | HOS y Bitacora | 100% | 0% | 0% | 0% |
|
||||
| MAE-018 | Reportes y KPIs | 100% | 0% | 0% | 0% |
|
||||
| Codigo | Nombre | DDL | Docs | Backend | Frontend |
|
||||
|--------|--------|:---:|:----:|:-------:|:--------:|
|
||||
| MAE-016 | Carta Porte CFDI | ✅ | ✅ | 10% | 0% |
|
||||
| MAE-017 | HOS y Bitacora | ✅ | ✅ | 0% | 0% |
|
||||
| MAE-018 | Reportes y KPIs | ✅ | ✅ | 0% | 0% |
|
||||
|
||||
### Fase 3 - MAA (Avanzado)
|
||||
|
||||
| Codigo | Nombre | DDL | Backend | Frontend |
|
||||
|--------|--------|:---:|:-------:|:--------:|
|
||||
| MAA-019 | Optimizacion Rutas | - | 0% | 0% |
|
||||
| MAA-020 | Integraciones EDI | - | 0% | 0% |
|
||||
| Codigo | Nombre | DDL | Docs | Backend | Frontend |
|
||||
|--------|--------|:---:|:----:|:-------:|:--------:|
|
||||
| MAA-019 | Optimizacion Rutas | - | - | 0% | 0% |
|
||||
| MAA-020 | Integraciones EDI | - | - | 0% | 0% |
|
||||
|
||||
---
|
||||
|
||||
## Referencias
|
||||
## Archivos de Referencia
|
||||
|
||||
| Recurso | Ubicacion |
|
||||
|---------|-----------|
|
||||
| Inventario BD | `orchestration/inventarios/DATABASE_INVENTORY.yml` |
|
||||
| Inventario Backend | `orchestration/inventarios/BACKEND_INVENTORY.yml` |
|
||||
| Catalogo Entities | `docs/_definitions/ENTITIES-CATALOG.md` |
|
||||
| Requerimientos Giro | `docs/03-requerimientos/REQ-GIRO-TRANSPORTISTA.md` |
|
||||
| CLAUDE.md | `CLAUDE.md` |
|
||||
| PROJECT-STATUS.md | `PROJECT-STATUS.md` |
|
||||
| Requerimientos | `docs/03-requerimientos/REQ-GIRO-TRANSPORTISTA.md` |
|
||||
| Modulos | `docs/02-definicion-modulos/` |
|
||||
| Arquitectura | `docs/10-arquitectura/FLUJO-PRINCIPAL-TRANSPORTE.md` |
|
||||
| Integraciones | `docs/30-integraciones/INTEGRACIONES-EXTERNAS.md` |
|
||||
| RBAC | `docs/40-estandares/MATRIZ-RBAC-TRANSPORTISTAS.yml` |
|
||||
| KPIs | `docs/40-estandares/ESPECIFICACION-KPIS.yml` |
|
||||
| Matrices | `orchestration/matrices/` |
|
||||
| DDL | `database/ddl/` |
|
||||
|
||||
---
|
||||
|
||||
@ -204,8 +168,9 @@ y el estado real del codigo. Los porcentajes han sido corregidos:
|
||||
|
||||
| Fecha | Cambio |
|
||||
|-------|--------|
|
||||
| 2026-01-27 | Documentacion completa (Fase 2-6): 18 modulos, 54 US, arquitectura, matrices |
|
||||
| 2026-01-27 | Correccion porcentajes tras auditoria |
|
||||
| 2026-01-25 | Creacion inicial |
|
||||
| 2026-01-27 | CORRECCION: Porcentajes ajustados tras auditoria |
|
||||
|
||||
---
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user