# 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*