ec43d9c6cd
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>
196 lines
8.4 KiB
Markdown
196 lines
8.4 KiB
Markdown
# 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
|