243 lines
8.5 KiB
Markdown
243 lines
8.5 KiB
Markdown
# 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
|