> ## 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.

# Tutoriales y Ayuda

> CIMAOS te guía la primera vez que entras a cada sección con tours interactivos. Si quieres repetirlos, están siempre disponibles desde el botón Ayuda del topbar.

<Note>
  La primera vez que entras a una sección clave de CIMAOS, un **tour interactivo** te muestra los elementos principales con spotlights y descripciones cortas. El sistema recuerda los tours que ya completaste y no vuelve a interrumpirte. Si quieres repetir un tour, está siempre disponible desde el botón **Ayuda** en la barra superior.
</Note>

## Cómo funcionan los tours

* **Aparecen automáticamente** la primera vez que un usuario entra a una sección con tour disponible
* Cada tour tiene varios pasos con un **spotlight** sobre el elemento explicado y un popover con título y descripción
* Puedes cerrar el tour en cualquier momento con la **X** o terminarlo con **Finalizar**
* Una vez que cierras o terminas un tour, no vuelve a aparecer automáticamente para ese usuario
* El estado de tours vistos es **por usuario**: cada profesional, asistente o administrador hace su propio onboarding

<Tip>
  Si entras a una sección que aún está cargando, el tour espera a que aparezcan los elementos antes de iniciarse. No vas a ver un tour "roto" sobre una pantalla en blanco.
</Tip>

***

## Volver a ver un tour

En cualquier momento puedes relanzar el tour de la sección donde estás:

<Steps>
  <Step title="Ve a la sección que quieres revisar">
    Por ejemplo: **Calendario**, **Dashboard**, **Configuración** o la ficha de un paciente
  </Step>

  <Step title="Haz clic en Ayuda">
    En la **barra superior** (topbar), haz clic en el botón **Ayuda** (ícono de signo de pregunta)
  </Step>

  <Step title="Sigue el tour">
    El tour de la sección actual se inicia desde el primer paso. Avanza con **Siguiente** o sal en cualquier momento.
  </Step>
</Steps>

<Info>
  El botón **Ayuda** solo aparece si la sección actual tiene un tour disponible para tu rol. En secciones sin tour, el botón no se muestra.
</Info>

***

## Tours disponibles

CIMAOS tiene tours específicos por sección. Los pasos cambian según tu rol para mostrarte solo lo relevante a tu trabajo.

| Sección                            | Administrador | Profesional | Asistente |
| ---------------------------------- | :-----------: | :---------: | :-------: |
| Dashboard                          |       Sí      |      Sí     |     Sí    |
| Calendario (Día / Semana / Global) |       Sí      |      Sí     |     Sí    |
| Ficha del Paciente                 |       Sí      |      Sí     |     Sí    |
| Reportes                           |       Sí      |      —      |     —     |
| Configuración                      |       Sí      |      —      |     —     |

<Info>
  Cada tour está adaptado al rol: el del Calendario para el Administrador menciona la vista global y el selector de profesional, mientras que el del Profesional se enfoca en su agenda personal y la vista de día/semana.
</Info>

***

## Qué cubre cada tour

<AccordionGroup>
  <Accordion title="Tour del Dashboard" icon="gauge">
    Recorre los elementos del **topbar** (cambio de clínica, navegación principal, acciones rápidas, menú de usuario) y luego los bloques propios del dashboard según tu rol:

    * **Administrador**: pulso del día, salud de la clínica, planes de tratamiento, agenda, notas pendientes y detalle de cobros.
    * **Profesional**: tu jornada, resumen del día, tu agenda y notas pendientes.
    * **Asistente**: pulso del día, cobros, horarios disponibles y agenda completa.

    Aparece al entrar a `/dashboard` por primera vez.
  </Accordion>

  <Accordion title="Tour del Calendario" icon="calendar">
    Cubre los elementos del calendario: título, selector de profesional (solo Administrador), selector de vista (Día / Semana / Global), navegación por fecha y la grilla de horarios.

    Aparece al entrar por primera vez a cualquiera de las vistas: `/calendar/day`, `/calendar/week` o `/calendar/global`.
  </Accordion>

  <Accordion title="Tour de la Ficha del Paciente" icon="user">
    Recorre las pestañas de la ficha: **Odontograma**, **Evoluciones**, **Sesiones**, **Imágenes**, **Recetas**, **Pagos** y **Recordatorios**, explicando para qué sirve cada una.

    Aparece la primera vez que abres la ficha de cualquier paciente. Disponible para los tres roles.
  </Accordion>

  <Accordion title="Tour de Reportes" icon="chart-line">
    Muestra los tres reportes principales: **Recaudación**, **Deuda Pacientes** y **Rendimiento por profesional**.

    Aparece al entrar a `/reports/revenue` por primera vez. Solo para Administrador.
  </Accordion>

  <Accordion title="Tour de Configuración" icon="gear">
    Recorre las secciones de Configuración agrupadas: **Mi Clínica** (Organización, Plan, Usuarios, Permisos), **Agenda** (Calendario, Reserva Online, Tipos de sesión, Boxes), **Clínica** (Pacientes, Nomenclatura), **Facturación** (Convenios, Aranceles, Agrupaciones) y **Sistema** (Ajustes, Exportar).

    Aparece al entrar a `/settings/organization` por primera vez. Solo para Administrador.
  </Accordion>
</AccordionGroup>

***

## Tours por rol

Algunos tours tienen versiones distintas según quién los vea, porque el dashboard, el calendario y los reportes muestran información diferente para cada rol.

### Dashboard

* **Administrador**: enfocado en gestión de clínica (salud, cobros, planes de tratamiento, notas pendientes de todos)
* **Profesional**: enfocado en su jornada personal (sus citas, sus notas pendientes)
* **Asistente**: enfocado en operación de recepción (citas sin confirmar, horarios libres, agenda completa)

### Calendario

* **Administrador**: incluye la **vista global** y el **selector de profesional** para ver agendas de todos
* **Profesional**: enfocado en vista de **Día** y **Semana** para su propia agenda
* **Asistente**: incluye la vista global y herramientas para gestionar citas de todos los profesionales

***

## Preguntas Frecuentes

<AccordionGroup>
  <Accordion title="¿Puedo desactivar los tours para un usuario?" icon="circle-question">
    Los tours son automáticos solo la primera vez. Si un usuario los cierra (con X o Finalizar), no vuelven a aparecer. No hay una opción global para desactivarlos en toda la clínica.
  </Accordion>

  <Accordion title="¿Si invito a un usuario nuevo, también verá los tours?" icon="user-plus">
    Sí. El estado de tours vistos es por usuario, así que cada profesional, asistente o administrador nuevo recibe sus tours la primera vez que entra a cada sección.
  </Accordion>

  <Accordion title="¿Puedo reiniciar los tours para volver a verlos todos?" icon="rotate-left">
    Cada tour se relanza desde el botón **Ayuda** del topbar cuando estás en la sección correspondiente. Hoy no hay un botón único que reinicie todos los tours a la vez.
  </Accordion>

  <Accordion title="¿Por qué no veo el botón Ayuda en algunas pantallas?" icon="circle-info">
    El botón **Ayuda** solo aparece cuando la sección actual tiene un tour disponible para tu rol. En pantallas sin tour (por ejemplo, una vista interna sin onboarding), el botón se oculta para no confundir.
  </Accordion>

  <Accordion title="¿Los tours se traducen a otros idiomas?" icon="language">
    Hoy los tours están en español neutro, igual que el resto de la interfaz. CIMAOS opera en toda Latinoamérica, y los textos están escritos en español neutro para todos los países.
  </Accordion>
</AccordionGroup>

***

## Ver también

* [Dashboard](/dashboard) — Sección con tour específico por rol
* [Calendario](/calendar/index) — Sección con tour específico por rol
* [Ficha del Paciente](/pacientes/index) — Sección con tour disponible para todos los roles

<Check>
  **Siguiente paso:** Si recién empiezas con CIMAOS, deja que los tours te guíen al entrar a cada sección. Si necesitas repasar uno, recuerda que el botón **Ayuda** en el topbar siempre está disponible.
</Check>