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>
114 lines
5.0 KiB
Markdown
114 lines
5.0 KiB
Markdown
# 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
|