← Proyectos

Clínica Gestión para una IPS

Plataforma de microservicios para una IPS colombiana, de la admisión a la glosa. Nació como hobby con código repetido en nueve servicios; la reconstruí siguiendo la norma real de facturación en salud.

Stack
Java 21 · Spring · Kafka · OpenBao · PostgreSQL · MySQL · Docker
Estado
Terminado
Año
2025

De hobby a un sistema para clínicas reales

Clínica nació de la base de CRUD-Test, mi primer backend, y de mi trabajo en una clínica. La primera versión era un hobby: nueve servicios por capas, cada uno validando el JWT con el mismo código copiado, mucho código repetido y otro que nadie usaba.

Cuando vi que el proyecto era sobre todo el mismo código pegado en varios servicios, decidí hacerlo en serio: lo rehice con ayuda de Claude y siguiendo la norma colombiana, para que resuelva un problema real de las clínicas del país.

Lo más difícil fue el tamaño

Cada servicio resultó ser un proyecto en sí mismo: historia clínica firma notas y cifra anexos, facturación habla con la DIAN y el Ministerio. Hoy son diez servicios y más de mil archivos Java. Siete pasaron a arquitectura hexagonal, y lo que antes estaba copiado vive en cuatro librerías compartidas.

Si algo se cae, la atención sigue

Arriba lo puedes ver en las pruebas reales, tumbando pacientes u OpenBao. El mismo principio se aplica en todo el sistema:

  • Urgencias no espera a un contrato. Si contratación no responde, urgencias admite igual, porque la ley lo obliga, y facturación revisa la cobertura después.
  • Ningún evento se pierde. Cada servicio guarda sus eventos en su propia base, en la misma transacción que el cambio, y Debezium los publica en Kafka. Si Kafka cae, esperan ahí.
  • Facturar no espera a nadie. La factura se emite aunque OpenBao o la DIAN no respondan; la firma y el envío se reintentan solos.

Seguridad para datos de salud

  • Ninguna clave sale de OpenBao. En la versión anterior, la clave de los tokens terminó publicada en el repositorio; ahora los tokens, las facturas y los comprobantes se firman con claves que no se pueden exportar.
  • Cada servicio aplica los permisos de la persona. El navegador nunca ve un token, y cuando un servicio llama a otro lo hace con los permisos de quien pidió, no con los de un usuario técnico.
  • La aplicación no puede borrar. Su usuario de base de datos no borra datos clínicos ni facturas ni cambia el esquema, y los cambios quedan auditados.

Facturar como exige la norma

Es la parte que conozco del trabajo, y la que recorre la prueba de arriba. Facturación sigue el ciclo real: factura electrónica del sector salud, validación ante la DIAN, RIPS ante el Ministerio, radicación ante la EPS dentro de los 22 días hábiles y respuesta a glosas con el manual único. Un asistente con IA local revisa las facturas sin que los datos salgan de la clínica, y solo propone acciones que una persona confirma.

El frontend todavía es la base del proyecto, y el sistema no está habilitado ante la DIAN: las pruebas corren contra simuladores.