# 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