# Flujo de Configuración y Cita

Esta página describe el flujo objetivo para preparar una agenda y poder crear citas válidas. El flujo parte de una configuración general, continúa con servicios y empleados, y termina con la creación de una cita validada por backend.

<p class="callout warning">**Importante:** parte de este flujo representa el comportamiento objetivo. Algunas reglas todavía deben implementarse en el modelo y en `AppointmentModelValidator` para que sean obligatorias tanto desde la UI como desde REST/API.</p>

## Flujo objetivo

<div drawio-diagram="178"><img src="https://docs.primware.net/uploads/images/drawio/2026-05/yoFttEn6HSRcxnol-drawing-1-1779470586.png" alt=""/></div>

## Secuencia funcional

1. Crear una configuración de agenda por organización o por alcance operativo.
2. Definir reglas generales como anticipación mínima, anticipación máxima, regla de asignación y política de aprobación.
3. Definir el horario macro de la agenda. Por ejemplo: lunes a viernes de 8:00 a 17:00.
4. Relacionar cada servicio con una sola configuración de agenda.
5. Configurar cada servicio con duración, precio, intervalo de slot y si requiere aprobación.
6. Configurar empleados y definir qué servicios puede atender cada uno.
7. Definir horario laboral y días libres del empleado.
8. Crear la cita seleccionando empleado, servicio, fecha y slot.
9. Validar primero la configuración de agenda y luego las reglas del empleado.
10. Guardar la cita como pendiente o aprobada según las reglas de aprobación.

## Jerarquía de disponibilidad esperada

<table id="bkmrk-nivelreglaprioridadc" style="width: 100%; border-collapse: collapse; margin: 12px 0 20px 0;"><thead><tr><th style="border: 1px solid #d8dee9; padding: 12px; background: #eef2f7; text-align: left;">Nivel</th><th style="border: 1px solid #d8dee9; padding: 12px; background: #eef2f7; text-align: left;">Regla</th><th style="border: 1px solid #d8dee9; padding: 12px; background: #eef2f7; text-align: left;">Prioridad</th></tr></thead><tbody><tr><td style="border: 1px solid #d8dee9; padding: 12px; vertical-align: top;">**Configuración de agenda**</td><td style="border: 1px solid #d8dee9; padding: 12px; vertical-align: top;">Define el marco general de operación: anticipación, días permitidos, horarios macro y aprobación.</td><td style="border: 1px solid #d8dee9; padding: 12px; vertical-align: top;">Debe estar por encima del empleado. Si la agenda general está cerrada, ningún empleado puede abrir disponibilidad.</td></tr><tr><td style="border: 1px solid #d8dee9; padding: 12px; vertical-align: top;">**Servicio**</td><td style="border: 1px solid #d8dee9; padding: 12px; vertical-align: top;">Define duración, precio, intervalo y si requiere aprobación.</td><td style="border: 1px solid #d8dee9; padding: 12px; vertical-align: top;">Debe resolver qué configuración aplica.</td></tr><tr><td style="border: 1px solid #d8dee9; padding: 12px; vertical-align: top;">**Empleado**</td><td style="border: 1px solid #d8dee9; padding: 12px; vertical-align: top;">Define servicios que puede atender, horario propio y bloqueos personales.</td><td style="border: 1px solid #d8dee9; padding: 12px; vertical-align: top;">Solo puede reducir o especializar la disponibilidad de la configuración, no ampliarla.</td></tr><tr><td style="border: 1px solid #d8dee9; padding: 12px; vertical-align: top;">**Cita**</td><td style="border: 1px solid #d8dee9; padding: 12px; vertical-align: top;">Consume empleado, servicio, configuración, slot y reglas de conflicto.</td><td style="border: 1px solid #d8dee9; padding: 12px; vertical-align: top;">Debe ser validada por evento antes de guardarse.</td></tr></tbody></table>

## Reglas pendientes para completar el flujo

- Relacionar cada servicio con una configuración de agenda.
- Validar que un servicio no pertenezca a más de una configuración.
- Agregar horario macro de configuración, similar al horario del empleado.
- Validar anticipación mínima y máxima desde la configuración.
- Aplicar la política de aprobación automática o forzada en `BeforeNew`.
- Hacer que los días libres de organización puedan aplicar por configuración cuando corresponda.