Adrian Flores Cortes 7f45eb6383 docs(modulos): MAI-007 POD y Cierre - Especificacion completa

Nuevo modulo P0 critico especificado:
- README.md: Vision general, alcance, actores, flujo
- REQUERIMIENTOS.md: 4 RF (4.7.1-4.7.4), RNF, validaciones
- RESUMEN-EPICA.md: Valor de negocio, criterios exito, 31 SP

User Stories (5):
- US-MAI007-001: Capturar firma digital (8 SP)
- US-MAI007-002: Registrar tiempos reales (5 SP)
- US-MAI007-003: Adjuntar fotos evidencia (5 SP)
- US-MAI007-004: Validar POD antes de cierre (8 SP)
- US-MAI007-005: Cerrar con excepcion (5 SP)

Este modulo es bloqueante para:
- MAI-009 (Facturacion)
- MAI-010 (Liquidaciones)
- MAE-016 (Carta Porte)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-27 01:33:03 -06:00

8.6 KiB

Raw Permalink Blame History

RESUMEN-EPICA.md - MAI-007: POD y Cierre Operativo

Codigo: MAI-007 Nombre: POD y Cierre Operativo Version: 1.0.0 Fecha: 2026-01-27

Valor de Negocio

Problema

Actualmente las empresas transportistas enfrentan:

Disputas con clientes por falta de evidencia de entrega
Retrasos en facturacion por documentacion incompleta
Perdida de ingresos por no documentar detention time
Imposibilidad de calcular rentabilidad real por viaje

Solucion

Un sistema robusto de captura de POD que:

Provee evidencia digital irrefutable de entrega
Automatiza el registro de tiempos para recargos
Cierra operativamente el viaje para facturacion inmediata
Calcula rentabilidad preliminar al cerrar

Beneficios Esperados

Beneficio	Metrica	Impacto
Reduccion disputas	-80% reclamos sin evidencia	Ahorro legal
Facturacion rapida	-3 dias ciclo facturacion	Flujo de caja
Recargos detention	+15% captura detention	Ingresos
Visibilidad costos	100% viajes con rentabilidad	Decisiones

Actores y Stakeholders

Usuarios Primarios

Actor	Responsabilidad	Frecuencia
Operador	Captura POD, registra tiempos	Cada entrega
Despachador	Valida POD, aprueba excepciones	Continuo
Supervisor	Autoriza cierres especiales	Bajo demanda

Usuarios Secundarios

Actor	Interes
Facturacion	Usa POD para emitir facturas
Atencion Cliente	Consulta POD para responder dudas
Gerencia	Revisa metricas de entrega

Flujo Principal

┌─────────────────────────────────────────────────────────────────┐
│                    VIAJE EN DESTINO                              │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│ 1. REGISTRO ARRIBO                                               │
│    - Automatico: Geocerca detecta unidad en destino             │
│    - Manual: Operador registra en app                           │
│    - Sistema: Timestamp + coordenadas                           │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│ 2. DESCARGA                                                      │
│    - Operador marca inicio descarga                              │
│    - Operador marca fin descarga                                 │
│    - Sistema: Calcula duracion, compara vs SLA                  │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│ 3. CAPTURA POD                                                   │
│    - Operador captura firma digital en pantalla                 │
│    - Operador ingresa nombre receptor                           │
│    - Operador toma fotos (opcional)                             │
│    - Operador escanea documento firmado (opcional)              │
│    - Sistema: Valida datos minimos                              │
└─────────────────────────────────────────────────────────────────┘
                              │
                    ┌─────────┴─────────┐
                    │                   │
                    ▼                   ▼
         ┌──────────────────┐  ┌──────────────────┐
         │ POD COMPLETO     │  │ POD INCOMPLETO   │
         │                  │  │                  │
         │ Firma OK         │  │ Falta firma o    │
         │ Receptor OK      │  │ receptor         │
         └────────┬─────────┘  └────────┬─────────┘
                  │                     │
                  │                     ▼
                  │           ┌──────────────────┐
                  │           │ EXCEPCION        │
                  │           │                  │
                  │           │ Motivo + Notas   │
                  │           │ Enviar a aprobar │
                  │           └────────┬─────────┘
                  │                    │
                  ▼                    ▼
┌─────────────────────────────────────────────────────────────────┐
│ 4. CIERRE VIAJE                                                  │
│    - Sistema: Congela costos                                     │
│    - Sistema: Calcula rentabilidad                               │
│    - Sistema: Cambia estado a CERRADO                           │
│    - Sistema: Notifica a facturacion                            │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                    LISTO PARA FACTURAR                          │
└─────────────────────────────────────────────────────────────────┘

Criterios de Exito

Funcionales

Operador puede capturar POD completo en <2 minutos
Sistema funciona offline y sincroniza al reconectar
Excepciones requieren aprobacion de supervisor
Cierre calcula rentabilidad automaticamente

Tecnicos

Fotos comprimidas a <500KB
Firma almacenada como imagen PNG
Sincronizacion en <30 segundos con conexion
Logs de auditoria completos

Negocio

98% de viajes con POD capturado
<5% de POD con excepciones
Facturacion dentro de 24h del cierre
100% viajes con rentabilidad calculada

Riesgos y Mitigaciones

Riesgo	Probabilidad	Impacto	Mitigacion
Operador sin conectividad	Alta	Alto	Modo offline robusto
Fotos muy pesadas	Media	Medio	Compresion automatica
Firma ilegible	Media	Medio	Validacion de trazos minimos
Rechazo de cierre sin POD	Baja	Alto	Flujo de excepciones

Dependencias

Prerequisitos

MAI-005 (Despacho): Viaje despachado
MAI-006 (Tracking): Geocercas configuradas
MAI-011 (Flota): Operador asignado

Habilita

MAI-009 (Facturacion): Requiere POD para facturar
MAI-010 (Liquidaciones): Requiere cierre para liquidar
MAE-016 (Carta Porte): Expediente completo

Story Points Estimados

Historia	Complejidad	SP
US-MAI007-001	Alta	8
US-MAI007-002	Media	5
US-MAI007-003	Media	5
US-MAI007-004	Alta	8
US-MAI007-005	Media	5
Total		31

Epica MAI-007 - ERP Transportistas - Sistema SIMCO v4.0.0

8.6 KiB Raw Permalink Blame History