9caeae936a
MAI-002 (Tarifas y SLA): - README, REQUERIMIENTOS, RESUMEN-EPICA - 5 User Stories (31 SP total) - Covers: tarifario por lane, recargos, SLA, cotizaciones, aprobaciones MAI-004 (Planeacion TMS): - README, REQUERIMIENTOS, RESUMEN-EPICA - 5 User Stories (39 SP total) - Covers: tablero planeacion, consolidacion, asignacion, validaciones, ETA MAI-005 (Despacho): - README, REQUERIMIENTOS, RESUMEN-EPICA - 5 User Stories (28 SP total) - Covers: checklist NOM-068, sellos, evidencias, kit documental, gate out Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
217 lines
7.8 KiB
Markdown
217 lines
7.8 KiB
Markdown
# 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*
|