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>
182 lines
7.4 KiB
Markdown
182 lines
7.4 KiB
Markdown
# 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
|