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

143 lines
7.4 KiB
Markdown

# 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 | Sí |
| Frenos | Servicio, estacionamiento | Sí |
| Luces | Delanteras, traseras, direccionales | Sí |
| Espejos | Retrovisores, laterales | No |
| Niveles | Aceite, anticongelante, combustible | No |
| Acoplamiento | Quinta rueda, conexiones, pernos | Sí |
| Documentación | Licencia, tarjeta, permisos | Sí |
---
## 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