rckrdmrd/erp-clinicas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
62cfcdb9c9
erp-clinicas/docs/08-epicas/EPIC-CL-012-imagenologia.md

315 lines
12 KiB
Markdown
Raw Blame History

# 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
Reference in New Issue View Git Blame Copy Permalink