# RESUMEN-EPICA.md - MAI-011 Gestion de Flota **Epica:** EPIC-MAI-011 | **Modulo:** MAI-011 | **Version:** 1.0.0 | **Actualizado:** 2026-01-27 --- ## Epica: EPIC-MAI-011 - Gestion de Flota ### Descripcion de la Epica Como empresa transportista de carga, necesitamos un sistema integral para gestionar toda nuestra flota vehicular (unidades motrices y remolques), operadores/conductores y su documentacion asociada. El sistema debe garantizar que solo recursos con documentacion vigente y en condiciones aptas puedan ser asignados a viajes, cumpliendo con la normatividad mexicana de autotransporte federal (permisos SCT, licencia federal tipo F, verificaciones, polizas de seguro, certificados fisicos medicos y pruebas antidoping). ### Objetivo de Negocio Eliminar el control manual (Excel, WhatsApp, carpetas fisicas) de la flota vehicular y operadores, reduciendo riesgos operativos por documentacion vencida, mejorando la disponibilidad de recursos y asegurando cumplimiento regulatorio ante la Secretaria de Infraestructura, Comunicaciones y Transportes (SICT, antes SCT). ### Metricas de Exito | Metrica | Objetivo | Medicion | |---------|----------|----------| | Tiempo de registro de unidad | < 5 minutos | Desde inicio de captura hasta guardado | | Documentos vencidos no detectados | 0% | Ningun recurso opera con documentos vencidos | | Disponibilidad de flota visible | 100% | Dashboard actualizado en tiempo real | | Tiempo de busqueda de operador disponible | < 30 segundos | Desde consulta hasta resultado | | Reduccion de incidencias por documentos | -80% | Comparado con proceso manual | --- ## Alcance ### Incluido - Alta, baja y modificacion de unidades motrices (tractocamiones, tortones, rabones, camionetas) - Alta, baja y modificacion de remolques (caja seca, refrigerada, plataforma, tanque, portacontenedor) - Gestion completa de operadores/conductores (datos personales, licencias, certificaciones, datos bancarios) - Gestion de documentos con vigencia para las tres entidades (unidad, remolque, operador) - Alertas automaticas de vencimiento de documentos - Bloqueo automatico de recursos con documentacion vencida - Asignaciones operador-unidad-remolque con historial - Dashboard de disponibilidad de flota - Busqueda de operadores disponibles con filtros - Configuraciones vehiculares (tractora + remolque) - Exportacion de reportes de flota ### Excluido (cubierto por otros modulos) - Mantenimiento preventivo y correctivo (MAI-013) - Control de combustible y gastos de viaje (MAI-012) - Gestion de carriers/terceros (MAI-014) - Tracking GPS en tiempo real (MAI-006) - Liquidacion y pago a operadores (MAI-010) - Carta Porte y datos fiscales del viaje (MAE-016) --- ## Historias de Usuario | ID | Titulo | SP | Prioridad | Estado | |----|--------|----|-----------|--------| | US-MAI011-001 | Registrar unidad nueva en flota | 5 | P0 | Backlog | | US-MAI011-002 | Registrar operador con documentos | 8 | P0 | Backlog | | US-MAI011-003 | Consultar disponibilidad de recursos | 5 | P0 | Backlog | | US-MAI011-004 | Asignar operador a unidad | 3 | P1 | Backlog | | US-MAI011-005 | Recibir alerta de documento por vencer | 5 | P0 | Backlog | | US-MAI011-006 | Bloquear unidad por mantenimiento vencido | 5 | P1 | Backlog | | US-MAI011-007 | Ver historial de asignaciones | 3 | P2 | Backlog | | US-MAI011-008 | Registrar cambio de status de unidad | 3 | P1 | Backlog | | US-MAI011-009 | Dashboard de flota (disponibilidad) | 5 | P1 | Backlog | | US-MAI011-010 | Buscar operador disponible | 3 | P1 | Backlog | | US-MAI011-011 | Configurar combinacion vehicular | 5 | P1 | Backlog | | US-MAI011-012 | Exportar reporte de flota | 3 | P2 | Backlog | ### Resumen de Esfuerzo | Prioridad | Historias | Story Points | |-----------|-----------|-------------| | P0 (Critico) | 4 | 23 | | P1 (Importante) | 6 | 24 | | P2 (Deseable) | 2 | 6 | | **Total** | **12** | **53** | --- ## Dependencias Criticas ### Prerequisitos (debe completarse antes) - MAI-001: Fundamentos (Auth, RBAC, multi-tenancy) debe estar operativo - Schema `fleet` creado en la base de datos con DDL `02-fleet-schema-ddl.sql` - ENUMs `fleet.tipo_unidad` y `fleet.estado_unidad` creados en `00-schemas-init.sql` ### Habilita (otros modulos dependen de este) - MAI-003: Ordenes de Transporte (necesita unidades/operadores para asignar) - MAI-004: Planeacion TMS (consulta disponibilidad de recursos) - MAI-005: Despacho (verifica aptitud de recursos) - MAI-013: Mantenimiento (opera sobre las unidades registradas aqui) - MAE-016: Carta Porte (usa datos de unidad/operador en complemento fiscal) --- ## Riesgos Identificados | Riesgo | Impacto | Mitigacion | |--------|---------|------------| | Datos incompletos de unidades existentes | Alto | Proceso de migracion con validacion obligatoria | | Operadores sin licencia federal digitalizada | Medio | Periodo de gracia con alertas diarias | | Resistencia al cambio (de Excel a sistema) | Medio | Capacitacion y soporte en sitio | | Documentos fisicos sin digitalizar | Alto | Flujo de captura con smartphone (foto directa) | | Multiples unidades de un mismo carrier | Bajo | Campo `es_propia` y `propietario_id` en entidades | --- ## Criterios de Aceptacion de la Epica 1. Se pueden registrar unidades motrices de todos los tipos (tractora, torton, rabon, camioneta) con datos completos 2. Se pueden registrar remolques de todos los tipos (caja seca, refrigerada, plataforma, tanque, portacontenedor) 3. Se pueden registrar operadores con licencia federal y certificaciones 4. Se pueden subir documentos con vigencia para unidades, remolques y operadores 5. El sistema genera alertas automaticas cuando un documento esta por vencer (30 dias por defecto) 6. El sistema bloquea automaticamente recursos con documentacion vencida 7. Se pueden crear asignaciones operador-unidad-remolque con historial 8. El dashboard muestra el estado de disponibilidad de toda la flota en tiempo real 9. Se puede buscar y filtrar operadores disponibles por criterios 10. Se puede exportar un reporte de la flota en formato Excel o PDF 11. Todas las operaciones respetan multi-tenancy (RLS) y RBAC --- *EPIC-MAI-011 Gestion de Flota - ERP Transportistas v1.0.0*