Cierres y Vacaciones
Los cierres te permiten bloquear períodos de tiempo específicos cuando tu clínica o un proveedor no está disponible para atender pacientes. A diferencia de los horarios de trabajo (que definen disponibilidad recurrente), los cierres son excepciones temporales para fechas específicas.
¿Qué son los Cierres?
Un cierre representa un período temporal de no disponibilidad en tu clínica. Cada cierre incluye:- Fecha y hora de inicio: Cuándo comienza el período cerrado
- Fecha y hora de fin: Cuándo finaliza el período cerrado
- Tipo: Cierre de toda la clínica o solo de un proveedor específico
- Razón: Motivo del cierre (opcional pero recomendado)
- Impacto estimado: Cuántos slots de citas se bloquearán
Tipos de Cierres
Cierre de Clínica
Toda la clínica cerradaCuando ningún proveedor puede atender pacientes. Ejemplos:
- Vacaciones de verano
- Días festivos (Navidad, Año Nuevo)
- Mudanza de local
- Mantenimiento general
Cierre de Proveedor
Solo un proveedor específicoCuando un proveedor individual no está disponible. Ejemplos:
- Permiso personal
- Cita médica
- Capacitación/curso
- Vacaciones personales
Cierres vs Horarios de Trabajo
Es importante entender cuándo usar cada sistema:| Concepto | Horarios de Trabajo | Cierres |
|---|---|---|
| Propósito | Disponibilidad recurrente semanal | Excepciones temporales |
| Frecuencia | Se repiten cada semana | Fechas específicas únicas |
| Ejemplo | ”Lunes de 9:00 a 18:00" | "Cerrado del 1 al 15 de agosto” |
| Duración | Indefinida (hasta que cambies) | Temporal (inicio y fin definidos) |
| Uso recomendado | Horario normal de operación | Vacaciones, festivos, permisos |
¿Cuándo usar cada uno?
Usa Horarios de Trabajo cuando:- Defines el horario normal de tu clínica (ej: lunes-viernes 9:00-18:00)
- Cambias permanentemente el horario de un proveedor
- Configuras turnos recurrentes (mañanas/tardes)
- Planeas vacaciones (1 semana o más)
- Tienes un día festivo (1 día específico)
- Un proveedor tiene permiso temporal (2-3 días)
- Cierras por evento excepcional (mudanza, mantenimiento)
Nuevas Features (2026-01-03)
El sistema de cierres incluye características avanzadas para mejor control y visibilidad:1. Preview de Impacto
Antes de crear un cierre, puedes ver exactamente cuántos slots de citas se bloquearán y el nivel de impacto (HIGH, MEDIUM, LOW). Esto te ayuda a:- Validar que el período elegido es correcto
- Evaluar si debes notificar manualmente a tus clientes
- Considerar alternativas si el impacto es muy alto
2. Notificaciones por Email Automáticas
Si un cierre tiene impacto HIGH (todos los slots bloqueados), el sistema envía automáticamente un email de alerta para que tomes acción. Características:- Envío automático al crear el cierre
- Solo para cierres de alto impacto
- Idempotencia: 1 solo email por cierre (no duplicados)
- Incluye detalles del impacto y fechas afectadas
3. Upcoming Closures (Próximos 14 Días)
El sistema muestra advertencias tempranas de cierres que empezarán en los próximos 14 días:- Widget en Dashboard con countdown
- API endpoint
/configuration-statusincluye upcoming closures - Ordenados por proximidad (más cercanos primero)
4. Actualizaciones en Tiempo Real (WebSocket)
Cuando un cierre empieza o termina, el sistema emite eventos WebSocket (clinic_status_changed) para actualizar interfaces en tiempo real:
- Frontend se actualiza automáticamente
- No requiere refresh manual
- Sincronización instantánea entre dispositivos
Flujos de Trabajo Principales
Crear Cierre
Bloquear período de no disponibilidad
Preview de Impacto
Analizar impacto antes de crear
Ver Upcoming Closures
Revisar cierres próximos (14 días)
Cancelar Cierre
Eliminar cierre existente
Mejores Prácticas
Siempre ejecuta Preview de Impacto antes de crear
Siempre ejecuta Preview de Impacto antes de crear
Por qué es importante:
- Evitas bloquear disponibilidad sin querer
- Valideas que las fechas son correctas
- Identificas si necesitas notificar manualmente a clientes
- Completa formulario de cierre con fechas
- Click en “Preview Impacto”
- Revisa cuántos slots se bloquearán
- Solo procede si el impacto es aceptable
Usa razones descriptivas
Usa razones descriptivas
Por qué es importante:
- Facilita la auditoría y revisión histórica
- Ayuda a recordar por qué se creó el cierre
- Mejora la trazabilidad del sistema
- ✅ “Vacaciones de verano - Playa del Carmen”
- ✅ “Día festivo - Navidad”
- ✅ “Capacitación: Curso de técnicas avanzadas”
- ❌ “Cerrado” (muy genérico)
- ❌ “Vacaciones” (sin detalles)
Planifica con anticipación (14+ días)
Planifica con anticipación (14+ días)
Por qué es importante:
- Tus clientes pueden ver “Upcoming Closures” en el sistema
- Tienes tiempo para notificar manualmente si es necesario
- Reduces cancelaciones de último minuto
- Crea cierres para vacaciones con al menos 2 semanas de anticipación
- Revisa la sección “Upcoming Closures” semanalmente
- Para cierres de emergencia, notifica a clientes afectados manualmente
Usa cierres de proveedor cuando sea posible
Usa cierres de proveedor cuando sea posible
Por qué es importante:
- Mantiene disponibilidad parcial (otros proveedores siguen atendiendo)
- Reduce el impacto en la agenda general
- Los clientes tienen más opciones de horarios
- Días festivos oficiales
- Vacaciones de toda la clínica
- Mantenimiento general del local
- Vacaciones personales de un empleado
- Capacitaciones individuales
- Permisos médicos
Revisa upcoming closures semanalmente
Revisa upcoming closures semanalmente
Por qué es importante:
- Detectas conflictos con anticipación
- Puedes ajustar o cancelar si cambian planes
- Mantienes control sobre la disponibilidad futura
- Navega a Dashboard o Cierres
- Revisa sección “Próximos Cierres”
- Verifica que todos siguen siendo válidos
- Cancela los que ya no apliquen
Casos de Uso Comunes
Vacaciones de verano (2 semanas)
Vacaciones de verano (2 semanas)
Escenario: Toda la clínica cerrará del 1 al 15 de agosto.Configuración:
- Tipo: Cierre de clínica (clinic-wide)
- Inicio: 2026-08-01 00:00
- Fin: 2026-08-15 23:59
- Razón: “Vacaciones de verano”
- Todos los slots bloqueados (impacto HIGH)
- Email notification enviado automáticamente
- Upcoming closure visible desde 2026-07-18 (14 días antes)
Día festivo (Navidad)
Día festivo (Navidad)
Permiso médico (2 días)
Permiso médico (2 días)
Escenario: Proveedor “Dr. García” no disponible 3-4 de febrero.Configuración:
- Tipo: Cierre de proveedor
- Proveedor: Dr. García
- Inicio: 2026-02-03 00:00
- Fin: 2026-02-04 23:59
- Razón: “Permiso médico personal”
- Solo slots de Dr. García bloqueados (impacto MEDIUM/LOW)
- NO se envía email (impacto no es HIGH)
- Otros proveedores siguen disponibles
Capacitación (medio día)
Capacitación (medio día)
Escenario: Proveedor “Ana López” en curso de 9:00 a 14:00.Configuración:
- Tipo: Cierre de proveedor
- Proveedor: Ana López
- Inicio: 2026-03-10 09:00
- Fin: 2026-03-10 14:00
- Razón: “Capacitación: Técnicas avanzadas”
- Solo slots 9:00-14:00 de Ana bloqueados (impacto LOW)
- NO se envía email
- Disponible por la tarde (14:00-18:00)