# MAI-005: Despacho

**Version:** 1.0.0
**Fecha:** 2026-01-27
**Estado:** Diseño
**Prioridad:** P0 (Crítico - Workflow + NOM-068 Compliance)

---

## Descripción General

El módulo de Despacho es responsable de la liberación operativa del viaje, asegurando que todos los checklists, documentos, sellos y evidencias estén completos antes de que la unidad salga a ruta.

**Problema que resuelve:**
- Viajes que salen sin inspección pre-viaje (riesgo de accidentes)
- Falta de control de sellos de seguridad
- Documentación incompleta que genera problemas en ruta
- Incumplimiento de NOM-068 (condiciones físico-mecánicas)

---

## Objetivos del Módulo

1. **Checklist Pre-Viaje:** Inspección documentada según NOM-068
2. **Control de Sellos:** Registro y evidencia de sellos de seguridad
3. **Evidencias de Carga:** Fotos del estado de la carga antes de salir
4. **Kit Documental:** Compilar todos los documentos necesarios
5. **Liberación Oficial:** Evento de "gate out" con timestamp y responsable

---

## Alcance Funcional

### Incluido

- Checklist de inspección pre-viaje parametrizable
- Control de sellos (asignación, fotos, verificación)
- Captura de evidencias de carga
- Compilación de kit documental digital
- Registro de salida (gate out)
- Validaciones de despacho
- Notificación de salida

### Excluido

- Planeación y asignación (MAI-004)
- Tracking en ruta (MAI-006)
- Generación de Carta Porte (MAE-016)

---

## Actores

| Actor | Rol en el módulo |
|-------|------------------|
| Operador | Ejecuta checklist, registra sellos, toma evidencias |
| Despachador | Valida checklist, autoriza salida |
| Vigilancia | Confirma salida física (gate out) |
| Sistema | Valida documentación, genera alertas |

---

## Flujo Principal

```
VIAJE PLANIFICADO
      │
      ▼
┌─────────────────────────────────────────┐
│ 1. CHECKLIST PRE-VIAJE                  │
│    - Operador inspecciona unidad        │
│    - Registra estado de cada punto      │
│    - Adjunta fotos si hay observaciones │
│    - Firma digital del checklist        │
└────────────────────┬────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────┐
│ 2. CONTROL DE SELLOS                    │
│    - Asignar números de sello           │
│    - Tomar foto de cada sello colocado  │
│    - Registrar ubicación del sello      │
└────────────────────┬────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────┐
│ 3. EVIDENCIAS DE CARGA                  │
│    - Fotos de la carga                  │
│    - Peso en báscula (si aplica)        │
│    - Firma de almacén                   │
└────────────────────┬────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────┐
│ 4. KIT DOCUMENTAL                       │
│    - Orden de viaje                     │
│    - Carta porte (si ya generada)       │
│    - Remisión/factura del cliente       │
│    - Permisos especiales                │
│    - Instrucciones de entrega           │
└────────────────────┬────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────┐
│ 5. VALIDACIÓN DE DESPACHO               │
│    ✓ Checklist completo                 │
│    ✓ Sellos registrados                 │
│    ✓ Documentos completos               │
│    ✓ Sin bloqueos de unidad/operador    │
└────────────────────┬────────────────────┘
                     │
              ┌──────┴──────┐
              │             │
              ▼             ▼
         [APROBADO]    [BLOQUEADO]
              │             │
              ▼             ▼
┌─────────────────┐  ┌─────────────────┐
│ 6. GATE OUT     │  │ Resolver y      │
│    - Timestamp  │  │ reintentar      │
│    - GPS        │  │                 │
│    - Responsable│  │                 │
└────────┬────────┘  └─────────────────┘
         │
         ▼
┌─────────────────────────────────────────┐
│         VIAJE DESPACHADO                │
│    → Inicia Tracking (MAI-006)          │
└─────────────────────────────────────────┘
```

---

## Datos del Módulo

### Entidades Principales

| Entidad | Descripción | Estado |
|---------|-------------|--------|
| ChecklistPreViaje | Inspección de unidad | NO IMPLEMENTADA |
| ItemChecklist | Puntos de inspección | NO IMPLEMENTADA |
| SelloViaje | Registro de sellos | NO IMPLEMENTADA |
| EvidenciaCarga | Fotos de la carga | NO IMPLEMENTADA |
| DespachoViaje | Registro de liberación | NO IMPLEMENTADA |

### Campos Clave Checklist

| Campo | Tipo | Obligatorio | Descripción |
|-------|------|-------------|-------------|
| viaje_id | UUID | Sí | Viaje asociado |
| tipo_checklist | ENUM | Sí | PRE_VIAJE, POST_VIAJE |
| operador_id | UUID | Sí | Quien ejecuta |
| fecha_ejecucion | TIMESTAMP | Sí | Cuándo se ejecutó |
| firma_operador | TEXT | Sí | Firma digital |
| status | ENUM | Sí | EN_PROCESO, APROBADO, RECHAZADO |
| items | JSONB | Sí | Detalle de puntos inspeccionados |

---

## Requerimientos Funcionales

Ver archivo: [REQUERIMIENTOS.md](./REQUERIMIENTOS.md)

---

## Compliance NOM-068

El módulo debe cumplir con NOM-068-SCT-2-2014:

- **Checklist parametrizable** según tipo de vehículo
- **Puntos de inspección** según norma (llantas, frenos, luces, etc.)
- **Evidencia fotográfica** de condiciones
- **Bloqueo de salida** si hay fallas críticas
- **Registro auditable** de inspecciones

---

## Métricas del Módulo

| KPI | Fórmula | Meta |
|-----|---------|------|
| Checklists completados | % viajes con checklist | 100% |
| Tiempo de despacho | Avg(gate_out - inicio_checklist) | <45 min |
| Viajes bloqueados | % viajes con bloqueo | <5% |
| Sellos documentados | % viajes con sellos OK | 100% |

---

## Dependencias

### Este módulo depende de:
- MAI-004 (Planeación): Viajes planificados
- MAI-011 (Flota): Datos de unidad y operador
- MAE-016 (Carta Porte): Documento para kit

### Otros módulos dependen de este:
- MAI-006 (Tracking): Inicia al despachar
- MAI-007 (POD): Viaje debe estar despachado

---

## Historias de Usuario

Ver carpeta: [historias-usuario/](./historias-usuario/)

| US | Título | Prioridad |
|----|--------|-----------|
| US-MAI005-001 | Ejecutar checklist pre-viaje | Alta |
| US-MAI005-002 | Registrar sellos de seguridad | Alta |
| US-MAI005-003 | Capturar evidencias de carga | Alta |
| US-MAI005-004 | Compilar kit documental | Media |
| US-MAI005-005 | Registrar salida (gate out) | Alta |

---

*Módulo MAI-005 - ERP Transportistas - Sistema SIMCO v4.0.0*