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

8.8 KiB

Raw Blame History

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

8.8 KiB Raw Blame History