From 4bbace63458ebf83c34b1e71152fb957defb88f6 Mon Sep 17 00:00:00 2001 From: Adrian Flores Cortes Date: Tue, 27 Jan 2026 01:22:27 -0600 Subject: [PATCH] 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 --- docs/_definitions/ENTITIES-CATALOG.md | 464 +++++++++------ orchestration/MAPA-DOCUMENTACION.yml | 366 ++++++++---- orchestration/PROXIMA-ACCION.md | 219 ++++--- .../inventarios/BACKEND_INVENTORY.yml | 537 ++++++++++++------ .../inventarios/MASTER_INVENTORY.yml | 456 +++++++++++++++ 5 files changed, 1492 insertions(+), 550 deletions(-) create mode 100644 orchestration/inventarios/MASTER_INVENTORY.yml diff --git a/docs/_definitions/ENTITIES-CATALOG.md b/docs/_definitions/ENTITIES-CATALOG.md index 48bc64a..4a92621 100644 --- a/docs/_definitions/ENTITIES-CATALOG.md +++ b/docs/_definitions/ENTITIES-CATALOG.md @@ -1,219 +1,331 @@ # ENTITIES-CATALOG.md - ERP Transportistas -**Version:** 1.0.0 -**Fecha:** 2026-01-26 -**Total Entities:** 153 (95 heredadas + 58 propias especializadas) +**Version:** 2.0.0 +**Fecha:** 2026-01-27 (Corregido en Auditoria Fase 0) +**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 | -|--------|----------|--------| -| auth | 20 | Heredado 100% | -| catalog | 15 | Heredado + extensiones | -| transport | ~25 | DDL completo | -| fleet | ~15 | DDL completo | -| tracking | ~10 | DDL completo | -| fuel | ~8 | DDL completo | -| maintenance | ~12 | DDL completo | -| carriers | ~8 | DDL completo | -| billing | ~10 | DDL completo | -| compliance | ~10 | DDL completo | +Este documento distingue entre: +1. **IMPLEMENTADAS**: Entities que EXISTEN en el codigo backend +2. **DISENADAS**: Entities definidas en documentacion/DDL pero NO implementadas aun + +| Categoria | Cantidad | Estado | +|-----------|----------|--------| +| Heredadas de erp-core | 109 | Implementadas | +| Propias implementadas | 44 | Implementadas (pero genericas) | +| Propias especializadas disenadas | ~58 | NO implementadas | --- -## Entities Heredadas (erp-core) +## Parte 1: Entities IMPLEMENTADAS (153 total) -### Schema: auth (20) -- User, Role, Permission, RefreshToken, Session -- Tenant, Company, Branch -- UserRole, RolePermission -- PasswordReset, TwoFactorAuth -- ApiKey, AuditLog, LoginAttempt -- UserPreference, UserNotification -- OAuthProvider, OAuthToken -- DeviceSession, SecurityEvent +### 1.1 Entities Heredadas (erp-core) - 109 -### Schema: catalog (15) -- Country, State, City, Currency -- PaymentMethod, PaymentTerm -- UnitOfMeasure, TaxRate -- DocumentType, DocumentSequence -- Category, Tag -- Bank, BankAccount -- Warehouse +#### Schema: auth (20 implementadas) +| Entity | Archivo | Estado | +|--------|---------|--------| +| User | user.entity.ts | 100% | +| Role | role.entity.ts | 100% | +| Permission | permission.entity.ts | 100% | +| Session | session.entity.ts | 100% | +| 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 | -|--------|-------|--------|-------------| -| 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 | +**Gap**: Falta OrdenTransporte, Embarque, Parada especializadas -### 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 | -|--------|-------|--------|-------------| -| 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 | +**Gap**: Falta Unidad, Remolque, Operador especializadas -### POD y Cierre (MAI-007) +#### Modulo: tracking (2) +| Entity | Archivo | Nota | +|--------|---------|------| +| 2 entities basicas | | Estructura minima | -| Entity | Tabla | Estado | Descripcion | -|--------|-------|--------|-------------| -| POD | pods | Pendiente | Proof of Delivery | -| FirmaDigital | firmas_digitales | Pendiente | Firma electronica | -| FotoEntrega | fotos_entrega | Pendiente | Evidencia fotografica | -| TiempoReal | tiempos_reales | Pendiente | Tiempos efectivos | +**Gap**: Falta EventoTracking, Geocerca, AlertaTracking -### Incidencias (MAI-008) +#### Modulo: viajes (4) +| Entity | Archivo | Nota | +|--------|---------|------| +| Timesheet | timesheet.entity.ts | GENERICA de projects | +| + 3 adicionales | | | -| Entity | Tabla | Estado | Descripcion | -|--------|-------|--------|-------------| -| Incidencia | incidencias | Pendiente | Evento inesperado | -| ReclamoCliente | reclamos_clientes | Pendiente | Queja formal | +**Gap**: Falta Viaje, Ruta, ParadaViaje especializadas + +#### Modulo: combustible-gastos (5) - ESPECIALIZADAS +| 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 | -|--------|-------|--------|-------------| -| Unidad | unidades | Backend 40% | Tractora/caja | -| Remolque | remolques | Pendiente | Semirremolque | -| ConfiguracionVehicular | configuraciones_vehiculares | Pendiente | Combinaciones | -| DocumentoUnidad | documentos_unidades | Pendiente | Permisos, seguros | +### Schema: transport (~25 disenadas) -### 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 | -|--------|-------|--------|-------------| -| Operador | operadores | Backend 40% | Conductor | -| LicenciaOperador | licencias_operadores | Pendiente | Licencias SCT | -| DocumentoOperador | documentos_operadores | Pendiente | Antidoping, cursos | -| DisponibilidadOperador | disponibilidad_operadores | Pendiente | Horario, descansos | +#### Viajes y Rutas (MAI-004, MAI-005) +| Entity | Tabla DDL | Estado Backend | +|--------|-----------|----------------| +| Viaje | viajes | NO EXISTE | +| Ruta | rutas | NO EXISTE | +| 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) - -| Entity | Tabla | Estado | Descripcion | -|--------|-------|--------|-------------| -| EventoTracking | eventos_tracking | Backend 20% | Posicion GPS | -| Geocerca | geocercas | Backend 20% | Zonas geograficas | -| AlertaTracking | alertas_tracking | Pendiente | Notificaciones | -| ETADinamico | eta_dinamico | Pendiente | Tiempo estimado | -| DispositivoGPS | dispositivos_gps | Pendiente | Hardware tracking | - ---- - -## 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 | +| Schema | Disenadas | Implementadas | Gap | +|--------|-----------|---------------|-----| +| transport | 25 | 0 especializadas | -25 | +| fleet | 15 | 0 especializadas | -15 | +| tracking | 10 | 2 basicas | -8 | +| maintenance | 12 | 0 | -12 | +| carriers | 8 | 0 | -8 | +| billing | 10 | 6 (tarifas) | -4 | +| compliance | 10 | 7 (carta-porte parcial) | -3 | +| **TOTAL** | **~90** | **15** | **~75** | --- ## 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)* diff --git a/orchestration/MAPA-DOCUMENTACION.yml b/orchestration/MAPA-DOCUMENTACION.yml index 508954e..f639cbd 100644 --- a/orchestration/MAPA-DOCUMENTACION.yml +++ b/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: - - archivo: "VISION-ERP-TRANSPORTISTAS.md" - tipo: "vision" - descripcion: "Vision del producto" - estado: "completado" + _definitions: + descripcion: "Definiciones centralizadas" + archivos: + - archivo: "_INDEX.yml" + 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: - descripcion: "Analisis de referencias y benchmarks" - archivos: [] - estado: "pendiente" + _quick: + descripcion: "Referencias rapidas" + archivos: + - 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: "pendiente" - estructura_por_modulo: - - "_MAP.md" - - "RESUMEN-EPICA-{codigo}.md" - - "requerimientos-funcionales/" - - "especificaciones/" - - "historias-usuario/" - - "implementacion/" + estado_general: "parcial" + modulos_documentados: + + MAI-003-ordenes-transporte: + estado: "80%" + archivos: + - README.md + - REQUERIMIENTOS.md + - 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" - tipo: "requerimientos" - descripcion: "Requerimientos especificos del giro" - estado: "completado" - - 10-modelado: - 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" + descripcion: "Requerimientos del giro" + archivos: + - archivo: "REQ-GIRO-TRANSPORTISTA.md" + estado: "completado" + rf_definidos: 68 + procesos: 13 orchestration: - - archivo: "BOOTLOADER.md" - tipo: "configuracion" - descripcion: "Secuencia de carga de contexto" + raiz: + - archivo: "BOOTLOADER.md" + tipo: "configuracion" + estado: "completado" - - archivo: "PROJECT-PROFILE.yml" - tipo: "perfil" - descripcion: "Perfil del proyecto para propagacion" + - archivo: "PROJECT-PROFILE.yml" + tipo: "perfil" + estado: "completado" - - archivo: "CONTEXT-MAP.yml" - tipo: "mapa" - descripcion: "Mapa de contexto NEXUS" + - archivo: "CONTEXT-MAP.yml" + tipo: "mapa" + estado: "completado" - - archivo: "DEPENDENCY-GRAPH.yml" - tipo: "dependencias" - descripcion: "Grafo de dependencias" + - archivo: "DEPENDENCY-GRAPH.yml" + tipo: "dependencias" + estado: "completado" - - archivo: "MAPA-DOCUMENTACION.yml" - tipo: "indice" - descripcion: "Este archivo" + - archivo: "MAPA-DOCUMENTACION.yml" + tipo: "indice" + estado: "actualizado_2026-01-27" - subdirectorios: - 00-guidelines: - - archivo: "CONTEXTO-PROYECTO.md" - descripcion: "Contexto del proyecto" + - archivo: "PROXIMA-ACCION.md" + tipo: "planificacion" + estado: "actualizado_2026-01-27" - directivas: - - subdirectorio: "checklists/" - descripcion: "Checklists por fase CAPVED" + inventarios: + descripcion: "Inventarios sincronizados" + 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: - descripcion: "Inventarios sincronizados" - archivos: [] - - tareas: - descripcion: "Historial de tareas" - estructura: "YYYY-MM-DD/TASK-NNN-{nombre}/" - - trazas: - descripcion: "Trazas de agentes" - archivos: [] + tareas: + descripcion: "Historial de tareas" + estructura: "TASK-YYYY-MM-DD-{nombre}/" + tareas_existentes: + - TASK-2026-01-25-001-CREAR-PROYECTO + - TASK-2026-01-25-DOCUMENTACION-MODULOS # ═══════════════════════════════════════════════════════════════════════════════ -# 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: - - path: "docs/02-definicion-modulos/MAI-003-ordenes-transporte/" - descripcion: "Definicion del modulo core de OT" + P0_inmediato: + - path: "docs/02-definicion-modulos/MAI-007-pod-cierre/" + 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/" - descripcion: "Definicion del modulo de flota" + - path: "docs/02-definicion-modulos/MAI-004-planeacion/" + 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/" - descripcion: "Definicion del modulo de tracking" + - path: "docs/02-definicion-modulos/MAI-005-despacho/" + 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/" - descripcion: "Definicion del modulo de Carta Porte" + - path: "docs/02-definicion-modulos/MAI-002-tarifas-sla/" + descripcion: "Base comercial" + archivos_requeridos: + - README.md + - REQUERIMIENTOS.md + - RESUMEN-EPICA.md + - historias-usuario/ (5-10 US) - media_prioridad: - - path: "docs/10-modelado/MODELO-DATOS-TRANSPORT.md" - descripcion: "Modelo de datos del schema transport" + P1_corto_plazo: + - path: "docs/02-definicion-modulos/MAI-009-facturacion-transporte/" + descripcion: "Completar documentacion (tiene ENTITIES.md)" + archivos_faltantes: + - README.md + - REQUERIMIENTOS.md + - RESUMEN-EPICA.md - - path: "docs/30-integraciones/gps-telematica/INTEGRACION-GPS.md" - descripcion: "Documentacion de integracion GPS" + - path: "docs/02-definicion-modulos/MAI-010-liquidaciones/" + descripcion: "Pago operadores" - - path: "docs/30-integraciones/pac-cfdi/INTEGRACION-PAC.md" - descripcion: "Documentacion de integracion PAC" + - path: "docs/02-definicion-modulos/MAI-008-incidencias/" + 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 - completados: 15 - pendientes: 10 - cobertura: "60%" + total_archivos_docs: 45 + archivos_completados: 32 + archivos_parciales: 8 + 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" diff --git a/orchestration/PROXIMA-ACCION.md b/orchestration/PROXIMA-ACCION.md index 886754c..5caaa1b 100644 --- a/orchestration/PROXIMA-ACCION.md +++ b/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)** -- `carga-combustible.entity.ts` - Cargas de combustible -- `cruce-peaje.entity.ts` - Cruces de peaje -- `gasto-viaje.entity.ts` - Gastos de viaje -- `anticipo-viatico.entity.ts` - Anticipos viaticos -- `control-rendimiento.entity.ts` - Control de rendimiento +| 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** | -**Modulo: tarifas-transporte (MAI-009)** -- `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 +### Entities Especializadas Creadas (2026-01-25) -### 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 -- 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 +### Entities Especializadas Faltantes (~58) -### TASK-2026-01-25-DOCUMENTACION-MODULOS (En Progreso) -- DATABASE_INVENTORY.yml creado -- BACKEND_INVENTORY.yml creado -- PROXIMA-ACCION.md actualizado +| 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 +### P0 - Inmediato (Auditoria Fase 0 en progreso) -1. **Completar servicios para entidades nuevas** - - combustible-gastos: crear services y DTOs - - tarifas-transporte: crear services y DTOs - - Estimacion: 4-6 horas +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 -2. **Crear especificaciones de modulos prioritarios** - - MAI-003: Ordenes de Transporte - - MAI-006: Tracking - - MAI-009: Facturacion Transporte - - MAI-011: Gestion de Flota - - MAE-016: Carta Porte CFDI +### P0 - Especificacion de Modulos Criticos -### 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** - - Entidades para complemento fiscal - - Integracion con PAC - - Generacion XML/PDF +3. **Crear User Stories para modulos con REQUERIMIENTOS** + - MAI-006 (Tracking) - 5-10 US + - MAI-011 (Gestion Flota) - 5-10 US -4. **Implementar frontend base** - - Dashboard transportista - - Gestion de flota - - Tracking de viajes +### 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 -5. **Integracion con GPS/Telematica** -6. **Portal de clientes** -7. **App movil para operadores** +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 +## Modulos del Sistema - Estado Corregido ### Fase 1 - MAI (Inicial) -| Codigo | Nombre | DDL | Backend | Frontend | -|--------|--------|:---:|:-------:|:--------:| -| MAI-001 | Fundamentos | - | 100% | - | -| MAI-002 | Clientes y Tarifas | - | 0% | - | -| MAI-003 | Ordenes de Transporte | 100% | 40% | 0% | -| MAI-004 | Planeacion TMS | 100% | 0% | 0% | -| MAI-005 | Despacho | 100% | 0% | 0% | -| MAI-006 | Tracking | 100% | 20% | 0% | -| MAI-007 | POD y Cierre | 100% | 0% | 0% | -| MAI-008 | Incidencias | 100% | 0% | 0% | -| MAI-009 | Facturacion Transporte | 100% | 30% | 0% | -| MAI-010 | Liquidaciones | 100% | 0% | 0% | -| MAI-011 | Gestion de Flota | 100% | 40% | 0% | -| MAI-012 | Combustible y Gastos | 100% | 50% | 0% | -| MAI-013 | Mantenimiento Flota | 100% | 0% | 0% | -| MAI-014 | Carriers (Terceros) | 100% | 0% | 0% | -| MAI-015 | Portal Cliente | 100% | 0% | 0% | +| 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 | Frontend | -|--------|--------|:---:|:-------:|:--------:| -| MAE-016 | Carta Porte CFDI | 100% | 0% | 0% | -| MAE-017 | HOS y Bitacora | 100% | 0% | 0% | -| MAE-018 | Reportes y KPIs | 100% | 0% | 0% | +| 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) @@ -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* diff --git a/orchestration/inventarios/BACKEND_INVENTORY.yml b/orchestration/inventarios/BACKEND_INVENTORY.yml index f3e00e9..2e8966e 100644 --- a/orchestration/inventarios/BACKEND_INVENTORY.yml +++ b/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 -modules: - # Heredados de erp-core - heredados: - - name: auth - entities: 20 - status: heredado - descripcion: "Autenticacion, JWT, OAuth, 2FA" +# NOTA IMPORTANTE: +# El 15% refleja que hay entities pero la mayoria NO tiene: +# - Services completos +# - DTOs +# - Tests +# - Validaciones de negocio +# El 40% anterior era INCORRECTO - - name: users - entities: 3 - status: heredado - descripcion: "Gestion de usuarios" +# ═══════════════════════════════════════════════════════════════════════════════ +# MODULOS HEREDADOS DE ERP-CORE (109 entities) +# ═══════════════════════════════════════════════════════════════════════════════ - - name: tenants - entities: 2 - status: heredado - descripcion: "Multi-tenancy" +modules_heredados: - - name: companies - entities: 1 - status: heredado - descripcion: "Empresas transportistas" + - name: auth + entities: 20 + status: heredado_completo + 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 - entities: 7 - status: heredado - descripcion: "Integracion IA/LLM" + - name: ai + entities: 7 + status: heredado_completo + 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 - entities: 7 - status: heredado - descripcion: "Auditoria y logs" + - name: audit + entities: 7 + status: heredado_completo + 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 - entities: 6 - status: heredado - descripcion: "Notificaciones multicanal" + - name: billing-usage + entities: 13 + status: heredado_completo + descripcion: "Facturacion SaaS y planes" + controllers: 4 + services: heredados - - name: billing-usage - entities: 5 - status: heredado - descripcion: "Facturacion SaaS" + - name: branches + entities: 5 + status: heredado_completo + descripcion: "Sucursales" + controllers: 1 + services: heredados - - name: branches - entities: 5 - status: heredado - descripcion: "Sucursales" + - name: core + entities: 10 + status: heredado_base + descripcion: "Modulo core compartido" + controllers: 1 + services: heredados - - name: financial - entities: 15 - status: heredado - descripcion: "Contabilidad base" + - name: financial + entities: 15 + status: heredado_completo + descripcion: "Contabilidad base" + controllers: 1 + services: heredados - - name: inventory - entities: 14 - status: heredado - descripcion: "Inventario base" + - name: inventory + entities: 15 + status: heredado_completo + descripcion: "Inventario base (refacciones)" + controllers: 3 + services: heredados - - name: partners - entities: 5 - status: heredado - descripcion: "Clientes/Proveedores" + - name: mcp + entities: 2 + status: heredado_completo + descripcion: "MCP Server" + controllers: 1 + services: heredados - - name: payment-terminals - entities: 3 - status: heredado - descripcion: "Terminales de pago" + - name: notifications + entities: 6 + status: heredado_completo + descripcion: "Notificaciones multicanal" + controllers: 1 + services: heredados - - name: mcp - entities: 2 - status: heredado - descripcion: "MCP Server" + - name: partners + entities: 6 + status: heredado_extendido + descripcion: "Clientes/Proveedores/Carriers" + controllers: 3 + services: heredados + notas: "Extendido para shippers y carriers" - # Especializados de Transporte (NUEVOS) - especializados: - - name: ordenes-transporte - entities: 4 - status: en_progreso - descripcion: "Ordenes de transporte y embarques" - 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: payment-terminals + entities: 3 + status: heredado_completo + descripcion: "Terminales de pago" + controllers: 7 + services: heredados - - name: gestion-flota - entities: 7 - 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" +# ═══════════════════════════════════════════════════════════════════════════════ +# MODULOS PROPIOS DE TRANSPORTE (44 entities) +# ═══════════════════════════════════════════════════════════════════════════════ - - name: tracking - entities: 0 - status: en_progreso - descripcion: "GPS, eventos, alertas" - modulo_simco: MAI-006 - controllers: 1 - notas: "Controlador basico creado, faltan entidades" +modules_propios: - - name: viajes - entities: 1 - status: en_progreso - descripcion: "Viajes y timesheets" - modulo_simco: MAI-003 - entidades: - - timesheet.entity.ts - controllers: 1 - notas: "Controlador creado" + - name: ordenes-transporte + entities: 5 + status: entity_only + descripcion: "Ordenes de transporte y cotizaciones" + modulo_simco: MAI-003 + entidades: + - quotation.entity.ts + - quotation-item.entity.ts + - 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 - entities: 5 - status: nuevo - descripcion: "Control de combustible, peajes, gastos" - 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 - notas: "Entidades creadas, faltan controladores y servicios" + - name: gestion-flota + entities: 9 + status: entity_only + 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 + - (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 - entities: 6 - status: nuevo - 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 - notas: "Entidades creadas, faltan controladores y servicios" + - name: tracking + entities: 2 + status: entity_only + descripcion: "GPS, eventos, alertas" + modulo_simco: MAI-006 + controllers: 1 + services: pendiente + notas: | + Solo 2 entities basicas. + Falta: EventoTracking, Geocerca, AlertaTracking, + ETADinamico, DispositivoGPS - - name: carta-porte - entities: 0 - status: pendiente - descripcion: "Complemento Carta Porte CFDI 3.1" - modulo_simco: MAE-016 - notas: "Pendiente implementacion" + - name: viajes + entities: 4 + status: entity_only + descripcion: "Viajes y timesheets" + modulo_simco: MAI-003/MAI-004 + entidades: + - timesheet.entity.ts + - (3 adicionales) + controllers: 2 + services: pendiente + notas: | + Entities genericas de projects. + Falta: Viaje, Ruta, ParadaViaje, ChecklistPreViaje, + SelloViaje, EvidenciaCarga - - name: fiscal - entities: 0 - status: pendiente - descripcion: "Integracion fiscal Mexico" - notas: "Pendiente implementacion" + - name: combustible-gastos + entities: 5 + status: entity_creada + descripcion: "Control de combustible, peajes, gastos" + 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 - entities: 0 - status: base - descripcion: "Modulo core compartido" + - name: tarifas-transporte + entities: 6 + status: entity_creada + 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 - controllers: 5 - services: TBD - dtos: TBD + entities: + heredadas: 109 + propias: 44 + 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: - 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 +# ═══════════════════════════════════════════════════════════════════════════════ +# ANALISIS DE GAPS +# ═══════════════════════════════════════════════════════════════════════════════ -# Controladores Nuevos (2026-01-25) -controladores_nuevos_2026_01_25: - - operadores.controller.ts (gestion-flota) - - unidades.controller.ts (gestion-flota) - - ordenes-transporte.controller.ts (ordenes-transporte) - - tracking.controller.ts (tracking) - - viajes.controller.ts (viajes) - total: 5 +gaps: + criticos: + - modulo: MAI-003 + descripcion: "Ordenes de Transporte" + entities_requeridas: + - OrdenTransporte + - Embarque + - 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" - - "11 entidades especializadas creadas para transporte" - - "5 controladores nuevos agregados 2026-01-25" - - "Pendiente: servicios, DTOs, tests" + - "CORRECCION 2026-01-27: El progreso del 40% era INCORRECTO" + - "El progreso REAL es ~15% (solo hay entities, falta implementacion)" + - "109 entities son heredadas de erp-core" + - "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 diff --git a/orchestration/inventarios/MASTER_INVENTORY.yml b/orchestration/inventarios/MASTER_INVENTORY.yml new file mode 100644 index 0000000..55b5dc0 --- /dev/null +++ b/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"