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>
139 lines
4.8 KiB
Markdown
139 lines
4.8 KiB
Markdown
# US-MAI007-005: Cerrar viaje con excepcion justificada
|
||
|
||
**ID:** US-MAI007-005
|
||
**Modulo:** MAI-007 (POD y Cierre)
|
||
**Prioridad:** Media
|
||
**Story Points:** 5
|
||
|
||
---
|
||
|
||
## Historia de Usuario
|
||
|
||
**Como** despachador
|
||
**Quiero** poder cerrar un viaje sin POD completo con una justificacion
|
||
**Para** no bloquear el proceso cuando hay situaciones excepcionales
|
||
|
||
---
|
||
|
||
## Criterios de Aceptacion
|
||
|
||
### CA-001: Opcion de excepcion
|
||
**Dado** que el POD no cumple validaciones
|
||
**Cuando** intento cerrar el viaje
|
||
**Entonces** el sistema ofrece la opcion "Cerrar con excepcion"
|
||
|
||
### CA-002: Motivo obligatorio
|
||
**Dado** que selecciono cerrar con excepcion
|
||
**Cuando** no selecciono un motivo del catalogo
|
||
**Entonces** el sistema no permite continuar
|
||
|
||
### CA-003: Justificacion detallada
|
||
**Dado** que selecciono un motivo de excepcion
|
||
**Cuando** escribo la justificacion detallada (min 20 caracteres)
|
||
**Entonces** puedo proceder con la solicitud de excepcion
|
||
|
||
### CA-004: Aprobacion pendiente
|
||
**Dado** que solicito cierre con excepcion
|
||
**Cuando** completo el formulario
|
||
**Entonces** el viaje queda en estado "EXCEPCION_PENDIENTE" hasta aprobacion
|
||
|
||
### CA-005: Notificacion a supervisor
|
||
**Dado** que hay una excepcion pendiente
|
||
**Cuando** se crea la solicitud
|
||
**Entonces** el supervisor recibe notificacion para aprobar/rechazar
|
||
|
||
---
|
||
|
||
## Catalogo de Motivos
|
||
|
||
| Codigo | Motivo | Descripcion |
|
||
|--------|--------|-------------|
|
||
| EXC-001 | Rechazo en destino | Cliente rechazo la mercancia |
|
||
| EXC-002 | Entrega parcial | Solo se entrego parte de la carga |
|
||
| EXC-003 | Falla dispositivo | No se pudo capturar firma/fotos |
|
||
| EXC-004 | Emergencia | Accidente, robo, desastre natural |
|
||
| EXC-005 | Cambio destino | Cliente solicito entregar en otro lugar |
|
||
| EXC-006 | Otro | Especificar en justificacion |
|
||
|
||
---
|
||
|
||
## Mockup / UI
|
||
|
||
```
|
||
┌─────────────────────────────────────────┐
|
||
│ Cierre con Excepcion - Viaje #12345 │
|
||
├─────────────────────────────────────────┤
|
||
│ │
|
||
│ ⚠ El POD no cumple validaciones: │
|
||
│ ✗ Sin firma capturada │
|
||
│ │
|
||
│ ───────────────────────────────────── │
|
||
│ │
|
||
│ Motivo de excepcion: * │
|
||
│ ┌─────────────────────────────────┐ │
|
||
│ │ Rechazo en destino ▼ │ │
|
||
│ └─────────────────────────────────┘ │
|
||
│ │
|
||
│ Justificacion detallada: * │
|
||
│ ┌─────────────────────────────────┐ │
|
||
│ │ El cliente rechazo la carga │ │
|
||
│ │ por dano visible en 3 cajas. │ │
|
||
│ │ Se levanto acta con fotos. │ │
|
||
│ │ Contacto: Juan Perez, almacen │ │
|
||
│ └─────────────────────────────────┘ │
|
||
│ │
|
||
│ Evidencia adicional: │
|
||
│ [+ Adjuntar foto/documento] │
|
||
│ │
|
||
│ ───────────────────────────────────── │
|
||
│ ℹ Esta solicitud sera enviada a │
|
||
│ supervisor para aprobacion. │
|
||
│ │
|
||
│ [Cancelar] [Enviar Solicitud] │
|
||
│ │
|
||
└─────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## Flujo de Aprobacion
|
||
|
||
```
|
||
SOLICITUD CREADA
|
||
│
|
||
▼
|
||
┌────────────────┐
|
||
│ SUPERVISOR │
|
||
│ revisa │
|
||
└───────┬────────┘
|
||
│
|
||
┌────┴────┐
|
||
│ │
|
||
▼ ▼
|
||
APROBADA RECHAZADA
|
||
│ │
|
||
▼ ▼
|
||
CERRADO PENDIENTE
|
||
(regresar a operador)
|
||
```
|
||
|
||
---
|
||
|
||
## Notas Tecnicas
|
||
|
||
- Excepciones se registran en tabla `excepciones_pod`
|
||
- Notificacion via push notification y email
|
||
- Timeout de aprobacion: 24 horas (escalamiento automatico)
|
||
- Auditoria completa de quien aprobo/rechazo y cuando
|
||
|
||
---
|
||
|
||
## Definicion de Done
|
||
|
||
- [ ] Formulario de excepcion implementado
|
||
- [ ] Catalogo de motivos configurable
|
||
- [ ] Flujo de aprobacion funcional
|
||
- [ ] Notificaciones a supervisor
|
||
- [ ] Auditoria completa
|
||
- [ ] Tests de flujo completo
|