# 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)

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