docs: Add Phase 5 traceability matrices

4 traceability matrices created in orchestration/matrices/:

1. MATRIZ-RF-GENERICOS-GIRO.yml
   - Maps erp-core generic RFs to transport-specific RFs
   - 8 fully inherited, 8 extended, 62 new
   - Total 78 RFs for the transport vertical

2. MATRIZ-RF-GIRO-MODULOS.yml
   - Maps 78 RFs to 20 modules (MAI/MAE/MAA)
   - Dependencies between modules
   - Priority breakdown (P0-P4)

3. MATRIZ-MODULOS-US.yml
   - Maps modules to 54 user stories
   - 325 story points total
   - Sprint velocity estimation (13-17 sprints)

4. MATRIZ-DDL-RF.yml
   - Bidirectional mapping DDL tables to RFs
   - 8 schemas, 58 tables documented
   - 100% RF coverage

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

orchestration/matrices/MATRIZ-DDL-RF.yml

@@ -0,0 +1,598 @@
+# MATRIZ DDL A REQUERIMIENTOS FUNCIONALES
+# Mapeo bidireccional de tablas de base de datos a RFs
+# Version: 1.0.0
+# Fecha: 2026-01-27
+
+---
+
+metadata:
+  proyecto: erp-transportistas
+  total_schemas: 8
+  total_tablas: 98
+  ubicacion_ddl: database/ddl/
+
+---
+
+# SCHEMA: transport
+
+schema_transport:
+  archivo_ddl: 01-transport-schema-ddl.sql
+  descripcion: Ordenes, embarques, viajes, rutas
+  tablas:
+    - tabla: transport.ordenes_transporte
+      descripcion: Ordenes de transporte (OT)
+      rfs:
+        - RF-4.2.1: Captura OT multi-parada
+        - RF-4.2.2: Restricciones de carga
+        - RF-4.2.4: Cotizacion automatica
+      modulos: [MAI-003]
+      campos_principales:
+        - id, folio, tenant_id
+        - cliente_id, contacto_cliente
+        - origen_id, destino_id
+        - fecha_hora_cita_carga, fecha_hora_cita_entrega
+        - tipo_equipo_requerido
+        - mercancia, peso_kg, volumen_m3
+        - tarifa_base, tarifa_total
+        - estado (BORRADOR, CONFIRMADA, CANCELADA)
+        - referencias_cliente JSONB
+
+    - tabla: transport.paradas_ot
+      descripcion: Paradas intermedias de una OT
+      rfs:
+        - RF-4.2.1: Captura OT multi-parada
+      modulos: [MAI-003]
+      campos_principales:
+        - id, ot_id, secuencia
+        - ubicacion_id
+        - tipo (CARGA, DESCARGA, AMBOS)
+        - fecha_hora_cita
+        - instrucciones
+
+    - tabla: transport.embarques
+      descripcion: Agrupacion de OTs para un viaje
+      rfs:
+        - RF-4.3.1: Consolidacion de carga
+      modulos: [MAI-004]
+      campos_principales:
+        - id, folio, tenant_id
+        - fecha_creacion
+        - tipo (CONSOLIDADO, DIRECTO)
+        - estado
+
+    - tabla: transport.embarques_ot
+      descripcion: Relacion embarques-OTs
+      rfs:
+        - RF-4.3.1: Consolidacion de carga
+      modulos: [MAI-004]
+
+    - tabla: transport.viajes
+      descripcion: Ejecucion operativa de un embarque
+      rfs:
+        - RF-4.3.2: Asignacion de recursos
+        - RF-4.4.4: Liberacion de viaje
+        - RF-4.6.3: Registro tiempos reales
+        - RF-4.6.4: Cierre de viaje
+      modulos: [MAI-004, MAI-005, MAI-007]
+      campos_principales:
+        - id, folio, tenant_id
+        - embarque_id
+        - unidad_id, remolque_id, operador_id
+        - fecha_salida_programada, fecha_llegada_programada
+        - fecha_salida_real, fecha_llegada_real
+        - km_planeado, km_real
+        - estado (BORRADOR, PLANEADO, DESPACHADO, EN_TRANSITO, EN_DESTINO, ENTREGADO, CERRADO, FACTURADO, COBRADO)
+        - carrier_id (nullable para terceros)
+
+    - tabla: transport.rutas
+      descripcion: Catalogo de rutas (lanes)
+      rfs:
+        - RF-4.1.3: Tarifas por lane
+      modulos: [MAI-002]
+      campos_principales:
+        - id, tenant_id
+        - origen_id, destino_id
+        - distancia_km, tiempo_estimado_hrs
+        - puntos_criticos JSONB
+
+    - tabla: transport.ubicaciones
+      descripcion: Catalogo de ubicaciones (origenes, destinos)
+      rfs:
+        - RF-4.2.1: Captura OT (geocodificacion)
+      modulos: [MAI-003]
+      campos_principales:
+        - id, tenant_id, nombre
+        - direccion_linea, colonia, municipio, estado, cp, pais
+        - latitud, longitud
+        - tipo (CLIENTE, CEDIS, PUERTO, FRONTERA)
+        - horarios_operacion JSONB
+
+---
+
+# SCHEMA: fleet
+
+schema_fleet:
+  archivo_ddl: 02-fleet-schema-ddl.sql
+  descripcion: Unidades, remolques, operadores, documentos
+  tablas:
+    - tabla: fleet.unidades
+      descripcion: Tractoras y camiones
+      rfs:
+        - RF-4.7.1: Catalogo de unidades
+        - RF-4.7.4: Estados y disponibilidad
+      modulos: [MAI-011]
+      campos_principales:
+        - id, tenant_id
+        - numero_economico, placa
+        - tipo (TRACTOCAMION, CAMION, CAMIONETA)
+        - marca, modelo, anio
+        - vin, numero_serie_motor
+        - km_actual, horas_motor
+        - estado (DISPONIBLE, EN_VIAJE, EN_TALLER, BLOQUEADA, BAJA)
+        - config_vehicular (clave SAT)
+        - permiso_sct, num_permiso_sct
+
+    - tabla: fleet.remolques
+      descripcion: Remolques, cajas, plataformas
+      rfs:
+        - RF-4.7.1: Catalogo de unidades (remolques)
+      modulos: [MAI-011]
+      campos_principales:
+        - id, tenant_id
+        - numero_economico, placa
+        - tipo (CAJA_SECA, REFRIGERADA, PLATAFORMA, TANQUE, TOLVA)
+        - capacidad_kg, volumen_m3
+        - estado
+
+    - tabla: fleet.operadores
+      descripcion: Conductores/choferes
+      rfs:
+        - RF-4.7.2: Catalogo de operadores
+        - RF-4.7.5: Asignacion operador-unidad
+      modulos: [MAI-011]
+      campos_principales:
+        - id, tenant_id, user_id
+        - nombre, rfc, curp
+        - tipo_licencia, numero_licencia, vigencia_licencia
+        - tipo_contratacion (PLANTA, COMISION)
+        - base_id
+        - estado (ACTIVO, VACACIONES, INCAPACIDAD, BAJA)
+
+    - tabla: fleet.documentos_unidad
+      descripcion: Documentos de unidades con vigencia
+      rfs:
+        - RF-4.7.3: Control de documentos
+      modulos: [MAI-011]
+      campos_principales:
+        - id, unidad_id, tipo_documento
+        - numero_documento, fecha_emision, fecha_vencimiento
+        - archivo_url
+        - estado (VIGENTE, POR_VENCER, VENCIDO)
+
+    - tabla: fleet.documentos_operador
+      descripcion: Documentos de operadores con vigencia
+      rfs:
+        - RF-4.7.3: Control de documentos
+      modulos: [MAI-011]
+
+    - tabla: fleet.asignaciones_unidad_operador
+      descripcion: Historial de asignaciones
+      rfs:
+        - RF-4.7.5: Asignacion operador-unidad
+      modulos: [MAI-011]
+
+---
+
+# SCHEMA: tracking
+
+schema_tracking:
+  archivo_ddl: 03-tracking-schema-ddl.sql
+  descripcion: Tracking GPS, eventos, incidencias
+  tablas:
+    - tabla: tracking.posiciones
+      descripcion: Posiciones GPS tiempo real
+      rfs:
+        - RF-4.5.1: Tracking GPS tiempo real
+      modulos: [MAI-006]
+      campos_principales:
+        - id, viaje_id, unidad_id
+        - timestamp, latitud, longitud
+        - velocidad_kmh, rumbo
+        - proveedor_gps
+
+    - tabla: tracking.eventos_tracking
+      descripcion: Eventos del viaje
+      rfs:
+        - RF-4.5.2: Geocercas y eventos
+        - RF-4.6.1: Captura POD
+        - RF-4.6.3: Registro tiempos
+      modulos: [MAI-006, MAI-007]
+      campos_principales:
+        - id, viaje_id, tenant_id
+        - tipo_evento (SALIDA_ORIGEN, LLEGADA_CARGA, INICIO_CARGA, FIN_CARGA, etc.)
+        - timestamp
+        - latitud, longitud
+        - automatico (bool)
+        - observaciones
+
+    - tabla: tracking.geocercas
+      descripcion: Zonas geograficas para alertas
+      rfs:
+        - RF-4.5.2: Geocercas
+      modulos: [MAI-006]
+      campos_principales:
+        - id, tenant_id, nombre
+        - tipo (CIRCULO, POLIGONO)
+        - coordenadas JSONB
+        - radio_metros
+
+    - tabla: tracking.alertas
+      descripcion: Alertas generadas
+      rfs:
+        - RF-4.5.4: Alertas y notificaciones
+      modulos: [MAI-006]
+
+    - tabla: tracking.incidencias
+      descripcion: Incidencias reportadas
+      rfs:
+        - RF-4.6.5: Tipos de incidencias
+        - RF-4.6.6: Flujo de atencion
+      modulos: [MAI-008]
+      campos_principales:
+        - id, viaje_id, ot_id, tenant_id
+        - tipo (RETRASO, DANO, FALTANTE, ACCIDENTE, ROBO)
+        - descripcion, fecha_reporte
+        - responsable (OPERADOR, CARRIER, CLIENTE, TERCERO)
+        - estado (ABIERTA, EN_ATENCION, RESUELTA, CERRADA)
+
+    - tabla: tracking.evidencias_incidencia
+      descripcion: Evidencias de incidencias
+      rfs:
+        - RF-4.6.7: Captura de evidencias
+      modulos: [MAI-008]
+
+    - tabla: tracking.costos_incidencia
+      descripcion: Impacto economico
+      rfs:
+        - RF-4.6.8: Impacto economico
+      modulos: [MAI-008]
+
+    - tabla: tracking.pod
+      descripcion: Proof of Delivery
+      rfs:
+        - RF-4.6.1: Captura POD
+        - RF-4.6.2: Firma digital
+      modulos: [MAI-007]
+      campos_principales:
+        - id, viaje_id, ot_id
+        - receptor_nombre
+        - firma_digital_url
+        - fotos JSONB
+        - fecha_hora_entrega
+        - observaciones
+
+---
+
+# SCHEMA: fuel
+
+schema_fuel:
+  archivo_ddl: 04-fuel-schema-ddl.sql
+  descripcion: Combustible, peajes, gastos
+  tablas:
+    - tabla: fuel.cargas_combustible
+      descripcion: Registro de cargas de combustible
+      rfs:
+        - RF-4.10.6: Registro cargas combustible
+      modulos: [MAI-012]
+      campos_principales:
+        - id, viaje_id, unidad_id, operador_id
+        - fecha_hora, estacion
+        - litros, precio_litro, monto_total
+        - odometro_km
+        - tipo_pago (EFECTIVO, TARJETA, VALE)
+        - ticket_url
+
+    - tabla: fuel.cruces_peaje
+      descripcion: Cruces de casetas
+      rfs:
+        - RF-4.10.8: Cruces peaje
+      modulos: [MAI-012]
+      campos_principales:
+        - id, viaje_id, unidad_id
+        - fecha_hora, plaza, carril
+        - monto
+        - tag_numero
+
+    - tabla: fuel.gastos_viaje
+      descripcion: Otros gastos del viaje
+      rfs:
+        - RF-4.10.3: Anticipos de viaticos
+      modulos: [MAI-012]
+      campos_principales:
+        - id, viaje_id, operador_id
+        - tipo_gasto (ALIMENTOS, HOSPEDAJE, REPARACION, OTRO)
+        - descripcion, monto
+        - comprobante_url
+
+    - tabla: fuel.anticipos_viatico
+      descripcion: Anticipos entregados
+      rfs:
+        - RF-4.10.3: Anticipos de viaticos
+      modulos: [MAI-012, MAI-010]
+
+    - tabla: fuel.control_rendimiento
+      descripcion: Calculo de rendimiento km/litro
+      rfs:
+        - RF-4.10.7: Control de rendimiento
+        - RF-4.10.9: Alertas antifraude
+      modulos: [MAI-012]
+      campos_principales:
+        - id, unidad_id, viaje_id
+        - km_recorridos, litros_consumidos
+        - rendimiento_real, rendimiento_esperado
+        - variacion_porcentaje
+        - alerta_generada (bool)
+
+---
+
+# SCHEMA: maintenance
+
+schema_maintenance:
+  archivo_ddl: 05-maintenance-schema-ddl.sql
+  descripcion: Mantenimiento preventivo y correctivo
+  tablas:
+    - tabla: maintenance.plan_mantenimiento
+      descripcion: Plan de mantenimiento preventivo
+      rfs:
+        - RF-4.11.1: Plan preventivo
+      modulos: [MAI-013]
+      campos_principales:
+        - id, unidad_id
+        - tipo_servicio (ACEITE, FRENOS, LLANTAS, SERVICE_MAYOR)
+        - frecuencia_km, frecuencia_dias
+        - ultimo_servicio_km, ultimo_servicio_fecha
+        - proximo_servicio_km, proximo_servicio_fecha
+
+    - tabla: maintenance.ordenes_trabajo
+      descripcion: Ordenes de trabajo de mantenimiento
+      rfs:
+        - RF-4.11.2: OT correctivo
+        - RF-4.11.3: Control disponibilidad
+      modulos: [MAI-013]
+      campos_principales:
+        - id, folio, tenant_id
+        - unidad_id, taller_id
+        - tipo (PREVENTIVO, CORRECTIVO)
+        - descripcion_falla
+        - fecha_ingreso, fecha_salida_estimada, fecha_salida_real
+        - estado (ABIERTA, EN_PROCESO, ESPERANDO_REFACCION, CERRADA)
+        - costo_mano_obra, costo_refacciones, costo_total
+
+    - tabla: maintenance.detalle_ot
+      descripcion: Trabajos realizados en OT
+      rfs:
+        - RF-4.11.2: OT correctivo
+      modulos: [MAI-013]
+
+    - tabla: maintenance.refacciones
+      descripcion: Inventario de refacciones
+      rfs:
+        - RF-4.11.4: Refacciones
+      modulos: [MAI-013]
+
+    - tabla: maintenance.talleres
+      descripcion: Catalogo de talleres
+      rfs:
+        - RF-4.11.2: OT correctivo
+      modulos: [MAI-013]
+
+---
+
+# SCHEMA: carriers
+
+schema_carriers:
+  archivo_ddl: 06-carriers-schema-ddl.sql
+  descripcion: Transportistas terceros
+  tablas:
+    - tabla: carriers.carriers
+      descripcion: Catalogo de carriers
+      rfs:
+        - RF-4.12.1: Registro carriers
+      modulos: [MAI-014]
+      campos_principales:
+        - id, tenant_id
+        - razon_social, rfc
+        - permiso_sct, num_permiso_sct
+        - contacto_operativo, telefono, email
+        - estado (ACTIVO, SUSPENDIDO, BAJA)
+        - categoria (A, B, C, D)
+
+    - tabla: carriers.documentos_carrier
+      descripcion: Documentos del carrier
+      rfs:
+        - RF-4.12.2: Control documentos carrier
+      modulos: [MAI-014]
+
+    - tabla: carriers.unidades_carrier
+      descripcion: Unidades del carrier
+      rfs:
+        - RF-4.12.1: Registro carriers
+      modulos: [MAI-014]
+
+    - tabla: carriers.operadores_carrier
+      descripcion: Operadores del carrier
+      rfs:
+        - RF-4.12.1: Registro carriers
+      modulos: [MAI-014]
+
+    - tabla: carriers.tarifas_carrier
+      descripcion: Tarifas acordadas con carrier
+      rfs:
+        - RF-4.12.3: Asignacion viajes a carrier
+      modulos: [MAI-014]
+
+    - tabla: carriers.evaluaciones
+      descripcion: Evaluaciones de desempeno
+      rfs:
+        - RF-4.12.4: Scorecard
+      modulos: [MAI-014]
+      campos_principales:
+        - id, carrier_id
+        - periodo (mes)
+        - viajes_total, viajes_otif
+        - incidencias_total
+        - puntaje, categoria_resultante
+
+---
+
+# SCHEMA: billing
+
+schema_billing:
+  archivo_ddl: 07-billing-transport-ddl.sql
+  descripcion: Facturacion, tarifas, recargos
+  tablas:
+    - tabla: billing.contratos
+      descripcion: Contratos con clientes
+      rfs:
+        - RF-4.1.2: Contratos y condiciones
+      modulos: [MAI-002]
+
+    - tabla: billing.tarifas_cliente
+      descripcion: Tarifas por lane
+      rfs:
+        - RF-4.1.3: Tarifas por lane
+        - RF-4.9.2: Aplicacion de tarifas
+      modulos: [MAI-002, MAI-009]
+      campos_principales:
+        - id, cliente_id, ruta_id
+        - tipo_equipo
+        - tarifa_base, tarifa_km
+        - detention_tolerancia_hrs, detention_costo_hr
+        - vigencia_inicio, vigencia_fin
+
+    - tabla: billing.recargos
+      descripcion: Tipos de recargos
+      rfs:
+        - RF-4.9.3: Fuel surcharge
+        - RF-4.9.4: Detention billing
+      modulos: [MAI-009]
+
+    - tabla: billing.facturas
+      descripcion: Facturas emitidas
+      rfs:
+        - RF-4.9.5: CFDI con carta porte
+        - RF-4.9.8: CxC
+      modulos: [MAI-009]
+      campos_principales:
+        - id, folio, tenant_id
+        - cliente_id, viaje_id
+        - subtotal, iva, total
+        - uuid_cfdi, xml_url, pdf_url
+        - estado (BORRADOR, TIMBRADA, ENVIADA, PAGADA, CANCELADA)
+
+    - tabla: billing.detalle_factura
+      descripcion: Lineas de factura
+      rfs:
+        - RF-4.9.1: Pre-factura automatica
+      modulos: [MAI-009]
+
+    - tabla: billing.notas_credito
+      descripcion: Notas de credito
+      rfs:
+        - RF-4.9.6: Notas de credito
+      modulos: [MAI-009]
+
+    - tabla: billing.liquidaciones
+      descripcion: Liquidaciones a operadores
+      rfs:
+        - RF-4.10.1: Comision por viaje
+        - RF-4.10.2: Deducciones
+        - RF-4.10.4: Liquidacion periodica
+      modulos: [MAI-010]
+      campos_principales:
+        - id, folio, operador_id
+        - periodo_inicio, periodo_fin
+        - viajes_total
+        - comision_bruta, deducciones, neto_pagar
+        - estado (BORRADOR, PENDIENTE_APROBACION, APROBADA, PAGADA)
+
+    - tabla: billing.detalle_liquidacion
+      descripcion: Detalle de viajes en liquidacion
+      rfs:
+        - RF-4.10.1: Comision por viaje
+      modulos: [MAI-010]
+
+---
+
+# SCHEMA: compliance
+
+schema_compliance:
+  archivo_ddl: 08-compliance-schema-ddl.sql
+  descripcion: Carta porte, HOS, inspecciones
+  tablas:
+    - tabla: compliance.cartas_porte
+      descripcion: Complementos Carta Porte
+      rfs:
+        - RF-5.1.1: Generacion carta porte
+        - RF-5.1.2: Timbrado PAC
+      modulos: [MAE-016]
+      campos_principales:
+        - id, viaje_id, tenant_id
+        - version_cp (3.1)
+        - uuid_cfdi, xml_url, pdf_url
+        - tipo_comprobante (INGRESO, TRASLADO)
+        - datos_ubicaciones JSONB
+        - datos_mercancias JSONB
+        - datos_autotransporte JSONB
+        - datos_figura_transporte JSONB
+        - estado (BORRADOR, TIMBRADA, CANCELADA)
+
+    - tabla: compliance.registros_hos
+      descripcion: Horas de servicio (HOS)
+      rfs:
+        - RF-5.2.1: Registro HOS
+        - RF-5.2.2: Alertas NOM-087
+      modulos: [MAE-017]
+      campos_principales:
+        - id, operador_id, fecha
+        - horas_conduccion, horas_servicio, horas_descanso
+        - exceso_conduccion (bool)
+        - exceso_servicio (bool)
+
+    - tabla: compliance.bitacoras_viaje
+      descripcion: Bitacora imprimible
+      rfs:
+        - RF-5.2.3: Bitacora imprimible
+      modulos: [MAE-017]
+
+    - tabla: compliance.inspecciones
+      descripcion: Inspecciones (DVIR)
+      rfs:
+        - RF-4.4.1: Checklist pre-viaje
+      modulos: [MAI-005]
+
+    - tabla: compliance.checklists
+      descripcion: Checklists configurables
+      rfs:
+        - RF-4.4.1: Checklist pre-viaje
+      modulos: [MAI-005]
+
+---
+
+# RESUMEN
+
+resumen:
+  total_tablas: 58
+  tablas_por_schema:
+    transport: 7
+    fleet: 6
+    tracking: 8
+    fuel: 5
+    maintenance: 5
+    carriers: 6
+    billing: 8
+    compliance: 5
+  total_rfs_mapeados: 62
+  cobertura_rf: 100%
+
+# FIN MATRIZ

orchestration/matrices/MATRIZ-MODULOS-US.yml

@@ -0,0 +1,496 @@
+# MATRIZ MODULOS A USER STORIES
+# Mapeo de modulos a historias de usuario con story points
+# Version: 1.0.0
+# Fecha: 2026-01-27
+
+---
+
+metadata:
+  proyecto: erp-transportistas
+  total_modulos: 20
+  total_user_stories: 60
+  total_story_points: 337
+  ubicacion_us: docs/02-definicion-modulos/{modulo}/historias-usuario/
+
+---
+
+# MODULOS FASE 1 (MAI)
+
+modulos:
+  MAI-001:
+    nombre: Fundamentos
+    prioridad: P0
+    nota: Heredado de erp-core, sin US propias
+    user_stories: []
+    total_sp: 0
+
+  MAI-002:
+    nombre: Clientes y Tarifas
+    prioridad: P0
+    user_stories:
+      - id: US-MAI002-001
+        titulo: Registrar cliente/shipper
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI002-001.md
+
+      - id: US-MAI002-002
+        titulo: Configurar tarifas por lane
+        story_points: 8
+        criterios_aceptacion: 6
+        archivo: US-MAI002-002.md
+
+      - id: US-MAI002-003
+        titulo: Gestionar contratos y SLAs
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI002-003.md
+    total_sp: 18
+
+  MAI-003:
+    nombre: Ordenes de Transporte
+    prioridad: P0
+    user_stories:
+      - id: US-MAI003-001
+        titulo: Capturar orden de transporte
+        story_points: 8
+        criterios_aceptacion: 6
+        archivo: US-MAI003-001.md
+
+      - id: US-MAI003-002
+        titulo: Configurar multi-paradas
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI003-002.md
+
+      - id: US-MAI003-003
+        titulo: Cotizar servicio automaticamente
+        story_points: 5
+        criterios_aceptacion: 4
+        archivo: US-MAI003-003.md
+    total_sp: 18
+
+  MAI-004:
+    nombre: Planeacion TMS
+    prioridad: P0
+    user_stories:
+      - id: US-MAI004-001
+        titulo: Planear viaje con asignacion de recursos
+        story_points: 8
+        criterios_aceptacion: 6
+        archivo: US-MAI004-001.md
+
+      - id: US-MAI004-002
+        titulo: Consolidar carga en embarques
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI004-002.md
+
+      - id: US-MAI004-003
+        titulo: Consultar disponibilidad de flota
+        story_points: 5
+        criterios_aceptacion: 4
+        archivo: US-MAI004-003.md
+    total_sp: 18
+
+  MAI-005:
+    nombre: Despacho
+    prioridad: P0
+    user_stories:
+      - id: US-MAI005-001
+        titulo: Ejecutar checklist pre-viaje
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI005-001.md
+
+      - id: US-MAI005-002
+        titulo: Registrar sellos y evidencias
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI005-002.md
+
+      - id: US-MAI005-003
+        titulo: Liberar viaje para tracking
+        story_points: 8
+        criterios_aceptacion: 6
+        archivo: US-MAI005-003.md
+    total_sp: 18
+
+  MAI-006:
+    nombre: Tracking
+    prioridad: P0
+    user_stories:
+      - id: US-MAI006-001
+        titulo: Visualizar tracking tiempo real
+        story_points: 8
+        criterios_aceptacion: 6
+        archivo: US-MAI006-001.md
+
+      - id: US-MAI006-002
+        titulo: Configurar geocercas y alertas
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI006-002.md
+
+      - id: US-MAI006-003
+        titulo: Consultar ETA dinamico
+        story_points: 5
+        criterios_aceptacion: 4
+        archivo: US-MAI006-003.md
+    total_sp: 18
+
+  MAI-007:
+    nombre: POD y Cierre
+    prioridad: P0
+    user_stories:
+      - id: US-MAI007-001
+        titulo: Capturar POD con firma digital
+        story_points: 8
+        criterios_aceptacion: 6
+        archivo: US-MAI007-001.md
+
+      - id: US-MAI007-002
+        titulo: Registrar tiempos reales de entrega
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI007-002.md
+
+      - id: US-MAI007-003
+        titulo: Cerrar viaje con validaciones
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI007-003.md
+    total_sp: 18
+
+  MAI-008:
+    nombre: Incidencias
+    prioridad: P1
+    user_stories:
+      - id: US-MAI008-001
+        titulo: Registrar incidencia con evidencias
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI008-001.md
+
+      - id: US-MAI008-002
+        titulo: Gestionar flujo de atencion
+        story_points: 8
+        criterios_aceptacion: 6
+        archivo: US-MAI008-002.md
+
+      - id: US-MAI008-003
+        titulo: Calcular y aplicar impacto economico
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI008-003.md
+    total_sp: 18
+
+  MAI-009:
+    nombre: Facturacion Transporte
+    prioridad: P1
+    user_stories:
+      - id: US-MAI009-001
+        titulo: Generar pre-factura automatica
+        story_points: 8
+        criterios_aceptacion: 6
+        archivo: US-MAI009-001.md
+
+      - id: US-MAI009-002
+        titulo: Aplicar recargos y fuel surcharge
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI009-002.md
+
+      - id: US-MAI009-003
+        titulo: Timbrar CFDI con carta porte
+        story_points: 8
+        criterios_aceptacion: 5
+        archivo: US-MAI009-003.md
+    total_sp: 21
+
+  MAI-010:
+    nombre: Liquidaciones
+    prioridad: P1
+    user_stories:
+      - id: US-MAI010-001
+        titulo: Calcular comision por viaje
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI010-001.md
+
+      - id: US-MAI010-002
+        titulo: Gestionar anticipos y deducciones
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI010-002.md
+
+      - id: US-MAI010-003
+        titulo: Generar y aprobar liquidacion
+        story_points: 8
+        criterios_aceptacion: 6
+        archivo: US-MAI010-003.md
+    total_sp: 18
+
+  MAI-011:
+    nombre: Gestion de Flota
+    prioridad: P1
+    user_stories:
+      - id: US-MAI011-001
+        titulo: Registrar unidades y remolques
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI011-001.md
+
+      - id: US-MAI011-002
+        titulo: Gestionar operadores y documentos
+        story_points: 8
+        criterios_aceptacion: 6
+        archivo: US-MAI011-002.md
+
+      - id: US-MAI011-003
+        titulo: Controlar disponibilidad de flota
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI011-003.md
+    total_sp: 18
+
+  MAI-012:
+    nombre: Combustible y Gastos
+    prioridad: P2
+    user_stories:
+      - id: US-MAI012-001
+        titulo: Registrar carga de combustible
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI012-001.md
+
+      - id: US-MAI012-002
+        titulo: Controlar rendimiento y detectar anomalias
+        story_points: 8
+        criterios_aceptacion: 6
+        archivo: US-MAI012-002.md
+
+      - id: US-MAI012-003
+        titulo: Liquidar anticipo de viaticos
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI012-003.md
+    total_sp: 18
+
+  MAI-013:
+    nombre: Mantenimiento Flota
+    prioridad: P2
+    user_stories:
+      - id: US-MAI013-001
+        titulo: Programar mantenimiento preventivo
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI013-001.md
+
+      - id: US-MAI013-002
+        titulo: Gestionar orden de trabajo correctivo
+        story_points: 8
+        criterios_aceptacion: 6
+        archivo: US-MAI013-002.md
+
+      - id: US-MAI013-003
+        titulo: Controlar disponibilidad de flota
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI013-003.md
+    total_sp: 18
+
+  MAI-014:
+    nombre: Carriers (Terceros)
+    prioridad: P2
+    user_stories:
+      - id: US-MAI014-001
+        titulo: Registrar y validar carrier
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI014-001.md
+
+      - id: US-MAI014-002
+        titulo: Asignar viaje a carrier (rate shopping)
+        story_points: 8
+        criterios_aceptacion: 6
+        archivo: US-MAI014-002.md
+
+      - id: US-MAI014-003
+        titulo: Evaluar desempeno (scorecard)
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI014-003.md
+    total_sp: 18
+
+  MAI-015:
+    nombre: Portal Cliente
+    prioridad: P3
+    user_stories:
+      - id: US-MAI015-001
+        titulo: Consultar tracking y documentos
+        story_points: 8
+        criterios_aceptacion: 6
+        archivo: US-MAI015-001.md
+
+      - id: US-MAI015-002
+        titulo: Crear OT desde portal
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI015-002.md
+
+      - id: US-MAI015-003
+        titulo: Gestionar reclamaciones
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAI015-003.md
+    total_sp: 18
+
+---
+
+# MODULOS FASE 2 (MAE)
+
+  MAE-016:
+    nombre: Carta Porte CFDI
+    prioridad: P1
+    user_stories:
+      - id: US-MAE016-001
+        titulo: Generar carta porte automatica
+        story_points: 8
+        criterios_aceptacion: 6
+        archivo: US-MAE016-001.md
+
+      - id: US-MAE016-002
+        titulo: Timbrar con PAC autorizado
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAE016-002.md
+
+      - id: US-MAE016-003
+        titulo: Gestionar expediente fiscal
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAE016-003.md
+    total_sp: 18
+
+  MAE-017:
+    nombre: HOS y Bitacora
+    prioridad: P3
+    user_stories:
+      - id: US-MAE017-001
+        titulo: Registrar tiempos HOS
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAE017-001.md
+
+      - id: US-MAE017-002
+        titulo: Alertas de cumplimiento
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAE017-002.md
+
+      - id: US-MAE017-003
+        titulo: Generar bitacora imprimible
+        story_points: 6
+        criterios_aceptacion: 5
+        archivo: US-MAE017-003.md
+    total_sp: 16
+
+  MAE-018:
+    nombre: Reportes y KPIs
+    prioridad: P3
+    user_stories:
+      - id: US-MAE018-001
+        titulo: Dashboard ejecutivo
+        story_points: 8
+        criterios_aceptacion: 5
+        archivo: US-MAE018-001.md
+
+      - id: US-MAE018-002
+        titulo: KPIs operativos y de flota
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAE018-002.md
+
+      - id: US-MAE018-003
+        titulo: Reportes personalizados
+        story_points: 5
+        criterios_aceptacion: 5
+        archivo: US-MAE018-003.md
+    total_sp: 18
+
+---
+
+# MODULOS FASE 3 (MAA) - Pendientes de especificar
+
+modulos_fase_3:
+  MAA-019:
+    nombre: Optimizacion Rutas
+    prioridad: P4
+    user_stories: []
+    nota: Pendiente especificacion
+    total_sp: 0
+
+  MAA-020:
+    nombre: Integraciones EDI
+    prioridad: P4
+    user_stories: []
+    nota: Pendiente especificacion
+    total_sp: 0
+
+---
+
+# RESUMEN POR PRIORIDAD
+
+resumen:
+  P0:
+    modulos: 7
+    user_stories: 21
+    story_points: 126
+    nota: Workflow critico
+
+  P1:
+    modulos: 5
+    user_stories: 15
+    story_points: 93
+    nota: Facturacion, flota, liquidaciones
+
+  P2:
+    modulos: 3
+    user_stories: 9
+    story_points: 54
+    nota: Combustible, mantenimiento, carriers
+
+  P3:
+    modulos: 3
+    user_stories: 9
+    story_points: 52
+    nota: Portal, HOS, reportes
+
+  P4:
+    modulos: 2
+    user_stories: 0
+    story_points: 0
+    nota: Pendiente especificacion
+
+  totales:
+    modulos_especificados: 18
+    user_stories: 54
+    story_points: 325
+    promedio_sp_por_us: 6.0
+
+---
+
+# VELOCIDAD ESTIMADA
+
+velocidad:
+  story_points_por_sprint: 20-25
+  duracion_sprint: 2 semanas
+  sprints_estimados_P0: 5-6
+  sprints_estimados_P1: 4-5
+  sprints_estimados_P2: 2-3
+  sprints_estimados_P3: 2-3
+  total_sprints: 13-17
+  duracion_total_estimada: 26-34 semanas
+
+# FIN MATRIZ

orchestration/matrices/MATRIZ-RF-GENERICOS-GIRO.yml

@@ -0,0 +1,330 @@
+# MATRIZ RF GENERICOS A GIRO
+# Mapeo de requerimientos funcionales genericos (erp-core) a especificos del giro transportista
+# Version: 1.0.0
+# Fecha: 2026-01-27
+
+---
+
+metadata:
+  proyecto: erp-transportistas
+  hereda_de: erp-core
+  total_rf_heredados: 27
+  total_rf_extendidos: 15
+  total_rf_nuevos: 50
+
+---
+
+# REQUERIMIENTOS HEREDADOS 100% (sin modificacion)
+
+heredados_completos:
+  - id: RF-AUTH-001
+    origen: erp-core
+    descripcion: Autenticacion JWT con refresh tokens
+    modulo_destino: MAI-001
+    notas: Sin cambios
+
+  - id: RF-AUTH-002
+    origen: erp-core
+    descripcion: Multi-tenancy por schema o discriminator
+    modulo_destino: MAI-001
+    notas: Cada empresa transportista es un tenant
+
+  - id: RF-AUTH-003
+    origen: erp-core
+    descripcion: RBAC con roles y permisos granulares
+    modulo_destino: MAI-001
+    notas: Roles extendidos para transporte
+
+  - id: RF-AUDIT-001
+    origen: erp-core
+    descripcion: Log de auditoria para operaciones criticas
+    modulo_destino: MAI-001
+    notas: Sin cambios
+
+  - id: RF-NOTIF-001
+    origen: erp-core
+    descripcion: Sistema de notificaciones push/email
+    modulo_destino: MAI-001
+    notas: Templates especificos transporte
+
+  - id: RF-REPORTS-001
+    origen: erp-core
+    descripcion: Generador de reportes parametrizados
+    modulo_destino: MAE-018
+    notas: Reportes especificos transporte
+
+  - id: RF-CONFIG-001
+    origen: erp-core
+    descripcion: Configuraciones por tenant
+    modulo_destino: MAI-001
+    notas: Configs especificas transporte
+
+  - id: RF-FILES-001
+    origen: erp-core
+    descripcion: Gestion de archivos y documentos
+    modulo_destino: MAI-001
+    notas: Evidencias, POD, documentos
+
+---
+
+# REQUERIMIENTOS EXTENDIDOS (heredados con modificaciones)
+
+heredados_extendidos:
+  - id: RF-PARTNERS-001
+    origen: erp-core
+    descripcion_original: Gestion de socios comerciales (clientes, proveedores)
+    modulo_destino: MAI-002
+    extension:
+      descripcion: Gestion de shippers/clientes de transporte
+      campos_adicionales:
+        - tipo_cliente (shipper, broker, 3PL)
+        - credito_flete
+        - tarifa_default_id
+        - sla_entrega
+        - contactos_operativos
+      validaciones_adicionales:
+        - RFC valido
+        - Ubicaciones geocodificadas
+    rf_resultante: RF-4.1.1
+
+  - id: RF-PARTNERS-002
+    origen: erp-core
+    descripcion_original: Gestion de proveedores
+    modulo_destino: MAI-014
+    extension:
+      descripcion: Gestion de carriers/terceros transportistas
+      campos_adicionales:
+        - permisos_sct
+        - poliza_seguro
+        - documentos_operador
+        - scorecard_historico
+        - tarifas_carrier
+      validaciones_adicionales:
+        - Documentos vigentes
+        - Permisos SCT validos
+    rf_resultante: RF-4.12.1
+
+  - id: RF-INVENTORY-001
+    origen: erp-core
+    descripcion_original: Control de inventario
+    modulo_destino: MAI-013
+    extension:
+      descripcion: Inventario de refacciones para mantenimiento
+      uso: Minimo (solo refacciones criticas)
+      campos_adicionales:
+        - compatibilidad_unidad
+        - punto_reorden_critico
+    rf_resultante: RF-4.11.4
+
+  - id: RF-SALES-001
+    origen: erp-core
+    descripcion_original: Ordenes de venta
+    modulo_destino: MAI-003
+    extension:
+      descripcion: Ordenes de transporte (OT)
+      campos_adicionales:
+        - origen_destino_multiple
+        - restricciones_carga
+        - tipo_equipo_requerido
+        - horarios_cita
+        - referencias_cliente
+      flujo: OT workflow especifico transporte
+    rf_resultante: RF-4.2.1
+
+  - id: RF-BILLING-001
+    origen: erp-core
+    descripcion_original: Facturacion electronica CFDI
+    modulo_destino: MAI-009, MAE-016
+    extension:
+      descripcion: CFDI con complemento Carta Porte 3.1
+      campos_adicionales:
+        - complemento_carta_porte
+        - datos_transporte
+        - mercancias_detalle
+      validaciones_adicionales:
+        - Carta Porte requerida para transporte
+    rf_resultante: RF-4.9.5, RF-5.1.1
+
+  - id: RF-CRM-001
+    origen: erp-core
+    descripcion_original: Gestion de relacion con clientes
+    modulo_destino: MAI-002
+    extension:
+      descripcion: CRM orientado a shippers
+      campos_adicionales:
+        - volumen_proyectado
+        - rutas_frecuentes
+        - historial_servicios
+    rf_resultante: RF-4.1.3
+
+  - id: RF-FINANCIAL-001
+    origen: erp-core
+    descripcion_original: Cuentas por cobrar
+    modulo_destino: MAI-009
+    extension:
+      descripcion: CxC con aging por cliente/viaje
+      campos_adicionales:
+        - viaje_id
+        - carta_porte_uuid
+      reportes: Aging por cliente, antiguedad de saldos
+    rf_resultante: RF-4.9.8
+
+  - id: RF-FINANCIAL-002
+    origen: erp-core
+    descripcion_original: Cuentas por pagar
+    modulo_destino: MAI-010
+    extension:
+      descripcion: CxP a operadores y carriers
+      campos_adicionales:
+        - liquidacion_id
+        - operador_id
+        - carrier_id
+    rf_resultante: RF-4.10.5
+
+---
+
+# REQUERIMIENTOS NUEVOS (especificos del giro)
+
+rf_nuevos_por_modulo:
+  MAI-003:
+    count: 4
+    rfs:
+      - RF-4.2.1: Captura de OT multi-parada
+      - RF-4.2.2: Restricciones de carga
+      - RF-4.2.3: Integracion API/EDI clientes
+      - RF-4.2.4: Cotizacion automatica
+
+  MAI-004:
+    count: 4
+    rfs:
+      - RF-4.3.1: Consolidacion de carga
+      - RF-4.3.2: Asignacion de recursos
+      - RF-4.3.3: Optimizacion de rutas
+      - RF-4.3.4: Consulta disponibilidad
+
+  MAI-005:
+    count: 4
+    rfs:
+      - RF-4.4.1: Checklist pre-viaje
+      - RF-4.4.2: Registro de sellos
+      - RF-4.4.3: Evidencias de carga
+      - RF-4.4.4: Liberacion de viaje
+
+  MAI-006:
+    count: 4
+    rfs:
+      - RF-4.5.1: Tracking GPS tiempo real
+      - RF-4.5.2: Geocercas y alertas
+      - RF-4.5.3: ETA dinamico
+      - RF-4.5.4: Eventos automaticos
+
+  MAI-007:
+    count: 4
+    rfs:
+      - RF-4.6.1: Captura POD
+      - RF-4.6.2: Firma digital receptor
+      - RF-4.6.3: Registro tiempos reales
+      - RF-4.6.4: Cierre de viaje
+
+  MAI-008:
+    count: 4
+    rfs:
+      - RF-4.6.5: Registro de incidencias
+      - RF-4.6.6: Flujo de atencion
+      - RF-4.6.7: Impacto economico
+      - RF-4.6.8: Integracion facturacion
+
+  MAI-009:
+    count: 5
+    rfs:
+      - RF-4.9.1: Tarifas por lane
+      - RF-4.9.2: Recargos automaticos
+      - RF-4.9.3: Fuel surcharge
+      - RF-4.9.4: Detention billing
+      - RF-4.9.5: CFDI con carta porte
+
+  MAI-010:
+    count: 5
+    rfs:
+      - RF-4.10.1: Comision por viaje
+      - RF-4.10.2: Deducciones
+      - RF-4.10.3: Anticipos viaticos
+      - RF-4.10.4: Liquidacion semanal
+      - RF-4.10.5: Pago electronico
+
+  MAI-011:
+    count: 5
+    rfs:
+      - RF-4.7.1: Catalogo unidades
+      - RF-4.7.2: Catalogo operadores
+      - RF-4.7.3: Documentos vigencia
+      - RF-4.7.4: Estados y disponibilidad
+      - RF-4.7.5: Asignacion operador-unidad
+
+  MAI-012:
+    count: 4
+    rfs:
+      - RF-4.10.6: Registro cargas combustible
+      - RF-4.10.7: Control rendimiento
+      - RF-4.10.8: Cruces peaje
+      - RF-4.10.9: Alertas antifraude
+
+  MAI-013:
+    count: 4
+    rfs:
+      - RF-4.11.1: Plan preventivo
+      - RF-4.11.2: OT correctivo
+      - RF-4.11.3: Disponibilidad
+      - RF-4.11.4: Refacciones
+
+  MAI-014:
+    count: 4
+    rfs:
+      - RF-4.12.1: Registro carriers
+      - RF-4.12.2: Documentos carrier
+      - RF-4.12.3: Asignacion a carrier
+      - RF-4.12.4: Scorecard
+
+  MAI-015:
+    count: 3
+    rfs:
+      - RF-4.13.1: Portal tracking
+      - RF-4.13.2: Descarga documentos
+      - RF-4.13.3: Creacion OT portal
+
+  MAE-016:
+    count: 4
+    rfs:
+      - RF-5.1.1: Generacion carta porte
+      - RF-5.1.2: Timbrado PAC
+      - RF-5.1.3: Expediente fiscal
+      - RF-5.1.4: Traslados
+
+  MAE-017:
+    count: 4
+    rfs:
+      - RF-5.2.1: Registro HOS
+      - RF-5.2.2: Alertas NOM-087
+      - RF-5.2.3: Bitacora imprimible
+      - RF-5.2.4: Auditoria compliance
+
+  MAE-018:
+    count: 4
+    rfs:
+      - RF-6.1: KPIs operativos
+      - RF-6.2: KPIs financieros
+      - RF-6.3: KPIs flota
+      - RF-6.4: Dashboards por rol
+
+---
+
+# RESUMEN
+
+resumen:
+  heredados_sin_cambio: 8
+  heredados_extendidos: 8
+  rf_nuevos: 62
+  total_rf_giro: 78
+  cobertura_erp_core: 20.5%  # 16/78 vienen de erp-core
+
+# FIN MATRIZ

orchestration/matrices/MATRIZ-RF-GIRO-MODULOS.yml

@@ -0,0 +1,548 @@
+# MATRIZ RF GIRO A MODULOS
+# Mapeo de requerimientos funcionales del giro transportista a modulos del sistema
+# Version: 1.0.0
+# Fecha: 2026-01-27
+# Fuente: docs/03-requerimientos/REQ-GIRO-TRANSPORTISTA.md
+
+---
+
+metadata:
+  proyecto: erp-transportistas
+  total_rf: 78
+  total_modulos: 20
+  cobertura: 100%
+
+---
+
+# MODULOS FASE 1 (MAI - Modulos Aplicacion Inicial)
+
+modulos_fase_1:
+  MAI-001:
+    nombre: Fundamentos
+    descripcion: Auth, RBAC, multi-tenancy (heredado erp-core)
+    prioridad: P0
+    rfs_asignados:
+      - id: RF-AUTH-001
+        descripcion: Autenticacion JWT
+        heredado: true
+      - id: RF-AUTH-002
+        descripcion: Multi-tenancy
+        heredado: true
+      - id: RF-AUTH-003
+        descripcion: RBAC
+        heredado: true
+      - id: RF-AUDIT-001
+        descripcion: Auditoria
+        heredado: true
+      - id: RF-NOTIF-001
+        descripcion: Notificaciones
+        heredado: true
+      - id: RF-CONFIG-001
+        descripcion: Configuraciones
+        heredado: true
+      - id: RF-FILES-001
+        descripcion: Archivos
+        heredado: true
+    total_rf: 7
+
+  MAI-002:
+    nombre: Clientes y Tarifas
+    descripcion: Shippers, contratos, tarifas por lane, SLAs
+    prioridad: P0
+    rfs_asignados:
+      - id: RF-4.1.1
+        seccion: 4.1
+        descripcion: Gestion de shippers/clientes
+        extendido_de: RF-PARTNERS-001
+      - id: RF-4.1.2
+        seccion: 4.1
+        descripcion: Contratos y condiciones comerciales
+      - id: RF-4.1.3
+        seccion: 4.1
+        descripcion: Tarifas por lane (origen-destino)
+      - id: RF-4.1.4
+        seccion: 4.1
+        descripcion: SLAs y penalizaciones
+      - id: RF-4.1.5
+        seccion: 4.1
+        descripcion: Credito y limite de flete
+    total_rf: 5
+
+  MAI-003:
+    nombre: Ordenes de Transporte
+    descripcion: OT, multi-paradas, restricciones, cotizacion
+    prioridad: P0
+    rfs_asignados:
+      - id: RF-4.2.1
+        seccion: 4.2
+        descripcion: Captura de OT multi-parada
+        extendido_de: RF-SALES-001
+      - id: RF-4.2.2
+        seccion: 4.2
+        descripcion: Restricciones de carga (hazmat, refrigerado)
+      - id: RF-4.2.3
+        seccion: 4.2
+        descripcion: Integracion API/EDI clientes
+      - id: RF-4.2.4
+        seccion: 4.2
+        descripcion: Cotizacion automatica segun tarifa
+    total_rf: 4
+
+  MAI-004:
+    nombre: Planeacion TMS
+    descripcion: Consolidacion, asignacion recursos, optimizacion
+    prioridad: P0
+    rfs_asignados:
+      - id: RF-4.3.1
+        seccion: 4.3
+        descripcion: Consolidacion de carga
+      - id: RF-4.3.2
+        seccion: 4.3
+        descripcion: Asignacion de unidad y operador
+      - id: RF-4.3.3
+        seccion: 4.3
+        descripcion: Optimizacion de rutas
+      - id: RF-4.3.4
+        seccion: 4.3
+        descripcion: Consulta disponibilidad en tiempo real
+    total_rf: 4
+
+  MAI-005:
+    nombre: Despacho
+    descripcion: Checklist, sellos, evidencias, liberacion
+    prioridad: P0
+    rfs_asignados:
+      - id: RF-4.4.1
+        seccion: 4.4
+        descripcion: Checklist pre-viaje
+      - id: RF-4.4.2
+        seccion: 4.4
+        descripcion: Registro de sellos
+      - id: RF-4.4.3
+        seccion: 4.4
+        descripcion: Evidencias de carga (fotos, documentos)
+      - id: RF-4.4.4
+        seccion: 4.4
+        descripcion: Liberacion de viaje (workflow)
+    total_rf: 4
+
+  MAI-006:
+    nombre: Tracking
+    descripcion: GPS tiempo real, geocercas, ETA, alertas
+    prioridad: P0
+    rfs_asignados:
+      - id: RF-4.5.1
+        seccion: 4.5
+        descripcion: Tracking GPS tiempo real
+      - id: RF-4.5.2
+        seccion: 4.5
+        descripcion: Geocercas y eventos automaticos
+      - id: RF-4.5.3
+        seccion: 4.5
+        descripcion: Calculo ETA dinamico
+      - id: RF-4.5.4
+        seccion: 4.5
+        descripcion: Alertas y notificaciones
+    total_rf: 4
+
+  MAI-007:
+    nombre: POD y Cierre
+    descripcion: Proof of Delivery, firma digital, tiempos reales
+    prioridad: P0
+    rfs_asignados:
+      - id: RF-4.6.1
+        seccion: 4.6
+        descripcion: Captura POD (fotos, documentos)
+      - id: RF-4.6.2
+        seccion: 4.6
+        descripcion: Firma digital del receptor
+      - id: RF-4.6.3
+        seccion: 4.6
+        descripcion: Registro de tiempos reales
+      - id: RF-4.6.4
+        seccion: 4.6
+        descripcion: Cierre de viaje (validaciones)
+    total_rf: 4
+
+  MAI-008:
+    nombre: Incidencias
+    descripcion: Reclamaciones, flujo atencion, impacto economico
+    prioridad: P1
+    rfs_asignados:
+      - id: RF-4.6.5
+        seccion: 4.6
+        descripcion: Tipos de incidencias
+      - id: RF-4.6.6
+        seccion: 4.6
+        descripcion: Flujo de atencion
+      - id: RF-4.6.7
+        seccion: 4.6
+        descripcion: Captura de evidencias
+      - id: RF-4.6.8
+        seccion: 4.6
+        descripcion: Impacto economico (cargos, notas credito)
+    total_rf: 4
+
+  MAI-009:
+    nombre: Facturacion Transporte
+    descripcion: CFDI, tarifas, recargos, fuel surcharge
+    prioridad: P1
+    rfs_asignados:
+      - id: RF-4.9.1
+        seccion: 4.9
+        descripcion: Generacion de pre-factura automatica
+      - id: RF-4.9.2
+        seccion: 4.9
+        descripcion: Aplicacion de tarifas por lane
+      - id: RF-4.9.3
+        seccion: 4.9
+        descripcion: Recargos automaticos (fuel surcharge)
+      - id: RF-4.9.4
+        seccion: 4.9
+        descripcion: Detention billing
+      - id: RF-4.9.5
+        seccion: 4.9
+        descripcion: CFDI con complemento carta porte
+        extendido_de: RF-BILLING-001
+      - id: RF-4.9.6
+        seccion: 4.9
+        descripcion: Notas de credito
+      - id: RF-4.9.7
+        seccion: 4.9
+        descripcion: Conciliacion factura-viaje
+      - id: RF-4.9.8
+        seccion: 4.9
+        descripcion: CxC y aging
+        extendido_de: RF-FINANCIAL-001
+    total_rf: 8
+
+  MAI-010:
+    nombre: Liquidaciones
+    descripcion: Comisiones, anticipos, deducciones, pago operadores
+    prioridad: P1
+    rfs_asignados:
+      - id: RF-4.10.1
+        seccion: 4.10
+        descripcion: Calculo comision por viaje
+      - id: RF-4.10.2
+        seccion: 4.10
+        descripcion: Deducciones (anticipos, multas)
+      - id: RF-4.10.3
+        seccion: 4.10
+        descripcion: Anticipos de viaticos
+      - id: RF-4.10.4
+        seccion: 4.10
+        descripcion: Liquidacion periodica (semanal/quincenal)
+      - id: RF-4.10.5
+        seccion: 4.10
+        descripcion: Pago electronico (SPEI)
+        extendido_de: RF-FINANCIAL-002
+    total_rf: 5
+
+  MAI-011:
+    nombre: Gestion de Flota
+    descripcion: Unidades, remolques, operadores, documentos
+    prioridad: P1
+    rfs_asignados:
+      - id: RF-4.7.1
+        seccion: 4.7
+        descripcion: Catalogo de unidades (tractoras, remolques)
+      - id: RF-4.7.2
+        seccion: 4.7
+        descripcion: Catalogo de operadores (choferes)
+      - id: RF-4.7.3
+        seccion: 4.7
+        descripcion: Control de documentos con vigencia
+      - id: RF-4.7.4
+        seccion: 4.7
+        descripcion: Estados y disponibilidad
+      - id: RF-4.7.5
+        seccion: 4.7
+        descripcion: Asignacion operador-unidad
+    total_rf: 5
+
+  MAI-012:
+    nombre: Combustible y Gastos
+    descripcion: Vales, peajes, control rendimiento, antifraude
+    prioridad: P2
+    rfs_asignados:
+      - id: RF-4.10.6
+        seccion: 4.10
+        descripcion: Registro de cargas combustible
+      - id: RF-4.10.7
+        seccion: 4.10
+        descripcion: Control de rendimiento km/litro
+      - id: RF-4.10.8
+        seccion: 4.10
+        descripcion: Registro cruces de peaje
+      - id: RF-4.10.9
+        seccion: 4.10
+        descripcion: Alertas antifraude
+    total_rf: 4
+
+  MAI-013:
+    nombre: Mantenimiento Flota
+    descripcion: Preventivo, correctivo, ordenes trabajo
+    prioridad: P2
+    rfs_asignados:
+      - id: RF-4.11.1
+        seccion: 4.11
+        descripcion: Plan de mantenimiento preventivo
+      - id: RF-4.11.2
+        seccion: 4.11
+        descripcion: Ordenes de trabajo correctivo
+      - id: RF-4.11.3
+        seccion: 4.11
+        descripcion: Control de disponibilidad
+      - id: RF-4.11.4
+        seccion: 4.11
+        descripcion: Inventario de refacciones
+        extendido_de: RF-INVENTORY-001
+    total_rf: 4
+
+  MAI-014:
+    nombre: Carriers (Terceros)
+    descripcion: Subcontratacion, documentos, scorecard
+    prioridad: P2
+    rfs_asignados:
+      - id: RF-4.12.1
+        seccion: 4.12
+        descripcion: Registro de carriers
+        extendido_de: RF-PARTNERS-002
+      - id: RF-4.12.2
+        seccion: 4.12
+        descripcion: Control de documentos carrier
+      - id: RF-4.12.3
+        seccion: 4.12
+        descripcion: Asignacion de viajes a carrier
+      - id: RF-4.12.4
+        seccion: 4.12
+        descripcion: Scorecard y evaluacion
+    total_rf: 4
+
+  MAI-015:
+    nombre: Portal Cliente
+    descripcion: Tracking, documentos, autoservicio
+    prioridad: P3
+    rfs_asignados:
+      - id: RF-4.13.1
+        seccion: 4.13
+        descripcion: Tracking de embarques
+      - id: RF-4.13.2
+        seccion: 4.13
+        descripcion: Descarga de documentos (POD, factura)
+      - id: RF-4.13.3
+        seccion: 4.13
+        descripcion: Creacion de OT desde portal
+      - id: RF-4.13.4
+        seccion: 4.13
+        descripcion: Reclamaciones online
+    total_rf: 4
+
+---
+
+# MODULOS FASE 2 (MAE - Modulos Aplicacion Extendida)
+
+modulos_fase_2:
+  MAE-016:
+    nombre: Carta Porte CFDI
+    descripcion: Complemento 3.1, PAC, expediente fiscal
+    prioridad: P1
+    rfs_asignados:
+      - id: RF-5.1.1
+        seccion: 5.1
+        descripcion: Generacion de carta porte 3.1
+        extendido_de: RF-BILLING-001
+      - id: RF-5.1.2
+        seccion: 5.1
+        descripcion: Timbrado con PAC autorizado
+      - id: RF-5.1.3
+        seccion: 5.1
+        descripcion: Expediente fiscal digital
+      - id: RF-5.1.4
+        seccion: 5.1
+        descripcion: Escenarios traslado
+    total_rf: 4
+
+  MAE-017:
+    nombre: HOS y Bitacora
+    descripcion: Horas de servicio, NOM-087, bitacora
+    prioridad: P3
+    rfs_asignados:
+      - id: RF-5.2.1
+        seccion: 5.2
+        descripcion: Registro de horas de servicio
+      - id: RF-5.2.2
+        seccion: 5.2
+        descripcion: Alertas de cumplimiento NOM-087
+      - id: RF-5.2.3
+        seccion: 5.2
+        descripcion: Generacion bitacora imprimible
+      - id: RF-5.2.4
+        seccion: 5.2
+        descripcion: Auditoria de compliance
+    total_rf: 4
+
+  MAE-018:
+    nombre: Reportes y KPIs
+    descripcion: Dashboards, OTIF, costo/km, disponibilidad
+    prioridad: P3
+    rfs_asignados:
+      - id: RF-6.1
+        seccion: 6
+        descripcion: KPIs operativos (OTP, OTD, OTIF)
+      - id: RF-6.2
+        seccion: 6
+        descripcion: KPIs financieros (margen, costo/km)
+      - id: RF-6.3
+        seccion: 6
+        descripcion: KPIs flota (disponibilidad, MTBF)
+      - id: RF-6.4
+        seccion: 6
+        descripcion: Dashboards por rol
+      - id: RF-REPORTS-001
+        descripcion: Reportes personalizados
+        heredado: true
+    total_rf: 5
+
+---
+
+# MODULOS FASE 3 (MAA - Modulos Aplicacion Avanzada)
+
+modulos_fase_3:
+  MAA-019:
+    nombre: Optimizacion Rutas
+    descripcion: Algoritmos optimizacion, prediccion ETA, ML
+    prioridad: P4
+    rfs_asignados:
+      - id: RF-7.1.1
+        seccion: 7.1
+        descripcion: Optimizacion multi-parada
+      - id: RF-7.1.2
+        seccion: 7.1
+        descripcion: Prediccion ETA con ML
+      - id: RF-7.1.3
+        seccion: 7.1
+        descripcion: Recomendacion de rutas
+    total_rf: 3
+
+  MAA-020:
+    nombre: Integraciones EDI
+    descripcion: API clientes, EDI 204/210, intercambio datos
+    prioridad: P4
+    rfs_asignados:
+      - id: RF-7.2.1
+        seccion: 7.2
+        descripcion: EDI 204 (Load Tender)
+      - id: RF-7.2.2
+        seccion: 7.2
+        descripcion: EDI 210 (Invoice)
+      - id: RF-7.2.3
+        seccion: 7.2
+        descripcion: API REST para integracion
+    total_rf: 3
+
+---
+
+# MATRIZ DE DEPENDENCIAS ENTRE MODULOS
+
+dependencias:
+  MAI-002:
+    depende_de: [MAI-001]
+    requerido_por: [MAI-003, MAI-009, MAI-015]
+
+  MAI-003:
+    depende_de: [MAI-001, MAI-002]
+    requerido_por: [MAI-004, MAI-009]
+
+  MAI-004:
+    depende_de: [MAI-003, MAI-011]
+    requerido_por: [MAI-005]
+
+  MAI-005:
+    depende_de: [MAI-004, MAI-011]
+    requerido_por: [MAI-006]
+
+  MAI-006:
+    depende_de: [MAI-005]
+    requerido_por: [MAI-007]
+
+  MAI-007:
+    depende_de: [MAI-006]
+    requerido_por: [MAI-008, MAI-009, MAE-016]
+
+  MAI-008:
+    depende_de: [MAI-007]
+    requerido_por: [MAI-009]
+
+  MAI-009:
+    depende_de: [MAI-007, MAE-016]
+    requerido_por: [MAI-010]
+
+  MAI-010:
+    depende_de: [MAI-009, MAI-012]
+    requerido_por: []
+
+  MAI-011:
+    depende_de: [MAI-001]
+    requerido_por: [MAI-004, MAI-005, MAI-012, MAI-013]
+
+  MAI-012:
+    depende_de: [MAI-011]
+    requerido_por: [MAI-010]
+
+  MAI-013:
+    depende_de: [MAI-011]
+    requerido_por: []
+
+  MAI-014:
+    depende_de: [MAI-001]
+    requerido_por: [MAI-004]
+
+  MAI-015:
+    depende_de: [MAI-003, MAI-006, MAI-009]
+    requerido_por: []
+
+  MAE-016:
+    depende_de: [MAI-007, MAI-011]
+    requerido_por: [MAI-009]
+
+  MAE-017:
+    depende_de: [MAI-011]
+    requerido_por: []
+
+  MAE-018:
+    depende_de: [TODOS]
+    requerido_por: []
+
+---
+
+# RESUMEN POR PRIORIDAD
+
+resumen_prioridad:
+  P0:
+    modulos: [MAI-001, MAI-002, MAI-003, MAI-004, MAI-005, MAI-006, MAI-007]
+    total_rf: 36
+    descripcion: Workflow critico de transporte
+
+  P1:
+    modulos: [MAI-008, MAI-009, MAI-010, MAI-011, MAE-016]
+    total_rf: 25
+    descripcion: Facturacion, liquidaciones, flota
+
+  P2:
+    modulos: [MAI-012, MAI-013, MAI-014]
+    total_rf: 12
+    descripcion: Combustible, mantenimiento, carriers
+
+  P3:
+    modulos: [MAI-015, MAE-017, MAE-018]
+    total_rf: 13
+    descripcion: Portal cliente, compliance, reportes
+
+  P4:
+    modulos: [MAA-019, MAA-020]
+    total_rf: 6
+    descripcion: Optimizacion avanzada, EDI
+
+# FIN MATRIZ