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>
141 lines
5.3 KiB
Markdown
141 lines
5.3 KiB
Markdown
# US-MAI012-001: Registrar carga de combustible
|
|
|
|
**ID:** US-MAI012-001
|
|
**Modulo:** MAI-012 (Combustible y Gastos)
|
|
**Prioridad:** Alta
|
|
**Story Points:** 5
|
|
|
|
---
|
|
|
|
## Historia de Usuario
|
|
|
|
**Como** operador
|
|
**Quiero** registrar cada carga de combustible con evidencia
|
|
**Para** documentar el consumo y facilitar el control de rendimiento
|
|
|
|
---
|
|
|
|
## Criterios de Aceptacion
|
|
|
|
### CA-001: Capturar datos de carga
|
|
**Dado** que cargo combustible durante el viaje
|
|
**Cuando** registro la carga en la app
|
|
**Entonces** capturo: litros, precio, estacion, odometro, tipo combustible
|
|
|
|
### CA-002: Tomar foto del ticket
|
|
**Dado** que necesito comprobar la carga
|
|
**Cuando** registro
|
|
**Entonces** tomo foto del ticket que se sube como evidencia
|
|
|
|
### CA-003: Captura GPS automatica
|
|
**Dado** que estoy en la estacion
|
|
**Cuando** registro la carga
|
|
**Entonces** el sistema captura mi ubicacion automaticamente
|
|
|
|
### CA-004: Validar odometro
|
|
**Dado** que el odometro debe ser consistente
|
|
**Cuando** ingreso el valor
|
|
**Entonces** valida que sea > ultimo odometro registrado
|
|
|
|
### CA-005: Soporte offline
|
|
**Dado** que puedo estar sin conexion
|
|
**Cuando** registro una carga
|
|
**Entonces** se guarda localmente y sincroniza despues
|
|
|
|
---
|
|
|
|
## Mockup / UI
|
|
|
|
```
|
|
+----------------------------------------------------------+
|
|
| REGISTRAR CARGA COMBUSTIBLE X |
|
|
+----------------------------------------------------------+
|
|
| |
|
|
| Unidad: T-1025 | Kenworth T680 |
|
|
| Viaje: VJE-0125 | CDMX -> Monterrey |
|
|
| Odometro anterior: 485,230 km |
|
|
| |
|
|
| ------------------------------------------------------ |
|
|
| |
|
|
| DATOS DE LA CARGA |
|
|
| |
|
|
| Tipo combustible: [DIESEL v] |
|
|
| |
|
|
| Tipo de pago: |
|
|
| (o) Vale de combustible |
|
|
| ( ) Tarjeta empresa |
|
|
| ( ) Efectivo (viatico) |
|
|
| |
|
|
| Numero de vale: [V-2026-01254 ] |
|
|
| |
|
|
| ------------------------------------------------------ |
|
|
| |
|
|
| CANTIDADES |
|
|
| |
|
|
| Litros cargados: [450.500 ] L |
|
|
| Precio por litro: [$24.35 ] |
|
|
| Total: $10,969.68 |
|
|
| |
|
|
| Odometro actual: [485,890 ] km |
|
|
| km desde ultima carga: 660 km |
|
|
| Rendimiento: 1.47 km/L [!] Bajo (esperado: 2.8) |
|
|
| |
|
|
| ------------------------------------------------------ |
|
|
| |
|
|
| ESTACION |
|
|
| |
|
|
| [!] Ubicacion GPS: 25.6866, -100.3161 |
|
|
| |
|
|
| Estacion: [PEMEX Monterrey Norte ] |
|
|
| Direccion: [Av. Lincoln 2500, MTY ] |
|
|
| |
|
|
| ------------------------------------------------------ |
|
|
| |
|
|
| EVIDENCIA |
|
|
| |
|
|
| [Camara] Tomar foto del ticket |
|
|
| |
|
|
| [IMG] ticket_pemex_001.jpg OK |
|
|
| |
|
|
| ------------------------------------------------------ |
|
|
| |
|
|
| [Cancelar] [Guardar Carga] |
|
|
| |
|
|
+----------------------------------------------------------+
|
|
```
|
|
|
|
---
|
|
|
|
## Validaciones
|
|
|
|
| Validacion | Regla | Mensaje Error |
|
|
|------------|-------|---------------|
|
|
| Odometro | > ultimo registrado | Odometro debe ser mayor a 485,230 |
|
|
| Litros | <= capacidad tanque | Excede capacidad del tanque (800L) |
|
|
| GPS | Cerca de estacion | Ubicacion no corresponde a estacion |
|
|
| Foto | Obligatoria | Debe adjuntar foto del ticket |
|
|
| Duplicado | No misma hora/estacion | Ya existe carga similar |
|
|
|
|
---
|
|
|
|
## Notas Tecnicas
|
|
|
|
- Tabla: `fuel.cargas_combustible`
|
|
- Foto a S3 con compresion (max 2MB)
|
|
- GPS con tolerancia de 500m a estacion
|
|
- Calculo rendimiento: km / litros
|
|
- Alerta si rendimiento < 70% esperado
|
|
|
|
---
|
|
|
|
## Definicion de Done
|
|
|
|
- [ ] Formulario de captura completo
|
|
- [ ] Captura GPS automatica
|
|
- [ ] Carga de foto de ticket
|
|
- [ ] Validacion de odometro
|
|
- [ ] Calculo de rendimiento
|
|
- [ ] Alerta si rendimiento bajo
|
|
- [ ] Soporte offline
|
|
- [ ] Tests de captura y validaciones
|