# 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*