# 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