erp-transportistas-v2/docs/02-definicion-modulos/MAI-012-combustible-gastos
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
..
historias-usuario docs: Add Phase 3 secondary modules specifications (P1/P2/P3) 2026-01-27 02:24:35 -06:00
ENTITIES.md docs: Complete SIMCO documentation for MAI-009 and MAI-012 modules 2026-01-25 14:55:18 -06:00
README.md docs: Add Phase 3 secondary modules specifications (P1/P2/P3) 2026-01-27 02:24:35 -06:00
REQUERIMIENTOS.md docs: Add Phase 3 secondary modules specifications (P1/P2/P3) 2026-01-27 02:24:35 -06:00
RESUMEN-EPICA.md docs: Add Phase 3 secondary modules specifications (P1/P2/P3) 2026-01-27 02:24:35 -06:00

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