rckrdmrd/erp-transportistas-v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
ec43d9c6cd
erp-transportistas-v2/docs/02-definicion-modulos/MAE-018-reportes-kpis/REQUERIMIENTOS.md
Adrian Flores Cortes ec43d9c6cd docs: Add Phase 3 secondary modules specifications (P1/P2/P3) 
Modules documented:
- MAI-003 (OT): README, REQUERIMIENTOS, RESUMEN-EPICA, 10 US
- MAI-006 (Tracking): README, REQUERIMIENTOS, RESUMEN-EPICA
- MAI-008 (Incidencias): 3 US (18 SP)
- MAI-011 (Flota): README, REQUERIMIENTOS, RESUMEN-EPICA
- MAI-012 (Combustible): 3 US (18 SP)
- MAI-013 (Mantenimiento): 3 US (18 SP)
- MAI-014 (Carriers): 3 US (18 SP)
- MAI-015 (Portal): 3 US (18 SP)
- MAE-016 (Carta Porte): 10 US
- MAE-017 (HOS): 3 US (16 SP)
- MAE-018 (Reportes): 3 US (18 SP)

Phase 2+3 complete: 13 modules, 50+ User Stories

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 02:24:35 -06:00

4.2 KiB
Raw Blame History

REQUERIMIENTOS - MAE-018: Reportes y KPIs

Modulo: MAE-018 Fuente: REQ-GIRO-TRANSPORTISTA.md - Seccion 6 Version: 1.0.0

Requerimientos Funcionales

RF-6.1: KPIs Operativos

KPI 1: On-Time Pickup (OTP)

  • Formula: (Pickups a tiempo / Total pickups) × 100
  • Meta tipica: >= 95%
  • Dimension: Por cliente, ruta, operador

KPI 2: On-Time Delivery (OTD)

  • Formula: (Entregas a tiempo / Total entregas) × 100
  • Meta tipica: >= 95%
  • Dimension: Por cliente, ruta, operador

KPI 3: OTIF (On Time In Full)

  • Formula: (Entregas a tiempo Y completas / Total) × 100
  • Meta tipica: >= 92%
  • Considera: Tiempo + cantidad correcta + sin dano

KPI 4: Detention Time

  • Formula: Tiempo en carga/descarga - Tiempo tolerancia
  • Meta tipica: <= 2 horas promedio
  • Impacto: Costos adicionales

Tablas fuente:

  • transport.viajes
  • tracking.eventos_tracking

RF-6.2: KPIs de Costos y Rentabilidad

KPI 5: Costo por Kilometro

  • Formula: Costo total viaje / km recorridos
  • Incluye: Combustible + peajes + viaticos + mantenimiento
  • Dimension: Por unidad, ruta, cliente

KPI 6: Costo por Viaje

  • Formula: Suma de todos los costos del viaje
  • Desglose: Fijos + variables

KPI 7: Margen por Cliente/Ruta

  • Formula: (Ingreso - Costo) / Ingreso × 100
  • Meta tipica: >= 15%
  • Alerta: Si < 10%

Tablas fuente:

  • fuel.cargas_combustible
  • fuel.cruces_peaje
  • fuel.gastos_viaje
  • billing.facturas

RF-6.3: KPIs de Flota

KPI 8: Disponibilidad de Flota

  • Formula: (Unidades disponibles / Total unidades) × 100
  • Excluye: En taller, bloqueadas
  • Meta tipica: >= 85%

KPI 9: MTBF (Mean Time Between Failures)

  • Formula: Tiempo total operacion / Numero de fallas
  • Dimension: Por tipo de unidad

KPI 10: MTTR (Mean Time To Repair)

  • Formula: Tiempo total reparacion / Numero de OTs
  • Meta tipica: <= 24 horas

Tablas fuente:

  • fleet.unidades
  • maintenance.ordenes_trabajo

RF-6.4: KPIs de Combustible

KPI: Rendimiento km/litro

  • Formula: km recorridos / litros consumidos
  • Dimension: Por unidad, operador
  • Comparar vs esperado

KPI: Costo Combustible / Ingreso

  • Formula: (Gasto combustible / Ingreso) × 100
  • Meta tipica: <= 30%

Tablas fuente:

  • fuel.cargas_combustible
  • fuel.control_rendimiento

RF-6.5: KPIs de Incidencias

KPI: Incidencias por 100 viajes

  • Formula: (Incidencias / Viajes) × 100
  • Dimension: Por tipo, cliente, operador
  • Meta tipica: <= 3%

KPI: Costo de Reclamos

  • Formula: Suma de costos por incidencias
  • Dimension: Por periodo, cliente

Tablas fuente:

  • tracking.incidencias
  • tracking.costos_incidencia

RF-6.6: KPIs de Cumplimiento

KPI: Cumplimiento Documental

  • Formula: (Docs vigentes / Docs requeridos) × 100
  • Aplica a: Unidades, operadores, carriers
  • Meta: 100%

KPI: Cumplimiento HOS

  • Formula: (Dias sin exceso / Dias totales) × 100
  • Meta: >= 98%

Tablas fuente:

  • fleet.documentos_unidad
  • compliance.registros_hos

Dashboards Requeridos

Dashboard Ejecutivo

  • KPIs principales con semaforo
  • Tendencias (ultimos 12 meses)
  • Top/Bottom performers
  • Alertas activas

Dashboard Operaciones

  • Viajes en curso
  • OTIF del dia/semana/mes
  • Incidencias pendientes
  • Detention acumulado

Dashboard Flota

  • Disponibilidad actual
  • Unidades en taller
  • Proximos mantenimientos
  • Documentos por vencer

Dashboard Financiero

  • Ingresos vs Costos
  • Margen por cliente
  • Cuentas por cobrar
  • Rentabilidad por ruta

Requerimientos No Funcionales

RNF-001: Performance

  • Dashboards cargan < 5 segundos
  • Precalculo de metricas (vistas materializadas)

RNF-002: Exportacion

  • Excel, PDF, CSV
  • Programacion de envio automatico

RNF-003: Personalizacion

  • Filtros por periodo, cliente, ruta
  • Dashboards personalizables por usuario

Matriz de Trazabilidad

RF KPIs Historias
RF-6.1 OTP, OTD, OTIF, Detention US-MAE018-002
RF-6.2 Costo/km, Margen US-MAE018-001
RF-6.3 Disponibilidad, MTBF, MTTR US-MAE018-002
RF-6.4 km/litro, Costo comb. US-MAE018-002
RF-6.5 Incidencias/100 US-MAE018-002
RF-6.6 Cumplimiento doc, HOS US-MAE018-002

REQUERIMIENTOS MAE-018 - ERP Transportistas v1.0.0