Agenda Citara
SaaS de agendamiento multi-tenant con un motor propietario de Control de Flujo en Tiempo Real que recalcula dinámicamente toda la agenda del día cuando una cita se extiende.
¿Cuál era el problema a resolver?
Los profesionales de servicios (médicos, terapeutas, consultores) lidian con calendarios rígidos. Cuando una sola cita se extiende 15 minutos, el resto del día colapsa — salas de espera llenas y clientes frustrados. Además, los recordatorios automáticos de WhatsApp vía proveedores tradicionales como Twilio tienen costos unitarios elevados que erosionan los márgenes de los profesionales independientes.
Cómo lo resolvimos en Núcleo Studio
Diseñé una plataforma de agendamiento multi-tenant altamente escalable. Más allá de las funciones estándar de reserva, Citara introduce un Módulo de Control de Flujo en Tiempo Real (MTR) que recalcula y desplaza dinámicamente toda la agenda del día si una cita se extiende. Para resolver el problema del costo de notificaciones, construí una arquitectura de mensajería híbrida que permite a los usuarios usar plantillas oficiales o conectar su WhatsApp personal mediante un microservicio descentralizado.
⚙️ Ejecución Técnica & Arquitectura
1. Motor MTR & Reprogramación Dinámica
Un motor algorítmico (/api/mtr/appointment/delay) intercepta los check-outs tardíos. Cuando una sesión excede su tiempo asignado, el sistema calcula el desfase en minutos, verifica los límites de buffer configurados por el usuario y propaga el retraso a todas las citas siguientes. Los clientes reciben automáticamente un mensaje de WhatsApp con su nuevo horario ajustado.
2. Microservicio Híbrido de WhatsApp Desacoplado
Diseñé un sistema de mensajería de doble canal para reducir drásticamente los costos de notificación. Los usuarios pueden optar por entrega estándar vía Twilio, o conectar su WhatsApp personal usando un microservicio Node.js/Express basado en @whiskeysockets/baileys. Un pipeline de sincronización con AWS S3 persiste los estados de autenticación entre reinicios de contenedores serverless — habilitando mensajería automatizada de costo cero directamente desde el número del profesional.
3. Facturación por Excedente con Stripe (Webhooks)
Diseñé una integración compleja de Stripe que maneja suscripciones de tarifa plana (Pro/Premium) junto con facturación por uso. El backend registra la cuota mensual de notificaciones en PostgreSQL. Si un usuario supera su límite, el sistema dispara un webhook checkout.session.completed para agregar automáticamente un ítem de excedente medido a su suscripción de Stripe, limitando dinámicamente para evitar facturas inesperadas.
4. Base de Datos en Tiempo Real & Row-Level Security (RLS)
Aseguré la arquitectura multi-tenant con Row-Level Security de Supabase, garantizando aislamiento absoluto de datos entre profesionales. La replicación lógica de PostgreSQL (Supabase Realtime) transmite actualizaciones instantáneas de UI vía WebSockets — el dashboard del operador refleja los estados de citas sin polling manual.
El impacto en el negocio
Se entregó una plataforma SaaS de alto margen. Al ofrecer el microservicio de WhatsApp personal, se reduce la fricción de adquisición (sin costos extra de mensajes), mientras que los usuarios avanzados ascienden naturalmente a tiers Premium para reportes avanzados y funciones MTR. La arquitectura serverless y optimizada para edge mantiene los costos de infraestructura despreciables, escalando de forma rentable desde el día uno.
¿Tu empresa tiene un cuello de botella similar?
Analizamos tu operación y te mostramos exactamente cómo podemos automatizarla. Sin compromiso.