7f45eb6383
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>
191 lines
8.6 KiB
Markdown
191 lines
8.6 KiB
Markdown
# 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*
|