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

2.7 KiB

Raw Permalink Blame History

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

Registrar cargas de combustible con evidencias
Controlar rendimiento real vs esperado por unidad
Detectar anomalias y posibles fugas/fraude
Gestionar peajes y gastos varios
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

2.7 KiB Raw Permalink Blame History