# US-MAI004-003: Asignar unidad a viaje

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

---

## Historia de Usuario

**Como** planner de tráfico
**Quiero** asignar unidad, operador y remolque a un embarque/viaje
**Para** crear el viaje planificado listo para despacho

---

## Criterios de Aceptación

### CA-001: Selector de unidad
**Dado** que tengo un embarque para asignar
**Cuando** abro el selector de unidad
**Entonces** veo solo unidades disponibles en las fechas requeridas con capacidad suficiente

### CA-002: Selector de operador
**Dado** que seleccioné una unidad
**Cuando** abro el selector de operador
**Entonces** veo solo operadores disponibles con licencia vigente y calificados

### CA-003: Selector de remolque
**Dado** que el viaje requiere remolque
**Cuando** abro el selector
**Entonces** veo remolques disponibles del tipo correcto

### CA-004: Validación de capacidad
**Dado** que asigno recursos
**Cuando** la capacidad de la unidad es menor al peso total
**Entonces** el sistema bloquea y muestra "Capacidad insuficiente"

### CA-005: Creación de viaje
**Dado** que todos los recursos están asignados y validados
**Cuando** confirmo la asignación
**Entonces** se crea viaje en estado PLANIFICADO con reservas de recursos

---

## Mockup / UI

```
┌─────────────────────────────────────────────────────────────────┐
│ ASIGNAR RECURSOS - EMB-0089                                  [X]│
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  Embarque: 2 OTs | 12 ton | CDMX → GDL/GDL Sur                 │
│  Fecha requerida: 28 Ene 2026 | Tipo equipo: Caja Seca         │
│                                                                 │
│  ─────────────────────────────────────────────────────────────  │
│                                                                 │
│  UNIDAD *                                                       │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ U-005 Kenworth T680 | Caja Seca 18 ton | ✓ Disponible  ▼│   │
│  └─────────────────────────────────────────────────────────┘   │
│  Capacidad: 12/18 ton (67%) ✓                                  │
│                                                                 │
│  OPERADOR *                                                     │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ Juan Pérez García | Lic. Federal A | ✓ Vigente        ▼│   │
│  └─────────────────────────────────────────────────────────┘   │
│  HOS disponibles: 11 hrs ✓                                     │
│                                                                 │
│  REMOLQUE (Opcional)                                            │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ Seleccionar remolque...                                ▼│   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
│  ─────────────────────────────────────────────────────────────  │
│                                                                 │
│  RESUMEN DE VALIDACIONES                                        │
│  ✓ Capacidad OK                                                │
│  ✓ Operador calificado                                         │
│  ✓ Unidad con documentos vigentes                              │
│  ✓ Sin conflicto de horarios                                   │
│                                                                 │
│  [Cancelar]                         [Crear Viaje Planificado]   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘
```

---

## Filtros de Disponibilidad

| Recurso | Criterios de filtrado |
|---------|----------------------|
| Unidad | Disponible en fecha, tipo equipo, capacidad suficiente, documentos OK |
| Operador | Disponible en fecha, licencia vigente, HOS suficiente, no en lista negra |
| Remolque | Disponible en fecha, tipo compatible, documentos OK |

---

## Notas Técnicas

- Los selectores usan búsqueda con autocomplete
- La disponibilidad se consulta en tiempo real
- Al crear viaje se crean registros en `asignaciones`
- Notificación push al operador asignado

---

## Definición de Done

- [ ] Selector de unidad con filtros
- [ ] Selector de operador con filtros
- [ ] Selector de remolque con filtros
- [ ] Validación de capacidad
- [ ] Creación de viaje y reservas
- [ ] Notificación al operador
- [ ] Tests de integración