erp-transportistas-v2/orchestration/matrices/MATRIZ-RF-GENERICOS-GIRO.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

331 lines
8.1 KiB
YAML

# 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