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
- Código
- GitHub ↗DeepWiki ↗
Salida real de las pruebas contra el sistema completo (37 contenedores), con la DIAN y el Ministerio simulados. Las esperas largas van comprimidas.
Qué está pasando
- 01Personal con segundo factor
- 02Contrato con la EPS
- 03Paciente y episodio
- 04Historia clínica
- 05Configuración fiscal
- 06Factura firmada y DIAN
- 07RIPS y radicación
- 08Glosa y nota crédito
- 09Verificación pública
- 10Eventos por Debezium
- 11Reglas de acceso
- 01Se apaga patient-service
- 02Historia clínica sigue
- 03Un paciente nuevo, 503
- 04Vuelve patient-service
- 05Todo sano
- 01Se apaga el nodo activo
- 02Otro nodo asume
- 03Los secretos se siguen leyendo
- 04Un servicio arranca igual
- 05Vuelve el nodo
- 06Se reintegra solo
- 01Se apagan los tres nodos
- 02Los pacientes se siguen registrando
- 03Lo sellado se sigue verificando
- 04Sellar algo nuevo, 503
- 05Vuelve OpenBao
- 06Se recupera solo
La pieza interactiva de este caso está en ymid.me/projects/clinica/
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.