erp-transportistas-v2/docs/02-definicion-modulos/MAI-005-despacho/RESUMEN-EPICA.md
Adrian Flores Cortes 9caeae936a docs: Add MAI-002, MAI-004, MAI-005 module specifications
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>
2026-01-27 01:51:58 -06:00

216 lines
11 KiB
Markdown

# RESUMEN-EPICA.md - MAI-005: Despacho
**Código:** MAI-005
**Nombre:** Despacho
**Version:** 1.0.0
**Fecha:** 2026-01-27
---
## Valor de Negocio
### Problema
Las empresas transportistas enfrentan riesgos por:
- Unidades que salen sin inspección (accidentes, multas)
- Sellos no documentados (reclamos por robo/faltante)
- Documentación incompleta (retenciones en ruta)
- Incumplimiento de NOM-068 (sanciones SCT)
- Sin registro de hora de salida real
### Solución
Un módulo de despacho que:
- Obliga a completar checklist antes de salir
- Documenta sellos con evidencia fotográfica
- Compila kit documental digital
- Registra gate out con timestamp y GPS
### Beneficios Esperados
| Beneficio | Métrica | Impacto |
|-----------|---------|---------|
| Reducción accidentes | -40% incidentes mecánicos | Seguridad, costos |
| Compliance NOM-068 | 100% inspecciones | Evita multas |
| Menos reclamos | -60% disputas por sellos | Ahorro legal |
| Trazabilidad | 100% viajes con gate out | Auditoría |
---
## Actores y Stakeholders
### Usuarios Primarios
| Actor | Responsabilidad | Frecuencia |
|-------|-----------------|------------|
| Operador | Ejecuta checklist, registra sellos | Cada viaje |
| Despachador | Valida y autoriza salida | Cada viaje |
| Vigilancia | Confirma gate out físico | Cada viaje |
### Usuarios Secundarios
| Actor | Interés |
|-------|---------|
| Jefe de Flota | Monitorea condiciones de unidades |
| Cliente | Recibe notificación de salida |
| Auditor | Revisa compliance NOM-068 |
---
## Flujo Principal
```
┌─────────────────────────────────────────────────────────────────┐
│ VIAJE PLANIFICADO │
│ (Unidad y operador asignados) │
└─────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────┐
│ 1. CHECKLIST PRE-VIAJE (Operador) │
│ │
│ Unidad: U-005 Kenworth T680 │
│ │
│ □ Llantas │
│ ├─ Presión eje delantero: [110 psi] ✓ │
│ ├─ Presión eje trasero: [105 psi] ✓ │
│ └─ Estado visual: [OK ▼] ✓ │
│ │
│ □ Frenos │
│ ├─ Freno de servicio: [OK ▼] ✓ │
│ └─ Freno de mano: [OK ▼] ✓ │
│ │
│ □ Luces │
│ ├─ Delanteras: [OK ▼] ✓ │
│ ├─ Traseras: [Observación ▼] ⚠ [📷 Foto] │
│ └─ Direccionales: [OK ▼] ✓ │
│ │
│ ... (más puntos según NOM-068) │
│ │
│ [Firmar y Enviar] │
└─────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────┐
│ 2. CONTROL DE SELLOS (Operador) │
│ │
│ Sellos del viaje: │
│ ┌───────────────────────────────────────────────────────────┐ │
│ │ #001: ABC-123456 │ Puerta trasera │ [📷] ✓ │ │
│ │ #002: ABC-123457 │ Puerta lateral │ [📷] ✓ │ │
│ └───────────────────────────────────────────────────────────┘ │
│ │
│ [+ Agregar Sello] │
└─────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────┐
│ 3. EVIDENCIAS DE CARGA (Operador) │
│ │
│ Fotos de carga: [📷] [📷] [📷] 3/5 │
│ Peso báscula: [12,500 kg] │
│ Firma almacén: [✓ Capturada] │
└─────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────┐
│ 4. VALIDACIÓN (Despachador) │
│ │
│ Estado del despacho: │
│ ✓ Checklist completado (15 puntos OK, 1 observación) │
│ ✓ Sellos registrados (2) │
│ ✓ Evidencias de carga (3 fotos + firma) │
│ ✓ Kit documental completo │
│ ✓ Operador con HOS disponible (11 hrs) │
│ │
│ [Autorizar Salida] │
└─────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────┐
│ 5. GATE OUT (Vigilancia) │
│ │
│ ✓ Confirmar salida física │
│ │
│ Fecha/Hora: 2026-01-28 06:15:32 │
│ GPS: 19.4326, -99.1332 │
│ Autoriza: Carlos Méndez (Vigilancia) │
│ │
│ [Registrar Gate Out] │
└─────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────┐
│ VIAJE DESPACHADO │
│ → Tracking activado (MAI-006) │
│ → Cliente notificado │
└─────────────────────────────────────────────────────────────────┘
```
---
## Criterios de Éxito
### Funcionales
- [ ] Checklist parametrizable por tipo de unidad
- [ ] Bloqueo de salida por fallas críticas
- [ ] Registro de sellos con fotos
- [ ] Kit documental compilado
- [ ] Gate out con GPS y timestamp
### Técnicos
- [ ] Funciona offline (checklist, fotos)
- [ ] Sincronización en <30 segundos
- [ ] Registros inmutables
- [ ] Integración con tracking
### Negocio
- [ ] 100% viajes con checklist
- [ ] 100% sellos documentados
- [ ] <45 min tiempo de despacho
- [ ] 0 multas por NOM-068
---
## Riesgos y Mitigaciones
| Riesgo | Probabilidad | Impacto | Mitigación |
|--------|--------------|---------|------------|
| Operador omite checklist | Media | Alto | Bloqueo obligatorio |
| Fotos no se sincronizan | Media | Medio | Cola de reintentos |
| Resistencia al cambio | Alta | Medio | Capacitación, UX simple |
| Falta de conectividad | Alta | Medio | Modo offline robusto |
---
## Dependencias
### Prerequisitos
- MAI-004 (Planeación): Viaje planificado
- MAI-011 (Flota): Datos de unidad
- MAE-016 (Carta Porte): Documento para kit (opcional)
### Habilita
- MAI-006 (Tracking): Se activa al despachar
- MAI-007 (POD): Viaje debe estar despachado
---
## Story Points Estimados
| Historia | Complejidad | SP |
|----------|-------------|---|
| US-MAI005-001 | Alta | 8 |
| US-MAI005-002 | Media | 5 |
| US-MAI005-003 | Media | 5 |
| US-MAI005-004 | Media | 5 |
| US-MAI005-005 | Media | 5 |
| **Total** | | **28** |
---
*Épica MAI-005 - ERP Transportistas - Sistema SIMCO v4.0.0*