## Visión general

Los **Horarios** son plantillas semanales reutilizables que describen la **jornada esperada** de tu
operación dentro del módulo **Gestión de Equipo** de Conversa Labs. Cada horario tiene
un **nombre**, una **zona horaria** y un indicador **activo**. A partir de un horario **generas
turnos planificados** en un rango de fechas: la plataforma materializa los bloques semanales
recurrentes en turnos concretos y con fecha.

Esos **turnos planificados** se convierten en la línea base esperada — el "cuándo debería estar
trabajando el agente" — que la **adherencia al horario** compara contra la línea de tiempo de estados
en vivo. En otras palabras, el horario define el plan, la generación convierte el plan en turnos con
fecha, y la adherencia mide qué tanto la presencia real coincidió con ese plan.

> En esta versión, la pantalla de Horarios gestiona la **plantilla** (nombre, zona horaria, activo) y
> dispara la **generación de turnos**. El mapa de bloques recurrentes por día de la semana se define
> **vía API** por ahora (el modelo y la rutina de generación ya lo consumen). Un editor semanal
> visual es una evolución futura.

## Requisitos previos

- El módulo Gestión de Equipo es **opcional** y debe estar **habilitado en tu cuenta**. Si no encuentras el área
  Gestión de Equipo, pide a un administrador que la active.
- La pestaña **Horarios** está en la **configuración** de Gestión de Equipo y es para **administradores** (y roles
  personalizados con los permisos de Gestión de Equipo).
- Los **bloques recurrentes por día de la semana** (las horas que se repiten) se definen **vía API**
  en esta versión — la pantalla gestiona la plantilla (nombre / zona horaria / activo) y la
  generación de turnos.

## Paso a paso

### Crea un horario

1. Abre **Gestión de Equipo** → **Configuración** → **Horarios**.
2. Haz clic en **Agregar**.
3. Indica un **Nombre** (ej.: "Comercial lun–vie").
4. Elige la **Zona horaria** — los turnos se generan en esa zona, así que usa la zona de trabajo del
   equipo.
5. Deja **Activo** encendido (o apágalo para mantener el horario como borrador).
6. Haz clic en **Guardar**.

### Genera turnos a partir de un horario

1. En la fila del horario, haz clic en **Generar turnos** (ícono de calendario).
2. Elige la **fecha inicial** (desde) y la **fecha final** (hasta) del rango.
3. Haz clic en **Generar turnos**. La generación se ejecuta en segundo plano; los turnos
   planificados se materializan para todo el rango a partir de los bloques recurrentes del horario.

### Edita, desactiva o elimina

- Usa el **lápiz** para editar el nombre, la zona horaria o el estado activo.
- Apaga **Activo** para mostrar la insignia **INACTIVO**: el horario se conserva, pero deja de usarse
  como referencia.
- Usa la **papelera** para eliminar el horario.

## Configuración y opciones

| Campo / acción | Qué hace |
|---|---|
| **Nombre** | Identifica el horario en la lista. Obligatorio para guardar. |
| **Zona horaria** | La zona usada para generar los turnos. Alinéala a la zona de trabajo para que la adherencia coincida. |
| **Activo** | Mantiene el horario en uso. Apagado muestra la insignia **INACTIVO** (borrador). |
| **Generar turnos** | Materializa turnos planificados entre una fecha inicial y una fecha final. |
| **Bloques recurrentes por día** | El mapa semanal de horas, definido **vía API** en esta versión. |

## Alcance monitoreado en la generación

La generación de turnos materializa turnos **solo para agentes monitoreados**. Si un agente asignado
a una plantilla sale del monitoreo, los turnos ya generados se conservan —solo las próximas
generaciones lo omiten— y la lista de horarios muestra un aviso ámbar con cuántos agentes de la
plantilla están fuera del monitoreo.

## Casos de uso

- Modelar una jornada estándar de días hábiles y generar los turnos de todo el mes de una vez.
- Mantener un horario separado para la cobertura de fin de semana, con otro conjunto de bloques.
- Preparar la línea base esperada que alimenta la **adherencia al horario** de cada agente.
- Guardar un horario desactivado como borrador hasta validar las horas antes de generar.

## Consejos, límites y buenas prácticas

- La generación es **asíncrona** (se ejecuta en segundo plano) — los turnos aparecen poco después de
  confirmar.
- El botón **Generar turnos** solo se habilita cuando **ambas fechas** (inicial y final) están
  completas.
- Genera **un rango a la vez** y evita rangos superpuestos para no duplicar turnos planificados.
- Define la **zona horaria** del horario igual a la zona de trabajo del equipo — así la adherencia
  compara lo esperado con lo real de forma correcta.
- La **meta de adherencia** se configura en la pestaña **General** de la configuración de Gestión de Equipo, no en
  el horario.

## Solución de problemas

- **No veo la pestaña Horarios** — el módulo no está habilitado en la cuenta, o no eres administrador.
- **El botón Generar turnos está deshabilitado** — completa tanto la fecha inicial como la final.
- **No puedo guardar el horario** — el campo **Nombre** es obligatorio.
- **Los turnos generados no afectan la adherencia** — revisa que los bloques recurrentes por día se
  hayan definido vía API, que la zona horaria sea correcta y que los agentes estén monitoreados con
  una jornada esperada definida.

## Ver también

- **Visión general de Gestión de Equipo** — el panorama del módulo.
- **Panel de monitoreo** — el estado en vivo del equipo que la adherencia usa como base real.
- **Estados y pausas** — el catálogo de estados con cronómetro y límites detrás de la línea de tiempo.
- **Colas** — agrupa agentes y bandejas con una política de distribución.
- **Agentes monitoreados (inscripción)** — quién aparece en el panel y la jornada diaria esperada.