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>

docs/_definitions/ENTITIES-CATALOG.md

@@ -1,219 +1,331 @@
 # ENTITIES-CATALOG.md - ERP Transportistas
 
-**Version:** 1.0.0
+**Version:** 2.0.0
-**Fecha:** 2026-01-26
+**Fecha:** 2026-01-27 (Corregido en Auditoria Fase 0)
-**Total Entities:** 153 (95 heredadas + 58 propias especializadas)
+**Total Entities en Codigo:** 153 (109 heredadas + 44 propias)
+**Entities Especializadas Disenadas (sin implementar):** 58
 
 ---
 
-## Resumen por Schema
+## IMPORTANTE: Clarificacion de Estado
 
-| Schema | Entities | Estado |
+Este documento distingue entre:
-|--------|----------|--------|
+1. **IMPLEMENTADAS**: Entities que EXISTEN en el codigo backend
-| auth | 20 | Heredado 100% |
+2. **DISENADAS**: Entities definidas en documentacion/DDL pero NO implementadas aun
-| catalog | 15 | Heredado + extensiones |
+
-| transport | ~25 | DDL completo |
+| Categoria | Cantidad | Estado |
-| fleet | ~15 | DDL completo |
+|-----------|----------|--------|
-| tracking | ~10 | DDL completo |
+| Heredadas de erp-core | 109 | Implementadas |
-| fuel | ~8 | DDL completo |
+| Propias implementadas | 44 | Implementadas (pero genericas) |
-| maintenance | ~12 | DDL completo |
+| Propias especializadas disenadas | ~58 | NO implementadas |
-| carriers | ~8 | DDL completo |
-| billing | ~10 | DDL completo |
-| compliance | ~10 | DDL completo |
 
 ---
 
-## Entities Heredadas (erp-core)
+## Parte 1: Entities IMPLEMENTADAS (153 total)
 
-### Schema: auth (20)
+### 1.1 Entities Heredadas (erp-core) - 109
-- User, Role, Permission, RefreshToken, Session
-- Tenant, Company, Branch
-- UserRole, RolePermission
-- PasswordReset, TwoFactorAuth
-- ApiKey, AuditLog, LoginAttempt
-- UserPreference, UserNotification
-- OAuthProvider, OAuthToken
-- DeviceSession, SecurityEvent
 
-### Schema: catalog (15)
+#### Schema: auth (20 implementadas)
-- Country, State, City, Currency
+| Entity | Archivo | Estado |
-- PaymentMethod, PaymentTerm
+|--------|---------|--------|
-- UnitOfMeasure, TaxRate
+| User | user.entity.ts | 100% |
-- DocumentType, DocumentSequence
+| Role | role.entity.ts | 100% |
-- Category, Tag
+| Permission | permission.entity.ts | 100% |
-- Bank, BankAccount
+| Session | session.entity.ts | 100% |
-- Warehouse
+| Tenant | tenant.entity.ts | 100% |
+| Company | company.entity.ts | 100% |
+| Group | group.entity.ts | 100% |
+| ApiKey | api-key.entity.ts | 100% |
+| PasswordReset | password-reset.entity.ts | 100% |
+| OAuthProvider | oauth-provider.entity.ts | 100% |
+| OAuthState | oauth-state.entity.ts | 100% |
+| OAuthUserLink | oauth-user-link.entity.ts | 100% |
+| TrustedDevice | trusted-device.entity.ts | 100% |
+| VerificationCode | verification-code.entity.ts | 100% |
+| MfaAuditLog | mfa-audit-log.entity.ts | 100% |
+| Device | device.entity.ts | 100% |
+| UserProfile | user-profile.entity.ts | 100% |
+| UserProfileAssignment | user-profile-assignment.entity.ts | 100% |
+| ProfileTool | profile-tool.entity.ts | 100% |
+| ProfileModule | profile-module.entity.ts | 100% |
+
+#### Schema: ai (7 implementadas)
+| Entity | Archivo | Estado |
+|--------|---------|--------|
+| Completion | completion.entity.ts | 100% |
+| Conversation | conversation.entity.ts | 100% |
+| Embedding | embedding.entity.ts | 100% |
+| KnowledgeBase | knowledge-base.entity.ts | 100% |
+| Model | model.entity.ts | 100% |
+| Prompt | prompt.entity.ts | 100% |
+| Usage | usage.entity.ts | 100% |
+
+#### Schema: audit (7 implementadas)
+| Entity | Archivo | Estado |
+|--------|---------|--------|
+| AuditLog | audit-log.entity.ts | 100% |
+| ConfigChange | config-change.entity.ts | 100% |
+| DataExport | data-export.entity.ts | 100% |
+| EntityChange | entity-change.entity.ts | 100% |
+| LoginHistory | login-history.entity.ts | 100% |
+| PermissionChange | permission-change.entity.ts | 100% |
+| SensitiveDataAccess | sensitive-data-access.entity.ts | 100% |
+
+#### Schema: billing-usage (13 implementadas)
+- BillingAlert, InvoiceItem, PaymentMethod, SubscriptionPlan, UsageEvent
+- + 8 entities adicionales
+
+#### Schema: branches (5 implementadas)
+- Branch, BranchInventorySettings, BranchPaymentTerminal, BranchSchedule, UserBranchAssignment
+
+#### Schema: core (10 implementadas)
+- Entities base compartidas
+
+#### Schema: financial (15 implementadas)
+- AccountMapping, AccountType, BankReconciliationRule, BankStatement, BankStatementLine
+- FiscalPeriod, FiscalYear, Invoice, InvoiceLine, JournalEntry
+- JournalEntryLine, Journal, Payment, Tax, + 1
+
+#### Schema: inventory (15 implementadas)
+- InventoryAdjustment, InventoryAdjustmentLine, InventoryCount, InventoryCountLine
+- Location, Lot, Picking, StockLevel, StockMove, StockMovement
+- StockQuant, StockValuationLayer, TransferOrder, TransferOrderLine, + 1
+
+#### Schema: mcp (2 implementadas)
+- ToolCall, ToolCallResult
+
+#### Schema: notifications (6 implementadas)
+- Channel, InAppNotification, Notification, NotificationBatch, Preference, Template
+
+#### Schema: partners (6 implementadas)
+- PartnerSegment, PartnerTaxInfo, PartnerAddress, PartnerBankAccount, PartnerContact, + 1
+
+#### Schema: payment-terminals (3 implementadas)
+- TerminalPayment, TerminalWebhookEvent, TenantTerminalConfig
 
 ---
 
-## Entities Propias - Schema: transport (~25)
+### 1.2 Entities Propias Implementadas - 44
 
-### Ordenes de Transporte (MAI-003)
+#### Modulo: ordenes-transporte (5)
+| Entity | Archivo | Nota |
+|--------|---------|------|
+| Quotation | quotation.entity.ts | GENERICA - no especializada |
+| QuotationItem | quotation-item.entity.ts | GENERICA |
+| SalesOrder | sales-order.entity.ts | GENERICA |
+| SalesOrderItem | sales-order-item.entity.ts | GENERICA |
+| + 1 adicional | | |
 
-| Entity | Tabla | Estado | Descripcion |
+**Gap**: Falta OrdenTransporte, Embarque, Parada especializadas
-|--------|-------|--------|-------------|
-| OrdenTransporte | ordenes_transporte | Backend 40% | Solicitud de servicio |
-| Embarque | embarques | Pendiente | Agrupacion de OTs |
-| Parada | paradas | Pendiente | Origenes/destinos |
-| RestriccionOT | restricciones_ot | Pendiente | Restricciones logisticas |
-| ItemOT | items_ot | Pendiente | Lineas de la OT |
 
-### Viajes y Rutas (MAI-004, MAI-005)
+#### Modulo: gestion-flota (9)
+| Entity | Archivo | Nota |
+|--------|---------|------|
+| Product | product.entity.ts | GENERICA |
+| ProductCategory | product-category.entity.ts | GENERICA |
+| ProductVariant | product-variant.entity.ts | GENERICA |
+| ProductAttribute | product-attribute.entity.ts | GENERICA |
+| ProductAttributeValue | product-attribute-value.entity.ts | GENERICA |
+| ProductPrice | product-price.entity.ts | GENERICA |
+| ProductSupplier | product-supplier.entity.ts | GENERICA |
+| + 2 adicionales | | |
 
-| Entity | Tabla | Estado | Descripcion |
+**Gap**: Falta Unidad, Remolque, Operador especializadas
-|--------|-------|--------|-------------|
-| Viaje | viajes | Backend parcial | Ejecucion operativa |
-| Ruta | rutas | Pendiente | Trayecto definido |
-| ParadaViaje | paradas_viaje | Pendiente | Secuencia de paradas |
-| ChecklistPreViaje | checklists_pre_viaje | Pendiente | Inspeccion salida |
-| SelloViaje | sellos_viaje | Pendiente | Sellos de seguridad |
-| EvidenciaCarga | evidencias_carga | Pendiente | Fotos de carga |
 
-### POD y Cierre (MAI-007)
+#### Modulo: tracking (2)
+| Entity | Archivo | Nota |
+|--------|---------|------|
+| 2 entities basicas | | Estructura minima |
 
-| Entity | Tabla | Estado | Descripcion |
+**Gap**: Falta EventoTracking, Geocerca, AlertaTracking
-|--------|-------|--------|-------------|
-| POD | pods | Pendiente | Proof of Delivery |
-| FirmaDigital | firmas_digitales | Pendiente | Firma electronica |
-| FotoEntrega | fotos_entrega | Pendiente | Evidencia fotografica |
-| TiempoReal | tiempos_reales | Pendiente | Tiempos efectivos |
 
-### Incidencias (MAI-008)
+#### Modulo: viajes (4)
+| Entity | Archivo | Nota |
+|--------|---------|------|
+| Timesheet | timesheet.entity.ts | GENERICA de projects |
+| + 3 adicionales | | |
 
-| Entity | Tabla | Estado | Descripcion |
+**Gap**: Falta Viaje, Ruta, ParadaViaje especializadas
-|--------|-------|--------|-------------|
+
-| Incidencia | incidencias | Pendiente | Evento inesperado |
+#### Modulo: combustible-gastos (5) - ESPECIALIZADAS
-| ReclamoCliente | reclamos_clientes | Pendiente | Queja formal |
+| Entity | Archivo | Estado |
+|--------|---------|--------|
+| CargaCombustible | carga-combustible.entity.ts | Entity creada, sin service |
+| CrucePeaje | cruce-peaje.entity.ts | Entity creada, sin service |
+| GastoViaje | gasto-viaje.entity.ts | Entity creada, sin service |
+| AnticipoViatico | anticipo-viatico.entity.ts | Entity creada, sin service |
+| ControlRendimiento | control-rendimiento.entity.ts | Entity creada, sin service |
+
+#### Modulo: tarifas-transporte (6) - ESPECIALIZADAS
+| Entity | Archivo | Estado |
+|--------|---------|--------|
+| Lane | lane.entity.ts | Entity creada, sin service |
+| Tarifa | tarifa.entity.ts | Entity creada, sin service |
+| RecargoCatalogo | recargo-catalogo.entity.ts | Entity creada, sin service |
+| FacturaTransporte | factura-transporte.entity.ts | Entity creada, sin service |
+| LineaFactura | linea-factura.entity.ts | Entity creada, sin service |
+| FuelSurcharge | fuel-surcharge.entity.ts | Entity creada, sin service |
+
+#### Modulo: carta-porte (7)
+| Entity | Archivo | Estado |
+|--------|---------|--------|
+| 7 entities basicas | | Estructura para Carta Porte |
+
+#### Modulo: fiscal (6)
+| Entity | Archivo | Estado |
+|--------|---------|--------|
+| 6 entities fiscales | | Integracion fiscal Mexico |
 
 ---
 
-## Entities Propias - Schema: fleet (~15)
+## Parte 2: Entities DISENADAS (No Implementadas) - ~58
 
-### Unidades y Remolques (MAI-011)
+Las siguientes entities estan definidas en documentacion funcional y/o DDL
+pero **NO EXISTEN** aun en el codigo backend.
 
-| Entity | Tabla | Estado | Descripcion |
+### Schema: transport (~25 disenadas)
-|--------|-------|--------|-------------|
-| Unidad | unidades | Backend 40% | Tractora/caja |
-| Remolque | remolques | Pendiente | Semirremolque |
-| ConfiguracionVehicular | configuraciones_vehiculares | Pendiente | Combinaciones |
-| DocumentoUnidad | documentos_unidades | Pendiente | Permisos, seguros |
 
-### Operadores (MAI-011)
+#### Ordenes de Transporte (MAI-003)
+| Entity | Tabla DDL | Estado Backend |
+|--------|-----------|----------------|
+| OrdenTransporte | ordenes_transporte | NO EXISTE |
+| Embarque | embarques | NO EXISTE |
+| Parada | paradas | NO EXISTE |
+| RestriccionOT | restricciones_ot | NO EXISTE |
+| ItemOT | items_ot | NO EXISTE |
 
-| Entity | Tabla | Estado | Descripcion |
+#### Viajes y Rutas (MAI-004, MAI-005)
-|--------|-------|--------|-------------|
+| Entity | Tabla DDL | Estado Backend |
-| Operador | operadores | Backend 40% | Conductor |
+|--------|-----------|----------------|
-| LicenciaOperador | licencias_operadores | Pendiente | Licencias SCT |
+| Viaje | viajes | NO EXISTE |
-| DocumentoOperador | documentos_operadores | Pendiente | Antidoping, cursos |
+| Ruta | rutas | NO EXISTE |
-| DisponibilidadOperador | disponibilidad_operadores | Pendiente | Horario, descansos |
+| ParadaViaje | paradas_viaje | NO EXISTE |
+| ChecklistPreViaje | checklists_pre_viaje | NO EXISTE |
+| SelloViaje | sellos_viaje | NO EXISTE |
+| EvidenciaCarga | evidencias_carga | NO EXISTE |
+
+#### POD y Cierre (MAI-007)
+| Entity | Tabla DDL | Estado Backend |
+|--------|-----------|----------------|
+| POD | pods | NO EXISTE |
+| FirmaDigital | firmas_digitales | NO EXISTE |
+| FotoEntrega | fotos_entrega | NO EXISTE |
+| TiempoReal | tiempos_reales | NO EXISTE |
+
+#### Incidencias (MAI-008)
+| Entity | Tabla DDL | Estado Backend |
+|--------|-----------|----------------|
+| Incidencia | incidencias | NO EXISTE |
+| ReclamoCliente | reclamos_clientes | NO EXISTE |
+
+### Schema: fleet (~15 disenadas)
+
+#### Unidades y Remolques (MAI-011)
+| Entity | Tabla DDL | Estado Backend |
+|--------|-----------|----------------|
+| Unidad | unidades | NO EXISTE |
+| Remolque | remolques | NO EXISTE |
+| ConfiguracionVehicular | configuraciones_vehiculares | NO EXISTE |
+| DocumentoUnidad | documentos_unidades | NO EXISTE |
+
+#### Operadores (MAI-011)
+| Entity | Tabla DDL | Estado Backend |
+|--------|-----------|----------------|
+| Operador | operadores | NO EXISTE |
+| LicenciaOperador | licencias_operadores | NO EXISTE |
+| DocumentoOperador | documentos_operadores | NO EXISTE |
+| DisponibilidadOperador | disponibilidad_operadores | NO EXISTE |
+
+### Schema: tracking (~10 disenadas)
+
+#### Eventos GPS (MAI-006)
+| Entity | Tabla DDL | Estado Backend |
+|--------|-----------|----------------|
+| EventoTracking | eventos_tracking | NO EXISTE |
+| Geocerca | geocercas | NO EXISTE |
+| AlertaTracking | alertas_tracking | NO EXISTE |
+| ETADinamico | eta_dinamico | NO EXISTE |
+| DispositivoGPS | dispositivos_gps | NO EXISTE |
+
+### Schema: maintenance (~12 disenadas)
+
+#### Mantenimiento (MAI-013)
+| Entity | Tabla DDL | Estado Backend |
+|--------|-----------|----------------|
+| OrdenTrabajo | ordenes_trabajo | NO EXISTE |
+| ProgramaMantenimiento | programas_mantenimiento | NO EXISTE |
+| RefaccionFlota | refacciones_flota | NO EXISTE |
+| HistorialMantenimiento | historial_mantenimiento | NO EXISTE |
+| ProveedorMantenimiento | proveedores_mantenimiento | NO EXISTE |
+
+### Schema: carriers (~8 disenadas)
+
+#### Terceros (MAI-014)
+| Entity | Tabla DDL | Estado Backend |
+|--------|-----------|----------------|
+| Carrier | carriers | NO EXISTE |
+| DocumentoCarrier | documentos_carriers | NO EXISTE |
+| ScorecardCarrier | scorecard_carriers | NO EXISTE |
+| TarifaCarrier | tarifas_carriers | NO EXISTE |
+
+### Schema: billing (~10 disenadas)
+
+#### Liquidaciones (MAI-010)
+| Entity | Tabla DDL | Estado Backend |
+|--------|-----------|----------------|
+| LiquidacionOperador | liquidaciones_operadores | NO EXISTE |
+| Deduccion | deducciones | NO EXISTE |
+
+### Schema: compliance (~10 disenadas)
+
+#### Carta Porte (MAE-016)
+| Entity | Tabla DDL | Estado Backend |
+|--------|-----------|----------------|
+| CartaPorte | cartas_porte | PARCIAL (7 entities basicas) |
+| UbicacionCartaPorte | ubicaciones_carta_porte | NO EXISTE |
+| MercanciaCartaPorte | mercancias_carta_porte | NO EXISTE |
+| AutoTransporteFederal | autotransporte_federal | NO EXISTE |
+| FiguraTransporte | figuras_transporte | NO EXISTE |
+
+#### HOS y Bitacora (MAE-017)
+| Entity | Tabla DDL | Estado Backend |
+|--------|-----------|----------------|
+| RegistroHOS | registros_hos | NO EXISTE |
+| Bitacora | bitacoras | NO EXISTE |
+| InspeccionUnidad | inspecciones_unidades | NO EXISTE |
 
 ---
 
-## Entities Propias - Schema: tracking (~10)
+## Resumen de Gaps
 
-### Eventos GPS (MAI-006)
+| Schema | Disenadas | Implementadas | Gap |
-
+|--------|-----------|---------------|-----|
-| Entity | Tabla | Estado | Descripcion |
+| transport | 25 | 0 especializadas | -25 |
-|--------|-------|--------|-------------|
+| fleet | 15 | 0 especializadas | -15 |
-| EventoTracking | eventos_tracking | Backend 20% | Posicion GPS |
+| tracking | 10 | 2 basicas | -8 |
-| Geocerca | geocercas | Backend 20% | Zonas geograficas |
+| maintenance | 12 | 0 | -12 |
-| AlertaTracking | alertas_tracking | Pendiente | Notificaciones |
+| carriers | 8 | 0 | -8 |
-| ETADinamico | eta_dinamico | Pendiente | Tiempo estimado |
+| billing | 10 | 6 (tarifas) | -4 |
-| DispositivoGPS | dispositivos_gps | Pendiente | Hardware tracking |
+| compliance | 10 | 7 (carta-porte parcial) | -3 |
-
+| **TOTAL** | **~90** | **15** | **~75** |
----
-
-## Entities Propias - Schema: fuel (~8)
-
-### Combustible (MAI-012)
-
-| Entity | Tabla | Estado | Descripcion |
-|--------|-------|--------|-------------|
-| CargaCombustible | cargas_combustible | Backend 50% | Registro de carga |
-| CrucePeaje | cruces_peaje | Backend 50% | Peajes IAVE/TAG |
-| GastoViaje | gastos_viaje | Backend 50% | Gastos operativos |
-| AnticipoViatico | anticipos_viaticos | Backend 50% | Adelantos |
-| ControlRendimiento | control_rendimiento | Backend 50% | km/litro |
-
----
-
-## Entities Propias - Schema: maintenance (~12)
-
-### Mantenimiento (MAI-013)
-
-| Entity | Tabla | Estado | Descripcion |
-|--------|-------|--------|-------------|
-| OrdenTrabajo | ordenes_trabajo | Pendiente | OT mantenimiento |
-| ProgramaMantenimiento | programas_mantenimiento | Pendiente | Preventivo |
-| RefaccionFlota | refacciones_flota | Pendiente | Inventario partes |
-| HistorialMantenimiento | historial_mantenimiento | Pendiente | Registro historico |
-| ProveedorMantenimiento | proveedores_mantenimiento | Pendiente | Talleres externos |
-
----
-
-## Entities Propias - Schema: carriers (~8)
-
-### Terceros (MAI-014)
-
-| Entity | Tabla | Estado | Descripcion |
-|--------|-------|--------|-------------|
-| Carrier | carriers | Pendiente | Transportista externo |
-| DocumentoCarrier | documentos_carriers | Pendiente | Permisos, seguros |
-| ScorecardCarrier | scorecard_carriers | Pendiente | Evaluacion |
-| TarifaCarrier | tarifas_carriers | Pendiente | Precios acordados |
-
----
-
-## Entities Propias - Schema: billing (~10)
-
-### Facturacion Transporte (MAI-009)
-
-| Entity | Tabla | Estado | Descripcion |
-|--------|-------|--------|-------------|
-| Lane | lanes | Backend 30% | Ruta comercial |
-| Tarifa | tarifas | Backend 30% | Precio por lane |
-| RecargoCatalogo | recargos_catalogo | Backend 30% | Fuel surcharge, detention |
-| FacturaTransporte | facturas_transporte | Backend 30% | Factura servicio |
-| LineaFactura | lineas_factura | Backend 30% | Detalle factura |
-| FuelSurcharge | fuel_surcharge | Backend 30% | Recargo combustible |
-
-### Liquidaciones (MAI-010)
-
-| Entity | Tabla | Estado | Descripcion |
-|--------|-------|--------|-------------|
-| LiquidacionOperador | liquidaciones_operadores | Pendiente | Pago operador |
-| Deduccion | deducciones | Pendiente | Descuentos |
-
----
-
-## Entities Propias - Schema: compliance (~10)
-
-### Carta Porte (MAE-016)
-
-| Entity | Tabla | Estado | Descripcion |
-|--------|-------|--------|-------------|
-| CartaPorte | cartas_porte | Pendiente | Complemento CFDI |
-| UbicacionCartaPorte | ubicaciones_carta_porte | Pendiente | Origenes/destinos |
-| MercanciaCartaPorte | mercancias_carta_porte | Pendiente | Detalle carga |
-| AutoTransporteFederal | autotransporte_federal | Pendiente | Datos SCT |
-| FiguraTransporte | figuras_transporte | Pendiente | Operador, propietario |
-
-### HOS y Bitacora (MAE-017)
-
-| Entity | Tabla | Estado | Descripcion |
-|--------|-------|--------|-------------|
-| RegistroHOS | registros_hos | Pendiente | Horas de servicio |
-| Bitacora | bitacoras | Pendiente | Log operador |
-| InspeccionUnidad | inspecciones_unidades | Pendiente | Pre/post viaje |
 
 ---
 
 ## Referencias
 
-- DDL completo: `database/ddl/`
 - Backend Inventory: `orchestration/inventarios/BACKEND_INVENTORY.yml`
 - Database Inventory: `orchestration/inventarios/DATABASE_INVENTORY.yml`
+- DDL: `database/ddl/`
 
 ---
 
-*Ultima actualizacion: 2026-01-26*
+## Historial
+
+| Fecha | Version | Cambio |
+|-------|---------|--------|
+| 2026-01-26 | 1.0.0 | Creacion inicial |
+| 2026-01-27 | 2.0.0 | CORRECCION: Separacion clara IMPLEMENTADAS vs DISENADAS |
+
+---
+
+*Ultima actualizacion: 2026-01-27 (Auditoria Fase 0)*

orchestration/MAPA-DOCUMENTACION.yml

@@ -1,13 +1,14 @@
 # MAPA-DOCUMENTACION.yml - ERP Transportistas
 # Indice de documentacion del proyecto
 # Sistema SIMCO v4.0.0
+# ACTUALIZADO: 2026-01-27 (Auditoria Fase 0)
 
-version: "1.0.0"
+version: "2.0.0"
 project: "erp-transportistas"
-updated: "2026-01-25"
+updated: "2026-01-27"
 
 # ═══════════════════════════════════════════════════════════════════════════════
-# ESTRUCTURA DE DOCUMENTACION
+# ESTRUCTURA DE DOCUMENTACION (ACTUAL)
 # ═══════════════════════════════════════════════════════════════════════════════
 
 estructura:
@@ -16,158 +17,303 @@ estructura:
     - archivo: "CLAUDE.md"
       tipo: "configuracion"
       descripcion: "Instrucciones para Claude Code"
+      estado: "completado"
 
     - archivo: "README.md"
       tipo: "documentacion"
       descripcion: "Documentacion general del proyecto"
+      estado: "completado"
 
     - archivo: "PROJECT-STATUS.md"
       tipo: "estado"
       descripcion: "Estado actual del proyecto"
+      estado: "requiere_actualizacion"
 
     - archivo: "INVENTARIO.yml"
       tipo: "inventario"
       descripcion: "Inventario SIMCO del proyecto"
+      estado: "completado"
 
   docs:
-    00-vision-general:
+    _definitions:
-      - archivo: "VISION-ERP-TRANSPORTISTAS.md"
+      descripcion: "Definiciones centralizadas"
-        tipo: "vision"
+      archivos:
-        descripcion: "Vision del producto"
+        - archivo: "_INDEX.yml"
-        estado: "completado"
+          estado: "completado"
+        - archivo: "MODULES-CATALOG.md"
+          estado: "completado"
+        - archivo: "ENTITIES-CATALOG.md"
+          estado: "corregido_2026-01-27"
+        - archivo: "SERVICES-CATALOG.md"
+          estado: "pendiente"
+        - archivo: "DATABASE-SCHEMA.md"
+          estado: "completado"
 
-    01-analisis-referencias:
+    _quick:
-      descripcion: "Analisis de referencias y benchmarks"
+      descripcion: "Referencias rapidas"
-      archivos: []
+      archivos:
-      estado: "pendiente"
+        - archivo: "QUICK-INDEX.yml"
+          estado: "completado"
+        - archivo: "QUICK-MODULES.yml"
+          estado: "completado"
+        - archivo: "QUICK-DATABASE.yml"
+          estado: "completado"
+        - archivo: "QUICK-API.yml"
+          estado: "completado"
+
+    00-vision-general:
+      descripcion: "Vision del producto"
+      archivos:
+        - archivo: "VISION-ERP-TRANSPORTISTAS.md"
+          estado: "completado"
 
     02-definicion-modulos:
       descripcion: "Definicion funcional de modulos"
-      archivos: []
+      estado_general: "parcial"
-      estado: "pendiente"
+      modulos_documentados:
-      estructura_por_modulo:
+
-        - "_MAP.md"
+        MAI-003-ordenes-transporte:
-        - "RESUMEN-EPICA-{codigo}.md"
+          estado: "80%"
-        - "requerimientos-funcionales/"
+          archivos:
-        - "especificaciones/"
+            - README.md
-        - "historias-usuario/"
+            - REQUERIMIENTOS.md
-        - "implementacion/"
+            - RESUMEN-EPICA.md
+          historias_usuario: 10
+          directorio: "historias-usuario/"
+
+        MAI-006-tracking:
+          estado: "60%"
+          archivos:
+            - README.md
+            - REQUERIMIENTOS.md
+            - RESUMEN-EPICA.md
+          historias_usuario: 0
+
+        MAI-011-gestion-flota:
+          estado: "60%"
+          archivos:
+            - README.md
+            - REQUERIMIENTOS.md
+            - RESUMEN-EPICA.md
+          historias_usuario: 0
+
+        MAI-012-combustible-gastos:
+          estado: "30%"
+          archivos:
+            - ENTITIES.md
+          historias_usuario: 0
+
+        MAI-009-facturacion-transporte:
+          estado: "10%"
+          archivos:
+            - ENTITIES.md
+          historias_usuario: 0
+
+        MAE-016-carta-porte:
+          estado: "80%"
+          archivos:
+            - README.md
+            - REQUERIMIENTOS.md
+            - RESUMEN-EPICA.md
+          historias_usuario: 10
+          directorio: "historias-usuario/"
+
+      modulos_sin_documentacion:
+        - MAI-002
+        - MAI-004
+        - MAI-005
+        - MAI-007
+        - MAI-008
+        - MAI-010
+        - MAI-013
+        - MAI-014
+        - MAI-015
+        - MAE-017
+        - MAE-018
+        - MAA-019
+        - MAA-020
 
     03-requerimientos:
-      - archivo: "REQ-GIRO-TRANSPORTISTA.md"
+      descripcion: "Requerimientos del giro"
-        tipo: "requerimientos"
+      archivos:
-        descripcion: "Requerimientos especificos del giro"
+        - archivo: "REQ-GIRO-TRANSPORTISTA.md"
-        estado: "completado"
+          estado: "completado"
-
+          rf_definidos: 68
-    10-modelado:
+          procesos: 13
-      descripcion: "Modelos de datos y diagramas"
-      archivos: []
-      estado: "pendiente"
-
-    20-user-stories:
-      descripcion: "Historias de usuario"
-      archivos: []
-      estado: "pendiente"
-
-    30-integraciones:
-      descripcion: "Documentacion de integraciones"
-      subdirectorios:
-        - "gps-telematica/"
-        - "pac-cfdi/"
-        - "mapas/"
-        - "whatsapp/"
-      estado: "pendiente"
-
-    90-transversal:
-      descripcion: "Temas transversales"
-      archivos: []
-      estado: "pendiente"
-
-    97-adr:
-      descripcion: "Architecture Decision Records"
-      archivos: []
-      estado: "pendiente"
 
   orchestration:
-    - archivo: "BOOTLOADER.md"
+    raiz:
-      tipo: "configuracion"
+      - archivo: "BOOTLOADER.md"
-      descripcion: "Secuencia de carga de contexto"
+        tipo: "configuracion"
+        estado: "completado"
 
-    - archivo: "PROJECT-PROFILE.yml"
+      - archivo: "PROJECT-PROFILE.yml"
-      tipo: "perfil"
+        tipo: "perfil"
-      descripcion: "Perfil del proyecto para propagacion"
+        estado: "completado"
 
-    - archivo: "CONTEXT-MAP.yml"
+      - archivo: "CONTEXT-MAP.yml"
-      tipo: "mapa"
+        tipo: "mapa"
-      descripcion: "Mapa de contexto NEXUS"
+        estado: "completado"
 
-    - archivo: "DEPENDENCY-GRAPH.yml"
+      - archivo: "DEPENDENCY-GRAPH.yml"
-      tipo: "dependencias"
+        tipo: "dependencias"
-      descripcion: "Grafo de dependencias"
+        estado: "completado"
 
-    - archivo: "MAPA-DOCUMENTACION.yml"
+      - archivo: "MAPA-DOCUMENTACION.yml"
-      tipo: "indice"
+        tipo: "indice"
-      descripcion: "Este archivo"
+        estado: "actualizado_2026-01-27"
 
-    subdirectorios:
+      - archivo: "PROXIMA-ACCION.md"
-      00-guidelines:
+        tipo: "planificacion"
-        - archivo: "CONTEXTO-PROYECTO.md"
+        estado: "actualizado_2026-01-27"
-          descripcion: "Contexto del proyecto"
 
-      directivas:
+    inventarios:
-        - subdirectorio: "checklists/"
+      descripcion: "Inventarios sincronizados"
-          descripcion: "Checklists por fase CAPVED"
+      archivos:
+        - archivo: "DATABASE_INVENTORY.yml"
+          estado: "completado"
+        - archivo: "BACKEND_INVENTORY.yml"
+          estado: "corregido_2026-01-27"
+        - archivo: "MASTER_INVENTORY.yml"
+          estado: "nuevo_2026-01-27"
 
-      inventarios:
+    tareas:
-        descripcion: "Inventarios sincronizados"
+      descripcion: "Historial de tareas"
-        archivos: []
+      estructura: "TASK-YYYY-MM-DD-{nombre}/"
-
+      tareas_existentes:
-      tareas:
+        - TASK-2026-01-25-001-CREAR-PROYECTO
-        descripcion: "Historial de tareas"
+        - TASK-2026-01-25-DOCUMENTACION-MODULOS
-        estructura: "YYYY-MM-DD/TASK-NNN-{nombre}/"
-
-      trazas:
-        descripcion: "Trazas de agentes"
-        archivos: []
 
 # ═══════════════════════════════════════════════════════════════════════════════
-# DOCUMENTOS POR CREAR (PRIORIZADOS)
+# CARPETAS ELIMINADAS (2026-01-27)
+# ═══════════════════════════════════════════════════════════════════════════════
+
+eliminadas_auditoria:
+  fecha: "2026-01-27"
+  razon: "Carpetas vacias sin contenido"
+  carpetas:
+    - "docs/01-analisis-referencias/"
+    - "docs/10-modelado/"
+    - "docs/20-user-stories/"
+    - "docs/30-integraciones/"
+    - "docs/90-transversal/"
+    - "docs/97-adr/"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# DOCUMENTOS PENDIENTES (PRIORIZADOS)
 # ═══════════════════════════════════════════════════════════════════════════════
 
 pendientes:
 
-  alta_prioridad:
+  P0_inmediato:
-    - path: "docs/02-definicion-modulos/MAI-003-ordenes-transporte/"
+    - path: "docs/02-definicion-modulos/MAI-007-pod-cierre/"
-      descripcion: "Definicion del modulo core de OT"
+      descripcion: "Modulo critico - bloquea facturacion"
+      archivos_requeridos:
+        - README.md
+        - REQUERIMIENTOS.md
+        - RESUMEN-EPICA.md
+        - historias-usuario/ (5-10 US)
 
-    - path: "docs/02-definicion-modulos/MAI-011-gestion-flota/"
+    - path: "docs/02-definicion-modulos/MAI-004-planeacion/"
-      descripcion: "Definicion del modulo de flota"
+      descripcion: "Workflow critico"
+      archivos_requeridos:
+        - README.md
+        - REQUERIMIENTOS.md
+        - RESUMEN-EPICA.md
+        - historias-usuario/ (5-10 US)
 
-    - path: "docs/02-definicion-modulos/MAI-006-tracking/"
+    - path: "docs/02-definicion-modulos/MAI-005-despacho/"
-      descripcion: "Definicion del modulo de tracking"
+      descripcion: "Workflow + NOM-068"
+      archivos_requeridos:
+        - README.md
+        - REQUERIMIENTOS.md
+        - RESUMEN-EPICA.md
+        - historias-usuario/ (5-10 US)
 
-    - path: "docs/02-definicion-modulos/MAE-016-carta-porte-cfdi/"
+    - path: "docs/02-definicion-modulos/MAI-002-tarifas-sla/"
-      descripcion: "Definicion del modulo de Carta Porte"
+      descripcion: "Base comercial"
+      archivos_requeridos:
+        - README.md
+        - REQUERIMIENTOS.md
+        - RESUMEN-EPICA.md
+        - historias-usuario/ (5-10 US)
 
-  media_prioridad:
+  P1_corto_plazo:
-    - path: "docs/10-modelado/MODELO-DATOS-TRANSPORT.md"
+    - path: "docs/02-definicion-modulos/MAI-009-facturacion-transporte/"
-      descripcion: "Modelo de datos del schema transport"
+      descripcion: "Completar documentacion (tiene ENTITIES.md)"
+      archivos_faltantes:
+        - README.md
+        - REQUERIMIENTOS.md
+        - RESUMEN-EPICA.md
 
-    - path: "docs/30-integraciones/gps-telematica/INTEGRACION-GPS.md"
+    - path: "docs/02-definicion-modulos/MAI-010-liquidaciones/"
-      descripcion: "Documentacion de integracion GPS"
+      descripcion: "Pago operadores"
 
-    - path: "docs/30-integraciones/pac-cfdi/INTEGRACION-PAC.md"
+    - path: "docs/02-definicion-modulos/MAI-008-incidencias/"
-      descripcion: "Documentacion de integracion PAC"
+      descripcion: "Soporte operativo"
+
+    - path: "docs/02-definicion-modulos/MAI-006-tracking/historias-usuario/"
+      descripcion: "Agregar 5-10 user stories"
+
+    - path: "docs/02-definicion-modulos/MAI-011-gestion-flota/historias-usuario/"
+      descripcion: "Agregar 5-10 user stories"
+
+  P2_mediano_plazo:
+    - path: "docs/02-definicion-modulos/MAI-012-combustible-gastos/"
+      descripcion: "Completar (tiene ENTITIES.md)"
+
+    - path: "docs/02-definicion-modulos/MAI-013-mantenimiento/"
+      descripcion: "Mantenimiento flota"
+
+    - path: "docs/02-definicion-modulos/MAI-014-carriers/"
+      descripcion: "Terceros"
+
+    - path: "docs/02-definicion-modulos/MAE-017-hos-bitacora/"
+      descripcion: "Compliance HOS"
+
+    - path: "docs/02-definicion-modulos/MAE-018-reportes-kpis/"
+      descripcion: "Analytics"
 
 # ═══════════════════════════════════════════════════════════════════════════════
-# ESTADISTICAS
+# ESTADISTICAS (CORREGIDAS)
 # ═══════════════════════════════════════════════════════════════════════════════
 
 estadisticas:
-  total_archivos: 25
+  total_archivos_docs: 45
-  completados: 15
+  archivos_completados: 32
-  pendientes: 10
+  archivos_parciales: 8
-  cobertura: "60%"
+  archivos_pendientes: "~40 (modulos sin documentar)"
+
+  modulos:
+    total: 20
+    documentados_completos: 2
+    documentados_parciales: 4
+    sin_documentar: 14
+
+  user_stories:
+    existentes: 30
+    requeridas_estimado: 180
+    gap: 150
+
+  cobertura_documentacion: "25%"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# HISTORIAL
+# ═══════════════════════════════════════════════════════════════════════════════
+
+historial:
+  - fecha: "2026-01-25"
+    autor: "META-ORQUESTADOR"
+    cambio: "Creacion inicial"
+
+  - fecha: "2026-01-27"
+    autor: "AUDITOR"
+    cambio: |
+      Auditoria Fase 0:
+      - Eliminadas 6 carpetas vacias
+      - Estadisticas corregidas
+      - Pendientes priorizados
+      - Estructura actualizada
 
 # ═══════════════════════════════════════════════════════════════════════════════
 # METADATA
@@ -176,3 +322,5 @@ estadisticas:
 metadata:
   created_by: "META-ORQUESTADOR"
   created_at: "2026-01-25"
+  last_audit: "2026-01-27"
+  auditor: "AUDITOR-FASE-0"

orchestration/PROXIMA-ACCION.md

@@ -1,41 +1,62 @@
 # PROXIMA-ACCION.md - ERP Transportistas
 
-**Ultima Actualizacion:** 2026-01-25
+**Ultima Actualizacion:** 2026-01-27 (Auditoria Fase 0)
 **Sistema:** SIMCO v4.0.0
-**Estado del Proyecto:** 45% completado | DDL 100% | Backend 40%
+**Estado del Proyecto:** 15% completado | DDL 100% | Backend 15% | Frontend 0%
 
 ---
 
-## Estado Actual (2026-01-25)
+## 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 | 40% | 153 entities (95 heredadas + 11 nuevas especializadas) |
+| Backend | 15% | 153 entities (109 heredadas + 44 propias), faltan services/DTOs |
 | Frontend | 0% | Pendiente |
-| Documentacion | 30% | Requerimientos definidos, falta especificaciones modulos |
+| Documentacion | 25% | Requerimientos definidos, falta especificar modulos |
 
-### Entidades Nuevas Creadas (2026-01-25)
+### Desglose de Entities
 
-**Modulo: combustible-gastos (MAI-012)**
+| Categoria | Cantidad | Estado |
-- `carga-combustible.entity.ts` - Cargas de combustible
+|-----------|----------|--------|
-- `cruce-peaje.entity.ts` - Cruces de peaje
+| Heredadas erp-core | 109 | 100% funcionales |
-- `gasto-viaje.entity.ts` - Gastos de viaje
+| Propias genericas | 33 | Entity only, sin services |
-- `anticipo-viatico.entity.ts` - Anticipos viaticos
+| Propias especializadas | 11 | Entity only, sin services |
-- `control-rendimiento.entity.ts` - Control de rendimiento
+| **Disenadas sin implementar** | **~58** | **GAP CRITICO** |
 
-**Modulo: tarifas-transporte (MAI-009)**
+### Entities Especializadas Creadas (2026-01-25)
-- `lane.entity.ts` - Lanes/rutas de transporte
-- `tarifa.entity.ts` - Tarifas por lane
-- `recargo-catalogo.entity.ts` - Catalogo de recargos
-- `factura-transporte.entity.ts` - Facturas de transporte
-- `linea-factura.entity.ts` - Lineas de factura
-- `fuel-surcharge.entity.ts` - Recargo por combustible
 
-### Controladores Nuevos Creados (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)
@@ -44,87 +65,119 @@
 
 ---
 
-## Tareas Completadas
+## Gaps Criticos Identificados
 
-### TASK-2026-01-25-001-CREAR-PROYECTO
+### Entities Especializadas Faltantes (~58)
-- Estructura de carpetas creada
-- CLAUDE.md con especificaciones del giro
-- Documentacion de requerimientos (REQ-GIRO-TRANSPORTISTA.md)
-- Registro en SUBMODULES-INVENTORY.yml
-- **Commit:** 2026-01-25
 
-### TASK-2026-01-25-DOCUMENTACION-MODULOS (En Progreso)
+| Modulo | Entities Faltantes | Prioridad |
-- DATABASE_INVENTORY.yml creado
+|--------|-------------------|-----------|
-- BACKEND_INVENTORY.yml creado
+| MAI-003 | OrdenTransporte, Embarque, Parada, etc. | P0 |
-- PROXIMA-ACCION.md actualizado
+| 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
+### P0 - Inmediato (Auditoria Fase 0 en progreso)
 
-1. **Completar servicios para entidades nuevas**
+1. **Completar purga de documentacion** - En progreso
-   - combustible-gastos: crear services y DTOs
+   - [x] Eliminar carpetas vacias
-   - tarifas-transporte: crear services y DTOs
+   - [x] Reescribir BACKEND_INVENTORY.yml
-   - Estimacion: 4-6 horas
+   - [x] Reescribir ENTITIES-CATALOG.md
+   - [x] Actualizar PROXIMA-ACCION.md
+   - [ ] Crear MASTER_INVENTORY.yml
+   - [ ] Actualizar MAPA-DOCUMENTACION.yml
 
-2. **Crear especificaciones de modulos prioritarios**
+### P0 - Especificacion de Modulos Criticos
-   - MAI-003: Ordenes de Transporte
-   - MAI-006: Tracking
-   - MAI-009: Facturacion Transporte
-   - MAI-011: Gestion de Flota
-   - MAE-016: Carta Porte CFDI
 
-### P1 - Corto Plazo
+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. **Implementar modulo Carta Porte CFDI 3.1**
+3. **Crear User Stories para modulos con REQUERIMIENTOS**
-   - Entidades para complemento fiscal
+   - MAI-006 (Tracking) - 5-10 US
-   - Integracion con PAC
+   - MAI-011 (Gestion Flota) - 5-10 US
-   - Generacion XML/PDF
 
-4. **Implementar frontend base**
+### P1 - Completar Backend
-   - Dashboard transportista
+
-   - Gestion de flota
+4. **Implementar entities especializadas**
-   - Tracking de viajes
+   - 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
 
-5. **Integracion con GPS/Telematica**
+9. **Modulo Carta Porte CFDI 3.1**
-6. **Portal de clientes**
+   - Validar entities vs requisitos SAT
-7. **App movil para operadores**
+   - Integracion PAC
+
+10. **Integracion GPS/Telematica**
+11. **Portal de clientes**
 
 ---
 
-## Modulos del Sistema
+## Modulos del Sistema - Estado Corregido
 
 ### Fase 1 - MAI (Inicial)
 
-| Codigo | Nombre | DDL | Backend | Frontend |
+| Codigo | Nombre | DDL | Backend | Docs | Frontend |
-|--------|--------|:---:|:-------:|:--------:|
+|--------|--------|:---:|:-------:|:----:|:--------:|
-| MAI-001 | Fundamentos | - | 100% | - |
+| MAI-001 | Fundamentos | - | 100% | - | - |
-| MAI-002 | Clientes y Tarifas | - | 0% | - |
+| MAI-002 | Clientes y Tarifas | - | 0% | 0% | 0% |
-| MAI-003 | Ordenes de Transporte | 100% | 40% | 0% |
+| MAI-003 | Ordenes de Transporte | 100% | 10% | 80% | 0% |
-| MAI-004 | Planeacion TMS | 100% | 0% | 0% |
+| MAI-004 | Planeacion TMS | 100% | 0% | 0% | 0% |
-| MAI-005 | Despacho | 100% | 0% | 0% |
+| MAI-005 | Despacho | 100% | 0% | 0% | 0% |
-| MAI-006 | Tracking | 100% | 20% | 0% |
+| MAI-006 | Tracking | 100% | 5% | 60% | 0% |
-| MAI-007 | POD y Cierre | 100% | 0% | 0% |
+| MAI-007 | POD y Cierre | 100% | 0% | 0% | 0% |
-| MAI-008 | Incidencias | 100% | 0% | 0% |
+| MAI-008 | Incidencias | 100% | 0% | 0% | 0% |
-| MAI-009 | Facturacion Transporte | 100% | 30% | 0% |
+| MAI-009 | Facturacion Transporte | 100% | 15% | 0% | 0% |
-| MAI-010 | Liquidaciones | 100% | 0% | 0% |
+| MAI-010 | Liquidaciones | 100% | 0% | 0% | 0% |
-| MAI-011 | Gestion de Flota | 100% | 40% | 0% |
+| MAI-011 | Gestion de Flota | 100% | 10% | 60% | 0% |
-| MAI-012 | Combustible y Gastos | 100% | 50% | 0% |
+| MAI-012 | Combustible y Gastos | 100% | 20% | 30% | 0% |
-| MAI-013 | Mantenimiento Flota | 100% | 0% | 0% |
+| MAI-013 | Mantenimiento Flota | 100% | 0% | 0% | 0% |
-| MAI-014 | Carriers (Terceros) | 100% | 0% | 0% |
+| MAI-014 | Carriers (Terceros) | 100% | 0% | 0% | 0% |
-| MAI-015 | Portal Cliente | 100% | 0% | 0% |
+| MAI-015 | Portal Cliente | 100% | 0% | 0% | 0% |
 
 ### Fase 2 - MAE (Extendido)
 
-| Codigo | Nombre | DDL | Backend | Frontend |
+| Codigo | Nombre | DDL | Backend | Docs | Frontend |
-|--------|--------|:---:|:-------:|:--------:|
+|--------|--------|:---:|:-------:|:----:|:--------:|
-| MAE-016 | Carta Porte CFDI | 100% | 0% | 0% |
+| MAE-016 | Carta Porte CFDI | 100% | 10% | 80% | 0% |
-| MAE-017 | HOS y Bitacora | 100% | 0% | 0% |
+| MAE-017 | HOS y Bitacora | 100% | 0% | 0% | 0% |
-| MAE-018 | Reportes y KPIs | 100% | 0% | 0% |
+| MAE-018 | Reportes y KPIs | 100% | 0% | 0% | 0% |
 
 ### Fase 3 - MAA (Avanzado)
 
@@ -141,9 +194,19 @@
 |---------|-----------|
 | Inventario BD | `orchestration/inventarios/DATABASE_INVENTORY.yml` |
 | Inventario Backend | `orchestration/inventarios/BACKEND_INVENTORY.yml` |
-| Requerimientos | `docs/03-requerimientos/REQ-GIRO-TRANSPORTISTA.md` |
+| 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*

orchestration/inventarios/BACKEND_INVENTORY.yml

@@ -1,226 +1,389 @@
 # BACKEND_INVENTORY.yml - ERP Transportistas
 # Sistema SIMCO v4.0.0
-# Generado: 2026-01-25
+# CORREGIDO: 2026-01-27 (Auditoria Fase 0)
 
-version: "1.0.0"
+version: "2.0.0"
 created: "2026-01-25"
-updated: "2026-01-25"
+updated: "2026-01-27"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# RESUMEN EJECUTIVO
+# ═══════════════════════════════════════════════════════════════════════════════
 
-# Resumen
 summary:
   framework: NestJS
   language: TypeScript
-  total_modules: 23
   total_entities: 153
+  entities_heredadas: 109
+  entities_propias: 44
   hereda_de: erp-core
-  status: "40% implementado"
+  status: "15% implementado (entities creadas, faltan services/DTOs/tests)"
 
-# Modulos del Backend
+# NOTA IMPORTANTE:
-modules:
+# El 15% refleja que hay entities pero la mayoria NO tiene:
-  # Heredados de erp-core
+# - Services completos
-  heredados:
+# - DTOs
-    - name: auth
+# - Tests
-      entities: 20
+# - Validaciones de negocio
-      status: heredado
+# El 40% anterior era INCORRECTO
-      descripcion: "Autenticacion, JWT, OAuth, 2FA"
 
-    - name: users
+# ═══════════════════════════════════════════════════════════════════════════════
-      entities: 3
+# MODULOS HEREDADOS DE ERP-CORE (109 entities)
-      status: heredado
+# ═══════════════════════════════════════════════════════════════════════════════
-      descripcion: "Gestion de usuarios"
 
-    - name: tenants
+modules_heredados:
-      entities: 2
-      status: heredado
-      descripcion: "Multi-tenancy"
 
-    - name: companies
+  - name: auth
-      entities: 1
+    entities: 20
-      status: heredado
+    status: heredado_completo
-      descripcion: "Empresas transportistas"
+    descripcion: "Autenticacion, JWT, OAuth, 2FA, sessions"
+    entidades:
+      - user.entity.ts
+      - role.entity.ts
+      - permission.entity.ts
+      - session.entity.ts
+      - tenant.entity.ts
+      - company.entity.ts
+      - group.entity.ts
+      - api-key.entity.ts
+      - password-reset.entity.ts
+      - oauth-provider.entity.ts
+      - oauth-state.entity.ts
+      - oauth-user-link.entity.ts
+      - trusted-device.entity.ts
+      - verification-code.entity.ts
+      - mfa-audit-log.entity.ts
+      - device.entity.ts
+      - user-profile.entity.ts
+      - user-profile-assignment.entity.ts
+      - profile-tool.entity.ts
+      - profile-module.entity.ts
+    controllers: 2
+    services: heredados
 
-    - name: ai
+  - name: ai
-      entities: 7
+    entities: 7
-      status: heredado
+    status: heredado_completo
-      descripcion: "Integracion IA/LLM"
+    descripcion: "Integracion IA/LLM"
+    entidades:
+      - completion.entity.ts
+      - conversation.entity.ts
+      - embedding.entity.ts
+      - knowledge-base.entity.ts
+      - model.entity.ts
+      - prompt.entity.ts
+      - usage.entity.ts
+    controllers: 1
+    services: heredados
 
-    - name: audit
+  - name: audit
-      entities: 7
+    entities: 7
-      status: heredado
+    status: heredado_completo
-      descripcion: "Auditoria y logs"
+    descripcion: "Auditoria y logs"
+    entidades:
+      - audit-log.entity.ts
+      - config-change.entity.ts
+      - data-export.entity.ts
+      - entity-change.entity.ts
+      - login-history.entity.ts
+      - permission-change.entity.ts
+      - sensitive-data-access.entity.ts
+    controllers: 1
+    services: heredados
 
-    - name: notifications
+  - name: billing-usage
-      entities: 6
+    entities: 13
-      status: heredado
+    status: heredado_completo
-      descripcion: "Notificaciones multicanal"
+    descripcion: "Facturacion SaaS y planes"
+    controllers: 4
+    services: heredados
 
-    - name: billing-usage
+  - name: branches
-      entities: 5
+    entities: 5
-      status: heredado
+    status: heredado_completo
-      descripcion: "Facturacion SaaS"
+    descripcion: "Sucursales"
+    controllers: 1
+    services: heredados
 
-    - name: branches
+  - name: core
-      entities: 5
+    entities: 10
-      status: heredado
+    status: heredado_base
-      descripcion: "Sucursales"
+    descripcion: "Modulo core compartido"
+    controllers: 1
+    services: heredados
 
-    - name: financial
+  - name: financial
-      entities: 15
+    entities: 15
-      status: heredado
+    status: heredado_completo
-      descripcion: "Contabilidad base"
+    descripcion: "Contabilidad base"
+    controllers: 1
+    services: heredados
 
-    - name: inventory
+  - name: inventory
-      entities: 14
+    entities: 15
-      status: heredado
+    status: heredado_completo
-      descripcion: "Inventario base"
+    descripcion: "Inventario base (refacciones)"
+    controllers: 3
+    services: heredados
 
-    - name: partners
+  - name: mcp
-      entities: 5
+    entities: 2
-      status: heredado
+    status: heredado_completo
-      descripcion: "Clientes/Proveedores"
+    descripcion: "MCP Server"
+    controllers: 1
+    services: heredados
 
-    - name: payment-terminals
+  - name: notifications
-      entities: 3
+    entities: 6
-      status: heredado
+    status: heredado_completo
-      descripcion: "Terminales de pago"
+    descripcion: "Notificaciones multicanal"
+    controllers: 1
+    services: heredados
 
-    - name: mcp
+  - name: partners
-      entities: 2
+    entities: 6
-      status: heredado
+    status: heredado_extendido
-      descripcion: "MCP Server"
+    descripcion: "Clientes/Proveedores/Carriers"
+    controllers: 3
+    services: heredados
+    notas: "Extendido para shippers y carriers"
 
-  # Especializados de Transporte (NUEVOS)
+  - name: payment-terminals
-  especializados:
+    entities: 3
-    - name: ordenes-transporte
+    status: heredado_completo
-      entities: 4
+    descripcion: "Terminales de pago"
-      status: en_progreso
+    controllers: 7
-      descripcion: "Ordenes de transporte y embarques"
+    services: heredados
-      modulo_simco: MAI-003
-      entidades:
-        - quotation.entity.ts
-        - quotation-item.entity.ts
-        - sales-order.entity.ts
-        - sales-order-item.entity.ts
-      controllers: 1
-      notas: "Pendiente completar servicios"
 
-    - name: gestion-flota
+# ═══════════════════════════════════════════════════════════════════════════════
-      entities: 7
+# MODULOS PROPIOS DE TRANSPORTE (44 entities)
-      status: en_progreso
+# ═══════════════════════════════════════════════════════════════════════════════
-      descripcion: "Unidades, operadores, productos"
-      modulo_simco: MAI-011
-      entidades:
-        - product.entity.ts
-        - product-category.entity.ts
-        - product-variant.entity.ts
-        - product-attribute.entity.ts
-        - product-attribute-value.entity.ts
-        - product-price.entity.ts
-        - product-supplier.entity.ts
-      controllers: 2
-      notas: "Controladores operadores y unidades creados"
 
-    - name: tracking
+modules_propios:
-      entities: 0
-      status: en_progreso
-      descripcion: "GPS, eventos, alertas"
-      modulo_simco: MAI-006
-      controllers: 1
-      notas: "Controlador basico creado, faltan entidades"
 
-    - name: viajes
+  - name: ordenes-transporte
-      entities: 1
+    entities: 5
-      status: en_progreso
+    status: entity_only
-      descripcion: "Viajes y timesheets"
+    descripcion: "Ordenes de transporte y cotizaciones"
-      modulo_simco: MAI-003
+    modulo_simco: MAI-003
-      entidades:
+    entidades:
-        - timesheet.entity.ts
+      - quotation.entity.ts
-      controllers: 1
+      - quotation-item.entity.ts
-      notas: "Controlador creado"
+      - sales-order.entity.ts
+      - sales-order-item.entity.ts
+      - (1 adicional)
+    controllers: 2
+    services: pendiente
+    dtos: pendiente
+    notas: |
+      Entities creadas pero son GENERICAS de sales.
+      Falta: OrdenTransporte, Embarque, Parada, RestriccionOT
+      como entities ESPECIALIZADAS del giro transporte.
 
-    - name: combustible-gastos
+  - name: gestion-flota
-      entities: 5
+    entities: 9
-      status: nuevo
+    status: entity_only
-      descripcion: "Control de combustible, peajes, gastos"
+    descripcion: "Unidades, operadores, productos"
-      modulo_simco: MAI-012
+    modulo_simco: MAI-011
-      entidades:
+    entidades:
-        - carga-combustible.entity.ts
+      - product.entity.ts
-        - cruce-peaje.entity.ts
+      - product-category.entity.ts
-        - gasto-viaje.entity.ts
+      - product-variant.entity.ts
-        - anticipo-viatico.entity.ts
+      - product-attribute.entity.ts
-        - control-rendimiento.entity.ts
+      - product-attribute-value.entity.ts
-      controllers: 0
+      - product-price.entity.ts
-      notas: "Entidades creadas, faltan controladores y servicios"
+      - product-supplier.entity.ts
+      - (2 adicionales)
+    controllers: 3
+    services: pendiente
+    notas: |
+      Entities son GENERICAS de products.
+      Falta: Unidad, Remolque, Operador, LicenciaOperador,
+      DocumentoUnidad, DisponibilidadOperador como
+      entities ESPECIALIZADAS del giro transporte.
 
-    - name: tarifas-transporte
+  - name: tracking
-      entities: 6
+    entities: 2
-      status: nuevo
+    status: entity_only
-      descripcion: "Tarifas por lane, facturacion, recargos"
+    descripcion: "GPS, eventos, alertas"
-      modulo_simco: MAI-009
+    modulo_simco: MAI-006
-      entidades:
+    controllers: 1
-        - lane.entity.ts
+    services: pendiente
-        - tarifa.entity.ts
+    notas: |
-        - recargo-catalogo.entity.ts
+      Solo 2 entities basicas.
-        - factura-transporte.entity.ts
+      Falta: EventoTracking, Geocerca, AlertaTracking,
-        - linea-factura.entity.ts
+      ETADinamico, DispositivoGPS
-        - fuel-surcharge.entity.ts
-      controllers: 0
-      notas: "Entidades creadas, faltan controladores y servicios"
 
-    - name: carta-porte
+  - name: viajes
-      entities: 0
+    entities: 4
-      status: pendiente
+    status: entity_only
-      descripcion: "Complemento Carta Porte CFDI 3.1"
+    descripcion: "Viajes y timesheets"
-      modulo_simco: MAE-016
+    modulo_simco: MAI-003/MAI-004
-      notas: "Pendiente implementacion"
+    entidades:
+      - timesheet.entity.ts
+      - (3 adicionales)
+    controllers: 2
+    services: pendiente
+    notas: |
+      Entities genericas de projects.
+      Falta: Viaje, Ruta, ParadaViaje, ChecklistPreViaje,
+      SelloViaje, EvidenciaCarga
 
-    - name: fiscal
+  - name: combustible-gastos
-      entities: 0
+    entities: 5
-      status: pendiente
+    status: entity_creada
-      descripcion: "Integracion fiscal Mexico"
+    descripcion: "Control de combustible, peajes, gastos"
-      notas: "Pendiente implementacion"
+    modulo_simco: MAI-012
+    entidades:
+      - carga-combustible.entity.ts
+      - cruce-peaje.entity.ts
+      - gasto-viaje.entity.ts
+      - anticipo-viatico.entity.ts
+      - control-rendimiento.entity.ts
+    controllers: 0
+    services: pendiente
+    dtos: pendiente
+    notas: "Entities especializadas creadas 2026-01-25. Faltan controllers y services."
 
-    - name: core
+  - name: tarifas-transporte
-      entities: 0
+    entities: 6
-      status: base
+    status: entity_creada
-      descripcion: "Modulo core compartido"
+    descripcion: "Tarifas por lane, facturacion, recargos"
+    modulo_simco: MAI-009
+    entidades:
+      - lane.entity.ts
+      - tarifa.entity.ts
+      - recargo-catalogo.entity.ts
+      - factura-transporte.entity.ts
+      - linea-factura.entity.ts
+      - fuel-surcharge.entity.ts
+    controllers: 0
+    services: pendiente
+    dtos: pendiente
+    notas: "Entities especializadas creadas 2026-01-25. Faltan controllers y services."
+
+  - name: carta-porte
+    entities: 7
+    status: entity_creada
+    descripcion: "Complemento Carta Porte CFDI 3.1"
+    modulo_simco: MAE-016
+    controllers: 0
+    services: pendiente
+    notas: "7 entities basicas para carta porte. Requiere validacion vs SAT."
+
+  - name: fiscal
+    entities: 6
+    status: entity_creada
+    descripcion: "Integracion fiscal Mexico"
+    controllers: 1
+    services: pendiente
+    notas: "Entities fiscales basicas."
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# RESUMEN DE TOTALES
+# ═══════════════════════════════════════════════════════════════════════════════
 
-# Totales
 totales:
-  entities: 153
+  entities:
-  controllers: 5
+    heredadas: 109
-  services: TBD
+    propias: 44
-  dtos: TBD
+    total: 153
+  controllers:
+    heredados: 26
+    propios: 9
+    total: 35
+  services:
+    heredados: "~30"
+    propios: 0
+    total: "~30"
+  dtos:
+    heredados: "~60"
+    propios: 0
+    total: "~60"
 
-# Entidades Nuevas (2026-01-25)
+# ═══════════════════════════════════════════════════════════════════════════════
-entidades_nuevas_2026_01_25:
+# ANALISIS DE GAPS
-  combustible_gastos:
+# ═══════════════════════════════════════════════════════════════════════════════
-    - carga-combustible.entity.ts
-    - cruce-peaje.entity.ts
-    - gasto-viaje.entity.ts
-    - anticipo-viatico.entity.ts
-    - control-rendimiento.entity.ts
-  tarifas_transporte:
-    - lane.entity.ts
-    - tarifa.entity.ts
-    - recargo-catalogo.entity.ts
-    - factura-transporte.entity.ts
-    - linea-factura.entity.ts
-    - fuel-surcharge.entity.ts
-  total: 11
 
-# Controladores Nuevos (2026-01-25)
+gaps:
-controladores_nuevos_2026_01_25:
+  criticos:
-  - operadores.controller.ts (gestion-flota)
+    - modulo: MAI-003
-  - unidades.controller.ts (gestion-flota)
+      descripcion: "Ordenes de Transporte"
-  - ordenes-transporte.controller.ts (ordenes-transporte)
+      entities_requeridas:
-  - tracking.controller.ts (tracking)
+        - OrdenTransporte
-  - viajes.controller.ts (viajes)
+        - Embarque
-  total: 5
+        - Parada
+        - RestriccionOT
+        - ItemOT
+      entities_existentes: 0
+      gap: 5
+
+    - modulo: MAI-004
+      descripcion: "Planeacion TMS"
+      entities_requeridas:
+        - Consolidacion
+        - AsignacionRecurso
+        - CapacidadRuta
+      entities_existentes: 0
+      gap: 3
+
+    - modulo: MAI-005
+      descripcion: "Despacho"
+      entities_requeridas:
+        - ChecklistPreViaje
+        - Sello
+        - EvidenciaCarga
+        - OrdenViaje
+      entities_existentes: 0
+      gap: 4
+
+    - modulo: MAI-007
+      descripcion: "POD y Cierre"
+      entities_requeridas:
+        - POD
+        - FirmaDigital
+        - FotoEntrega
+        - TiempoReal
+      entities_existentes: 0
+      gap: 4
+
+    - modulo: MAI-011
+      descripcion: "Gestion de Flota"
+      entities_requeridas:
+        - Unidad
+        - Remolque
+        - Operador
+        - LicenciaOperador
+        - DocumentoUnidad
+        - DisponibilidadOperador
+      entities_existentes: 0
+      gap: 6
+
+  total_entities_faltantes: 22
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# NOTAS Y OBSERVACIONES
+# ═══════════════════════════════════════════════════════════════════════════════
 
-# Notas
 notas:
-  - "Backend hereda 95+ entities de erp-core"
+  - "CORRECCION 2026-01-27: El progreso del 40% era INCORRECTO"
-  - "11 entidades especializadas creadas para transporte"
+  - "El progreso REAL es ~15% (solo hay entities, falta implementacion)"
-  - "5 controladores nuevos agregados 2026-01-25"
+  - "109 entities son heredadas de erp-core"
-  - "Pendiente: servicios, DTOs, tests"
+  - "44 entities son propias pero muchas son GENERICAS no especializadas"
+  - "Las entities especializadas del giro (22+) NO EXISTEN aun"
+  - "Hay 11 entities nuevas especializadas creadas 2026-01-25 (combustible + tarifas)"
+  - "Faltan services, DTOs, validaciones para todas las entities propias"
+
+historial:
+  - fecha: "2026-01-25"
+    autor: "META-ORQUESTADOR"
+    cambio: "Creacion inicial"
+
+  - fecha: "2026-01-27"
+    autor: "AUDITOR"
+    cambio: |
+      CORRECCION CRITICA: Reescritura completa con estado real.
+      - Porcentaje corregido de 40% a 15%
+      - Separacion clara heredadas vs propias
+      - Identificacion de gaps criticos
+      - Documentacion de entities faltantes

orchestration/inventarios/MASTER_INVENTORY.yml

@@ -0,0 +1,456 @@
+# MASTER_INVENTORY.yml - ERP Transportistas
+# Sistema SIMCO v4.0.0
+# Inventario Maestro Consolidado
+# Creado: 2026-01-27 (Auditoria Fase 0)
+
+version: "1.0.0"
+created: "2026-01-27"
+updated: "2026-01-27"
+audit_date: "2026-01-27"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# RESUMEN EJECUTIVO
+# ═══════════════════════════════════════════════════════════════════════════════
+
+resumen:
+  proyecto: erp-transportistas
+  tipo: ERP Vertical (Transporte de Carga)
+  hereda_de: erp-core
+  estado_general: "15% completado"
+
+  metricas:
+    ddl:
+      schemas: 8
+      tablas_estimadas: 98
+      enums_estimados: 47
+      progreso: "100%"
+
+    backend:
+      framework: NestJS
+      entities_total: 153
+      entities_heredadas: 109
+      entities_propias: 44
+      entities_especializadas_faltantes: 58
+      controllers: 35
+      services_propios: 0
+      progreso: "15%"
+
+    frontend:
+      framework: React
+      componentes: 0
+      paginas: 0
+      progreso: "0%"
+
+    documentacion:
+      modulos_total: 20
+      modulos_documentados: 4
+      user_stories: 30
+      progreso: "25%"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# COHERENCIA ENTRE CAPAS
+# ═══════════════════════════════════════════════════════════════════════════════
+
+coherencia:
+  ddl_vs_backend:
+    tablas_ddl: 98
+    entities_especializadas_esperadas: 98
+    entities_especializadas_implementadas: 44
+    gap: 54
+    coherencia_porcentaje: "45%"
+    estado: "INCOHERENTE - Requiere implementacion de entities"
+
+  backend_vs_documentacion:
+    modulos_documentados_con_entities: 4
+    modulos_documentados_sin_entities: 6
+    modulos_sin_documentacion: 10
+    estado: "INCOHERENTE - Falta documentacion de modulos"
+
+  rf_vs_modulos:
+    rf_totales_giro: 68
+    rf_cubiertos_por_modulos: 40
+    rf_sin_modulo: 28
+    cobertura: "59%"
+    estado: "PARCIAL - Requiere mapeo completo"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# INVENTARIO DE MODULOS
+# ═══════════════════════════════════════════════════════════════════════════════
+
+modulos:
+  fase_1_mai:
+    - codigo: MAI-001
+      nombre: Fundamentos
+      ddl: "-"
+      backend: "100%"
+      docs: "-"
+      frontend: "-"
+      herencia: "100% erp-core"
+      prioridad: "-"
+
+    - codigo: MAI-002
+      nombre: Clientes y Tarifas
+      ddl: "0%"
+      backend: "0%"
+      docs: "0%"
+      frontend: "0%"
+      prioridad: P0
+      rf_relacionados: [RF-4.1.1, RF-4.1.2, RF-4.1.3, RF-4.1.4, RF-4.1.5]
+
+    - codigo: MAI-003
+      nombre: Ordenes de Transporte
+      ddl: "100%"
+      backend: "10%"
+      docs: "80%"
+      frontend: "0%"
+      prioridad: P0
+      rf_relacionados: [RF-4.2.1, RF-4.2.2, RF-4.2.3, RF-4.2.4, RF-4.2.5, RF-4.2.6]
+      archivos_docs:
+        - docs/02-definicion-modulos/MAI-003-ordenes-transporte/README.md
+        - docs/02-definicion-modulos/MAI-003-ordenes-transporte/REQUERIMIENTOS.md
+        - docs/02-definicion-modulos/MAI-003-ordenes-transporte/RESUMEN-EPICA.md
+      user_stories: 10
+
+    - codigo: MAI-004
+      nombre: Planeacion TMS
+      ddl: "100%"
+      backend: "0%"
+      docs: "0%"
+      frontend: "0%"
+      prioridad: P0
+      rf_relacionados: [RF-4.3.1, RF-4.3.2, RF-4.3.3, RF-4.3.4, RF-4.3.5, RF-4.3.6]
+
+    - codigo: MAI-005
+      nombre: Despacho
+      ddl: "100%"
+      backend: "0%"
+      docs: "0%"
+      frontend: "0%"
+      prioridad: P0
+      rf_relacionados: [RF-4.4.1, RF-4.4.2, RF-4.4.3, RF-4.4.4, RF-4.4.5, RF-4.4.6]
+
+    - codigo: MAI-006
+      nombre: Tracking
+      ddl: "100%"
+      backend: "5%"
+      docs: "60%"
+      frontend: "0%"
+      prioridad: P1
+      rf_relacionados: [RF-4.5.1, RF-4.5.2, RF-4.5.3, RF-4.5.4, RF-4.5.5, RF-4.5.6]
+      archivos_docs:
+        - docs/02-definicion-modulos/MAI-006-tracking/README.md
+        - docs/02-definicion-modulos/MAI-006-tracking/REQUERIMIENTOS.md
+        - docs/02-definicion-modulos/MAI-006-tracking/RESUMEN-EPICA.md
+
+    - codigo: MAI-007
+      nombre: POD y Cierre
+      ddl: "100%"
+      backend: "0%"
+      docs: "0%"
+      frontend: "0%"
+      prioridad: P0
+      rf_relacionados: [RF-4.7.1, RF-4.7.2, RF-4.7.3, RF-4.7.4]
+
+    - codigo: MAI-008
+      nombre: Incidencias
+      ddl: "100%"
+      backend: "0%"
+      docs: "0%"
+      frontend: "0%"
+      prioridad: P1
+      rf_relacionados: [RF-4.6.1, RF-4.6.2, RF-4.6.3, RF-4.6.4, RF-4.6.5, RF-4.6.6]
+
+    - codigo: MAI-009
+      nombre: Facturacion Transporte
+      ddl: "100%"
+      backend: "15%"
+      docs: "0%"
+      frontend: "0%"
+      prioridad: P1
+      rf_relacionados: [RF-4.8.1, RF-4.8.2, RF-4.8.3, RF-4.8.4, RF-4.8.5]
+      entities_implementadas: 6
+
+    - codigo: MAI-010
+      nombre: Liquidaciones
+      ddl: "100%"
+      backend: "0%"
+      docs: "0%"
+      frontend: "0%"
+      prioridad: P1
+      rf_relacionados: [RF-4.9.1, RF-4.9.2, RF-4.9.3, RF-4.9.4]
+
+    - codigo: MAI-011
+      nombre: Gestion de Flota
+      ddl: "100%"
+      backend: "10%"
+      docs: "60%"
+      frontend: "0%"
+      prioridad: P0
+      rf_relacionados: [RF-4.11.1, RF-4.11.2, RF-4.11.3, RF-4.11.4, RF-4.11.5]
+      archivos_docs:
+        - docs/02-definicion-modulos/MAI-011-gestion-flota/README.md
+        - docs/02-definicion-modulos/MAI-011-gestion-flota/REQUERIMIENTOS.md
+        - docs/02-definicion-modulos/MAI-011-gestion-flota/RESUMEN-EPICA.md
+
+    - codigo: MAI-012
+      nombre: Combustible y Gastos
+      ddl: "100%"
+      backend: "20%"
+      docs: "30%"
+      frontend: "0%"
+      prioridad: P2
+      rf_relacionados: [RF-4.10.1, RF-4.10.2, RF-4.10.3, RF-4.10.4, RF-4.10.5]
+      entities_implementadas: 5
+      archivos_docs:
+        - docs/02-definicion-modulos/MAI-012-combustible-gastos/ENTITIES.md
+
+    - codigo: MAI-013
+      nombre: Mantenimiento Flota
+      ddl: "100%"
+      backend: "0%"
+      docs: "0%"
+      frontend: "0%"
+      prioridad: P2
+      rf_relacionados: [RF-4.11.1, RF-4.11.2, RF-4.11.3, RF-4.11.4, RF-4.11.5]
+
+    - codigo: MAI-014
+      nombre: Carriers (Terceros)
+      ddl: "100%"
+      backend: "0%"
+      docs: "0%"
+      frontend: "0%"
+      prioridad: P2
+      rf_relacionados: [RF-4.12.1, RF-4.12.2, RF-4.12.3, RF-4.12.4, RF-4.12.5, RF-4.12.6]
+
+    - codigo: MAI-015
+      nombre: Portal Cliente
+      ddl: "100%"
+      backend: "0%"
+      docs: "0%"
+      frontend: "0%"
+      prioridad: P3
+      rf_relacionados: [RF-4.13.1, RF-4.13.2, RF-4.13.3, RF-4.13.4]
+
+  fase_2_mae:
+    - codigo: MAE-016
+      nombre: Carta Porte CFDI
+      ddl: "100%"
+      backend: "10%"
+      docs: "80%"
+      frontend: "0%"
+      prioridad: P1
+      rf_relacionados: [RF-5.1.1, RF-5.1.2, RF-5.1.3, RF-5.1.4, RF-5.1.5, RF-5.1.6, RF-5.1.7]
+      archivos_docs:
+        - docs/02-definicion-modulos/MAE-016-carta-porte/README.md
+        - docs/02-definicion-modulos/MAE-016-carta-porte/REQUERIMIENTOS.md
+        - docs/02-definicion-modulos/MAE-016-carta-porte/RESUMEN-EPICA.md
+      user_stories: 10
+
+    - codigo: MAE-017
+      nombre: HOS y Bitacora
+      ddl: "100%"
+      backend: "0%"
+      docs: "0%"
+      frontend: "0%"
+      prioridad: P3
+      rf_relacionados: [RF-5.2.1, RF-5.2.2, RF-5.2.3, RF-5.2.4]
+
+    - codigo: MAE-018
+      nombre: Reportes y KPIs
+      ddl: "100%"
+      backend: "0%"
+      docs: "0%"
+      frontend: "0%"
+      prioridad: P2
+
+  fase_3_maa:
+    - codigo: MAA-019
+      nombre: Optimizacion Rutas
+      ddl: "0%"
+      backend: "0%"
+      docs: "0%"
+      frontend: "0%"
+      prioridad: P3
+
+    - codigo: MAA-020
+      nombre: Integraciones EDI
+      ddl: "0%"
+      backend: "0%"
+      docs: "0%"
+      frontend: "0%"
+      prioridad: P3
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# PRIORIZACION DE MODULOS
+# ═══════════════════════════════════════════════════════════════════════════════
+
+priorizacion:
+  criterios:
+    bloqueante_workflow: 5
+    compliance_requerido: 4
+    alta_dependencia: 3
+    backend_parcial: 2
+    solicitado: 1
+
+  resultado:
+    P0:
+      - codigo: MAI-007
+        nombre: POD y Cierre
+        puntos: 8
+        justificacion: "Bloquea facturacion, cierre operativo"
+
+      - codigo: MAI-004
+        nombre: Planeacion TMS
+        puntos: 8
+        justificacion: "Workflow critico OT -> Viaje"
+
+      - codigo: MAI-005
+        nombre: Despacho
+        puntos: 8
+        justificacion: "Workflow + NOM-068 compliance"
+
+      - codigo: MAI-002
+        nombre: Tarifas y SLA
+        puntos: 7
+        justificacion: "Base comercial obligatoria"
+
+      - codigo: MAI-003
+        nombre: Ordenes de Transporte
+        puntos: 7
+        justificacion: "Core del sistema, ya tiene docs"
+
+      - codigo: MAI-011
+        nombre: Gestion de Flota
+        puntos: 7
+        justificacion: "Recursos criticos, ya tiene docs"
+
+    P1:
+      - codigo: MAI-009
+        nombre: Facturacion Transporte
+        puntos: 6
+        justificacion: "Monetizacion"
+
+      - codigo: MAI-010
+        nombre: Liquidaciones
+        puntos: 5
+        justificacion: "Pago operadores"
+
+      - codigo: MAI-008
+        nombre: Incidencias
+        puntos: 4
+        justificacion: "Soporte operativo"
+
+      - codigo: MAI-006
+        nombre: Tracking
+        puntos: 4
+        justificacion: "Visibilidad, ya tiene docs"
+
+      - codigo: MAE-016
+        nombre: Carta Porte CFDI
+        puntos: 6
+        justificacion: "Compliance fiscal obligatorio"
+
+    P2:
+      - codigo: MAI-012
+        nombre: Combustible y Gastos
+        puntos: 4
+        justificacion: "Control costos, entities existentes"
+
+      - codigo: MAI-013
+        nombre: Mantenimiento Flota
+        puntos: 3
+        justificacion: "Disponibilidad"
+
+      - codigo: MAI-014
+        nombre: Carriers
+        puntos: 3
+        justificacion: "Escalabilidad"
+
+      - codigo: MAE-018
+        nombre: Reportes y KPIs
+        puntos: 2
+        justificacion: "Analytics"
+
+    P3:
+      - codigo: MAI-015
+        nombre: Portal Cliente
+        puntos: 2
+        justificacion: "Fase posterior"
+
+      - codigo: MAE-017
+        nombre: HOS y Bitacora
+        puntos: 3
+        justificacion: "Compliance secundario"
+
+      - codigo: MAA-019
+        nombre: Optimizacion Rutas
+        puntos: 1
+        justificacion: "Fase avanzada"
+
+      - codigo: MAA-020
+        nombre: Integraciones EDI
+        puntos: 1
+        justificacion: "Fase avanzada"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# GAPS Y ACCIONES REQUERIDAS
+# ═══════════════════════════════════════════════════════════════════════════════
+
+gaps:
+  documentacion:
+    modulos_sin_requerimientos:
+      - MAI-002
+      - MAI-004
+      - MAI-005
+      - MAI-007
+      - MAI-008
+      - MAI-009
+      - MAI-010
+      - MAI-013
+      - MAI-014
+      - MAI-015
+      - MAE-017
+      - MAE-018
+    total: 12
+    accion: "Crear REQUERIMIENTOS.md por modulo"
+
+  backend:
+    entities_especializadas_faltantes: 58
+    services_faltantes: "todos los propios"
+    dtos_faltantes: "todos los propios"
+    accion: "Implementar entities, services y DTOs"
+
+  coherencia:
+    ddl_sin_entity: 54
+    entity_sin_service: 44
+    accion: "Completar implementacion backend"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# REFERENCIAS A OTROS INVENTARIOS
+# ═══════════════════════════════════════════════════════════════════════════════
+
+referencias:
+  - archivo: DATABASE_INVENTORY.yml
+    descripcion: "Detalle de DDL y schemas"
+    ultima_actualizacion: "2026-01-25"
+
+  - archivo: BACKEND_INVENTORY.yml
+    descripcion: "Detalle de entities y modulos backend"
+    ultima_actualizacion: "2026-01-27"
+
+  - archivo: ../docs/_definitions/ENTITIES-CATALOG.md
+    descripcion: "Catalogo detallado de entities"
+    ultima_actualizacion: "2026-01-27"
+
+  - archivo: ../docs/_definitions/MODULES-CATALOG.md
+    descripcion: "Catalogo de modulos"
+    ultima_actualizacion: "2026-01-26"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# HISTORIAL
+# ═══════════════════════════════════════════════════════════════════════════════
+
+historial:
+  - fecha: "2026-01-27"
+    autor: "AUDITOR"
+    cambio: "Creacion inicial como parte de Auditoria Fase 0"