rckrdmrd/erp-transportistas-v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(analisis): Fase 1 - Matrices de coherencia y mapeo RF

Browse Source 
Nuevos archivos de analisis:
- MATRIZ-COHERENCIA-DDL-BACKEND.yml: Coherencia 28% global
  - transport: 0% (6 tablas, 0 entities)
  - fleet: 0% (5 tablas, 0 entities)
  - fuel: 100% (5 tablas, 5 entities)
  - billing: 100% (6 tablas, 6 entities)

- MAPEO-RF-GIRO-A-MODULOS.yml: 68 RF mapeados
  - 35% con documentacion
  - P0 urgente: MAI-007, MAI-004, MAI-005, MAI-002

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Adrian Flores Cortes 2026-01-27 01:28:16 -06:00
parent 4bbace6345
commit 1845cfcaec
2 changed files with 1491 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

964
orchestration/analisis/MAPEO-RF-GIRO-A-MODULOS.yml Normal file
View File

@ -0,0 +1,964 @@
# MAPEO-RF-GIRO-A-MODULOS.yml - ERP Transportistas
# Sistema SIMCO v4.0.0
# Mapeo de Requerimientos Funcionales del Giro a Modulos
# Fuente: docs/03-requerimientos/REQ-GIRO-TRANSPORTISTA.md
# Creado: 2026-01-27 (Fase 1 Auditoria)
version: "1.0.0"
created: "2026-01-27"
updated: "2026-01-27"
# ═══════════════════════════════════════════════════════════════════════════════
# RESUMEN EJECUTIVO
# ═══════════════════════════════════════════════════════════════════════════════
resumen:
total_rf_giro: 68
rf_mapeados_a_modulos: 68
rf_con_documentacion: 24
rf_sin_documentacion: 44
cobertura_documentacion: "35%"
# ═══════════════════════════════════════════════════════════════════════════════
# MAPEO POR PROCESO DEL GIRO
# ═══════════════════════════════════════════════════════════════════════════════
procesos:
# ═══════════════════════════════════════════════════════════════════════════
# 4.1 Gestion de Tarifas, Contratos y SLA
# ═══════════════════════════════════════════════════════════════════════════
proceso_4_1:
nombre: "Gestion de tarifas, contratos y SLA"
modulo_principal: MAI-002
modulos_relacionados: [MAI-009]
requerimientos:
- codigo: RF-4.1.1
descripcion: "Tarifario por lane y servicio"
modulo: MAI-002
tablas_ddl: [lanes, tarifas]
entity_existente: true
documentacion: false
prioridad: P0
- codigo: RF-4.1.2
descripcion: "Matriz de recargos (surcharges)"
modulo: MAI-002
tablas_ddl: [recargos_catalogo, fuel_surcharge]
entity_existente: true
documentacion: false
prioridad: P0
- codigo: RF-4.1.3
descripcion: "SLA por cliente"
modulo: MAI-002
tablas_ddl: [sla_clientes]
entity_existente: false
documentacion: false
prioridad: P0
- codigo: RF-4.1.4
descripcion: "Cotizacion rapida"
modulo: MAI-002
tablas_ddl: [cotizaciones]
entity_existente: false
documentacion: false
prioridad: P1
- codigo: RF-4.1.5
descripcion: "Control de aprobaciones"
modulo: MAI-002
tablas_ddl: [aprobaciones]
entity_existente: false
documentacion: false
prioridad: P1
# ═══════════════════════════════════════════════════════════════════════════
# 4.2 Captura de Orden de Transporte (OT)
# ═══════════════════════════════════════════════════════════════════════════
proceso_4_2:
nombre: "Captura de Orden de Transporte"
modulo_principal: MAI-003
modulos_relacionados: [MAI-002]
requerimientos:
- codigo: RF-4.2.1
descripcion: "Datos obligatorios OT"
modulo: MAI-003
tablas_ddl: [ordenes_transporte]
entity_existente: false
documentacion: true
us_existentes: [US-MAI003-001, US-MAI003-002]
prioridad: P0
- codigo: RF-4.2.2
descripcion: "Restricciones logisticas"
modulo: MAI-003
tablas_ddl: [restricciones_ot]
entity_existente: false
documentacion: true
us_existentes: [US-MAI003-003]
prioridad: P0
- codigo: RF-4.2.3
descripcion: "Multi-paradas"
modulo: MAI-003
tablas_ddl: [paradas_ot]
entity_existente: false
documentacion: true
us_existentes: [US-MAI003-004]
prioridad: P0
- codigo: RF-4.2.4
descripcion: "LTL vs FTL"
modulo: MAI-003
tablas_ddl: [ordenes_transporte.tipo_servicio]
entity_existente: false
documentacion: true
prioridad: P1
- codigo: RF-4.2.5
descripcion: "Documentacion adjunta"
modulo: MAI-003
tablas_ddl: [documentos_ot]
entity_existente: false
documentacion: true
us_existentes: [US-MAI003-009]
prioridad: P1
- codigo: RF-4.2.6
descripcion: "Portal/API de clientes"
modulo: MAI-015
tablas_ddl: [api_clientes]
entity_existente: false
documentacion: false
prioridad: P3
# ═══════════════════════════════════════════════════════════════════════════
# 4.3 Planeacion TMS
# ═══════════════════════════════════════════════════════════════════════════
proceso_4_3:
nombre: "Planeacion (TMS-like)"
modulo_principal: MAI-004
modulos_relacionados: [MAI-003, MAI-011]
requerimientos:
- codigo: RF-4.3.1
descripcion: "Tablero de planeacion"
modulo: MAI-004
tablas_ddl: [planeacion_viajes]
entity_existente: false
documentacion: false
prioridad: P0
- codigo: RF-4.3.2
descripcion: "Consolidacion automatica sugerida"
modulo: MAI-004
tablas_ddl: [embarques]
entity_existente: false
documentacion: false
prioridad: P0
- codigo: RF-4.3.3
descripcion: "Calculo de capacidad"
modulo: MAI-004
tablas_ddl: [unidades.capacidad]
entity_existente: false
documentacion: false
prioridad: P0
- codigo: RF-4.3.4
descripcion: "Reservas de recursos"
modulo: MAI-004
tablas_ddl: [asignaciones]
entity_existente: false
documentacion: false
prioridad: P0
- codigo: RF-4.3.5
descripcion: "Reglas de compatibilidad"
modulo: MAI-004
tablas_ddl: [reglas_asignacion]
entity_existente: false
documentacion: false
prioridad: P1
- codigo: RF-4.3.6
descripcion: "Simulacion de ruta y ETA"
modulo: MAI-004
tablas_ddl: [eta_calculado]
entity_existente: false
documentacion: false
prioridad: P2
# ═══════════════════════════════════════════════════════════════════════════
# 4.4 Despacho
# ═══════════════════════════════════════════════════════════════════════════
proceso_4_4:
nombre: "Despacho: liberacion de viaje"
modulo_principal: MAI-005
modulos_relacionados: [MAI-004, MAI-011]
requerimientos:
- codigo: RF-4.4.1
descripcion: "Orden de Viaje (OV)"
modulo: MAI-005
tablas_ddl: [viajes]
entity_existente: false
documentacion: false
prioridad: P0
- codigo: RF-4.4.2
descripcion: "Checklists pre-viaje"
modulo: MAI-005
tablas_ddl: [inspecciones_pre_viaje]
entity_existente: false
documentacion: false
prioridad: P0
- codigo: RF-4.4.3
descripcion: "Control de sellos"
modulo: MAI-005
tablas_ddl: [sellos_viaje]
entity_existente: false
documentacion: false
prioridad: P0
- codigo: RF-4.4.4
descripcion: "Evidencias de carga"
modulo: MAI-005
tablas_ddl: [evidencias_carga]
entity_existente: false
documentacion: false
prioridad: P0
- codigo: RF-4.4.5
descripcion: "Kit documental"
modulo: MAI-005
tablas_ddl: [documentos_viaje]
entity_existente: false
documentacion: false
prioridad: P1
- codigo: RF-4.4.6
descripcion: "Gate out / salida oficial"
modulo: MAI-005
tablas_ddl: [eventos.tipo='SALIDA']
entity_existente: false
documentacion: false
prioridad: P0
# ═══════════════════════════════════════════════════════════════════════════
# 4.5 Ejecucion y Tracking
# ═══════════════════════════════════════════════════════════════════════════
proceso_4_5:
nombre: "Ejecucion y tracking"
modulo_principal: MAI-006
modulos_relacionados: [MAI-005]
requerimientos:
- codigo: RF-4.5.1
descripcion: "Integracion GPS/Telematica"
modulo: MAI-006
tablas_ddl: [posiciones_gps]
entity_existente: false
documentacion: true
prioridad: P1
- codigo: RF-4.5.2
descripcion: "App movil operador"
modulo: MAI-006
tablas_ddl: [eventos]
entity_existente: true
documentacion: true
prioridad: P1
- codigo: RF-4.5.3
descripcion: "ETA dinamico"
modulo: MAI-006
tablas_ddl: [eta_calculado]
entity_existente: false
documentacion: true
prioridad: P2
- codigo: RF-4.5.4
descripcion: "Geocercas"
modulo: MAI-006
tablas_ddl: [geocercas]
entity_existente: false
documentacion: true
prioridad: P1
- codigo: RF-4.5.5
descripcion: "Alertas"
modulo: MAI-006
tablas_ddl: [alertas, reglas_alerta]
entity_existente: false
documentacion: true
prioridad: P1
- codigo: RF-4.5.6
descripcion: "Comunicacion omnicanal"
modulo: MAI-006
tablas_ddl: [notificaciones_tracking]
entity_existente: false
documentacion: false
prioridad: P2
# ═══════════════════════════════════════════════════════════════════════════
# 4.6 Incidencias
# ═══════════════════════════════════════════════════════════════════════════
proceso_4_6:
nombre: "Incidencias, excepciones y reclamaciones"
modulo_principal: MAI-008
modulos_relacionados: [MAI-006, MAI-009]
requerimientos:
- codigo: RF-4.6.1
descripcion: "Tipos de incidencia"
modulo: MAI-008
tablas_ddl: [incidencias]
entity_existente: false
documentacion: false
prioridad: P1
- codigo: RF-4.6.2
descripcion: "Flujo de atencion"
modulo: MAI-008
tablas_ddl: [incidencias.estado]
entity_existente: false
documentacion: false
prioridad: P1
- codigo: RF-4.6.3
descripcion: "Evidencias y bitacora"
modulo: MAI-008
tablas_ddl: [evidencias_incidencia]
entity_existente: false
documentacion: false
prioridad: P1
- codigo: RF-4.6.4
descripcion: "Impacto economico"
modulo: MAI-008
tablas_ddl: [costos_incidencia]
entity_existente: false
documentacion: false
prioridad: P2
- codigo: RF-4.6.5
descripcion: "SLA de incidencias"
modulo: MAI-008
tablas_ddl: [sla_incidencias]
entity_existente: false
documentacion: false
prioridad: P2
- codigo: RF-4.6.6
descripcion: "Integracion a facturacion"
modulo: MAI-008
tablas_ddl: [ajustes_factura]
entity_existente: false
documentacion: false
prioridad: P2
# ═══════════════════════════════════════════════════════════════════════════
# 4.7 POD y Cierre
# ═══════════════════════════════════════════════════════════════════════════
proceso_4_7:
nombre: "POD y cierre operativo"
modulo_principal: MAI-007
modulos_relacionados: [MAI-009]
requerimientos:
- codigo: RF-4.7.1
descripcion: "Captura POD"
modulo: MAI-007
tablas_ddl: [pod]
entity_existente: false
documentacion: false
prioridad: P0
- codigo: RF-4.7.2
descripcion: "Validaciones POD"
modulo: MAI-007
tablas_ddl: [pod.validado]
entity_existente: false
documentacion: false
prioridad: P0
- codigo: RF-4.7.3
descripcion: "Tiempos reales"
modulo: MAI-007
tablas_ddl: [tiempos_reales]
entity_existente: false
documentacion: false
prioridad: P0
- codigo: RF-4.7.4
descripcion: "Cierre contable operativo"
modulo: MAI-007
tablas_ddl: [cierre_viaje]
entity_existente: false
documentacion: false
prioridad: P0
# ═══════════════════════════════════════════════════════════════════════════
# 4.8 Facturacion Transporte
# ═══════════════════════════════════════════════════════════════════════════
proceso_4_8:
nombre: "Facturacion especializada transporte"
modulo_principal: MAI-009
modulos_relacionados: [MAI-007, MAE-016]
requerimientos:
- codigo: RF-4.8.1
descripcion: "Factura por viaje/embarque/OT"
modulo: MAI-009
tablas_ddl: [facturas_transporte]
entity_existente: true
documentacion: false
prioridad: P1
- codigo: RF-4.8.2
descripcion: "Calculo automatico de recargos"
modulo: MAI-009
tablas_ddl: [lineas_factura]
entity_existente: true
documentacion: false
prioridad: P1
- codigo: RF-4.8.3
descripcion: "Integracion con POD"
modulo: MAI-009
tablas_ddl: [facturas_transporte.pod_id]
entity_existente: true
documentacion: false
prioridad: P1
- codigo: RF-4.8.4
descripcion: "Conciliacion"
modulo: MAI-009
tablas_ddl: [conciliaciones]
entity_existente: false
documentacion: false
prioridad: P2
- codigo: RF-4.8.5
descripcion: "Estados de cuenta por cliente"
modulo: MAI-009
tablas_ddl: [estados_cuenta]
entity_existente: false
documentacion: false
prioridad: P2
# ═══════════════════════════════════════════════════════════════════════════
# 4.9 Liquidaciones
# ═══════════════════════════════════════════════════════════════════════════
proceso_4_9:
nombre: "Liquidacion a operadores"
modulo_principal: MAI-010
modulos_relacionados: [MAI-007, MAI-012]
requerimientos:
- codigo: RF-4.9.1
descripcion: "Esquemas de pago"
modulo: MAI-010
tablas_ddl: [esquemas_pago]
entity_existente: false
documentacion: false
prioridad: P1
- codigo: RF-4.9.2
descripcion: "Viaticos"
modulo: MAI-010
tablas_ddl: [anticipos_viaticos]
entity_existente: true
documentacion: false
prioridad: P1
- codigo: RF-4.9.3
descripcion: "Deducciones"
modulo: MAI-010
tablas_ddl: [deducciones]
entity_existente: false
documentacion: false
prioridad: P1
- codigo: RF-4.9.4
descripcion: "Corte y autorizacion"
modulo: MAI-010
tablas_ddl: [liquidaciones]
entity_existente: false
documentacion: false
prioridad: P1
# ═══════════════════════════════════════════════════════════════════════════
# 4.10 Combustible y Gastos
# ═══════════════════════════════════════════════════════════════════════════
proceso_4_10:
nombre: "Combustible, peajes y gastos"
modulo_principal: MAI-012
modulos_relacionados: [MAI-007]
requerimientos:
- codigo: RF-4.10.1
descripcion: "Planeado vs real"
modulo: MAI-012
tablas_ddl: [control_rendimiento]
entity_existente: true
documentacion: true
prioridad: P2
- codigo: RF-4.10.2
descripcion: "Captura de cargas combustible"
modulo: MAI-012
tablas_ddl: [cargas_combustible]
entity_existente: true
documentacion: true
prioridad: P2
- codigo: RF-4.10.3
descripcion: "Peajes"
modulo: MAI-012
tablas_ddl: [cruces_peaje]
entity_existente: true
documentacion: true
prioridad: P2
- codigo: RF-4.10.4
descripcion: "Gastos varios"
modulo: MAI-012
tablas_ddl: [gastos_viaje]
entity_existente: true
documentacion: true
prioridad: P2
- codigo: RF-4.10.5
descripcion: "Alertas antifraude"
modulo: MAI-012
tablas_ddl: [alertas_fraude]
entity_existente: false
documentacion: false
prioridad: P2
# ═══════════════════════════════════════════════════════════════════════════
# 4.11 Mantenimiento Flota
# ═══════════════════════════════════════════════════════════════════════════
proceso_4_11:
nombre: "Mantenimiento y disponibilidad flota"
modulo_principal: MAI-013
modulos_relacionados: [MAI-011]
requerimientos:
- codigo: RF-4.11.1
descripcion: "Plan preventivo"
modulo: MAI-013
tablas_ddl: [planes_mantenimiento, programacion_mantenimiento]
entity_existente: false
documentacion: false
prioridad: P2
- codigo: RF-4.11.2
descripcion: "Correctivo"
modulo: MAI-013
tablas_ddl: [ordenes_trabajo]
entity_existente: false
documentacion: false
prioridad: P2
- codigo: RF-4.11.3
descripcion: "Inventario de refacciones"
modulo: MAI-013
tablas_ddl: [refacciones_flota]
entity_existente: false
documentacion: false
prioridad: P2
- codigo: RF-4.11.4
descripcion: "Historial por activo"
modulo: MAI-013
tablas_ddl: [historial_mantenimiento]
entity_existente: false
documentacion: false
prioridad: P2
- codigo: RF-4.11.5
descripcion: "Disponibilidad"
modulo: MAI-011
tablas_ddl: [unidades.estado]
entity_existente: false
documentacion: true
prioridad: P0
# ═══════════════════════════════════════════════════════════════════════════
# 4.12 Carriers
# ═══════════════════════════════════════════════════════════════════════════
proceso_4_12:
nombre: "Gestion de terceros (carriers)"
modulo_principal: MAI-014
modulos_relacionados: [MAI-004]
requerimientos:
- codigo: RF-4.12.1
descripcion: "Registro de carrier"
modulo: MAI-014
tablas_ddl: [carriers]
entity_existente: false
documentacion: false
prioridad: P2
- codigo: RF-4.12.2
descripcion: "Asignacion a carrier"
modulo: MAI-014
tablas_ddl: [asignaciones_carrier]
entity_existente: false
documentacion: false
prioridad: P2
- codigo: RF-4.12.3
descripcion: "Control de documentos"
modulo: MAI-014
tablas_ddl: [documentos_carrier]
entity_existente: false
documentacion: false
prioridad: P2
- codigo: RF-4.12.4
descripcion: "Recepcion POD tercero"
modulo: MAI-014
tablas_ddl: [pod_carrier]
entity_existente: false
documentacion: false
prioridad: P2
- codigo: RF-4.12.5
descripcion: "Costo vs ingreso"
modulo: MAI-014
tablas_ddl: [margenes_carrier]
entity_existente: false
documentacion: false
prioridad: P2
- codigo: RF-4.12.6
descripcion: "Scorecard"
modulo: MAI-014
tablas_ddl: [scorecard]
entity_existente: false
documentacion: false
prioridad: P2
# ═══════════════════════════════════════════════════════════════════════════
# 4.13 Portal Cliente
# ═══════════════════════════════════════════════════════════════════════════
proceso_4_13:
nombre: "Portal de cliente"
modulo_principal: MAI-015
modulos_relacionados: [MAI-006]
requerimientos:
- codigo: RF-4.13.1
descripcion: "Tracking"
modulo: MAI-015
tablas_ddl: [vista_tracking_cliente]
entity_existente: false
documentacion: false
prioridad: P3
- codigo: RF-4.13.2
descripcion: "Documentos"
modulo: MAI-015
tablas_ddl: [documentos_portal]
entity_existente: false
documentacion: false
prioridad: P3
- codigo: RF-4.13.3
descripcion: "Creacion de OT"
modulo: MAI-015
tablas_ddl: [ot_portal]
entity_existente: false
documentacion: false
prioridad: P3
- codigo: RF-4.13.4
descripcion: "Reclamaciones"
modulo: MAI-015
tablas_ddl: [reclamos_portal]
entity_existente: false
documentacion: false
prioridad: P3
# ═══════════════════════════════════════════════════════════════════════════
# 5.1 CFDI Carta Porte
# ═══════════════════════════════════════════════════════════════════════════
proceso_5_1:
nombre: "CFDI con Complemento Carta Porte"
modulo_principal: MAE-016
modulos_relacionados: [MAI-009]
requerimientos:
- codigo: RF-5.1.1
descripcion: "Soportar Carta Porte 3.1"
modulo: MAE-016
tablas_ddl: [cartas_porte]
entity_existente: true
documentacion: true
us_existentes: [US-MAE016-001]
prioridad: P1
- codigo: RF-5.1.2
descripcion: "Escenarios de emision"
modulo: MAE-016
tablas_ddl: [cartas_porte.tipo]
entity_existente: true
documentacion: true
us_existentes: [US-MAE016-002, US-MAE016-003]
prioridad: P1
- codigo: RF-5.1.3
descripcion: "Expediente fiscal por viaje"
modulo: MAE-016
tablas_ddl: [expediente_fiscal]
entity_existente: true
documentacion: true
us_existentes: [US-MAE016-006]
prioridad: P1
- codigo: RF-5.1.4
descripcion: "Validaciones previas"
modulo: MAE-016
tablas_ddl: [validaciones_carta_porte]
entity_existente: false
documentacion: true
us_existentes: [US-MAE016-002]
prioridad: P1
- codigo: RF-5.1.5
descripcion: "Reemision/correccion"
modulo: MAE-016
tablas_ddl: [bitacora_carta_porte]
entity_existente: false
documentacion: true
us_existentes: [US-MAE016-005]
prioridad: P1
- codigo: RF-5.1.6
descripcion: "Integracion con PAC"
modulo: MAE-016
tablas_ddl: [timbrado_pac]
entity_existente: false
documentacion: true
us_existentes: [US-MAE016-003]
prioridad: P1
- codigo: RF-5.1.7
descripcion: "Evidencia para inspeccion"
modulo: MAE-016
tablas_ddl: [documentos_carta_porte]
entity_existente: false
documentacion: true
us_existentes: [US-MAE016-004]
prioridad: P1
# ═══════════════════════════════════════════════════════════════════════════
# 5.2 HOS y Bitacora
# ═══════════════════════════════════════════════════════════════════════════
proceso_5_2:
nombre: "Bitacora de Horas de Servicio (HOS)"
modulo_principal: MAE-017
modulos_relacionados: [MAI-011]
requerimientos:
- codigo: RF-5.2.1
descripcion: "Registro HOS"
modulo: MAE-017
tablas_ddl: [hos_logs]
entity_existente: false
documentacion: false
prioridad: P3
- codigo: RF-5.2.2
descripcion: "Bitacora formato"
modulo: MAE-017
tablas_ddl: [hos_resumen_diario]
entity_existente: false
documentacion: false
prioridad: P3
- codigo: RF-5.2.3
descripcion: "Alertas incumplimiento"
modulo: MAE-017
tablas_ddl: [alertas_hos]
entity_existente: false
documentacion: false
prioridad: P3
- codigo: RF-5.2.4
descripcion: "Evidencias HOS"
modulo: MAE-017
tablas_ddl: [auditoria_hos]
entity_existente: false
documentacion: false
prioridad: P3
# ═══════════════════════════════════════════════════════════════════════════════
# RESUMEN POR MODULO
# ═══════════════════════════════════════════════════════════════════════════════
resumen_por_modulo:
MAI-002:
nombre: "Clientes y Tarifas"
rf_asignados: 5
rf_con_entity: 2
rf_con_docs: 0
prioridad: P0
MAI-003:
nombre: "Ordenes de Transporte"
rf_asignados: 6
rf_con_entity: 0
rf_con_docs: 5
prioridad: P0
MAI-004:
nombre: "Planeacion TMS"
rf_asignados: 6
rf_con_entity: 0
rf_con_docs: 0
prioridad: P0
MAI-005:
nombre: "Despacho"
rf_asignados: 6
rf_con_entity: 0
rf_con_docs: 0
prioridad: P0
MAI-006:
nombre: "Tracking"
rf_asignados: 6
rf_con_entity: 1
rf_con_docs: 5
prioridad: P1
MAI-007:
nombre: "POD y Cierre"
rf_asignados: 4
rf_con_entity: 0
rf_con_docs: 0
prioridad: P0
MAI-008:
nombre: "Incidencias"
rf_asignados: 6
rf_con_entity: 0
rf_con_docs: 0
prioridad: P1
MAI-009:
nombre: "Facturacion Transporte"
rf_asignados: 5
rf_con_entity: 3
rf_con_docs: 0
prioridad: P1
MAI-010:
nombre: "Liquidaciones"
rf_asignados: 4
rf_con_entity: 1
rf_con_docs: 0
prioridad: P1
MAI-011:
nombre: "Gestion de Flota"
rf_asignados: 1
rf_con_entity: 0
rf_con_docs: 1
prioridad: P0
MAI-012:
nombre: "Combustible y Gastos"
rf_asignados: 5
rf_con_entity: 4
rf_con_docs: 4
prioridad: P2
MAI-013:
nombre: "Mantenimiento Flota"
rf_asignados: 4
rf_con_entity: 0
rf_con_docs: 0
prioridad: P2
MAI-014:
nombre: "Carriers"
rf_asignados: 6
rf_con_entity: 0
rf_con_docs: 0
prioridad: P2
MAI-015:
nombre: "Portal Cliente"
rf_asignados: 5
rf_con_entity: 0
rf_con_docs: 0
prioridad: P3
MAE-016:
nombre: "Carta Porte CFDI"
rf_asignados: 7
rf_con_entity: 3
rf_con_docs: 7
prioridad: P1
MAE-017:
nombre: "HOS y Bitacora"
rf_asignados: 4
rf_con_entity: 0
rf_con_docs: 0
prioridad: P3
# ═══════════════════════════════════════════════════════════════════════════════
# ACCIONES REQUERIDAS
# ═══════════════════════════════════════════════════════════════════════════════
acciones:
P0_urgente:
- modulo: MAI-007
accion: "Crear REQUERIMIENTOS.md y 5 US"
rf_afectados: 4
- modulo: MAI-004
accion: "Crear REQUERIMIENTOS.md y 5 US"
rf_afectados: 6
- modulo: MAI-005
accion: "Crear REQUERIMIENTOS.md y 5 US"
rf_afectados: 6
- modulo: MAI-002
accion: "Crear REQUERIMIENTOS.md y 5 US"
rf_afectados: 5
P1_corto_plazo:
- modulo: MAI-008
accion: "Crear REQUERIMIENTOS.md"
rf_afectados: 6
- modulo: MAI-009
accion: "Crear REQUERIMIENTOS.md"
rf_afectados: 5
- modulo: MAI-010
accion: "Crear REQUERIMIENTOS.md"
rf_afectados: 4
- modulo: MAI-006
accion: "Agregar 5-10 User Stories"
rf_afectados: 6
- modulo: MAI-011
accion: "Agregar 5-10 User Stories"
rf_afectados: 1

527
orchestration/analisis/MATRIZ-COHERENCIA-DDL-BACKEND.yml Normal file
View File

@ -0,0 +1,527 @@
# MATRIZ-COHERENCIA-DDL-BACKEND.yml - ERP Transportistas
# Sistema SIMCO v4.0.0
# Analisis de coherencia entre DDL y Backend
# Creado: 2026-01-27 (Fase 1 Auditoria)
version: "1.0.0"
created: "2026-01-27"
updated: "2026-01-27"
# ═══════════════════════════════════════════════════════════════════════════════
# RESUMEN EJECUTIVO
# ═══════════════════════════════════════════════════════════════════════════════
resumen:
total_tablas_ddl: 53
total_entities_especializadas: 44
entities_heredadas: 109
gap_entities_faltantes: 42
coherencia_porcentaje: "21%"
estado: "INCOHERENTE - Requiere implementacion urgente"
# ═══════════════════════════════════════════════════════════════════════════════
# DETALLE POR SCHEMA
# ═══════════════════════════════════════════════════════════════════════════════
schemas:
transport:
ddl_file: "01-transport-schema-ddl.sql"
tablas_ddl: 6
tablas:
- nombre: ordenes_transporte
entity_esperada: OrdenTransporte
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P0
modulo: MAI-003
- nombre: embarques
entity_esperada: Embarque
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P0
modulo: MAI-003
- nombre: viajes
entity_esperada: Viaje
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P0
modulo: MAI-004
- nombre: paradas_viaje
entity_esperada: ParadaViaje
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P1
modulo: MAI-004
- nombre: pod
entity_esperada: POD
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P0
modulo: MAI-007
- nombre: incidencias
entity_esperada: Incidencia
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P1
modulo: MAI-008
resumen:
implementadas: 0
faltantes: 6
coherencia: "0%"
fleet:
ddl_file: "02-fleet-schema-ddl.sql"
tablas_ddl: 5
tablas:
- nombre: unidades
entity_esperada: Unidad
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P0
modulo: MAI-011
- nombre: remolques
entity_esperada: Remolque
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P0
modulo: MAI-011
- nombre: operadores
entity_esperada: Operador
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P0
modulo: MAI-011
- nombre: documentos_flota
entity_esperada: DocumentoFlota
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P1
modulo: MAI-011
- nombre: asignaciones
entity_esperada: AsignacionFlota
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P1
modulo: MAI-011
resumen:
implementadas: 0
faltantes: 5
coherencia: "0%"
tracking:
ddl_file: "03-tracking-schema-ddl.sql"
tablas_ddl: 6
tablas:
- nombre: posiciones_gps
entity_esperada: PosicionGPS
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P1
modulo: MAI-006
- nombre: eventos
entity_esperada: EventoTracking
entity_existente: "tracking/entities (2 basicas)"
estado: PARCIAL
prioridad: P1
modulo: MAI-006
- nombre: geocercas
entity_esperada: Geocerca
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P1
modulo: MAI-006
- nombre: alertas
entity_esperada: AlertaTracking
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P2
modulo: MAI-006
- nombre: reglas_alerta
entity_esperada: ReglaAlerta
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P2
modulo: MAI-006
- nombre: eta_calculado
entity_esperada: ETACalculado
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P2
modulo: MAI-006
resumen:
implementadas: 1
faltantes: 5
coherencia: "17%"
fuel:
ddl_file: "04-fuel-schema-ddl.sql"
tablas_ddl: 5
tablas:
- nombre: cargas_combustible
entity_esperada: CargaCombustible
entity_existente: "combustible-gastos/carga-combustible.entity.ts"
estado: IMPLEMENTADA
prioridad: P2
modulo: MAI-012
- nombre: cruces_peaje
entity_esperada: CrucePeaje
entity_existente: "combustible-gastos/cruce-peaje.entity.ts"
estado: IMPLEMENTADA
prioridad: P2
modulo: MAI-012
- nombre: gastos_viaje
entity_esperada: GastoViaje
entity_existente: "combustible-gastos/gasto-viaje.entity.ts"
estado: IMPLEMENTADA
prioridad: P2
modulo: MAI-012
- nombre: anticipos_viaticos
entity_esperada: AnticipoViatico
entity_existente: "combustible-gastos/anticipo-viatico.entity.ts"
estado: IMPLEMENTADA
prioridad: P2
modulo: MAI-012
- nombre: control_rendimiento
entity_esperada: ControlRendimiento
entity_existente: "combustible-gastos/control-rendimiento.entity.ts"
estado: IMPLEMENTADA
prioridad: P2
modulo: MAI-012
resumen:
implementadas: 5
faltantes: 0
coherencia: "100%"
maintenance:
ddl_file: "05-maintenance-schema-ddl.sql"
tablas_ddl: 5
tablas:
- nombre: planes_mantenimiento
entity_esperada: PlanMantenimiento
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P2
modulo: MAI-013
- nombre: programacion_mantenimiento
entity_esperada: ProgramacionMantenimiento
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P2
modulo: MAI-013
- nombre: ordenes_trabajo
entity_esperada: OrdenTrabajo
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P2
modulo: MAI-013
- nombre: lineas_orden_trabajo
entity_esperada: LineaOrdenTrabajo
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P2
modulo: MAI-013
- nombre: checklist_items
entity_esperada: ChecklistItem
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P2
modulo: MAI-013
resumen:
implementadas: 0
faltantes: 5
coherencia: "0%"
carriers:
ddl_file: "06-carriers-schema-ddl.sql"
tablas_ddl: 6
tablas:
- nombre: carriers
entity_esperada: Carrier
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P2
modulo: MAI-014
- nombre: documentos_carrier
entity_esperada: DocumentoCarrier
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P2
modulo: MAI-014
- nombre: unidades_carrier
entity_esperada: UnidadCarrier
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P2
modulo: MAI-014
- nombre: operadores_carrier
entity_esperada: OperadorCarrier
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P2
modulo: MAI-014
- nombre: asignaciones_carrier
entity_esperada: AsignacionCarrier
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P2
modulo: MAI-014
- nombre: scorecard
entity_esperada: ScorecardCarrier
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P2
modulo: MAI-014
resumen:
implementadas: 0
faltantes: 6
coherencia: "0%"
billing:
ddl_file: "07-billing-transport-ddl.sql"
tablas_ddl: 6
tablas:
- nombre: lanes
entity_esperada: Lane
entity_existente: "tarifas-transporte/lane.entity.ts"
estado: IMPLEMENTADA
prioridad: P1
modulo: MAI-009
- nombre: tarifas
entity_esperada: Tarifa
entity_existente: "tarifas-transporte/tarifa.entity.ts"
estado: IMPLEMENTADA
prioridad: P1
modulo: MAI-009
- nombre: recargos_catalogo
entity_esperada: RecargoCatalogo
entity_existente: "tarifas-transporte/recargo-catalogo.entity.ts"
estado: IMPLEMENTADA
prioridad: P1
modulo: MAI-009
- nombre: facturas_transporte
entity_esperada: FacturaTransporte
entity_existente: "tarifas-transporte/factura-transporte.entity.ts"
estado: IMPLEMENTADA
prioridad: P1
modulo: MAI-009
- nombre: lineas_factura
entity_esperada: LineaFactura
entity_existente: "tarifas-transporte/linea-factura.entity.ts"
estado: IMPLEMENTADA
prioridad: P1
modulo: MAI-009
- nombre: fuel_surcharge
entity_esperada: FuelSurcharge
entity_existente: "tarifas-transporte/fuel-surcharge.entity.ts"
estado: IMPLEMENTADA
prioridad: P1
modulo: MAI-009
resumen:
implementadas: 6
faltantes: 0
coherencia: "100%"
compliance:
ddl_file: "08-compliance-schema-ddl.sql"
tablas_ddl: 8
tablas:
- nombre: cartas_porte
entity_esperada: CartaPorte
entity_existente: "carta-porte/entities (7 basicas)"
estado: PARCIAL
prioridad: P1
modulo: MAE-016
- nombre: ubicaciones_carta_porte
entity_esperada: UbicacionCartaPorte
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P1
modulo: MAE-016
- nombre: mercancias_carta_porte
entity_esperada: MercanciaCartaPorte
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P1
modulo: MAE-016
- nombre: figuras_transporte
entity_esperada: FiguraTransporte
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P1
modulo: MAE-016
- nombre: autotransporte_carta_porte
entity_esperada: AutotransporteCartaPorte
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P1
modulo: MAE-016
- nombre: hos_logs
entity_esperada: HOSLog
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P3
modulo: MAE-017
- nombre: hos_resumen_diario
entity_esperada: HOSResumenDiario
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P3
modulo: MAE-017
- nombre: inspecciones_pre_viaje
entity_esperada: InspeccionPreViaje
entity_existente: null
estado: NO_IMPLEMENTADA
prioridad: P2
modulo: MAE-017
resumen:
implementadas: 1
faltantes: 7
coherencia: "13%"
# ═══════════════════════════════════════════════════════════════════════════════
# RESUMEN CONSOLIDADO
# ═══════════════════════════════════════════════════════════════════════════════
consolidado:
por_schema:
- schema: transport
tablas: 6
implementadas: 0
coherencia: "0%"
prioridad: P0
- schema: fleet
tablas: 5
implementadas: 0
coherencia: "0%"
prioridad: P0
- schema: tracking
tablas: 6
implementadas: 1
coherencia: "17%"
prioridad: P1
- schema: fuel
tablas: 5
implementadas: 5
coherencia: "100%"
prioridad: P2
- schema: maintenance
tablas: 5
implementadas: 0
coherencia: "0%"
prioridad: P2
- schema: carriers
tablas: 6
implementadas: 0
coherencia: "0%"
prioridad: P2
- schema: billing
tablas: 6
implementadas: 6
coherencia: "100%"
prioridad: P1
- schema: compliance
tablas: 8
implementadas: 1
coherencia: "13%"
prioridad: P1
totales:
tablas_ddl: 47
entities_implementadas: 13
entities_parciales: 2
entities_faltantes: 32
coherencia_global: "28%"
# ═══════════════════════════════════════════════════════════════════════════════
# PLAN DE ACCION
# ═══════════════════════════════════════════════════════════════════════════════
plan_accion:
P0_urgente:
descripcion: "Entities criticas para workflow principal"
schemas: [transport, fleet]
entities_requeridas: 11
justificacion: |
Sin estas entities no se puede implementar el flujo:
OT -> Planeacion -> Despacho -> Viaje -> POD -> Facturacion
P1_corto_plazo:
descripcion: "Entities para visibilidad y compliance"
schemas: [tracking, compliance]
entities_requeridas: 12
justificacion: |
Tracking es diferenciador de mercado.
Compliance (Carta Porte) es obligacion fiscal.
P2_mediano_plazo:
descripcion: "Entities de optimizacion"
schemas: [maintenance, carriers]
entities_requeridas: 11
justificacion: |
Mantenimiento para disponibilidad de flota.
Carriers para escalabilidad.
# ═══════════════════════════════════════════════════════════════════════════════
# NOTAS
# ═══════════════════════════════════════════════════════════════════════════════
notas:
- "fuel y billing estan 100% coherentes (11 entities implementadas)"
- "transport y fleet estan al 0% - CRITICO para el negocio"
- "Se requieren ~32 entities nuevas especializadas"
- "Las entities genericas existentes (Product, SalesOrder, etc.) NO sirven para el giro"