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

5.6 KiB

Raw Blame History

US-MAE018-001: Dashboard ejecutivo

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

Historia de Usuario

Como director general Quiero ver un dashboard ejecutivo con los KPIs principales Para tener vision del desempeno del negocio en una sola pantalla

Criterios de Aceptacion

CA-001: Ver KPIs principales

Dado que accedo al dashboard Cuando cargo la pagina Entonces veo los KPIs principales con valor actual y meta

CA-002: Semaforo de cumplimiento

Dado que cada KPI tiene una meta Cuando veo el indicador Entonces tiene color verde/amarillo/rojo segun cumplimiento

CA-003: Tendencia historica

Dado que necesito ver evolucion Cuando consulto un KPI Entonces veo grafico de tendencia (ultimos 12 meses)

CA-004: Drill-down

Dado que quiero profundizar Cuando hago clic en un KPI Entonces veo detalle por dimension (cliente, ruta, etc.)

CA-005: Alertas activas

Dado que hay situaciones criticas Cuando veo el dashboard Entonces aparecen alertas que requieren atencion

Mockup / UI

+----------------------------------------------------------+
| DASHBOARD EJECUTIVO - Enero 2026                         |
+----------------------------------------------------------+
|                                                          |
|  +------------------+  +------------------+               |
|  |      OTIF        |  |    Margen        |               |
|  |   [92.5%]   [G]  |  |   [18.2%]   [G]  |               |
|  |   Meta: 92%      |  |   Meta: 15%      |               |
|  |   ^ +1.2% vs mes |  |   v -0.5% vs mes |               |
|  +------------------+  +------------------+               |
|                                                          |
|  +------------------+  +------------------+               |
|  |  Disponibilidad  |  |   Costo/km       |               |
|  |   [87.3%]   [A]  |  |   [$12.45]  [G]  |               |
|  |   Meta: 85%      |  |   Meta: $13.00   |               |
|  |   = igual mes    |  |   v -2.1% vs mes |               |
|  +------------------+  +------------------+               |
|                                                          |
|  +------------------+  +------------------+               |
|  |  Incidencias     |  |  On-Time Del.    |               |
|  |   [2.8%]    [G]  |  |   [94.2%]   [A]  |               |
|  |   Meta: <=3%     |  |   Meta: 95%      |               |
|  |   v -0.3% vs mes |  |   ^ +0.8% vs mes |               |
|  +------------------+  +------------------+               |
|                                                          |
|  [G] = Verde (cumple)  [A] = Amarillo (cerca)           |
|  [R] = Rojo (no cumple)                                 |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  TENDENCIA OTIF (12 MESES)                              |
|                                                          |
|  100%|                                                  |
|   95%|  ----*----*----*----*----*----*----*----*--      |
|   90%|                         *              *         |
|   85%|                              *                   |
|      +--+--+--+--+--+--+--+--+--+--+--+--+              |
|       Feb Mar Abr May Jun Jul Ago Sep Oct Nov Dic Ene  |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  ALERTAS ACTIVAS                                        |
|                                                          |
|  [!] 3 unidades con mantenimiento vencido              |
|  [!] Cliente CEMEX: OTIF < 90% (investigar)            |
|  [!] Carrier "Fletes Bajio" en categoria D             |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  RESUMEN FINANCIERO                                     |
|                                                          |
|  Ingresos mes:      $4,250,000                         |
|  Costos mes:        $3,478,000                         |
|  Margen bruto:        $772,000 (18.2%)                 |
|                                                          |
|  Viajes completados:   380                             |
|  Km recorridos:      285,000                           |
|                                                          |
+----------------------------------------------------------+

KPIs del Dashboard Ejecutivo

KPI	Formula	Meta	Semaforo
OTIF	Entregas OK / Total	92%	G>=92, A>=88, R<88
Margen	(Ing-Costo)/Ing	15%	G>=15, A>=12, R<12
Disponibilidad	Unid OK / Total	85%	G>=85, A>=80, R<80
Costo/km	Costo total / km	$13	G<=13, A<=15, R>15
Incidencias	Inc / Viajes	3%	G<=3, A<=5, R>5
On-Time Delivery	Entregas a tiempo	95%	G>=95, A>=90, R<90

Notas Tecnicas

Vistas materializadas para performance
Job nocturno calcula KPIs del dia anterior
Cache de 15 minutos para dashboard
Chart.js o Recharts para graficos
Drill-down abre modal con detalle

Definicion de Done

6 KPIs principales con semaforo
Comparativo vs meta y vs mes anterior
Grafico de tendencia 12 meses
Drill-down por dimension
Seccion de alertas activas
Resumen financiero
Carga < 5 segundos
Tests de calculo de KPIs

5.6 KiB Raw Blame History