# 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