# US-MAI005-004: Compilar kit documental

**ID:** US-MAI005-004
**Módulo:** MAI-005 (Despacho)
**Prioridad:** Media
**Story Points:** 5

---

## Historia de Usuario

**Como** despachador
**Quiero** que el sistema compile automáticamente todos los documentos necesarios para el viaje
**Para** asegurar que el operador lleva toda la documentación requerida y evitar retenciones en ruta

---

## Criterios de Aceptación

### CA-001: Compilar documentos automáticamente
**Dado** que un viaje está listo para despachar
**Cuando** accedo al kit documental
**Entonces** el sistema lista todos los documentos requeridos con su estado (disponible/pendiente)

### CA-002: Incluir orden de viaje
**Dado** que el viaje está planificado
**Cuando** compilo el kit
**Entonces** incluye la Orden de Viaje con código QR para identificación rápida

### CA-003: Incluir Carta Porte (si existe)
**Dado** que la Carta Porte fue generada en MAE-016
**Cuando** compilo el kit
**Entonces** incluye el CFDI Carta Porte con su UUID

### CA-004: Alertar documentos faltantes
**Dado** que faltan documentos obligatorios
**Cuando** reviso el kit
**Entonces** el sistema muestra alertas con los documentos pendientes

### CA-005: Disponible offline en app
**Dado** que el kit está completo
**Cuando** el operador lo descarga en su app
**Entonces** todos los documentos están disponibles sin conexión

### CA-006: Descargar paquete completo
**Dado** que necesito imprimir los documentos
**Cuando** solicito descarga
**Entonces** se genera un ZIP con todos los PDFs del kit

---

## Mockup / UI

```
┌─────────────────────────────────────────────────────────────────┐
│ KIT DOCUMENTAL                                         ✕        │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  Viaje: VJE-0123 | Ruta: CDMX → GDL → AGS                      │
│                                                                 │
│  ─────────────────────────────────────────────────────────────  │
│                                                                 │
│  DOCUMENTOS DEL VIAJE                                           │
│                                                                 │
│  📄 OBLIGATORIOS                                                │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ ✅ Orden de Viaje                                       │   │
│  │    OV-VJE-0123.pdf | 2 páginas | [Ver] [Descargar]     │   │
│  ├─────────────────────────────────────────────────────────┤   │
│  │ ✅ Carta Porte CFDI                                     │   │
│  │    UUID: 6ba7b810-9dad-11d1-80b4-00c04fd430c8          │   │
│  │    CP-VJE-0123.pdf | 4 páginas | [Ver] [Descargar]     │   │
│  ├─────────────────────────────────────────────────────────┤   │
│  │ ✅ Remisión del cliente                                 │   │
│  │    REM-CLI-2026-0891.pdf | [Ver] [Descargar]           │   │
│  ├─────────────────────────────────────────────────────────┤   │
│  │ ⚠️ Factura del cliente                                  │   │
│  │    PENDIENTE - El cliente no ha subido la factura       │   │
│  │    [Subir manualmente] [Omitir con nota]               │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
│  📄 CONDICIONALES (según carga)                                │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ ✅ Permiso de materiales peligrosos                     │   │
│  │    PERM-HAZMAT-2026.pdf | [Ver] [Descargar]            │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
│  📄 INSTRUCCIONES POR PARADA                                   │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ Parada 1: Almacén GDL Centro                            │   │
│  │ • Entregar en andén 5                                   │   │
│  │ • Contacto: Juan Pérez (33) 1234-5678                  │   │
│  │ • Horario: 08:00 - 18:00                               │   │
│  ├─────────────────────────────────────────────────────────┤   │
│  │ Parada 2: Bodega AGS                                    │   │
│  │ • Requiere cita previa (ya agendada)                   │   │
│  │ • Contacto: María López (449) 876-5432                 │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
│  ─────────────────────────────────────────────────────────────  │
│                                                                 │
│  ⚠ 1 documento pendiente                                       │
│                                                                 │
│  [Descargar ZIP]  [Enviar a app]  [Imprimir todo]              │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘
```

---

## Tipos de Documentos

| Tipo | Obligatorio | Fuente | Generación |
|------|-------------|--------|------------|
| Orden de Viaje | Siempre | Sistema | Automática |
| Carta Porte | Siempre | MAE-016 | Automática |
| Remisión | Por cliente | Cliente/Sistema | Manual/Auto |
| Factura | Por cliente | Cliente | Manual |
| Permiso Hazmat | Si aplica | Sistema | Referencia |
| Permiso Sobredimensión | Si aplica | SCT | Manual |
| Instrucciones | Siempre | Embarque | Automática |

---

## Validaciones de Documentos

| Código | Validación | Acción si falla |
|--------|------------|-----------------|
| DOC_001 | Orden de Viaje presente | Bloquear despacho |
| DOC_002 | Carta Porte si viaje federal | Bloquear despacho |
| DOC_003 | Permisos especiales si carga lo requiere | Bloquear despacho |
| DOC_004 | Factura del cliente | Advertencia |
| DOC_005 | Instrucciones de entrega | Advertencia |

---

## Notas Técnicas

- Tabla: `documentos_viaje`
- Generación de OV desde vista `v_orden_viaje`
- Integración con MAE-016 para obtener Carta Porte
- ZIP generado con JSZip o similar
- Sincronización a app móvil via API dedicada
- Cache de documentos para acceso offline

---

## Definición de Done

- [ ] Compilación automática de documentos
- [ ] Generación de Orden de Viaje con QR
- [ ] Integración con Carta Porte (MAE-016)
- [ ] Alertas de documentos faltantes
- [ ] Descarga de ZIP con todos los PDFs
- [ ] Sincronización a app móvil
- [ ] Validaciones bloqueantes vs advertencias
- [ ] Tests de compilación y generación