# US-MAI013-003: Controlar disponibilidad de flota

**ID:** US-MAI013-003
**Modulo:** MAI-013 (Mantenimiento)
**Prioridad:** Media
**Story Points:** 5

---

## Historia de Usuario

**Como** jefe de flota
**Quiero** ver la disponibilidad real de las unidades
**Para** planear operaciones y detectar problemas de capacidad

---

## Criterios de Aceptacion

### CA-001: Dashboard de disponibilidad
**Dado** que necesito vision de la flota
**Cuando** accedo al modulo
**Entonces** veo resumen de disponibilidad por estado

### CA-002: Bloqueo automatico
**Dado** que una unidad tiene documentos vencidos
**Cuando** vence la fecha
**Entonces** se bloquea automaticamente

### CA-003: Historial de estados
**Dado** que quiero analizar una unidad
**Cuando** consulto su historial
**Entonces** veo timeline de cambios de estado

### CA-004: Alertas de baja disponibilidad
**Dado** que la disponibilidad baja del umbral
**Cuando** se detecta
**Entonces** se envia alerta a operaciones

### CA-005: Reporte de disponibilidad
**Dado** que necesito metricas
**Cuando** genero reporte
**Entonces** veo % disponibilidad por periodo

---

## Mockup / UI

### Dashboard de Disponibilidad

```
+----------------------------------------------------------+
| DISPONIBILIDAD DE FLOTA                                  |
+----------------------------------------------------------+
|                                                          |
|  +-------------+  +-------------+  +-------------+       |
|  |     35      |  |    28       |  |   80%       |       |
|  | Total Flota |  | Disponibles |  | Disponibil. |       |
|  +-------------+  +-------------+  +-------------+       |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  DISTRIBUCION POR ESTADO                                |
|                                                          |
|       Disponible ████████████████████████████ 28 (80%) |
|         En viaje ██████████████ 4 (11%)                |
|        En taller ███ 2 (6%)                            |
|        Bloqueada █ 1 (3%)                              |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  UNIDADES NO DISPONIBLES                                |
|                                                          |
|  | Unidad  | Estado    | Motivo           | Desde    |  |
|  |---------|-----------|------------------|----------|  |
|  | T-1025  | En taller | OT-0125 Frenos   | 27-ene   |  |
|  | T-1030  | En taller | OT-0124 Motor    | 25-ene   |  |
|  | T-1018  | Bloqueada | Poliza vencida   | 26-ene   |  |
|  | T-1022  | En viaje  | VJE-0130         | 26-ene   |  |
|  | T-1032  | En viaje  | VJE-0128         | 25-ene   |  |
|  | R-0045  | En viaje  | VJE-0130         | 26-ene   |  |
|  | R-0048  | En viaje  | VJE-0128         | 25-ene   |  |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  ALERTAS ACTIVAS                                        |
|                                                          |
|  [!] T-1018: Poliza vencida desde 26-ene-2026          |
|  [!] T-1015: Verificacion vence en 5 dias              |
|  [!] R-0052: Mantenimiento vencido (pendiente 800 km)  |
|                                                          |
+----------------------------------------------------------+
```

### Detalle de Unidad

```
+----------------------------------------------------------+
| UNIDAD T-1025 - Kenworth T680                         X  |
+----------------------------------------------------------+
|                                                          |
|  Estado actual: EN_TALLER                               |
|  Desde: 27-ene-2026 07:00                               |
|  Motivo: OT-0125 - Reparacion de frenos                |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  DOCUMENTACION                                          |
|                                                          |
|  | Documento        | Vigencia   | Estado    |         |
|  |------------------|------------|-----------|         |
|  | Tarjeta circ.    | 15-mar-27  | [OK]      |         |
|  | Poliza seguro    | 30-jun-26  | [OK]      |         |
|  | Verificacion     | 28-feb-26  | [30 dias] |         |
|  | Permiso SCT      | 01-dic-26  | [OK]      |         |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  MANTENIMIENTO                                          |
|                                                          |
|  | Servicio         | Ultimo     | Proximo   |         |
|  |------------------|------------|-----------|         |
|  | Cambio aceite    | 485,230 km | 500,230km |         |
|  | Rev. frenos      | En curso   | -         |         |
|  | Service mayor    | 400,000 km | 500,000km |         |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  HISTORIAL DE ESTADOS (ultimos 30 dias)                |
|                                                          |
|  27-ene 07:00  EN_TALLER      OT-0125 creada           |
|  26-ene 18:00  DISPONIBLE     VJE-0125 cerrado         |
|  20-ene 06:00  EN_VIAJE       VJE-0125 asignado        |
|  19-ene 14:00  DISPONIBLE     Liberado de taller       |
|  15-ene 08:00  EN_TALLER      OT-0118 preventivo       |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  METRICAS                                               |
|                                                          |
|  % Disponibilidad (30 dias): 78%                       |
|  Dias en taller: 7                                     |
|  Dias en viaje: 18                                     |
|  Dias disponible: 5                                    |
|                                                          |
+----------------------------------------------------------+
```

---

## Reglas de Bloqueo Automatico

| Documento/Condicion | Anticipacion | Accion |
|---------------------|--------------|--------|
| Poliza seguro | 0 dias | Bloqueo inmediato |
| Verificacion | 0 dias | Bloqueo inmediato |
| Permiso SCT | 0 dias | Bloqueo inmediato |
| Mto. preventivo | +10% km | Alerta, bloqueo a +20% |
| Falla critica | Inmediato | Bloqueo inmediato |

---

## Notas Tecnicas

- Tabla: `fleet.unidades.estado`
- Tabla: `maintenance.bloqueos_unidad`
- Vista: `maintenance.historial_estados_unidad`
- Job: `check-document-expiry.job.ts` (diario)
- Dashboard con Chart.js

---

## Definicion de Done

- [ ] Dashboard de disponibilidad
- [ ] Detalle por unidad con estados
- [ ] Bloqueo automatico por vencimientos
- [ ] Historial de cambios de estado
- [ ] Alertas por baja disponibilidad
- [ ] Reporte de % disponibilidad
- [ ] Tests de bloqueo automatico