# EPICA: EPIC-CL-006 - Laboratorio

## Metadata

| Campo | Valor |
|-------|-------|
| **ID** | EPIC-CL-006 |
| **Nombre** | Laboratorio |
| **Modulo** | laboratorio |
| **Fase** | Fase 1 - MVP |
| **Prioridad** | P1 (Alto) |
| **Estado** | Backlog |
| **Story Points** | 38 |
| **Sprint(s)** | Sprint 6-7 |

---

## Descripcion

Gestión de estudios de laboratorio clínico. Solicitud de estudios desde consulta, toma de muestras, captura de resultados, valores de referencia, alertas de valores críticos y entrega de resultados al paciente.

---

## Objetivo de Negocio

- Flujo completo de laboratorio
- Resultados oportunos
- Alertas de valores críticos
- Integración con expediente clínico
- Control de calidad

---

## Historias de Usuario

| ID | Historia | Prioridad | SP | Estado |
|----|----------|-----------|-----|--------|
| US-CL006-001 | Como médico, quiero solicitar estudios de laboratorio desde la consulta | P0 | 5 | Backlog |
| US-CL006-002 | Como laboratorista, quiero ver órdenes de estudios pendientes | P0 | 3 | Backlog |
| US-CL006-003 | Como laboratorista, quiero registrar toma de muestra con hora y responsable | P0 | 3 | Backlog |
| US-CL006-004 | Como laboratorista, quiero capturar resultados de estudios | P0 | 5 | Backlog |
| US-CL006-005 | Como laboratorista, quiero ver valores de referencia al capturar | P0 | 3 | Backlog |
| US-CL006-006 | Como médico, quiero recibir alerta de valores críticos | P0 | 5 | Backlog |
| US-CL006-007 | Como paciente, quiero descargar mis resultados desde el portal | P0 | 5 | Backlog |
| US-CL006-008 | Como médico, quiero ver historial de estudios del paciente | P1 | 3 | Backlog |
| US-CL006-009 | Como admin, quiero configurar catálogo de estudios con valores de referencia | P0 | 4 | Backlog |
| US-CL006-010 | Como laboratorista, quiero validar resultados antes de liberar | P1 | 2 | Backlog |

**Total Story Points:** 38 SP

---

## Flujo de Laboratorio

```
┌─────────────┐
│  SOLICITUD  │  ← Médico solicita estudios
└──────┬──────┘
       │
       ▼
┌─────────────┐
│  RECEPCIÓN  │  ← Paciente llega a lab
└──────┬──────┘
       │
       ▼
┌─────────────┐
│TOMA_MUESTRA │  ← Flebotomía
└──────┬──────┘
       │
       ▼
┌─────────────┐
│ EN_PROCESO  │  ← Análisis en curso
└──────┬──────┘
       │
       ▼
┌─────────────┐
│  CAPTURA    │  ← Resultados capturados
└──────┬──────┘
       │
       ▼
┌─────────────┐
│ VALIDACIÓN  │  ← QC revisa
└──────┬──────┘
       │
       ▼
┌─────────────┐
│  LIBERADO   │  ← Disponible para médico/paciente
└─────────────┘
```

---

## Estructura de Resultados

```
┌─────────────────────────────────────────────────────────┐
│              RESULTADOS DE LABORATORIO                  │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  BIOMETRÍA HEMÁTICA COMPLETA                            │
│  ┌──────────────┬─────────┬──────────────┬───────────┐ │
│  │ Parámetro    │ Result. │ Referencia   │ Estado    │ │
│  ├──────────────┼─────────┼──────────────┼───────────┤ │
│  │ Hemoglobina  │ 14.5    │ 13.5-17.5    │ ✓ Normal  │ │
│  │ Hematocrito  │ 42%     │ 40-52%       │ ✓ Normal  │ │
│  │ Leucocitos   │ 12,500  │ 4,500-11,000 │ ⚠️ Alto   │ │
│  │ Plaquetas    │ 250,000 │ 150K-400K    │ ✓ Normal  │ │
│  │ Glucosa      │ 285     │ 70-100       │ 🔴 CRÍTICO│ │
│  └──────────────┴─────────┴──────────────┴───────────┘ │
│                                                         │
│  🔴 VALORES CRÍTICOS DETECTADOS                         │
│     Glucosa: 285 mg/dL - Notificar al médico            │
│                                                         │
│  Laboratorista: QFB María García                        │
│  Fecha toma: 2024-12-08 09:30                           │
│  Fecha resultado: 2024-12-08 14:45                      │
│  Validado por: Dr. Roberto Sánchez                      │
│                                                         │
└─────────────────────────────────────────────────────────┘
```

---

## Criterios de Aceptacion de la Epica

**Funcionales:**
- [ ] Solicitar estudios desde consulta
- [ ] Ver órdenes pendientes
- [ ] Registrar toma de muestra
- [ ] Capturar resultados
- [ ] Valores de referencia
- [ ] Alertas de valores críticos
- [ ] Validación de resultados
- [ ] Entrega de resultados

**No Funcionales:**
- [ ] Alerta de críticos < 1 minuto
- [ ] Historial de 5 años
- [ ] Cumplimiento normativo de laboratorio

**Tecnicos:**
- [ ] Integración con consultas
- [ ] Integración con expediente
- [ ] Notificaciones push para críticos
- [ ] Generación de PDF de resultados

---

## Dependencias

**Esta epica depende de:**
| Epica/Modulo | Estado | Bloqueante |
|--------------|--------|------------|
| EPIC-CL-001 Fundamentos | Backlog | Si |
| EPIC-CL-002 Pacientes | Backlog | Si |
| EPIC-CL-004 Consultas | Backlog | Si |

**Esta epica bloquea:**
| Epica/Modulo | Razon |
|--------------|-------|
| EPIC-CL-011 Expediente | Resultados son parte del expediente |

---

## Desglose Tecnico

**Database:**
- [ ] Schema: `laboratory`
- [ ] Tablas: 7 (lab_orders, lab_order_items, samples, results, result_values, studies_catalog, reference_values)
- [ ] Funciones: 3 (check_critical, calculate_status, validate_result)
- [ ] Indices: Por paciente, médico, fecha, estado

**Backend:**
- [ ] Modulo: `laboratory`
- [ ] Entities: 6 (LabOrder, LabOrderItem, Sample, Result, ResultValue, StudyCatalog)
- [ ] Endpoints: 15
- [ ] Tests: 30

**Frontend:**
- [ ] Paginas: 5 (LabOrders, SampleCollection, ResultCapture, ResultViewer, CatalogConfig)
- [ ] Componentes: 12 (OrderCard, ResultGrid, CriticalAlert, ReferenceIndicator, etc.)
- [ ] Stores: 1 (laboratoryStore)

---

## Endpoints API

| Metodo | Endpoint | Descripcion |
|--------|----------|-------------|
| POST | /api/laboratory/orders | Crear orden de estudios |
| GET | /api/laboratory/orders | Listar órdenes |
| GET | /api/laboratory/orders/:id | Detalle de orden |
| POST | /api/laboratory/orders/:id/sample | Registrar toma |
| POST | /api/laboratory/orders/:id/results | Capturar resultados |
| POST | /api/laboratory/orders/:id/validate | Validar resultados |
| GET | /api/laboratory/orders/:id/pdf | Descargar PDF |
| GET | /api/laboratory/history/:patientId | Historial del paciente |
| GET | /api/laboratory/studies | Catálogo de estudios |

---

## Riesgos

| Riesgo | Probabilidad | Impacto | Mitigacion |
|--------|--------------|---------|------------|
| Críticos no notificados | Baja | Alto | Múltiples canales de alerta |
| Resultados incorrectos | Media | Alto | Doble validación |
| Pérdida de muestras | Baja | Alto | Trazabilidad completa |

---

## Definition of Ready (DoR)

- [x] Historias de usuario definidas
- [x] Criterios de aceptacion claros
- [x] Dependencias identificadas
- [x] Estimacion completada
- [ ] Catálogo de estudios definido
- [ ] Valores de referencia documentados

## Definition of Done (DoD)

- [ ] Flujo completo de laboratorio
- [ ] Alertas de críticos funcionando
- [ ] Resultados en expediente
- [ ] PDF de resultados generándose
- [ ] Tests de integración pasando
- [ ] Documentación de API

---

## Historial

| Fecha | Cambio | Autor |
|-------|--------|-------|
| 2025-12-08 | Creacion de epica | Claude-Agent |

---

**Creada por:** Claude-Agent
**Fecha:** 2025-12-08
**Ultima actualizacion:** 2025-12-08
