> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cimaos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gestión de Usuarios

> Invita a tu equipo, asigna roles, configura horarios de trabajo y gestiona ausencias de cada miembro.

<Note>
  Desde la gestión de usuarios puedes administrar todo tu equipo: invitar nuevos miembros, asignar roles, configurar horarios de trabajo individuales y registrar ausencias. Es el punto central para organizar quién trabaja en tu clínica y cuándo.
</Note>

## Funcionalidades

* **Invitar miembros** al equipo por email con un rol asignado
* **Cambiar roles** de los miembros existentes
* **Configurar horarios de trabajo** individuales por día de la semana
* **Registrar ausencias** (vacaciones, licencias, feriados)
* **Eliminar usuarios** que ya no forman parte del equipo
* **Gestionar invitaciones** pendientes (reenviar o revocar)

***

## Roles disponibles

| Rol                          | Descripción                                                   | ¿Cuenta como profesional pago? |
| ---------------------------- | ------------------------------------------------------------- | :----------------------------: |
| **Administrador Secundario** | Gestiona usuarios, permisos y configuración de la clínica     |               Sí               |
| **Profesional Odontología**  | Atiende pacientes, gestiona sus citas y planes de tratamiento |               Sí               |
| **Asistente Odontología**    | Rol de apoyo administrativo y recepción                       |           No (gratis)          |

<Info>
  Tu plan de suscripción define cuántos profesionales pagos puedes tener. Los asistentes no cuentan contra ese límite, por lo que puedes agregar los que necesites sin costo adicional.
</Info>

***

## Permisos por Rol

| Funcionalidad         |     Administradores    | Profesionales | Asistentes |
| --------------------- | :--------------------: | :-----------: | :--------: |
| Invitar usuarios      |           Sí           |       No      |     No     |
| Cambiar roles         | Sí (excepto el propio) |       No      |     No     |
| Eliminar usuarios     | Sí (excepto el propio) |       No      |     No     |
| Configurar horarios   |       Sí (todos)       |       No      |     No     |
| Registrar ausencias   |       Sí (todos)       |       No      |     No     |
| Ver lista de usuarios |           Sí           |       Sí      |     Sí     |

***

## Cómo invitar un usuario

<Steps>
  <Step title="Abre Gestión de Usuarios">
    Ve a **Configuración** → **Usuarios**
  </Step>

  <Step title="Haz clic en Invitar Usuario">
    Haz clic en el botón **Invitar Usuario** en la esquina superior derecha
  </Step>

  <Step title="Ingresa el email">
    Escribe la dirección de correo electrónico del miembro del equipo
  </Step>

  <Step title="Selecciona el rol">
    Elige entre Administrador Secundario, Profesional Odontología o Asistente Odontología
  </Step>

  <Step title="Envía la invitación">
    Haz clic en **Enviar Invitación** → El sistema envía un email con el enlace para unirse
  </Step>
</Steps>

<Info>
  El botón **Invitar Usuario** siempre abre el diálogo, sin importar cuántos profesionales tengas. El aviso de límite aparece dentro del diálogo y solo cuando corresponde según el rol que elijas.
</Info>

<Warning>
  **Límite alcanzado al elegir un rol de pago.** Si seleccionas **Profesional Odontología** o **Administrador Secundario** y tu clínica ya llegó al límite de profesionales del plan, aparece un aviso amarillo dentro del diálogo —"Has alcanzado el límite de profesionales (X/Y)"— y el botón **Enviar Invitación** queda deshabilitado. Para invitar más profesionales o administradores, primero [aumenta tu plan](/configuracion/plan).

  Los **Asistentes de Odontología** son gratuitos, no cuentan en este límite y siempre se pueden invitar, incluso estando al tope del plan.
</Warning>

### Estados de invitación

| Estado        | Significado                                        |
| ------------- | -------------------------------------------------- |
| **Pendiente** | El email fue enviado pero el usuario aún no acepta |
| **Activo**    | El usuario aceptó la invitación y tiene acceso     |

### Gestionar invitaciones pendientes

Para cada invitación pendiente puedes:

* **Reenviar invitación**: Si el usuario no recibió el email o este expiró
* **Revocar invitación**: Si ya no deseas que esa persona se una

Accede a estas opciones desde el menú de tres puntos (⋯) junto a la invitación.

***

## Vistas y filtros

La lista de usuarios tiene tres pestañas:

| Pestaña          | Qué muestra                                  |
| ---------------- | -------------------------------------------- |
| **Todos**        | Usuarios activos + invitaciones pendientes   |
| **Activos**      | Solo miembros que ya aceptaron la invitación |
| **Invitaciones** | Solo invitaciones pendientes                 |

Además puedes filtrar por rol usando el dropdown **Todos los roles**.

***

## Información de cada usuario

Cada tarjeta de usuario muestra:

* Nombre y avatar
* Estado (Activo / Pendiente)
* Rol asignado
* Email
* Fecha desde que es miembro
* Días de trabajo configurados (indicadores visuales por día de la semana)

***

## Configurar horarios de trabajo

Los horarios de trabajo definen cuándo cada profesional está disponible para atender pacientes. Estos horarios bloquean automáticamente los slots no disponibles en el calendario.

<Steps>
  <Step title="Ubica al usuario">
    Busca al miembro del equipo en la lista de usuarios
  </Step>

  <Step title="Haz clic en el ícono de calendario">
    Haz clic en el ícono de calendario junto al usuario
  </Step>

  <Step title="Configura cada día">
    Para cada día de la semana, activa o desactiva el día y define los bloques horarios
  </Step>

  <Step title="Agrega bloques múltiples">
    Puedes agregar varios bloques por día (ej: 09:00-13:00 y 15:00-19:00 para jornada partida)
  </Step>

  <Step title="Guarda">
    Haz clic en **Guardar** para aplicar los cambios
  </Step>
</Steps>

<Tip>
  Los horarios se validan contra los horarios de atención de la clínica. No puedes asignar un horario fuera del rango configurado en **Configuración** → **Organización** → **Horarios de Atención**.
</Tip>

***

## Registrar ausencias

Las ausencias bloquean automáticamente los horarios de un profesional en el calendario durante el período indicado.

<Steps>
  <Step title="Ubica al usuario">
    Busca al miembro del equipo en la lista
  </Step>

  <Step title="Haz clic en el ícono de ojo">
    Haz clic en el ícono de ojo para abrir el panel de ausencias
  </Step>

  <Step title="Haz clic en Nueva Ausencia">
    Haz clic en **Nueva Ausencia** → Se abre el formulario
  </Step>

  <Step title="Selecciona las fechas">
    Elige la fecha de inicio y fin en el calendario
  </Step>

  <Step title="Elige el tipo">
    Selecciona entre **Día completo** o **Horario específico** (ausencia parcial)
  </Step>

  <Step title="Selecciona el motivo">
    Elige: Vacaciones, Licencia médica, Personal, Feriado u Otro
  </Step>

  <Step title="Guarda">
    Agrega una descripción opcional y haz clic en **Guardar**
  </Step>
</Steps>

### Tipos de ausencia

| Tipo                   | Alcance                                           |
| ---------------------- | ------------------------------------------------- |
| **Día completo**       | Bloquea todo el día de trabajo                    |
| **Horario específico** | Bloquea solo un rango horario (ej: 09:00 a 14:00) |

### Gestionar ausencias existentes

El panel de ausencias tiene dos pestañas:

* **Próximas**: Ausencias futuras (se pueden eliminar)
* **Historial**: Ausencias pasadas (solo consulta)

<Warning>
  Si las fechas seleccionadas se solapan con ausencias existentes, el sistema te mostrará una advertencia con las ausencias que podrían entrar en conflicto.
</Warning>

***

## Límite de profesionales

Tu plan de suscripción define cuántos profesionales pagos puedes tener:

| Situación                  | Indicador                                                                                                                                                                                       |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Uso normal**             | Contador "X de Y profesionales utilizados" junto al filtro de roles                                                                                                                             |
| **Cerca del límite (80%)** | Alerta amarilla "Estás cerca del límite de profesionales" con enlace para aumentar el plan                                                                                                      |
| **Al límite**              | El diálogo de invitación sigue abriéndose. Al elegir un rol de pago aparece un aviso amarillo dentro del diálogo y se deshabilita **Enviar Invitación**; los asistentes se pueden invitar igual |
| **Plan expirado**          | No se pueden enviar invitaciones (aparece un aviso de plan vencido al intentar invitar)                                                                                                         |

<Info>
  Solo los **profesionales** y **administradores secundarios** cuentan contra el límite del plan. Los asistentes no, por lo que el contador no aumenta al invitarlos.
</Info>

***

## Acciones disponibles por usuario

| Acción              | Disponible para                      | Cómo acceder                     |
| ------------------- | ------------------------------------ | -------------------------------- |
| Cambiar rol         | Usuarios activos (excepto el propio) | Menú ⋯ → **Cambiar rol**         |
| Eliminar usuario    | Usuarios activos (excepto el propio) | Menú ⋯ → **Eliminar usuario**    |
| Reenviar invitación | Invitaciones pendientes              | Menú ⋯ → **Reenviar invitación** |
| Revocar invitación  | Invitaciones pendientes              | Menú ⋯ → **Revocar invitación**  |
| Configurar horarios | Profesionales y asistentes activos   | Ícono de calendario              |
| Ver ausencias       | Profesionales y asistentes activos   | Ícono de ojo                     |

***

## Preguntas Frecuentes

<AccordionGroup>
  <Accordion title="¿Puedo cambiar mi propio rol?" icon="user-pen">
    No. Por seguridad, no puedes modificar tu propio rol ni eliminarte. Otro administrador debe hacer ese cambio.
  </Accordion>

  <Accordion title="¿Qué pasa si elimino un usuario que tiene citas?" icon="calendar-xmark">
    Las citas existentes del usuario se mantienen en el sistema. Sin embargo, ya no se podrán agendar nuevas citas con ese profesional.
  </Accordion>

  <Accordion title="¿Puedo tener más de un administrador?" icon="user-shield">
    Sí. Puedes tener un administrador principal y varios administradores secundarios. Todos tienen permisos de gestión, pero cada administrador secundario cuenta como un profesional pago en tu plan.
  </Accordion>

  <Accordion title="¿Los asistentes pueden tener horarios de trabajo?" icon="clock">
    Sí. Los asistentes pueden tener horarios de trabajo configurados para indicar su disponibilidad en la clínica.
  </Accordion>

  <Accordion title="Llegué al límite de mi plan, ¿puedo seguir invitando asistentes?" icon="user-plus">
    Sí. Los **Asistentes de Odontología** son gratuitos y no cuentan contra el límite de profesionales, así que puedes invitarlos en cualquier momento. El aviso de límite y el bloqueo del envío solo aparecen al elegir un rol de pago (Profesional o Administrador Secundario).
  </Accordion>

  <Accordion title="¿Por qué se abre el diálogo de invitación si ya estoy al límite?" icon="circle-question">
    El diálogo se abre siempre para que puedas invitar asistentes gratuitos aunque estés al tope de profesionales. Si dentro del diálogo eliges un rol de pago estando al límite, verás el aviso amarillo y el botón **Enviar Invitación** quedará deshabilitado hasta que cambies el rol o aumentes tu plan.
  </Accordion>
</AccordionGroup>

***

## Ver también

* [Permisos por Rol](/configuracion/usuarios/permisos) - Configura qué puede hacer cada rol
* [Plan y Suscripción](/configuracion/plan) - Gestiona el límite de profesionales de tu plan
* [Horarios de Trabajo](/configuracion/organizacion/horarios) - Horarios generales de la clínica

<Check>
  **Siguiente paso:** Configura los [Permisos por Rol](/configuracion/usuarios/permisos) para controlar qué acciones puede realizar cada miembro del equipo.
</Check>