erp-transportistas-v2/docs/02-definicion-modulos/MAI-005-despacho

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

---

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/

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