erp-transportistas-v2/docs/02-definicion-modulos/MAI-012-combustible-gastos/README.md
Adrian Flores Cortes ec43d9c6cd docs: Add Phase 3 secondary modules specifications (P1/P2/P3)
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>
2026-01-27 02:24:35 -06:00

99 lines
2.7 KiB
Markdown

# MAI-012: Combustible y Gastos de Viaje
**Modulo:** MAI-012
**Nombre:** Combustible y Gastos de Viaje
**Prioridad:** P2
**Estado:** Especificado
---
## Descripcion General
Modulo para control de combustible, peajes y gastos variables de viaje. Incluye registro de cargas, control de rendimiento, deteccion de anomalias/fraude y liquidacion de viaticos.
---
## Objetivos
1. Registrar cargas de combustible con evidencias
2. Controlar rendimiento real vs esperado por unidad
3. Detectar anomalias y posibles fugas/fraude
4. Gestionar peajes y gastos varios
5. Liquidar anticipos de viaticos
---
## Actores
| Actor | Rol en el Modulo |
|-------|------------------|
| Operador | Registra cargas y gastos |
| Control Combustible | Aprueba y analiza rendimientos |
| Despachador | Entrega anticipos |
| Administracion | Aprueba gastos y detecta anomalias |
---
## Dependencias
| Depende de | Para |
|------------|------|
| MAI-011 (Flota) | Datos de unidades |
| MAI-006 (Tracking) | Km recorridos reales |
| MAI-003 (OT) | Viajes asociados |
| MAI-010 (Liquidaciones) | Viaticos y deducciones |
---
## Entidades del Modulo
| Entidad | Tabla | Descripcion |
|---------|-------|-------------|
| CargaCombustible | fuel.cargas_combustible | Cargas de combustible |
| CrucePeaje | fuel.cruces_peaje | Cruces de casetas |
| GastoViaje | fuel.gastos_viaje | Gastos varios |
| AnticipoViatico | fuel.anticipos_viaticos | Anticipos de viaticos |
| ControlRendimiento | fuel.control_rendimiento | Control de rendimiento |
---
## Flujo Principal
```
Viaje asignado → Solicitud anticipo → Entrega efectivo →
Cargas combustible → Peajes → Gastos varios →
Cierre viaje → Comprobacion gastos → Liquidacion
```
---
## Alertas Antifraude
| Alerta | Descripcion | Accion |
|--------|-------------|--------|
| Consumo excesivo | Rendimiento < 70% esperado | Investigar |
| Carga fuera de ruta | GPS fuera de corredor | Rechazar |
| Carga duplicada | Misma hora/estacion | Bloquear |
| Ticket alterado | OCR detecta alteracion | Revisar |
| Frecuencia anomala | Muchas cargas en poco tiempo | Alertar |
---
## Estructura de Archivos
```
MAI-012-combustible-gastos/
├── README.md <- Este archivo
├── ENTITIES.md <- Entidades (existente)
├── REQUERIMIENTOS.md <- RF detallados
├── RESUMEN-EPICA.md <- Vision de negocio
└── historias-usuario/
├── US-MAI012-001.md <- Registrar carga combustible
├── US-MAI012-002.md <- Controlar rendimiento
└── US-MAI012-003.md <- Liquidar anticipo viaticos
```
---
*MAI-012 Combustible y Gastos - ERP Transportistas v1.0.0*