erp-transportistas-v2/docs/02-definicion-modulos/MAE-018-reportes-kpis/historias-usuario/US-MAE018-002.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

7.7 KiB

US-MAE018-002: KPIs operativos y de flota

ID: US-MAE018-002 Modulo: MAE-018 (Reportes y KPIs) Prioridad: Alta Story Points: 5


Historia de Usuario

Como jefe de operaciones Quiero dashboards especializados por area Para monitorear el desempeno detallado de operaciones y flota


Criterios de Aceptacion

CA-001: Dashboard de operaciones

Dado que soy jefe de operaciones Cuando accedo a mi dashboard Entonces veo KPIs de OTIF, tiempos, viajes activos

CA-002: Dashboard de flota

Dado que soy jefe de flota Cuando accedo a mi dashboard Entonces veo disponibilidad, mantenimiento, documentos

CA-003: Filtros por periodo

Dado que quiero analizar un periodo especifico Cuando aplico filtros Entonces los datos se recalculan para ese periodo

CA-004: Comparativo entre dimensiones

Dado que quiero comparar rendimiento Cuando consulto un KPI Entonces puedo ver ranking (top/bottom performers)

CA-005: Exportar datos

Dado que necesito los datos fuera del sistema Cuando exporto Entonces descargo Excel/CSV con el detalle


Mockup / UI

Dashboard Operaciones

+----------------------------------------------------------+
| DASHBOARD OPERACIONES - Enero 2026                       |
+----------------------------------------------------------+
|                                                          |
|  Filtros: [Este mes v] [Todos los clientes v] [Aplicar] |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  VIAJES ACTIVOS AHORA                                   |
|                                                          |
|  +-------------+  +-------------+  +-------------+       |
|  |     12      |  |      3      |  |      2      |       |
|  | En transito |  |  Cargando   |  |  Descargando|       |
|  +-------------+  +-------------+  +-------------+       |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  KPIs DEL PERIODO                                       |
|                                                          |
|  | KPI              | Actual | Meta  | Tendencia |      |
|  |------------------|--------|-------|-----------|      |
|  | On-Time Pickup   | 96.2%  | 95%   | [G] ^     |      |
|  | On-Time Delivery | 94.2%  | 95%   | [A] ^     |      |
|  | OTIF             | 92.5%  | 92%   | [G] ^     |      |
|  | Detention prom.  | 1.8 h  | 2.0 h | [G] v     |      |
|  | Viajes/dia       | 12.3   | 12.0  | [G] =     |      |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  TOP 5 CLIENTES POR VOLUMEN                             |
|                                                          |
|  | Cliente      | Viajes | OTIF  | Margen |             |
|  |--------------|--------|-------|--------|             |
|  | Liverpool    |   45   | 95.5% | 19.2%  |             |
|  | CEMEX        |   38   | 88.2% | 15.1%  | [!]         |
|  | Bimbo        |   32   | 94.1% | 17.8%  |             |
|  | Walmart      |   28   | 93.2% | 14.5%  |             |
|  | Soriana      |   25   | 96.0% | 18.5%  |             |
|                                                          |
|  [!] CEMEX por debajo de meta OTIF                     |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  INCIDENCIAS DEL PERIODO                                |
|                                                          |
|  Total: 11 incidencias (2.9%)                          |
|                                                          |
|       Retrasos ████████ 5                              |
|          Danos ████ 3                                  |
|      Faltantes ██ 2                                    |
|          Otros █ 1                                     |
|                                                          |
|  [Ver detalle de incidencias]                          |
|                                                          |
+----------------------------------------------------------+

Dashboard Flota

+----------------------------------------------------------+
| DASHBOARD FLOTA - 27 enero 2026                          |
+----------------------------------------------------------+
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  DISPONIBILIDAD ACTUAL                                  |
|                                                          |
|       Disponible ██████████████████████████████ 28 (80%)|
|         En viaje ████████ 4 (11%)                      |
|        En taller ██ 2 (6%)                             |
|        Bloqueada █ 1 (3%)                              |
|                                                          |
|  Total unidades: 35                                    |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  KPIs DE MANTENIMIENTO                                  |
|                                                          |
|  | KPI           | Actual  | Meta   | Estado   |       |
|  |---------------|---------|--------|----------|       |
|  | MTBF          | 45 dias | 30 dias| [G]      |       |
|  | MTTR          | 18 hrs  | 24 hrs | [G]      |       |
|  | Cumpl. prev.  | 92%     | 95%    | [A]      |       |
|  | Costo/km mto. | $0.85   | $1.00  | [G]      |       |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  PROXIMOS MANTENIMIENTOS (7 dias)                       |
|                                                          |
|  | Unidad  | Servicio        | Fecha     | km falt.|   |
|  |---------|-----------------|-----------|---------|   |
|  | T-1025  | Cambio aceite   | 28-ene    | 150 km  |   |
|  | T-1030  | Verificacion    | 30-ene    | -       |   |
|  | T-1018  | Service mayor   | 31-ene    | 900 km  |   |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  DOCUMENTOS POR VENCER (30 dias)                        |
|                                                          |
|  | Unidad  | Documento       | Vence     |             |
|  |---------|-----------------|-----------|             |
|  | T-1015  | Verificacion    | 28-feb    |             |
|  | T-1022  | Poliza seguro   | 15-feb    |             |
|  | OP-0032 | Licencia fed.   | 10-feb    |             |
|                                                          |
+----------------------------------------------------------+

Notas Tecnicas

  • Tablas fuente de cada modulo
  • Vistas materializadas por periodo
  • Actualizacion cada 15 minutos
  • Exportacion con libreria xlsx

Definicion de Done

  • Dashboard de operaciones
  • Dashboard de flota
  • KPIs con semaforo y tendencia
  • Ranking de performers
  • Filtros por periodo
  • Exportacion Excel/CSV
  • Tests de calculos