# 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*