erp-mecanicas-diesel/docs/08-epicas/EPIC-MMD-003-diagnosticos.md

210 lines
6.4 KiB
Markdown

# EPICA: EPIC-MMD-003 - Diagnosticos y Pruebas
## Metadata
| Campo | Valor |
|-------|-------|
| **ID** | EPIC-MMD-003 |
| **Nombre** | Diagnosticos y Pruebas |
| **Modulo** | diagnosticos |
| **Fase** | Fase 1 - MVP |
| **Prioridad** | P0 (Critico) |
| **Estado** | Backlog |
| **Story Points** | 42 |
| **Sprint(s)** | Sprint 3-4 |
---
## Descripcion
Modulo especializado para el registro y seguimiento de diagnosticos y pruebas realizadas a equipos diesel. Incluye diagnosticos computarizados, pruebas de banco (inyectores, bombas), mediciones y resultados con parametros de referencia. Permite documentar problemas encontrados y recomendaciones.
---
## Objetivo de Negocio
- Estandarizar proceso de diagnostico
- Documentar problemas y soluciones para consulta futura
- Justificar trabajos ante el cliente con evidencia
- Reducir diagnosticos repetidos (consulta de historial)
- Base para cotizaciones precisas
---
## Historias de Usuario
| ID | Historia | Prioridad | SP | Estado |
|----|----------|-----------|-----|--------|
| US-MMD003-001 | Como mecanico, quiero registrar diagnostico computarizado con codigos de error para documentar fallas | P0 | 8 | Backlog |
| US-MMD003-002 | Como mecanico, quiero registrar pruebas de banco de inyectores con resultados para evaluar estado | P0 | 8 | Backlog |
| US-MMD003-003 | Como mecanico, quiero registrar pruebas de bomba de inyeccion con parametros para diagnosticar | P0 | 5 | Backlog |
| US-MMD003-004 | Como mecanico, quiero comparar resultados vs valores de referencia para determinar estado | P0 | 5 | Backlog |
| US-MMD003-005 | Como mecanico, quiero adjuntar fotos de partes danadas para evidencia | P1 | 5 | Backlog |
| US-MMD003-006 | Como mecanico, quiero registrar recomendaciones de reparacion para la cotizacion | P0 | 3 | Backlog |
| US-MMD003-007 | Como jefe de taller, quiero ver historial de diagnosticos por vehiculo para consulta | P1 | 5 | Backlog |
| US-MMD003-008 | Como admin, quiero configurar tipos de prueba con parametros de referencia | P2 | 3 | Backlog |
**Total Story Points:** 42 SP
---
## Tipos de Diagnostico Soportados
### Diagnostico Computarizado (OBD/Scanner)
| Campo | Descripcion |
|-------|-------------|
| Codigo DTC | Codigo de falla (ej: P0201) |
| Descripcion | Descripcion del codigo |
| Sistema | Motor, Transmision, Frenos, etc. |
| Gravedad | Critico, Importante, Menor |
| Congelado | Si/No (freeze frame) |
### Prueba de Banco - Inyectores
| Parametro | Unidad | Rango Normal |
|-----------|--------|--------------|
| Presion Apertura | PSI | 2800-3200 |
| Patron de Spray | Visual | Uniforme |
| Retorno | ml/min | 0-20 |
| Goteo | Visual | Ninguno |
| Caudal | ml/100 inyecciones | 45-55 |
### Prueba de Banco - Bomba Inyeccion
| Parametro | Unidad | Descripcion |
|-----------|--------|-------------|
| Presion Maxima | PSI | A RPM especificadas |
| Caudal por Cilindro | ml/min | Balance entre cilindros |
| Timing | Grados | Punto de inyeccion |
| Curva de Avance | Grafica | Comportamiento vs RPM |
### Mediciones Generales
| Medicion | Unidad | Equipo |
|----------|--------|--------|
| Compresion | PSI | Compresimetro |
| Voltaje Bateria | V | Multimetro |
| Resistencia Sensor | Ohms | Multimetro |
| Temperatura | C | Termometro |
| Presion Aceite | PSI | Manometro |
---
## Criterios de Aceptacion de la Epica
**Funcionales:**
- [ ] Registro de diagnostico computarizado con codigos
- [ ] Registro de pruebas de banco con plantillas
- [ ] Comparacion automatica vs valores de referencia
- [ ] Semaforo de estado (verde/amarillo/rojo)
- [ ] Adjuntar fotos como evidencia
- [ ] Generar recomendaciones de reparacion
- [ ] Vincular diagnostico a orden de servicio
**No Funcionales:**
- [ ] Carga de formulario diagnostico < 1 segundo
- [ ] Soporte de imagenes hasta 5MB
- [ ] Historial consultable en < 500ms
**Tecnicos:**
- [ ] Almacenamiento de imagenes (S3 o local)
- [ ] Integracion con modulo Vehiculos
- [ ] Integracion con modulo Ordenes
- [ ] Export a PDF de diagnostico
---
## Dependencias
**Esta epica depende de:**
| Epica/Modulo | Estado | Bloqueante |
|--------------|--------|------------|
| EPIC-MMD-001 Fundamentos | Backlog | Si |
| EPIC-MMD-005 Vehiculos | Backlog | Si |
**Esta epica bloquea:**
| Epica/Modulo | Razon |
|--------------|-------|
| EPIC-MMD-002 Ordenes | Requiere diagnosticos |
| EPIC-MMD-006 Cotizaciones | Usa recomendaciones |
---
## Desglose Tecnico
**Database:**
- [ ] Schema: `service_management` (compartido con ordenes)
- [ ] Tablas: 6 (diagnosticos, diagnostico_items, pruebas_banco, fotos, referencias, etc.)
- [ ] Funciones: 2 (evaluar_resultado, generar_reporte)
**Backend:**
- [ ] Modulo: `diagnostics`
- [ ] Entities: 5 (Diagnostic, DiagnosticItem, BenchTest, Photo, Reference)
- [ ] Endpoints: 15+
- [ ] Tests: 25+
**Frontend:**
- [ ] Paginas: 3 (DiagnosticForm, DiagnosticDetail, DiagnosticHistory)
- [ ] Componentes: 12+ (DTCInput, BenchTestForm, PhotoUpload, ResultCard, etc.)
- [ ] Stores: 1 (diagnosticsStore)
---
## Endpoints API
| Metodo | Endpoint | Descripcion |
|--------|----------|-------------|
| POST | /api/diagnostics | Crear diagnostico |
| GET | /api/diagnostics/:id | Detalle diagnostico |
| POST | /api/diagnostics/:id/dtc | Agregar codigo DTC |
| POST | /api/diagnostics/:id/bench-test | Agregar prueba banco |
| POST | /api/diagnostics/:id/photos | Subir foto |
| GET | /api/vehicles/:id/diagnostics | Historial por vehiculo |
| GET | /api/references/injectors/:type | Valores referencia |
| GET | /api/diagnostics/:id/pdf | Exportar PDF |
---
## Riesgos
| Riesgo | Probabilidad | Impacto | Mitigacion |
|--------|--------------|---------|------------|
| Valores referencia incompletos | Alta | Medio | Permitir captura manual |
| Fotos muy pesadas | Media | Bajo | Compresion automatica |
| Mecanicos no documentan | Alta | Alto | UI simple, campos minimos |
---
## Definition of Ready (DoR)
- [x] Historias de usuario definidas
- [x] Criterios de aceptacion claros
- [x] Tipos de diagnostico identificados
- [x] Parametros de referencia documentados
- [ ] Diseno de formularios aprobado
## Definition of Done (DoD)
- [ ] Formularios de diagnostico funcionando
- [ ] Pruebas de banco con plantillas
- [ ] Comparacion vs referencia operativa
- [ ] Upload de fotos funcionando
- [ ] Export PDF
- [ ] Tests pasando
- [ ] Demo realizada
---
## Historial
| Fecha | Cambio | Autor |
|-------|--------|-------|
| 2025-12-06 | Creacion de epica | Requirements-Analyst |
---
**Creada por:** Requirements-Analyst
**Fecha:** 2025-12-06
**Ultima actualizacion:** 2025-12-06