# US-MAI012-002: Controlar rendimiento y detectar anomalias

**ID:** US-MAI012-002
**Modulo:** MAI-012 (Combustible y Gastos)
**Prioridad:** Alta
**Story Points:** 8

---

## Historia de Usuario

**Como** administrador de control de combustible
**Quiero** monitorear el rendimiento de las unidades y detectar anomalias
**Para** prevenir fugas, fraude y optimizar costos

---

## Criterios de Aceptacion

### CA-001: Dashboard de rendimiento
**Dado** que necesito vision general
**Cuando** accedo al modulo de combustible
**Entonces** veo dashboard con rendimiento de toda la flota

### CA-002: Comparativo esperado vs real
**Dado** que cada unidad tiene rendimiento esperado
**Cuando** consulto una unidad
**Entonces** veo comparativo con desviacion porcentual

### CA-003: Alertas automaticas
**Dado** que hay umbrales de anomalia definidos
**Cuando** una carga excede el umbral
**Entonces** se genera alerta automatica

### CA-004: Investigar anomalias
**Dado** que hay una alerta de posible fraude
**Cuando** la investigo
**Entonces** veo detalle de cargas, ubicaciones, timeline

### CA-005: Reportes por periodo
**Dado** que necesito analisis historico
**Cuando** genero reporte
**Entonces** veo tendencias de rendimiento por unidad/operador

---

## Mockup / UI

### Dashboard de Rendimiento

```
+----------------------------------------------------------+
| CONTROL DE COMBUSTIBLE - Dashboard                       |
+----------------------------------------------------------+
|                                                          |
|  Periodo: [Enero 2026    v]   [Actualizar]              |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  RESUMEN FLOTA                                          |
|                                                          |
|  +-------------+  +-------------+  +-------------+      |
|  | 35 Unidades |  | 2.45 km/L   |  | $1.8M       |      |
|  | Activas     |  | Prom. Rend. |  | Gasto Comb. |      |
|  +-------------+  +-------------+  +-------------+      |
|                                                          |
|  +-------------+  +-------------+  +-------------+      |
|  | 5 Alertas   |  | 2 Criticas  |  | 98.2%       |      |
|  | Pendientes  |  | Por revisar |  | Comprobado  |      |
|  +-------------+  +-------------+  +-------------+      |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  UNIDADES CON ANOMALIA                                  |
|                                                          |
|  | Unidad  | Rend.Real | Esperado | Desv. | Alerta    ||
|  |---------|-----------|----------|-------|-----------|
|  | T-1025  |   1.47    |   2.80   | -47%  | CRITICA   ||
|  | T-1032  |   2.10    |   2.80   | -25%  | ALTA      ||
|  | R-0089  |   1.95    |   2.50   | -22%  | MEDIA     ||
|                                                          |
|  [Ver todas las unidades]                               |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  RENDIMIENTO POR UNIDAD (Top 10 / Bottom 10)           |
|                                                          |
|       T-1015 ████████████████████████ 3.2 km/L         |
|       T-1018 ███████████████████████ 3.1 km/L          |
|       T-1022 ██████████████████████ 3.0 km/L           |
|       ...                                               |
|       T-1032 ████████████ 2.1 km/L [!]                 |
|       T-1025 ████████ 1.5 km/L [!]                     |
|                                                          |
+----------------------------------------------------------+
```

### Detalle de Anomalia

```
+----------------------------------------------------------+
| ALERTA: Bajo Rendimiento - T-1025                     X  |
+----------------------------------------------------------+
|                                                          |
|  Unidad: T-1025 | Kenworth T680                         |
|  Operador: Juan Perez Garcia                            |
|  Periodo: 20-ene a 27-ene-2026                          |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  INDICADORES                                            |
|                                                          |
|  Rendimiento real:    1.47 km/L                        |
|  Rendimiento esperado: 2.80 km/L                        |
|  Desviacion:          -47.5%   [!!! CRITICO]           |
|                                                          |
|  km Recorridos:       2,310 km                         |
|  Litros consumidos:   1,571 L                          |
|  Costo total:         $38,253.85                       |
|  Costo esperado:      $20,063.00                       |
|  Sobrecosto:          $18,190.85                       |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  CARGAS EN EL PERIODO                                   |
|                                                          |
|  | Fecha   | Estacion      | Litros | GPS      | Foto ||
|  |---------|---------------|--------|----------|------||
|  | 21-ene  | PEMEX Qro     | 450 L  | [OK]     | [Ver]||
|  | 22-ene  | PEMEX SLP     | 380 L  | [OK]     | [Ver]||
|  | 24-ene  | PEMEX MTY     | 420 L  | [!]      | [Ver]||
|  | 26-ene  | PEMEX MTY     | 321 L  | [OK]     | [Ver]||
|                                                          |
|  [!] Carga del 24-ene: GPS a 8km de estacion           |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  MAPA DE CARGAS                                         |
|                                                          |
|  [Mapa mostrando ruta vs ubicaciones de carga]         |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  POSIBLES CAUSAS                                        |
|                                                          |
|  [x] Fuga/robo de combustible                          |
|  [ ] Falla mecanica (inyectores, bomba)                |
|  [ ] Ruta ineficiente                                  |
|  [ ] Carga pesada / condiciones adversas               |
|  [ ] Ticket alterado                                   |
|                                                          |
|  Accion: [Enviar a taller para revision       v]       |
|                                                          |
|  Comentario:                                           |
|  [Se sospecha de robo. Unidad a revision mecanic...  ]|
|                                                          |
|  [Cerrar sin accion]                [Crear tarea]      |
|                                                          |
+----------------------------------------------------------+
```

---

## Tipos de Alerta

| Codigo | Descripcion | Umbral | Accion |
|--------|-------------|--------|--------|
| CONSUMO_EXCESIVO | Rendimiento muy bajo | < 70% esperado | Investigar |
| CARGA_FUERA_RUTA | GPS lejos de ruta | > 5 km | Rechazar |
| CARGA_DUPLICADA | Misma estacion/hora | < 2 horas | Bloquear |
| TANQUE_EXCEDIDO | Mas de capacidad | > 100% | Bloquear |
| HORARIO_INUSUAL | Carga en madrugada | 2am-5am | Revisar |

---

## Notas Tecnicas

- Tabla: `fuel.control_rendimiento`
- Tabla: `fuel.alertas_fraude`
- Job diario calcula rendimiento
- Notificaciones push/email por alerta
- Dashboard con graficas Recharts

---

## Definicion de Done

- [ ] Dashboard de rendimiento de flota
- [ ] Comparativo esperado vs real
- [ ] Sistema de alertas automaticas
- [ ] Detalle de anomalia con evidencias
- [ ] Mapa de cargas vs ruta
- [ ] Reportes por periodo
- [ ] Notificaciones por severidad
- [ ] Tests de deteccion de anomalias