# 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