erp-transportistas-v2/docs/02-definicion-modulos/MAI-005-despacho/historias-usuario/US-MAI005-001.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

7.4 KiB

US-MAI005-001: Ejecutar checklist pre-viaje

ID: US-MAI005-001 Módulo: MAI-005 (Despacho) Prioridad: Alta Story Points: 8


Historia de Usuario

Como operador de transporte Quiero ejecutar un checklist de inspección pre-viaje en mi dispositivo móvil Para documentar el estado de la unidad y cumplir con NOM-068 antes de salir a ruta


Criterios de Aceptación

CA-001: Cargar checklist por tipo de unidad

Dado que tengo un viaje asignado Cuando inicio el checklist pre-viaje Entonces el sistema carga la plantilla correspondiente al tipo de unidad (tractora, remolque, caja seca)

CA-002: Registrar estado de cada punto

Dado que estoy ejecutando el checklist Cuando inspecciono cada punto Entonces puedo marcar: OK, Observación, o Falla con comentario opcional

CA-003: Adjuntar fotos por punto

Dado que un punto tiene observación o falla Cuando selecciono la opción de foto Entonces puedo capturar y adjuntar una imagen como evidencia

CA-004: Bloqueo por fallas críticas

Dado que marco una falla en punto crítico (frenos, llantas, luces) Cuando intento finalizar el checklist Entonces el sistema indica que el viaje no puede despacharse sin resolver

CA-005: Firma digital del operador

Dado que completé todos los puntos del checklist Cuando finalizo la inspección Entonces debo firmar digitalmente para confirmar que realicé la inspección

CA-006: Funcionamiento offline

Dado que estoy sin conexión a internet Cuando ejecuto el checklist Entonces puedo completarlo y las fotos se sincronizan al recuperar conexión


Mockup / UI

┌─────────────────────────────────────────────────────────────────┐
│ CHECKLIST PRE-VIAJE                                    ✕        │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  Viaje: VJE-0123 | Unidad: U-005 Kenworth T680                 │
│  Tipo: Tractocamión con semirremolque                          │
│                                                                 │
│  Progreso: ████████░░░░░░░░ 8/15 puntos                        │
│                                                                 │
│  ─────────────────────────────────────────────────────────────  │
│                                                                 │
│  🔧 LLANTAS                                                     │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ Presión eje delantero                                    │   │
│  │ Valor: [110 psi]                                         │   │
│  │ Estado: (●) OK  ( ) Observación  ( ) Falla              │   │
│  │                                                          │   │
│  │ Presión eje trasero                                      │   │
│  │ Valor: [105 psi]                                         │   │
│  │ Estado: (●) OK  ( ) Observación  ( ) Falla              │   │
│  │                                                          │   │
│  │ Profundidad de dibujo                                    │   │
│  │ Estado: ( ) OK  (●) Observación  ( ) Falla              │   │
│  │ Nota: [Desgaste visible en eje 3]                       │   │
│  │ [📷 Agregar Foto]                                        │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
│  🔧 FRENOS (CRÍTICO)                                           │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ Freno de servicio                                        │   │
│  │ Estado: (●) OK  ( ) Observación  ( ) Falla              │   │
│  │                                                          │   │
│  │ Freno de estacionamiento                                 │   │
│  │ Estado: (●) OK  ( ) Observación  ( ) Falla              │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
│  🔧 LUCES                                           [Expandir] │
│  🔧 ESPEJOS Y CRISTALES                            [Expandir] │
│  🔧 NIVELES                                         [Expandir] │
│  🔧 ACOPLAMIENTO                                   [Expandir] │
│  🔧 DOCUMENTACIÓN                                  [Expandir] │
│                                                                 │
│  ─────────────────────────────────────────────────────────────  │
│                                                                 │
│  ⚠ 1 observación registrada                                    │
│                                                                 │
│  [Cancelar]                              [Firmar y Finalizar]  │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Puntos de Inspección NOM-068

Categoría Puntos Crítico
Llantas Presión, profundidad, estado
Frenos Servicio, estacionamiento
Luces Delanteras, traseras, direccionales
Espejos Retrovisores, laterales No
Niveles Aceite, anticongelante, combustible No
Acoplamiento Quinta rueda, conexiones, pernos
Documentación Licencia, tarjeta, permisos

Notas Técnicas

  • Plantillas en tabla checklist_items filtradas por tipo_unidad
  • Checklist se guarda en inspecciones_pre_viaje
  • Fotos se suben a S3 con referencia en item.foto_url
  • Sincronización via cola de reintentos (máx 3 intentos)
  • Firma se almacena como base64 en firma_operador

Definición de Done

  • Carga de plantilla por tipo de unidad
  • UI de checklist con todos los puntos NOM-068
  • Captura de fotos por punto
  • Validación de puntos críticos
  • Firma digital del operador
  • Funcionamiento offline con sincronización
  • Tests unitarios de validaciones
  • Tests de integración de sincronización