erp-transportistas-v2/orchestration/matrices/MATRIZ-RF-GIRO-MODULOS.yml
Adrian Flores Cortes a3991cd4ea 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>
2026-01-27 02:37:51 -06:00

549 lines
14 KiB
YAML

# 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