# 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*