From a3991cd4ea2c5aaf7d7fcff799429d98449130ab Mon Sep 17 00:00:00 2001 From: Adrian Flores Cortes Date: Tue, 27 Jan 2026 02:37:51 -0600 Subject: [PATCH] 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 --- orchestration/matrices/MATRIZ-DDL-RF.yml | 598 ++++++++++++++++++ orchestration/matrices/MATRIZ-MODULOS-US.yml | 496 +++++++++++++++ .../matrices/MATRIZ-RF-GENERICOS-GIRO.yml | 330 ++++++++++ .../matrices/MATRIZ-RF-GIRO-MODULOS.yml | 548 ++++++++++++++++ 4 files changed, 1972 insertions(+) create mode 100644 orchestration/matrices/MATRIZ-DDL-RF.yml create mode 100644 orchestration/matrices/MATRIZ-MODULOS-US.yml create mode 100644 orchestration/matrices/MATRIZ-RF-GENERICOS-GIRO.yml create mode 100644 orchestration/matrices/MATRIZ-RF-GIRO-MODULOS.yml diff --git a/orchestration/matrices/MATRIZ-DDL-RF.yml b/orchestration/matrices/MATRIZ-DDL-RF.yml new file mode 100644 index 0000000..482c32f --- /dev/null +++ b/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 diff --git a/orchestration/matrices/MATRIZ-MODULOS-US.yml b/orchestration/matrices/MATRIZ-MODULOS-US.yml new file mode 100644 index 0000000..ade1efc --- /dev/null +++ b/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 diff --git a/orchestration/matrices/MATRIZ-RF-GENERICOS-GIRO.yml b/orchestration/matrices/MATRIZ-RF-GENERICOS-GIRO.yml new file mode 100644 index 0000000..c4824dc --- /dev/null +++ b/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 diff --git a/orchestration/matrices/MATRIZ-RF-GIRO-MODULOS.yml b/orchestration/matrices/MATRIZ-RF-GIRO-MODULOS.yml new file mode 100644 index 0000000..5aaaf3d --- /dev/null +++ b/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