erp-mecanicas-diesel/docs/02-definicion-modulos/MMD-005-vehiculos/historias-usuario/US-MMD005-005-historial-servicios.md

3.1 KiB

US-MMD005-005: Ver Historial de Servicios

Metadata

Campo Valor
ID US-MMD005-005
Epica EPIC-MMD-005 - Vehiculos
Modulo vehiculos
Prioridad P0
Story Points 5
Sprint Sprint 3
Estado Backlog

Historia de Usuario

Como mecanico, quiero ver el historial completo de servicios del vehiculo, para consultar diagnosticos anteriores y evitar repetir trabajos.

Descripcion Detallada

El historial muestra todas las visitas del vehiculo al taller: ordenes de servicio, diagnosticos, refacciones usadas, y kilometraje. Permite entender el estado general del vehiculo y su historial de problemas.


Criterios de Aceptacion

Escenario 1: Ver timeline de servicios

DADO que abro el historial de un vehiculo
CUANDO se carga la vista
ENTONCES veo timeline con todas las visitas:
  | Fecha | Folio | Servicio | Km | Monto |
  | 2025-11-15 | OS-2025-0042 | Cambio aceite | 120,000 | $850 |
  | 2025-10-01 | OS-2025-0030 | Reparacion bomba | 115,000 | $8,500 |
  | 2025-08-20 | OS-2025-0018 | Diagnostico | 110,000 | $500 |

Escenario 2: Ver detalle de visita

DADO que hago clic en una orden del historial
CUANDO se abre el detalle
ENTONCES veo:
  - Trabajos realizados
  - Refacciones usadas
  - Diagnosticos con codigos DTC
  - Fotos de evidencia
  - Notas del mecanico

Escenario 3: Filtrar por tipo de servicio

DADO que quiero ver solo diagnosticos
CUANDO filtro por "Diagnosticos"
ENTONCES veo solo visitas que incluyeron diagnostico
Y puedo comparar resultados entre fechas

Escenario 4: Ver problemas recurrentes

DADO que el vehiculo tiene historial
CUANDO veo la seccion "Problemas frecuentes"
ENTONCES el sistema muestra:
  | Problema | Ocurrencias | Ultima vez |
  | Codigo P0201 | 3 veces | 2025-10-01 |
  | Fuga de aceite | 2 veces | 2025-08-20 |

Escenario 5: Grafica de kilometraje

DADO que veo el historial
CUANDO reviso "Kilometraje"
ENTONCES veo grafica de km por fecha
Y puedo estimar km promedio mensual

Componentes del Historial

Seccion Contenido
Timeline Lista cronologica de visitas
Servicios Resumen de trabajos realizados
Refacciones Partes usadas en el vehiculo
Diagnosticos Codigos DTC encontrados
Kilometraje Grafica y tabla de km
Problemas Fallas recurrentes

Tareas Tecnicas

Backend:

  • BE-094: Endpoint GET /api/vehicles/:id/history
  • BE-095: Agregacion de problemas frecuentes
  • BE-096: Calculo de km promedio

Frontend:

  • FE-093: Crear VehicleHistoryPage
  • FE-094: Crear HistoryTimeline component
  • FE-095: Crear RecurringIssuesCard
  • FE-096: Crear KmChart (recharts)

Dependencias

Depende de:

  • US-MMD005-001: Vehiculo registrado
  • US-MMD002-*: Ordenes de servicio
  • US-MMD003-*: Diagnosticos

Definition of Done (DoD)

  • Timeline de visitas
  • Detalle de cada visita
  • Filtros por tipo
  • Problemas recurrentes
  • Grafica de km
  • Tests pasando

Creada por: Requirements-Analyst Fecha: 2025-12-06