# 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