Salud
Plataforma de microservicios para una operación clínica
Plataforma modular y estrategia de cutover por dominios para reemplazar gradualmente un backend legacy.
Tipo de cliente
Clínica especializada en Lima, en transición gradual desde un backend legacy
Desafío
La fricción operativa a resolver.
La clínica sigue trabajando durante la transición
En Dermathani, una clínica de dermatología y estética en Lima, recepción necesita trabajar mientras el software evoluciona. La agenda, las visitas, la caja y el inventario tienen responsabilidades distintas, pero comparten la misma operación. Construí Dermhub para darles una estructura propia y mantener conectados los procesos que la clínica ya utiliza.
Al 22 de junio de 2026, la plataforma cuenta con 24 componentes productivos con comprobaciones de salud satisfactorias. La cifra reúne servicios de dominio, interfaz, capa de acceso e infraestructura. Detrás de ese conjunto hay una decisión concreta: separar responsabilidades y conservar los contratos que sostienen el trabajo diario.
La clínica sigue trabajando durante la transición
El sistema anterior reúne procesos históricos, datos existentes y superficies de trabajo activas. La transición exige mantener esa continuidad mientras cada dominio adquiere sus propias reglas. Una cita pertenece a la agenda; una venta involucra caja y facturación; un movimiento de existencias corresponde a inventario. Mezclar esas responsabilidades dificulta saber dónde aplicar un cambio y qué otras funciones dependen de él.
El problema de ingeniería consiste en trasladar esas responsabilidades sin exigir un reemplazo simultáneo de toda la operación. Recepción ya utiliza aplicaciones conectadas con la plataforma. Los datos comerciales reciben información de citas. Esa dependencia real determina el orden de la modernización: cada servicio debe encajar en un sistema que sigue trabajando.
Por eso definí una transición por dominios. Mantener interfaces compatibles y un puente con el sistema anterior forma parte de la arquitectura, tanto como desarrollar las funciones nuevas.
Enfoque
Dónde trazamos los límites de la plataforma
Un acceso común, responsabilidades separadas
Construí una capa de acceso entre la interfaz y los servicios. Desde ella se articulan usuarios, catálogo, agenda, visitas, caja, facturación, comprobantes electrónicos, inventario, comunicaciones, documentos y personal. Cada dominio concentra su lógica; la interfaz dispone de un punto común para trabajar con esas capacidades.
La decisión evita que cada pantalla tenga que resolver por su cuenta cómo conectarse con todos los servicios. Frente a un reemplazo integral del backend, elegí una estructura que admite cambios por dominio y conserva la compatibilidad durante la transición. La separación responde a responsabilidades de negocio reconocibles para quienes operan la clínica.
El puente forma parte del producto
El puente con los sistemas existentes sostiene la importación y la compatibilidad. La plataforma incorpora trabajos de sincronización y una matriz de rutinas para hacer explícita esa convivencia. Los grupos de ventas del sistema anterior se persisten antes de su importación; la entrada incorpora control de idempotencia dentro del ámbito de cada organización.
Este diseño conserva una referencia estable para procesar la información. La alternativa de reemplazar todas las conexiones en una sola intervención concentra demasiadas dependencias en el mismo cambio. La transición por dominios mantiene una ruta concreta para trasladar funciones y verificar cada integración.
Lo que recepción utiliza y lo que el sistema conecta
La identidad de una operación atraviesa sus servicios
En caja, la clave de idempotencia acompaña la operación desde la solicitud hasta el servicio que la procesa. La capa de acceso exige consistencia entre la clave del encabezado y la del cuerpo, y la transmite al siguiente servicio. Así, el control de reintentos forma parte del contrato entre componentes.
Los permisos también viajan con el contexto de la operación. Para los comprobantes electrónicos, la autenticación entre servicios cumple una función de transporte; el acceso aplica permisos específicos y transmite la identidad del actor. Separé ambas responsabilidades para que una credencial técnica no sustituya la autorización de quien ejecuta la acción.
Estar encendido y estar listo son comprobaciones distintas
La plataforma verifica tanto la actividad del servicio como su disponibilidad para trabajar. En el puente, la base de datos y el sistema de eventos son dependencias críticas. Una integración opcional con la copia comercial se trata como opcional cuando no está configurada. El criterio de disponibilidad refleja lo que cada componente necesita para cumplir su función.
Completé esa estructura con despliegue automatizado, comprobaciones de salud y observabilidad. La validación incluye acceso autenticado a funciones operativas y revisión de las rutas de la interfaz. El despliegue se evalúa desde las capacidades que entrega a la clínica.
Producción comprobada, función por función
Lo que recepción utiliza y lo que el sistema conecta
La plataforma sostiene la aplicación interna de recepción y alimenta citas hacia el dato comercial. Ambas funciones están identificadas como activas al 8 de julio de 2026. Ese uso conecta la arquitectura con el trabajo de la clínica: hay aplicaciones que dependen de su continuidad y datos operativos que circulan hacia otros procesos.
La interfaz reúne acceso a agenda, visitas, punto de venta, facturación, inventario y administración. Los servicios de comunicaciones exponen intenciones y plantillas; documentos dispone de plantillas y trabajos de generación; personal organiza integrantes y tareas. Estas funciones tienen contratos diferenciados y conviven detrás de una misma plataforma.
La operación técnica comprueba el estado de los componentes y sus dependencias. El equipo dispone de señales para distinguir la actividad de un proceso de su capacidad para atender solicitudes. Esa distinción guía la verificación de cada despliegue.
Resultado
Producción comprobada, función por función
Al 22 de junio de 2026, los 24 componentes productivos presentan un estado de salud satisfactorio. Las comprobaciones autenticadas reciben respuestas correctas en agenda, cola de visitas, punto de venta, ventas, saldos, comprobantes, existencias, movimientos, comunicaciones, documentos y personal. La interfaz sirve las rutas operativas y de administración incluidas en la verificación.
La responsabilidad completa es la unidad de cambio
El resultado es una plataforma modular con funciones expuestas y verificadas en producción, compatibilidad preservada y aplicaciones internas en uso. Recepción tiene una herramienta hecha a su medida; las citas alimentan el dato comercial; la evolución técnica sigue una separación explícita de responsabilidades.
La cifra de componentes describe el alcance del sistema. Su valor operativo está en lo que sostienen juntos: acceso a funciones de la clínica y continuidad de las aplicaciones que dependen de ellas.
La responsabilidad completa es la unidad de cambio
En este proyecto, la unidad útil de modernización es una responsabilidad completa: sus datos, permisos, interfaces y comprobaciones. Separar código adquiere sentido cuando también queda claro cómo una operación cruza los límites entre servicios y cómo se verifica su resultado.
La compatibilidad necesita diseño propio. Darle un puente, rutinas identificadas y reglas de importación convierte la convivencia en una parte explícita del sistema. Ese criterio sostiene la evolución de Dermhub mientras Dermathani continúa atendiendo.
Si tu operación depende de sistemas que deben seguir funcionando durante una modernización, agenda un diagnóstico operativo. Revisamos qué responsabilidades separar, qué contratos conservar y cómo verificar cada paso con las personas que usan el sistema.
Evidencia y resultados documentados
- componentes productivos con comprobaciones de salud satisfactorias — 24 — al 22 de junio de 2026
Sistema aplicado
Servicios y solución relacionados.
La operación ya tiene CRM, legacy, hojas o sistemas internos que no pueden reemplazarse de golpe.
Integración de IA a sistemas existentes
Añade IA sobre el stack actual sin romper procesos, datos ni continuidad operativa.
Diseño de una transición operable
Diseño de soluciones de IA y automatización
Una solución viable y una transición por etapas sin detener la operación.
Construcción con controles operativos
Implementación de IA y automatización
Convertir una prioridad clara en una solución que el equipo pueda usar.
FAQ
Preguntas sobre este caso
¿Qué hace Dermhub dentro de Dermathani?
Sostiene aplicaciones internas, incluida recepción, y alimenta citas hacia el dato comercial. Organiza servicios de agenda, visitas, caja, facturación, inventario, comunicaciones, documentos y personal. El caso la sitúa dentro del recorrido operativo descrito y limita el alcance a las decisiones, controles y resultados documentados; no añade capacidades, impactos ni condiciones que no estén respaldados por esa evidencia.
¿Qué significa la cifra de 24 componentes?
Es el conjunto productivo verificado al 22 de junio de 2026. Incluye servicios de dominio, interfaz, capa de acceso e infraestructura; cada componente cumple una responsabilidad dentro de la plataforma. El caso la sitúa dentro del recorrido operativo descrito y limita el alcance a las decisiones, controles y resultados documentados; no añade capacidades, impactos ni condiciones que no estén respaldados por esa evidencia.
¿Cómo convive con los sistemas anteriores?
Mediante un puente de importación y sincronización, contratos compatibles y una transición por dominios. Los procesos históricos siguen conectados mientras las responsabilidades se trasladan a servicios propios. El caso la sitúa dentro del recorrido operativo descrito y limita el alcance a las decisiones, controles y resultados documentados; no añade capacidades, impactos ni condiciones que no estén respaldados por esa evidencia.
¿Cómo se controla un reintento de caja?
La operación lleva una clave de idempotencia consistente. La capa de acceso la valida y la transmite al servicio siguiente para conservar la identidad de la solicitud durante el reintento. El caso la sitúa dentro del recorrido operativo descrito y limita el alcance a las decisiones, controles y resultados documentados; no añade capacidades, impactos ni condiciones que no estén respaldados por esa evidencia.
¿Cómo verificas que la plataforma está lista para operar?
Con comprobaciones de actividad y disponibilidad, revisión de dependencias y solicitudes autenticadas a funciones operativas. La verificación también incluye las rutas de la interfaz que utiliza el equipo. El caso la sitúa dentro del recorrido operativo descrito y limita el alcance a las decisiones, controles y resultados documentados; no añade capacidades, impactos ni condiciones que no estén respaldados por esa evidencia.