# 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