erp-transportistas-v2/orchestration/PROXIMA-ACCION.md
Adrian Flores Cortes 4bbace6345 docs(auditoria): Fase 0 - Purga y correccion de documentacion
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>
2026-01-27 01:22:27 -06:00

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*