erp-transportistas-v2/docs/02-definicion-modulos/MAI-013-mantenimiento-flota/historias-usuario/US-MAI013-003.md
Adrian Flores Cortes ec43d9c6cd docs: Add Phase 3 secondary modules specifications (P1/P2/P3)
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>
2026-01-27 02:24:35 -06:00

7.4 KiB

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