ec43d9c6cd
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>
127 lines
6.1 KiB
Markdown
127 lines
6.1 KiB
Markdown
# 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*
|