Plataforma multirrol de acompañamiento y cuidado a domicilio
Una plataforma en monolito modular para pedidos de acompañamiento hospitalario, cuidadores y servicios a domicilio. Incluye un miniprograma para pacientes, un miniprograma y una app para cuidadores, consolas para hospitales y operador, y un dominio de libro contable separado para el reparto de pagos y la liquidación.
EN BREVE: Construimos un único backend en monolito modular que atiende a pacientes, cuidadores, hospitales y operador para pedidos de acompañamiento y cuidados a domicilio, mantuvimos los movimientos de dinero en un esquema contable aparte y limitamos la asignación y el seguimiento a lo que un miniprograma puede hacer en un teléfono.
Resumen
Pacientes y familiares hacen el pedido desde un miniprograma. Los cuidadores aceptan y completan los trabajos desde otro miniprograma y una app Flutter. Hospitales y operador usan consolas web. El desarrollo partió de una revisión de arquitectura estructurada que puso los riesgos de cumplimiento y de reparto de pagos por delante de la elección de framework.
Problema
Los servicios de acompañamiento y cuidados implican a varias partes: paciente, familia, cuidador, hospital y operador. Cada una necesita una interfaz distinta. El pago tiene que repartirse entre la plataforma y los proveedores dentro de las reglas del canal de pago. La ubicación y la asignación de trabajos también tienen que funcionar con lo que los miniprogramas pueden hacer de verdad en un teléfono.
Restricciones
- Acceso de pacientes solo a través de un miniprograma de una plataforma de mensajería. La parte de cuidadores necesita una identidad de app propia porque los dos lados requieren permisos distintos.
- Los miniprogramas se pausan en segundo plano, así que el seguimiento continuo en directo no era una promesa fiable. El texto del producto pasó a “cada paso del servicio queda registrado”.
- El canal de pago limita qué parte de un pago se puede repartir. Las reglas de liquidación tenían que caber en ese límite.
- La enfermería a domicilio se aplazó del primer hito hasta poder cumplir los requisitos de licencia y de dispositivos de registro de una norma provincial de servicios de enfermería.
Arquitectura
| Parte | Implementación |
|---|---|
| Backend | Java 21, Spring Boot 4.1; un monolito Maven multimódulo con 15 módulos, entre ellos order, staff, hospital, market, pay, settle y notify |
| Datos | PostgreSQL 17 con esquemas separados de negocio y contabilidad; jOOQ en el dominio contable, Spring Data JDBC en el de negocio; cada cambio de esquema es una migración Flyway versionada |
| Clientes | Dos miniprogramas hechos con el framework nativo de la plataforma, una app Flutter para cuidadores y consolas de hospital y operador en Vue 3 |
| Entorno local | Docker Compose con un servicio simulado de la plataforma de mensajería, para que los flujos de inicio de sesión y pago funcionen sin credenciales reales |
Decisiones clave
- Monolito modular, no microservicios. Pedido, asignación y liquidación comparten un desplegable, lo que mantiene locales sus transacciones; los límites entre módulos se imponen en el código y no a través de la red.
- Dominio contable separado. La liquidación y el reparto se escriben en SQL explícito en su propio esquema, y el dominio de negocio nunca escribe directamente registros de dinero, así que cada movimiento se puede rastrear hasta un módulo.
- Ninguna promesa que la plataforma no pueda cumplir. En lugar de lanzar el pedido para que lo tome el primero que responda, el reparto se basa en asignación dirigida, un plazo de confirmación con escalado y llamadas de voz automáticas.
- Contratos antes que código. Los contratos de API, base de datos, temas, entornos y tests se pusieron por escrito primero, y la revisión de arquitectura dejó constancia de qué puntos solo podía decidir el propietario del proyecto.
Evidencias
- 287 clases de test Java y 156 ficheros de migración versionados en el backend.
- Los documentos del repositorio incluyen un informe de auditoría completo (2026-09-17) y una revisión de entrega (2026-09-19).
Límites
No se publican volúmenes de pedidos, estado operativo actual, instituciones asociadas ni condiciones económicas. La interpretación normativa de este caso es una aportación de ingeniería, no asesoramiento legal.
Preguntas frecuentes
¿Por qué miniprogramas en lugar de una app nativa para pacientes?
Los pacientes entran escaneando un código en el hospital. La revisión de arquitectura concluyó que los miniprogramas encajan con ese punto de entrada y con los canales de pago, así que una app nativa aparte aportaría poco a los pacientes.
¿Cómo se gestiona el dinero?
El dominio del libro contable tiene su propio esquema y es el único que escribe registros de dinero. Las reglas de reparto están diseñadas dentro de los límites del canal de pago.
¿Admite seguimiento en tiempo real de los cuidadores?
La plataforma registra cada paso del servicio. No promete seguimiento continuo en directo, porque los miniprogramas no pueden seguir enviando la ubicación en segundo plano.