rckrdmrd/erp-transportistas-v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
ec43d9c6cd
erp-transportistas-v2/docs/02-definicion-modulos/MAI-011-gestion-flota/RESUMEN-EPICA.md
Adrian Flores Cortes ec43d9c6cd docs: Add Phase 3 secondary modules specifications (P1/P2/P3) 
Modules documented:
- MAI-003 (OT): README, REQUERIMIENTOS, RESUMEN-EPICA, 10 US
- MAI-006 (Tracking): README, REQUERIMIENTOS, RESUMEN-EPICA
- MAI-008 (Incidencias): 3 US (18 SP)
- MAI-011 (Flota): README, REQUERIMIENTOS, RESUMEN-EPICA
- MAI-012 (Combustible): 3 US (18 SP)
- MAI-013 (Mantenimiento): 3 US (18 SP)
- MAI-014 (Carriers): 3 US (18 SP)
- MAI-015 (Portal): 3 US (18 SP)
- MAE-016 (Carta Porte): 10 US
- MAE-017 (HOS): 3 US (16 SP)
- MAE-018 (Reportes): 3 US (18 SP)

Phase 2+3 complete: 13 modules, 50+ User Stories

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 02:24:35 -06:00

6.1 KiB
Raw Blame History

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