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

# Vista Semana

> Usa la Vista Semana para planificar 7 días completos de un vistazo, identificar patrones y optimizar tu agenda semanal.

Esta vista muestra 7 días completos en columnas, desde el primer día de la semana (configurable) hasta el último.

## Cuándo usar

* Quieres planificar tu semana completa de trabajo
* Necesitas identificar días con baja o alta demanda
* Quieres ver patrones de ocupación en tu agenda
* Buscas el mejor momento para agendar pacientes recurrentes

***

## Cómo activar

<Steps>
  <Step title="Abre el calendario">
    Entra al módulo "Calendario" desde el menú lateral → Se abre el calendario
  </Step>

  <Step title="Activa la vista">
    Haz clic en el botón "Semana" en la esquina superior derecha
  </Step>

  <Step title="Observa la pantalla">
    Verás 7 columnas, una por cada día de la semana
  </Step>
</Steps>

Ahora tienes una vista panorámica de tu agenda semanal completa.

\[Screenshot sugerida: Vista Semana mostrando Lunes a Domingo con citas distribuidas]

***

## Elementos

Verás los siguientes elementos:

* **Encabezado de días:** Cada columna tiene el nombre del día y la fecha (ejemplo: "Lun 20", "Mar 21")
* **Barra de tiempo:** A la izquierda, todos los horarios del día
* **Tarjetas de citas:** Cada cita aparece como una tarjeta con vista completa, con la siguiente información:
  * **Línea de cabecera:** Hora de inicio y nombre del box en formato compacto (ejemplo: `09:30 · Box 1`), con el ícono del estado a la derecha
  * **Nombre completo del paciente** (destacado en negrita)
  * **Profesional asignado**
  * **Tratamiento** (en cursiva)
* **Indicador de estado:** Una barra lateral de color en el borde izquierdo de cada tarjeta indica el estado (gris=pendiente, azul=confirmada, rojo=cancelada, naranja=no asistió)
* **Día actual:** El día de hoy aparece destacado con un fondo diferente
* **Contador de citas:** Algunos días muestran cuántas citas tienes agendadas

<Note>
  Si una tarjeta es muy angosta o la cita es corta, los textos se recortan con puntos suspensivos ("…") para que todo quepa. Haz clic en la tarjeta para ver todos los detalles en un popover.
</Note>

***

## Popover de detalle

Al hacer click sobre cualquier tarjeta se abre un popover lateral con la información completa de la cita, útil cuando los textos quedaron recortados o quieres revisar todo de un vistazo. Muestra:

* **Nombre completo del paciente**
* **Profesional asignado**
* **Tratamiento**
* **Horario** (inicio → fin con duración total)
* **Box**
* **Observaciones** (si la cita tiene), en cursiva debajo del box, respetando los saltos de línea originales

Si la cita está **cancelada** o marcada como **inasistencia**, el popover también muestra la razón y las notas asociadas en un bloque aparte.

Desde el mismo popover puedes abrir la ficha del paciente, contactarlo por WhatsApp o cambiar el estado de la cita.

***

## Navegar por semanas

<Tabs>
  <Tab title="Flechas" icon="arrows-left-right">
    Usa las flechas `<` y `>` en la parte superior:

    * Flecha izquierda `<` → Semana anterior
    * Flecha derecha `>` → Semana siguiente

    **Ideal para:** Revisar semanas consecutivas, planificar tratamientos recurrentes
  </Tab>

  <Tab title="Selector de fecha" icon="calendar">
    Haz clic en el ícono de calendario para abrir el selector de fecha.

    Elige cualquier día del mes y el calendario te lleva automáticamente a la semana que contiene ese día.

    **Ideal para:** Saltar a una semana específica sin navegar semana por semana
  </Tab>

  <Tab title="Botón Hoy" icon="clock">
    Haz clic en el botón "Hoy" para volver rápidamente a la semana actual.

    El día de hoy aparecerá destacado dentro de la semana.

    **Ideal para:** Regresar al presente después de revisar semanas futuras o pasadas
  </Tab>
</Tabs>

***

## Selector de Profesional

<Tabs>
  <Tab title="Administradores y Asistentes">
    <Icon icon="check" color="green" /> Puedes ver la agenda semanal de cualquier profesional de la clínica.

    ### Cómo cambiar de profesional

    <Steps>
      <Step title="Localiza el selector">
        En la parte superior del calendario → Verás un menú desplegable con el nombre del profesional actual
      </Step>

      <Step title="Abre la lista">
        Haz clic en el selector → Se abre la lista de profesionales de tu clínica
      </Step>

      <Step title="Selecciona el profesional">
        Selecciona el profesional deseado → El calendario se actualiza automáticamente
      </Step>
    </Steps>

    Ahora verás la agenda completa de la semana del profesional seleccionado.
  </Tab>

  <Tab title="Profesionales">
    <Icon icon="xmark" color="red" /> Solo puedes ver tu propia agenda.

    <Note>
      El selector de profesional no está visible para ti por razones de privacidad y enfoque en tu propio trabajo.
    </Note>
  </Tab>
</Tabs>

***

## Configurar el primer día de la semana

El sistema puede configurarse para que la semana empiece en **Lunes** o **Domingo**:

<Steps>
  <Step title="Abre las preferencias">
    Ve a "Configuración" → "Preferencias" → Busca "Primer día de la semana"
  </Step>

  <Step title="Selecciona tu preferencia">
    Selecciona tu preferencia → Haz clic en "Guardar"
  </Step>

  <Step title="Verifica el cambio">
    Regresa al calendario → Verás el nuevo orden aplicado
  </Step>
</Steps>

Dependiendo de tu elección:

* **Lunes:** Lun, Mar, Mié, Jue, Vie, Sáb, Dom
* **Domingo:** Dom, Lun, Mar, Mié, Jue, Vie, Sáb

***

## Interactuar con citas

Haz clic en cualquier horario vacío para agendar una cita, o haz clic en una cita existente para ver opciones (confirmar, cancelar, eliminar, etc.).

<Tip>
  Esta vista es ideal para planificar tratamientos que requieren múltiples sesiones. Puedes ver rápidamente qué días tienes disponibilidad.
</Tip>

Más información completa en [Gestionar Citas](/calendar/gestionar-citas).

***

<Tip>
  ¿Eres administrador o asistente? Con el selector **Vista por: Profesional | Box** puedes organizar la semana por sala en vez de por profesional. Más detalles en [Vista por Box](/calendar/vistas-agenda/vista-box).
</Tip>

***

## Ver también

* [Vista Día](/calendar/vistas-agenda/vista-dia) - Enfócate en tu agenda diaria
* [Vista por Box](/calendar/vistas-agenda/vista-box) - Organiza la semana por sala en vez de por profesional
* [Vista Global](/calendar/vistas-agenda/vista-global) - Ve todos los boxes simultáneamente
* [Gestionar Citas](/calendar/gestionar-citas) - Aprende a agendar y gestionar citas