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>
8.6 KiB
8.6 KiB
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