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>
8.4 KiB
8.4 KiB
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