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>
186 lines
4.5 KiB
Markdown
186 lines
4.5 KiB
Markdown
# REQUERIMIENTOS - MAI-013: Mantenimiento de Flota
|
|
|
|
**Modulo:** MAI-013
|
|
**Fuente:** REQ-GIRO-TRANSPORTISTA.md - Seccion 4.11
|
|
**Version:** 1.0.0
|
|
|
|
---
|
|
|
|
## Requerimientos Funcionales
|
|
|
|
### RF-4.11.1: Plan Preventivo
|
|
|
|
**Descripcion:** Programar mantenimiento preventivo automatico por km, horas o fecha.
|
|
|
|
**Tipos de trigger:**
|
|
| Trigger | Parametro | Ejemplo |
|
|
|---------|-----------|---------|
|
|
| Por km | Intervalo km | Cada 15,000 km |
|
|
| Por horas motor | Intervalo horas | Cada 500 hrs |
|
|
| Por fecha | Periodicidad | Cada 6 meses |
|
|
| Por evento | Condicion | Post-viaje largo |
|
|
|
|
**Planes tipicos por tipo de unidad:**
|
|
| Unidad | Servicio | Intervalo |
|
|
|--------|----------|-----------|
|
|
| Tracto | Cambio aceite | 15,000 km |
|
|
| Tracto | Revision frenos | 30,000 km |
|
|
| Tracto | Service mayor | 100,000 km |
|
|
| Remolque | Revision llantas | 10,000 km |
|
|
| Remolque | Lubricacion | 5,000 km |
|
|
|
|
**Generacion automatica:**
|
|
- Job diario verifica km/horas/fechas
|
|
- Al alcanzar umbral → genera OT preventiva
|
|
- Notifica a jefe de mantenimiento
|
|
- Pre-agenda fecha tentativa
|
|
|
|
**Tablas DDL:**
|
|
- `maintenance.planes_mantenimiento`
|
|
- `maintenance.servicios_programados`
|
|
|
|
---
|
|
|
|
### RF-4.11.2: Mantenimiento Correctivo
|
|
|
|
**Descripcion:** Gestionar fallas reportadas con tickets y ordenes de trabajo.
|
|
|
|
**Flujo correctivo:**
|
|
```
|
|
Falla detectada → Ticket → Diagnostico → OT →
|
|
Ejecucion → Pruebas → Cierre → Liberacion
|
|
```
|
|
|
|
**Prioridades:**
|
|
| Nivel | Descripcion | SLA |
|
|
|-------|-------------|-----|
|
|
| CRITICA | Unidad parada en ruta | 4 horas |
|
|
| ALTA | Afecta seguridad | 24 horas |
|
|
| MEDIA | Afecta operacion | 48 horas |
|
|
| BAJA | Estetico/menor | 1 semana |
|
|
|
|
**Campos de ticket:**
|
|
- Unidad afectada
|
|
- Tipo de falla
|
|
- Descripcion
|
|
- Fotos
|
|
- Ubicacion (si en ruta)
|
|
- Prioridad
|
|
- Reportado por
|
|
|
|
**Tablas DDL:**
|
|
- `maintenance.tickets_falla`
|
|
- `maintenance.ordenes_trabajo`
|
|
|
|
---
|
|
|
|
### RF-4.11.3: Inventario de Refacciones
|
|
|
|
**Descripcion:** Control minimo de refacciones para taller propio.
|
|
|
|
**Alcance (minimo para el giro):**
|
|
- Catalogo de refacciones comunes
|
|
- Stock actual por almacen
|
|
- Consumo en ordenes de trabajo
|
|
- Punto de reorden
|
|
- Costo promedio
|
|
|
|
**Fuera de alcance:**
|
|
- Multialmacen complejo
|
|
- Lotes y caducidad
|
|
- Produccion
|
|
|
|
**Tablas DDL:**
|
|
- `maintenance.refacciones`
|
|
- `maintenance.movimientos_refaccion`
|
|
|
|
---
|
|
|
|
### RF-4.11.4: Historial por Activo
|
|
|
|
**Descripcion:** Mantener historial completo de mantenimientos por unidad.
|
|
|
|
**Metricas por unidad:**
|
|
| Metrica | Descripcion |
|
|
|---------|-------------|
|
|
| MTBF | Mean Time Between Failures |
|
|
| MTTR | Mean Time To Repair |
|
|
| Costo total | Suma de OTs |
|
|
| Fallas recurrentes | Misma falla >2 veces |
|
|
|
|
**Reportes:**
|
|
- Historial cronologico de OTs
|
|
- Costos acumulados
|
|
- Fallas frecuentes
|
|
- Comparativo entre unidades similares
|
|
|
|
**Tablas DDL:**
|
|
- `maintenance.historial_unidad` (vista materializada)
|
|
|
|
---
|
|
|
|
### RF-4.11.5: Disponibilidad de Flota
|
|
|
|
**Descripcion:** Controlar estado de cada unidad y bloquear si corresponde.
|
|
|
|
**Estados de unidad:**
|
|
| Estado | Puede asignarse | Motivo |
|
|
|--------|-----------------|--------|
|
|
| DISPONIBLE | Si | Lista para viaje |
|
|
| EN_VIAJE | No | Ya asignada |
|
|
| EN_TALLER | No | En mantenimiento |
|
|
| BLOQUEADA | No | Doc vencida o falla critica |
|
|
| BAJA_TEMPORAL | No | Fuera de servicio temporal |
|
|
| BAJA_DEFINITIVA | No | Vendida/siniestrada |
|
|
|
|
**Bloqueos automaticos:**
|
|
- Verificacion vehicular vencida
|
|
- Poliza de seguro vencida
|
|
- Mantenimiento preventivo vencido
|
|
- Falla critica no resuelta
|
|
|
|
**Dashboard de disponibilidad:**
|
|
- Total unidades
|
|
- Disponibles
|
|
- En viaje
|
|
- En taller
|
|
- Bloqueadas
|
|
- % disponibilidad
|
|
|
|
**Tablas DDL:**
|
|
- `fleet.unidades.estado`
|
|
- `maintenance.bloqueos_unidad`
|
|
|
|
---
|
|
|
|
## Requerimientos No Funcionales
|
|
|
|
### RNF-001: Alertas Proactivas
|
|
- Notificar 7 dias antes de vencimiento
|
|
- Notificar 1,000 km antes de servicio
|
|
- Notificar al 80% de horas de intervalo
|
|
|
|
### RNF-002: Integracion Telematica
|
|
- Obtener km/horas de ECU automaticamente
|
|
- Detectar codigos de falla OBD
|
|
|
|
### RNF-003: Movilidad
|
|
- App para mecanicos en piso
|
|
- Fotos de trabajos realizados
|
|
|
|
---
|
|
|
|
## Matriz de Trazabilidad
|
|
|
|
| RF | Tablas DDL | Endpoints | Historias |
|
|
|----|------------|-----------|-----------|
|
|
| RF-4.11.1 | planes_mto, servicios | GET/POST /planes | US-MAI013-001 |
|
|
| RF-4.11.2 | tickets, ordenes | POST /tickets | US-MAI013-002 |
|
|
| RF-4.11.3 | refacciones | GET /refacciones | US-MAI013-002 |
|
|
| RF-4.11.4 | historial_unidad | GET /historial | US-MAI013-003 |
|
|
| RF-4.11.5 | bloqueos_unidad | GET /disponibilidad | US-MAI013-003 |
|
|
|
|
---
|
|
|
|
*REQUERIMIENTOS MAI-013 - ERP Transportistas v1.0.0*
|