API Multi-Tenant para Expedientes Médicos – Arquitectura, Seguridad y Estado Actual del Proyecto
API Médica Multi-Tenant: avances recientes, arquitectura y enfoque en calidad
Por Sernalabs • Noviembre 2025
En las últimas semanas, nuestro proyecto de API médica multi-tenant ha dado pasos importantes para consolidarse como una solución moderna para clínicas privadas, consultorios y desarrolladores que buscan un backend clínico seguro, modular y extensible.
Estado actual del desarrollo
La API ya cuenta con los módulos base del núcleo clínico y el primer kernel especializado (Medicina General). Además, los endpoints principales ya pasaron por pruebas unitarias y se han iniciado pruebas de integración para validar la consistencia del flujo de datos entre entidades.
- Pruebas unitarias completas para controladores de Core.
- Pruebas de integración avanzadas para entidades del núcleo (Catálogos, Usuarios, Pacientes, Roles, Recetas, Permisos, Prescripciones, etc.).
- Pruebas de integración en progreso para Medicina General (por ahora: CurrentMedication).
- Sistema de autenticación implementado con tokens JWT que incluyen TenantId, UserId y RoleId.
- Middleware global de manejo de errores con registro limpio y protección contra información sensible.
Arquitectura: modular y preparada para especialidades
La API adopta un enfoque por capas combinado con una estructura tipo micro-kernel. El núcleo contiene entidades clínicas comunes, mientras que cada especialidad vive dentro de su propio “kernel” independiente.
Actualmente están definidos:
- Core: Tenants, Usuarios, Roles, Pacientes, Catálogos, Prescripciones, Alergias, Adicciones, Datos clínicos básicos.
- Medicina General (Kernel 1): Antecedentes familiares, personales, gineco-obstétricos y medicación actual.
Este diseño permite extender el sistema sin romper lo existente —por ejemplo, agregando módulos para pediatría, estomatología o acupuntura— manteniendo la separación lógica y operativa.
Calidad y pruebas: un enfoque práctico pero riguroso
El proyecto ya no se encuentra en una fase puramente experimental: estamos realizando validaciones constantes para asegurar que los endpoints respondan de forma correcta, segura y estable.
Entre los avances más destacados:
- Todos los endpoints GET ya operan con datos reales, con validaciones pendientes para contenido exacto.
- Los métodos POST, PUT y DELETE están en desarrollo y ya se prueban directamente desde Postman.
- Los controladores están siendo ajustados para que los clientes no tengan que enviar campos como
TenantId,CreatedByoUpdatedBy, ya que ahora se obtienen internamente desde el token. - Se agregó un middleware de excepciones con logging estructurado y anonimización de datos sensibles.
Pruebas desde Swagger (autenticación incluida)
Swagger ya permite probar los endpoints autenticados: basta con ingresar el token JWT generado por el login y usar el botón Authorize para habilitar todas las llamadas protegidas.
Esto facilita a desarrolladores front-end consumir y validar los recursos de forma rápida, sin necesidad de construir un cliente aún.
Lo que viene
Aunque la API aún no está hospedada en un servidor público, el proyecto avanza con una base sólida. La siguiente etapa incluye:
- Pruebas de integración completas para Medicina General.
- Revisión de modelos para normalizar detalles clínicos complejos.
- Implementación del módulo de permisos avanzados por Tenant.
- Preparación para el despliegue en AWS.
Una invitación a desarrolladores y clínicas
Si estás construyendo un front-end clínico o necesitas integrar funciones médicas sin crear todo desde cero, esta API puede servirte como base técnica. Y si eres una clínica o consultorio privado, podrás conectar tus sistemas internos con herramientas modernas sin depender de proveedores cerrados.
Muy pronto abriremos un programa piloto para recibir retroalimentación temprana. Si quieres mantenerte al día:
👉 Únete al boletín de Sernalabs aquí
Comentarios
Publicar un comentario