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

119 lines
6.1 KiB
Markdown

# 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