erp-transportistas-v2/docs/02-definicion-modulos/MAI-004-planeacion/historias-usuario/US-MAI004-004.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

5.0 KiB

US-MAI004-004: Validar compatibilidad de recursos

ID: US-MAI004-004 Módulo: MAI-004 (Planeación TMS) Prioridad: Alta Story Points: 5


Historia de Usuario

Como planner de tráfico Quiero que el sistema valide automáticamente que los recursos cumplen todos los requisitos Para evitar asignar operadores o unidades que no están calificados para el servicio


Criterios de Aceptación

CA-001: Validación de operador

Dado que asigno un operador Cuando el sistema valida Entonces verifica: licencia vigente, certificaciones requeridas, HOS disponibles, no en lista negra del cliente

CA-002: Validación de unidad

Dado que asigno una unidad Cuando el sistema valida Entonces verifica: documentos vigentes, cumple requisitos del cliente (GPS, antigüedad), tipo equipo correcto

CA-003: Bloqueo por incumplimiento

Dado que un recurso no cumple validación obligatoria Cuando intento confirmar asignación Entonces el sistema bloquea y muestra el motivo específico

CA-004: Advertencia

Dado que un recurso cumple pero con observaciones Cuando intento confirmar Entonces el sistema muestra advertencia pero permite continuar

CA-005: Override con autorización

Dado que necesito asignar un recurso que no cumple Cuando un supervisor autoriza el override Entonces se permite la asignación con registro de justificación


Mockup / UI

┌─────────────────────────────────────────────────────────────────┐
│ VALIDACIÓN DE RECURSOS                                          │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  OPERADOR: Juan Pérez García                                    │
│  ├─ ✓ Licencia Federal A vigente hasta 2027-05-15              │
│  ├─ ✓ Certificación materiales peligrosos                      │
│  ├─ ✓ HOS disponibles: 11 hrs (requerido: 8 hrs)               │
│  └─ ✓ No está en lista negra del cliente                       │
│                                                                 │
│  UNIDAD: U-005 Kenworth T680                                    │
│  ├─ ✓ Verificación vigente hasta 2026-06-30                    │
│  ├─ ✓ Seguro vigente hasta 2026-12-31                          │
│  ├─ ✓ Permiso SCT vigente                                      │
│  ├─ ✓ GPS instalado y activo                                   │
│  └─ ⚠ Antigüedad: 6 años (cliente pide <5 años)               │
│                                                                 │
│  ─────────────────────────────────────────────────────────────  │
│                                                                 │
│  ⚠ 1 ADVERTENCIA ENCONTRADA                                    │
│                                                                 │
│  La unidad excede la antigüedad requerida por el cliente.       │
│  Puede continuar pero se registrará como excepción.             │
│                                                                 │
│  [Cancelar]  [Solicitar Override]  [Continuar con Advertencia] │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Catálogo de Validaciones

Código Validación Tipo Aplica a
VAL-001 Licencia vigente Bloqueante Operador
VAL-002 Certificación requerida Bloqueante Operador
VAL-003 HOS suficientes Bloqueante Operador
VAL-004 Lista negra cliente Bloqueante Operador
VAL-005 Documentos unidad Bloqueante Unidad
VAL-006 GPS activo Bloqueante Unidad
VAL-007 Antigüedad máxima Advertencia Unidad
VAL-008 Tipo equipo correcto Bloqueante Unidad

Notas Técnicas

  • Las reglas se almacenan en requisitos_cliente y reglas_asignacion
  • El override requiere rol de supervisor
  • Todos los overrides se registran en auditoría
  • Las validaciones se ejecutan en tiempo real

Definición de Done

  • Validaciones de operador implementadas
  • Validaciones de unidad implementadas
  • UI de resultado de validaciones
  • Bloqueo por incumplimiento
  • Flujo de override con supervisor
  • Registro en auditoría
  • Tests de cada validación