Clinica23
Sistema de Información Radiológica Completo
RIS full-stack de ~76K líneas para centros de diagnóstico por imagen. 41 páginas Astro, 60+ endpoints API, visor DICOM custom (2,628 líneas), diagnóstico IA con MedGemma 1.5, dictado por voz con Chirp 2 (18 comandos médicos), facturación CASS con facturas PDF, integración HCCA HL7 v2.x, 14 tipos de consentimiento con firma digital, alertas de hallazgos críticos y portal del paciente — trilingüe (ES/EN/CA).
Año
2024 — Presente
Rol
Arquitecto & Developer Único
Tecnologías
11 tecnologías
El Desafío
Los centros de diagnóstico por imagen necesitan un RIS completo que cubra todo el flujo — desde la cita del paciente hasta la entrega del informe firmado digitalmente — con integración DICOM, diagnóstico asistido por IA, consentimiento digital, cumplimiento de facturación nacional e historia clínica compartida.
- Workflows en papel — consentimientos, peticiones de estudio e informes todavía dependen de firmas físicas y distribución manual
- Sin asistencia IA — los radiólogos interpretan estudios sin detección automática de hallazgos, comparación longitudinal ni soporte de diagnóstico diferencial
- Complejidad de facturación — la CASS de Andorra tiene coberturas por modalidad (90% RX, 60% RM, 100% mamografía screening) que requieren cálculo preciso
- Gap de interoperabilidad — la HCCA (historia clínica compartida de Andorra) exige intercambio de mensajes HL7 v2.x sobre MLLP para órdenes y resultados
El Enfoque
Construir un RIS full-stack sobre Astro 4 (modo híbrido) + React 18 con infraestructura Cloudflare (~76K líneas en 217 archivos fuente), un visor DICOM custom y doble integración IA (MedGemma para imagen + Gemini Pro para asistencia general).
- Astro híbrido — 41 páginas en 3 portales (web pública, panel admin, portal paciente) con islas React para componentes interactivos
- Visor DICOM custom — 2,628 líneas, sin cornerstone.js — window/level, zoom, pan, mediciones, anotaciones, overlay de hallazgos IA con bounding boxes coloreados por severidad
- IA dual — MedGemma 1.5 4B (Vertex AI) para análisis de imagen y detección de hallazgos + Gemini Pro (servicio de 384 líneas) para chat, resúmenes y generación de texto
- Dictado por voz — Google Cloud Speech-to-Text (Chirp 2) con 18 comandos de voz (navegación, puntuación, salto de sección) y vocabulario médico (BI-RADS, PI-RADS, TI-RADS, Lung-RADS)
La Solución
Clinica23 entrega 41 páginas, 60+ endpoints API, 51 componentes React y 10+ tablas D1 en 3 portales — con 33 archivos de test (11,738 líneas de test):
- Calendario de citas — programación multi-sala, 10 estados de cita, 3 niveles de prioridad, 9 modalidades de imagen (CT, MR, US, XR, MG, DX, NM, PT, DXA)
- Worklist — workflow de técnico para adquisición de estudios, workflow de radiólogo para interpretación, 9 estados de estudio cubriendo el ciclo completo
- Editor de informes — 1,327 líneas: secciones estructuradas (Técnica, Hallazgos, Impresión), plantillas por modalidad + parte del cuerpo, clasificación scoring (BI-RADS, PI-RADS, TI-RADS), codificación ICD-10, firma digital, dictado + asistente IA integrados
- Diagnóstico IA — MedGemma 1.5 vía Vertex AI: detección automática de hallazgos con bounding boxes, comparación longitudinal con estudios previos (componente de 659 líneas), diagnóstico diferencial, chat contextual de imagen (AIAssistant de 857 líneas)
- Alertas críticas — sistema de alertas en tiempo real de 560 líneas con audio para hallazgos urgentes que requieren acción clínica inmediata
- Facturación CASS — validación de cobertura seguridad social Andorra (RX 90%, ECO 75%, TAC 70%, RM 60%, MAM 100%), 8 estados de factura, 6 métodos de pago, facturas PDF profesionales (generador de 612 líneas con @react-pdf/renderer), IVA Andorra (0%/4.5%/9.5%)
- Integración HCCA — HL7 v2.x sobre MLLP (puerto TCP 2575): órdenes bidireccionales (ORM) + resultados (ORU), demografía de pacientes (ADT), acknowledgments (ACK)
- 14 tipos de consentimiento — rx, ct, mri, ecografía, mamografía, nuclear, intervención, biopsia, sedación, protección de datos + variantes con contraste — firma digital en canvas, soporte tutor/testigo, hash SHA-256
- Portal del paciente — 1,173 líneas, mobile-first (touch targets ≥44px): visor de estudios, descarga PDF, reserva de citas, auth por código de acceso
- Notificaciones — WhatsApp (Twilio) + Email (Resend) + llamadas de voz IA (ElevenLabs) para recordatorios de citas y entrega de resultados
- Extracción de laboratorio — componente de 662 líneas extrayendo resultados de lab desde PDF/imágenes vía MedGemma/Document AI
- Trilingüe — i18n completo en ES, EN y CA (catalán)
Resultados Clave
- ~76K líneas en 217 archivos fuente (41 páginas, 51 componentes React, 33 archivos test)
- Visor DICOM custom: 2,628 líneas con overlay IA y comparación longitudinal
- MedGemma 1.5 4B: detección automática de hallazgos, diagnóstico diferencial, chat imagen
- Dictado por voz: Chirp 2 STT con 18 comandos médicos y vocabulario radiológico
- Facturación CASS: cobertura por modalidad, facturas PDF, IVA Andorra
- HL7 v2.x HCCA: órdenes/resultados bidireccionales sobre MLLP
- 14 tipos de consentimiento con firma digital, soporte tutor, hash SHA-256
- Sistema de alertas críticas: alertas audio en tiempo real para hallazgos urgentes
- 60+ endpoints API en 3 capas (Astro, Pages Functions, backend compartido)
- Portal paciente: mobile-first con visor de estudios, reservas, descarga PDF