rckrdmrd/erp-clinicas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
erp-clinicas/docs/08-epicas/EPIC-CL-006-laboratorio.md

8.5 KiB
Raw Permalink Blame History

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)

  • Historias de usuario definidas
  • Criterios de aceptacion claros
  • Dependencias identificadas
  • 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