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

6.1 KiB

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