Visión general



Funcionalidades principales
Control de Acceso Basado en Roles (RBAC)
- Superadmin: Configuración general del establecimiento (límite de reservas por usuario, duración estándar de consultas, horarios generales) y administración de administradores.
- Admin: Gestión de sucursales, servicios, asignación de profesionales a agendas y administración centralizada de turnos.
- Paciente / Usuario: Interfaz intuitiva para buscar servicios y profesionales, reservar turnos, reprogramar citas existentes y consultar su historial médico de reservas.
Gestión de Agendas
- Definición de horarios estándar por profesional y sucursal.
- Capacidad de deshabilitar días específicos o modificar la duración y ventanas horarias de consulta para fechas particulares (schedule_config).
Motor de Notificaciones (Email + WhatsApp)
- Envío automático de confirmaciones inmediatas al reservar.
- Recordatorios automáticos despachados mediante tareas periódicas (24 horas y 2 horas antes de cada cita).
- Notificaciones automáticas de cancelación con motivos adaptados según si cancela el paciente o la clínica.
Seguridad
- Cierre automático de sesión tras un periodo prolongado de inactividad para proteger la privacidad de los datos médicos.
- Políticas de Seguridad a Nivel de Fila (RLS) en PostgreSQL que garantizan que cada usuario y médico solo pueda acceder a los datos que le corresponden.
Tecnologías utilizadas
- ⚛️ Framework principal: Next.js 16 (App Router) con React 19 y TypeScript.
- 🗄️ Base de datos y Auth: Supabase (PostgreSQL, Row Level Security) y manejo de sesiones del lado del servidor via @supabase/ssr.
- ⚡ Manejo de estado: TanStack React Query v5 para optimización de caché y sincronización de datos en tiempo real.
- 📋 Formularios y Validación: React Hook Form junto con esquemas de validación estrictos en Zod.
- 🎨 Estilos: Tailwind CSS v4, componentes accesibles basados en @base-ui/react y Lucide React.
- ✉️ Correos electrónicos: Resend para envíos transaccionales.
- 💬 Mensajería: API Cloud de Meta WhatsApp Business para el envío automatizado de plantillas de WhatsApp.
- ⏰ Tareas Programadas: Vercel Crons para la activación periódica de recordatorios.
