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>
192 lines
8.8 KiB
Markdown
192 lines
8.8 KiB
Markdown
# RESUMEN-EPICA.md - MAI-004: Planeación TMS
|
|
|
|
**Código:** MAI-004
|
|
**Nombre:** Planeación TMS
|
|
**Version:** 1.0.0
|
|
**Fecha:** 2026-01-27
|
|
|
|
---
|
|
|
|
## Valor de Negocio
|
|
|
|
### Problema
|
|
|
|
Las empresas transportistas enfrentan:
|
|
- Asignación manual que consume horas de trabajo
|
|
- Unidades viajando con capacidad subutilizada
|
|
- Incumplimiento de ventanas por mala planeación
|
|
- Falta de visibilidad de recursos disponibles
|
|
- Operadores asignados sin validar requisitos
|
|
|
|
### Solución
|
|
|
|
Un módulo TMS que:
|
|
- Centraliza la planeación en un tablero visual
|
|
- Sugiere consolidaciones para maximizar capacidad
|
|
- Valida automáticamente compatibilidad de recursos
|
|
- Calcula ETAs para anticipar problemas
|
|
|
|
### Beneficios Esperados
|
|
|
|
| Beneficio | Métrica | Impacto |
|
|
|-----------|---------|---------|
|
|
| Mejor utilización | +20% fill rate | Más ingresos por viaje |
|
|
| Menos incumplimientos | -50% SLA missed | Retención clientes |
|
|
| Productividad planner | -40% tiempo planeación | Costos operativos |
|
|
| Menos errores | -80% asignaciones inválidas | Evita sanciones |
|
|
|
|
---
|
|
|
|
## Actores y Stakeholders
|
|
|
|
### Usuarios Primarios
|
|
|
|
| Actor | Responsabilidad | Frecuencia |
|
|
|-------|-----------------|------------|
|
|
| Planner/Tráfico | Planifica y asigna recursos | Continuo |
|
|
| Jefe de Flota | Gestiona disponibilidad | Diario |
|
|
| Supervisor | Aprueba excepciones | Bajo demanda |
|
|
|
|
### Usuarios Secundarios
|
|
|
|
| Actor | Interés |
|
|
|-------|---------|
|
|
| Ventas | Consulta capacidad para compromisos |
|
|
| Despacho | Recibe viajes planificados |
|
|
| Gerencia | Métricas de utilización |
|
|
|
|
---
|
|
|
|
## Flujo Principal
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ OTs CONFIRMADAS PARA PLANIFICAR │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ 1. TABLERO DE PLANEACIÓN │
|
|
│ │
|
|
│ ┌──────────────────┐ ┌──────────────────────────────────┐ │
|
|
│ │ OTs Pendientes │ │ GANTT / CALENDARIO │ │
|
|
│ │ │ │ │ │
|
|
│ │ □ OT-001 CDMX │ │ Lun Mar Mie Jue Vie │ │
|
|
│ │ □ OT-002 GDL │ │ ════ ════ ════ ════ ════ │ │
|
|
│ │ □ OT-003 MTY │ │ U-01 ▓▓▓▓ ░░░░ ▓▓▓▓ │ │
|
|
│ │ □ OT-004 CDMX │ │ U-02 ▓▓▓▓▓▓▓▓▓ │ │
|
|
│ │ │ │ U-03 ░░░░░░░░░░░░ │ │
|
|
│ └──────────────────┘ └──────────────────────────────────┘ │
|
|
│ │
|
|
│ [Seleccionar OTs] [Sugerir Consolidación] [Asignar] │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ 2. CONSOLIDACIÓN │
|
|
│ │
|
|
│ Sistema detecta OTs consolidables: │
|
|
│ • OT-001 y OT-004: Mismo origen (CDMX), destinos cercanos │
|
|
│ • Ventanas compatibles: 8:00-12:00 y 10:00-14:00 │
|
|
│ • Capacidad combinada: 12 ton (Unidad: 18 ton) ✓ │
|
|
│ │
|
|
│ [Crear Embarque EMB-001] │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ 3. ASIGNACIÓN DE RECURSOS │
|
|
│ │
|
|
│ Embarque: EMB-001 (OT-001 + OT-004) │
|
|
│ │
|
|
│ Unidad: [U-05 Kenworth T680 ▼] ✓ Disponible │
|
|
│ Operador: [Juan Pérez García ▼] ✓ Licencia OK │
|
|
│ Remolque: [R-12 Caja Seca 53' ▼] ✓ Documentos OK │
|
|
│ │
|
|
│ Validaciones: │
|
|
│ ✓ Capacidad: 12/18 ton (67%) │
|
|
│ ✓ Operador autorizado para cliente │
|
|
│ ✓ Unidad cumple requisitos GPS │
|
|
│ ✓ Sin conflicto de horarios │
|
|
│ │
|
|
│ [Cancelar] [Crear Viaje Planificado] │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ VIAJE VJE-001 PLANIFICADO │
|
|
│ │
|
|
│ Fecha salida: 2026-01-28 06:00 │
|
|
│ ETA Destino 1: 2026-01-28 10:30 │
|
|
│ ETA Destino 2: 2026-01-28 14:00 │
|
|
│ │
|
|
│ → Listo para Despacho (MAI-005) │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## Criterios de Éxito
|
|
|
|
### Funcionales
|
|
|
|
- [ ] Tablero carga en <3 segundos
|
|
- [ ] Sugerencia de consolidación funciona correctamente
|
|
- [ ] Validaciones bloquean asignaciones inválidas
|
|
- [ ] ETA calculado con precisión ±30 minutos
|
|
|
|
### Técnicos
|
|
|
|
- [ ] Soporte para 500+ OTs en tablero
|
|
- [ ] Concurrencia sin conflictos
|
|
- [ ] Integración con API de mapas
|
|
- [ ] Cache de disponibilidad
|
|
|
|
### Negocio
|
|
|
|
- [ ] >75% utilización de flota
|
|
- [ ] >85% fill rate promedio
|
|
- [ ] <15 minutos por asignación
|
|
- [ ] <5% asignaciones con override
|
|
|
|
---
|
|
|
|
## Riesgos y Mitigaciones
|
|
|
|
| Riesgo | Probabilidad | Impacto | Mitigación |
|
|
|--------|--------------|---------|------------|
|
|
| Performance tablero | Media | Alto | Paginación, lazy loading |
|
|
| Conflictos concurrencia | Media | Alto | Bloqueo optimista |
|
|
| Datos de capacidad incorrectos | Baja | Alto | Validación en carga |
|
|
| API mapas no disponible | Baja | Medio | Cache de distancias |
|
|
|
|
---
|
|
|
|
## Dependencias
|
|
|
|
### Prerequisitos
|
|
- MAI-003 (OT): OTs confirmadas disponibles
|
|
- MAI-011 (Flota): Datos de unidades y operadores
|
|
- MAI-002 (Tarifas): Requisitos del cliente
|
|
|
|
### Habilita
|
|
- MAI-005 (Despacho): Viajes planificados para despachar
|
|
- MAI-006 (Tracking): Inicio de seguimiento
|
|
|
|
---
|
|
|
|
## Story Points Estimados
|
|
|
|
| Historia | Complejidad | SP |
|
|
|----------|-------------|---|
|
|
| US-MAI004-001 | Alta | 13 |
|
|
| US-MAI004-002 | Alta | 8 |
|
|
| US-MAI004-003 | Alta | 8 |
|
|
| US-MAI004-004 | Media | 5 |
|
|
| US-MAI004-005 | Media | 5 |
|
|
| **Total** | | **39** |
|
|
|
|
---
|
|
|
|
*Épica MAI-004 - ERP Transportistas - Sistema SIMCO v4.0.0*
|