Salud clínica y gestión de consultas — arquitectura de pagos divididos con depósito en garantía
Una plataforma clínica de salud mental requería agendamiento confidencial, emparejamiento dinámico de profesionales y repartos de pago legalmente conformes entre clínicas y terapeutas.
Microservices • Rails API • PostgreSQL • Docker
La restricción: dinero y confidencialidad en la misma transacción
Cada uno de esos requisitos es corriente por separado. Juntos tiran en direcciones opuestas. Emparejar a un paciente con un profesional exige leer disponibilidad e idoneidad con rapidez, mientras que la confidencialidad exige que el dato clínico sea alcanzable por la menor parte posible del sistema. Y un proceso de facturación que necesita saber a quién se atendió, quién lo atendió y cuándo, para dividir un pago, es precisamente el componente que jamás debería guardar esa información.
El lado financiero traía su propia restricción. El dinero cobrado a un paciente no es de la plataforma para retenerlo libremente — se debe, en proporciones definidas, a una clínica y a un profesional. Esa división tiene que ser correcta y auditable, no meramente eventual.
La arquitectura: la separación como frontera de cumplimiento
Diseñé servicios desacoplados para autenticación, agenda y finanzas/facturación. Construí cálculos automáticos de depósito en garantía, bloqueos de calendario de citas y pipelines de verificación de perfiles.
Las fronteras entre servicios se trazaron para limitar lo que cada parte del sistema puede ver, no sólo para repartir el trabajo entre equipos. Facturación opera sobre resultados de cita y los importes debidos por ellos; calcular una división no requiere contenido clínico, así que Facturación nunca tuvo acceso a él. Esa contención es lo que mantiene manejables las obligaciones de HIPAA y LGPD — la superficie que guarda dato regulado sigue siendo lo bastante pequeña para razonarla y auditarla.
El escrow hizo honesto el camino del pago. Los fondos quedan retenidos contra una sesión efectivamente prestada y se liberan en proporciones calculadas a cada parte, de modo que ningún pago depende de que alguien recuerde conciliarlo a mano a fin de mes.
Los bloqueos de agenda resolvieron la carrera de agendamiento de forma directa. La disponibilidad del profesional está disputada — dos pacientes pueden alcanzar la misma franja en el mismo instante — y el emparejamiento sólo es fiable si reservar una franja es atómico.
El resultado
Los pagos divididos se ejecutan automáticamente entre múltiples partes, el emparejamiento de agenda se resuelve en menos de un segundo, y la plataforma opera bajo estricto cumplimiento de HIPAA y LGPD.
La ganancia estructural es que la corrección y el cumplimiento los impone la arquitectura, no el procedimiento. Facturación no puede filtrar un dato clínico que nunca se le entregó, y una doble reserva no necesita conciliarse después porque no puede crearse.
[NDA PROTECTED / ANONYMIZED]