CORRECCION CRITICA: - Porcentaje backend corregido de 40% a 15% - Entities: 153 total (109 heredadas + 44 propias) - Entities especializadas disenadas sin implementar: ~58 Cambios: - BACKEND_INVENTORY.yml: Reescrito con estado real - ENTITIES-CATALOG.md: Separacion IMPLEMENTADAS vs DISENADAS - PROXIMA-ACCION.md: Porcentajes corregidos, gaps identificados - MAPA-DOCUMENTACION.yml: Estructura actualizada - MASTER_INVENTORY.yml: Nuevo inventario consolidado Carpetas vacias eliminadas: - docs/01-analisis-referencias/ - docs/10-modelado/ - docs/20-user-stories/ - docs/30-integraciones/ - docs/90-transversal/ - docs/97-adr/ Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
213 lines
6.4 KiB
Markdown
213 lines
6.4 KiB
Markdown
# PROXIMA-ACCION.md - ERP Transportistas
|
|
|
|
**Ultima Actualizacion:** 2026-01-27 (Auditoria Fase 0)
|
|
**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 Actual (2026-01-27)
|
|
|
|
### Progreso General
|
|
|
|
| Capa | Progreso | Notas |
|
|
|------|----------|-------|
|
|
| DDL | 100% | 8 schemas especializados transporte |
|
|
| Backend | 15% | 153 entities (109 heredadas + 44 propias), faltan services/DTOs |
|
|
| Frontend | 0% | Pendiente |
|
|
| Documentacion | 25% | Requerimientos definidos, falta especificar modulos |
|
|
|
|
### Desglose de Entities
|
|
|
|
| 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 |
|
|
|
|
---
|
|
|
|
## Proximas Acciones
|
|
|
|
### P0 - Inmediato (Auditoria Fase 0 en progreso)
|
|
|
|
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
|
|
|
|
### P0 - Especificacion de Modulos Criticos
|
|
|
|
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. **Crear User Stories para modulos con REQUERIMIENTOS**
|
|
- MAI-006 (Tracking) - 5-10 US
|
|
- MAI-011 (Gestion Flota) - 5-10 US
|
|
|
|
### P1 - Completar Backend
|
|
|
|
4. **Implementar entities especializadas**
|
|
- OrdenTransporte, Embarque, Parada (MAI-003)
|
|
- Unidad, Remolque, Operador (MAI-011)
|
|
- POD, FirmaDigital (MAI-007)
|
|
|
|
5. **Crear services y DTOs para entities existentes**
|
|
- combustible-gastos
|
|
- tarifas-transporte
|
|
|
|
### P1 - Especificacion Modulos Secundarios
|
|
|
|
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
|
|
- Integracion PAC
|
|
|
|
10. **Integracion GPS/Telematica**
|
|
11. **Portal de clientes**
|
|
|
|
---
|
|
|
|
## Modulos del Sistema - Estado Corregido
|
|
|
|
### 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% |
|
|
|
|
### 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% |
|
|
|
|
### Fase 3 - MAA (Avanzado)
|
|
|
|
| Codigo | Nombre | DDL | Backend | Frontend |
|
|
|--------|--------|:---:|:-------:|:--------:|
|
|
| MAA-019 | Optimizacion Rutas | - | 0% | 0% |
|
|
| MAA-020 | Integraciones EDI | - | 0% | 0% |
|
|
|
|
---
|
|
|
|
## Referencias
|
|
|
|
| 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` |
|
|
|
|
---
|
|
|
|
## Historial de Cambios
|
|
|
|
| Fecha | Cambio |
|
|
|-------|--------|
|
|
| 2026-01-25 | Creacion inicial |
|
|
| 2026-01-27 | CORRECCION: Porcentajes ajustados tras auditoria |
|
|
|
|
---
|
|
|
|
*Sistema SIMCO v4.0.0 - ERP Transportistas*
|