# 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
