erp-clinicas/docs/08-epicas/EPIC-CL-012-imagenologia.md

12 KiB

EPICA: EPIC-CL-012 - Imagenología

Metadata

Campo Valor
ID EPIC-CL-012
Nombre Imagenología
Modulo imagenologia
Fase Fase 2 - Extensión
Prioridad P1 (Alto)
Estado Backlog
Story Points 55
Sprint(s) Sprint 15-18

Descripcion

Módulo 100% nuevo para gestión de estudios de imagen médica. Solicitud de estudios, integración con equipos de imagen, almacenamiento y visor DICOM, interpretación por radiólogo y entrega de resultados.


Objetivo de Negocio

  • Estudios de imagen integrados
  • Almacenamiento centralizado (PACS)
  • Interpretación oportuna
  • Reducción de pérdida de estudios
  • Acceso remoto a imágenes

Historias de Usuario

ID Historia Prioridad SP Estado
US-CL012-001 Como médico, quiero solicitar estudio de imagen desde la consulta P0 5 Backlog
US-CL012-002 Como técnico, quiero ver órdenes de estudios pendientes P0 3 Backlog
US-CL012-003 Como técnico, quiero registrar realización de estudio P0 3 Backlog
US-CL012-004 Como sistema, quiero recibir imágenes DICOM del equipo P0 13 Backlog
US-CL012-005 Como radiólogo, quiero ver estudios pendientes de interpretar P0 3 Backlog
US-CL012-006 Como radiólogo, quiero ver imágenes en visor DICOM profesional P0 8 Backlog
US-CL012-007 Como radiólogo, quiero dictar interpretación del estudio P0 5 Backlog
US-CL012-008 Como médico, quiero recibir notificación cuando el estudio esté listo P0 3 Backlog
US-CL012-009 Como paciente, quiero descargar mis estudios de imagen P1 5 Backlog
US-CL012-010 Como admin, quiero configurar modalidades de imagen disponibles P0 3 Backlog
US-CL012-011 Como admin, quiero ver reportes de estudios realizados P1 4 Backlog

Total Story Points: 55 SP


Flujo de Imagenología

┌─────────────┐
│  SOLICITUD  │  ← Médico solicita estudio
└──────┬──────┘
       │
       ▼
┌─────────────┐
│  RECEPCIÓN  │  ← Paciente llega
└──────┬──────┘
       │
       ▼
┌─────────────┐
│ REALIZACIÓN │  ← Técnico realiza estudio
└──────┬──────┘
       │
       ▼
┌─────────────┐
│   DICOM     │  ← Imágenes enviadas al PACS
│   UPLOAD    │
└──────┬──────┘
       │
       ▼
┌─────────────┐
│INTERPRETAC. │  ← Radiólogo analiza
└──────┬──────┘
       │
       ▼
┌─────────────┐
│  LIBERADO   │  ← Disponible para médico/paciente
└─────────────┘

Arquitectura DICOM/PACS

┌─────────────────────────────────────────────────────────┐
│              ARQUITECTURA IMAGENOLOGÍA                  │
├─────────────────────────────────────────────────────────┤
│                                                         │
│   EQUIPOS DE IMAGEN          PACS SERVER               │
│  ┌───────────────┐         ┌─────────────────┐         │
│  │  Rayos X      │ ──────► │                 │         │
│  │  (DICOM)      │         │  Orthanc /      │         │
│  └───────────────┘         │  DCM4CHEE       │         │
│  ┌───────────────┐         │                 │         │
│  │  Ultrasonido  │ ──────► │  DICOM Store    │         │
│  │  (DICOM)      │         │  DICOM Query    │         │
│  └───────────────┘         │  DICOM Retrieve │         │
│  ┌───────────────┐         │                 │         │
│  │  Tomografía   │ ──────► │                 │         │
│  │  (DICOM)      │         └────────┬────────┘         │
│  └───────────────┘                  │                   │
│                                     │                   │
│                            ┌────────┴────────┐          │
│                            │   Backend API   │          │
│                            │   (Express)     │          │
│                            └────────┬────────┘          │
│                                     │                   │
│                            ┌────────┴────────┐          │
│                            │   Visor DICOM   │          │
│                            │   (Cornerstone) │          │
│                            └─────────────────┘          │
│                                                         │
│  ESTÁNDARES:                                            │
│  ├── DICOM 3.0 para imágenes                            │
│  ├── HL7 para integraciones                             │
│  ├── IHE XDS-I.b para compartir imágenes                │
│  └── WADO-RS para acceso web                            │
│                                                         │
└─────────────────────────────────────────────────────────┘

Modalidades de Imagen

┌─────────────────────────────────────────────────────────┐
│              MODALIDADES SOPORTADAS                     │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  CR/DR - Radiología Computarizada/Digital               │
│  ├── Rayos X de tórax                                   │
│  ├── Rayos X de abdomen                                 │
│  ├── Rayos X de extremidades                            │
│  └── Rayos X de columna                                 │
│                                                         │
│  US - Ultrasonido                                       │
│  ├── Abdominal                                          │
│  ├── Pélvico                                            │
│  ├── Obstétrico                                         │
│  └── Musculoesquelético                                 │
│                                                         │
│  CT - Tomografía Computarizada                          │
│  ├── Cráneo                                             │
│  ├── Tórax                                              │
│  ├── Abdomen                                            │
│  └── Columna                                            │
│                                                         │
│  MR - Resonancia Magnética                              │
│  ├── Cerebro                                            │
│  ├── Columna                                            │
│  └── Articulaciones                                     │
│                                                         │
└─────────────────────────────────────────────────────────┘

Criterios de Aceptacion de la Epica

Funcionales:

  • Solicitar estudios de imagen
  • Ver órdenes pendientes
  • Registrar realización
  • Recibir imágenes DICOM
  • Visor DICOM profesional
  • Interpretación por radiólogo
  • Notificación de resultados
  • Descarga de estudios
  • Reportes de producción

No Funcionales:

  • Carga de imágenes < 5 segundos
  • Almacenamiento de 5+ años
  • Cumplimiento DICOM 3.0

Tecnicos:

  • Servidor PACS (Orthanc)
  • Visor Cornerstone.js
  • Integración con consultas
  • Almacenamiento escalable

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 Imágenes son parte del expediente

Desglose Tecnico

Database:

  • Schema: imaging
  • Tablas: 7 (imaging_orders, order_items, studies, series, interpretations, modalities, pacs_log)
  • Funciones: 2 (log_dicom_event, update_study_status)
  • Indices: Por paciente, médico, fecha, modalidad, estado

Backend:

  • Modulo: imaging
  • Entities: 6 (ImagingOrder, OrderItem, Study, Series, Interpretation, Modality)
  • DICOM Service: Comunicación con PACS
  • Endpoints: 15
  • Tests: 30

Frontend:

  • Paginas: 5 (ImagingOrders, Worklist, DICOMViewer, Interpretation, Reports)
  • Componentes: 15 (OrderCard, StudyThumbnail, ViewerTools, InterpretationEditor, etc.)
  • Cornerstone.js para visor DICOM
  • Stores: 1 (imagingStore)

Infraestructura:

  • Orthanc PACS Server
  • Almacenamiento S3/MinIO para imágenes
  • CDN para distribución

Endpoints API

Metodo Endpoint Descripcion
POST /api/imaging/orders Crear orden de estudio
GET /api/imaging/orders Listar órdenes
GET /api/imaging/orders/:id Detalle de orden
POST /api/imaging/orders/:id/perform Registrar realización
GET /api/imaging/studies/:id Metadatos del estudio
GET /api/imaging/studies/:id/series Series del estudio
GET /api/imaging/wado-rs/* WADO-RS para imágenes
POST /api/imaging/interpretations Crear interpretación
GET /api/imaging/worklist Lista de trabajo radiólogo

Integraciones DICOM

Operación Protocolo Uso
C-STORE DICOM Recibir imágenes de equipos
C-FIND DICOM Buscar estudios
C-MOVE DICOM Recuperar estudios
WADO-RS HTTP Acceso web a imágenes

Riesgos

Riesgo Probabilidad Impacto Mitigacion
Integración DICOM compleja Alta Alto PACS probado (Orthanc)
Almacenamiento costoso Media Medio Compresión + tiering
Visor lento Media Medio Streaming progresivo

Nota Técnica

Este módulo es 100% nuevo y requiere infraestructura especializada:

  • Servidor PACS compatible DICOM 3.0
  • Almacenamiento de gran capacidad para imágenes
  • Visor web profesional (Cornerstone.js)
  • Conocimiento de estándares médicos (DICOM, HL7, IHE)

Definition of Ready (DoR)

  • Historias de usuario definidas
  • Criterios de aceptacion claros
  • Dependencias identificadas
  • Estimacion completada
  • PACS Server seleccionado
  • Equipos DICOM compatibles

Definition of Done (DoD)

  • Flujo completo de imagenología
  • Recepción DICOM funcionando
  • Visor profesional operativo
  • Interpretación de estudios
  • 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