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

# Introducción

> Accede al historial completo de sesiones, evoluciones clínicas, imágenes y recetas médicas de cada paciente.

<Note>
  El módulo Ficha del Paciente te permite visualizar todo el historial clínico: sesiones agendadas, tratamientos realizados, evoluciones, imágenes y recetas médicas.
</Note>

## Funcionalidades

La Ficha del Paciente te permite:

* **Ver los datos de contacto** del paciente siempre visibles bajo el encabezado
* **Ver sesiones** con timeline cronológico y estadísticas
* **Filtrar sesiones** por estado (agendadas, confirmadas, canceladas, inasistencias)
* **Revisar evoluciones clínicas** con las piezas dentales tratadas
* **Gestionar planes de tratamiento** con tratamientos, pagos y envío al paciente
* **Gestionar imágenes** clínicas como radiografías y fotografías
* **Crear y gestionar recetas médicas** con previsualización e impresión
* **Programar recordatorios** por email con seguimiento de apertura
* **Ver razones** de cancelaciones e inasistencias

***

## Permisos por Rol

| Funcionalidad               | Administradores |   Profesionales   |     Asistentes    |
| --------------------------- | :-------------: | :---------------: | :---------------: |
| Ver sesiones del paciente   |    Sí (todas)   | Sí (solo propias) |     Sí (todas)    |
| Ver evoluciones             |    Sí (todas)   | Sí (solo propias) |     Sí (todas)    |
| Eliminar evoluciones        |    Sí (todas)   |         No        |         No        |
| Ver planes de tratamiento   |    Sí (todos)   |    Configurable   |     Sí (todos)    |
| Crear planes de tratamiento |        Sí       |         Sí        |         No        |
| Registrar pagos             |        Sí       |    Configurable   |    Configurable   |
| Ver imágenes                |        Sí       |         Sí        |         Sí        |
| Subir imágenes              |        Sí       |         Sí        |         Sí        |
| Eliminar imágenes           |        Sí       |         No        |         No        |
| Ver recetas                 |        Sí       |         Sí        |         Sí        |
| Crear recetas               |        Sí       |         Sí        |         No        |
| Eliminar recetas            |    Sí (todas)   | Sí (solo propias) |         No        |
| Ver recordatorios           |        Sí       |         Sí        |         Sí        |
| Programar recordatorios     |        Sí       |         Sí        |         Sí        |
| Eliminar recordatorios      |    Sí (todos)   | Sí (solo propios) | Sí (solo propios) |

<Info>
  **Nota:** "Solo propias" significa que los profesionales solo pueden ver las sesiones y evoluciones donde ellos son el profesional asignado, y solo pueden eliminar las recetas que ellos crearon.
</Info>

***

## Datos de contacto siempre visibles

Apenas abres la ficha de un paciente, justo bajo su nombre encontrarás una **franja con los datos de contacto** que se muestra de forma permanente. Así tienes a mano la información clave sin necesidad de abrir el modal de edición.

La franja muestra:

* **Fecha de nacimiento** del paciente, con el formato de fecha de tu clínica
* **Teléfono** de contacto, formateado según el país
* **Correo electrónico**
* **Dirección** (incluye la ciudad cuando está cargada)

<Info>
  Cuando un dato no está registrado, en su lugar aparece un guion (**—**). Es una señal rápida de qué información falta completar en la ficha del paciente.
</Info>

<Tip>
  ¿Falta o quieres corregir algún dato? Edítalo desde el botón de **editar paciente** en el encabezado de la ficha; los cambios se reflejan al instante en la franja.
</Tip>

***

## Documento de identidad del paciente

Al **crear** o **editar** un paciente, el campo del documento de identidad se valida automáticamente según el **país de tu clínica**. El nombre del campo y el formato esperado cambian según corresponda: **RUT** en Chile, **DNI** en Perú y **Cédula** en Colombia.

Si escribes un valor que no cumple el formato del país, el formulario marca el campo con un aviso (por ejemplo, **RUT inválido**) y **no te deja guardar** hasta que lo corrijas.

| País     | Documento  | Qué se valida                                    |
| -------- | ---------- | ------------------------------------------------ |
| Chile    | **RUT**    | Dígito verificador correcto (ej: `12.345.678-9`) |
| Perú     | **DNI**    | 8 dígitos (ej: `12345678`)                       |
| Colombia | **Cédula** | Entre 6 y 10 dígitos                             |

<Info>
  El documento de identidad es un **campo opcional**: puedes dejarlo vacío y guardar el paciente sin problema. La validación solo se aplica cuando escribes un valor.
</Info>

<Tip>
  En países que aún no tienen una regla estricta definida, el campo acepta cualquier valor para no bloquearte. La validación se irá afinando a medida que CIMAOS sume más países.
</Tip>

***

## Secciones de la Ficha

<CardGroup cols={2}>
  <Card title="Sesiones" icon="calendar-check" href="/pacientes/sesiones">
    Historial completo de citas con timeline, estadísticas y filtros.
  </Card>

  <Card title="Evoluciones" icon="tooth" href="/pacientes/evoluciones">
    Registro de tratamientos clínicos con piezas dentales involucradas.
  </Card>

  <Card title="Planes de tratamiento" icon="file-invoice-dollar" href="/pacientes/presupuestos/index">
    Propuestas de tratamiento con precios, pagos y envío al paciente.
  </Card>

  <Card title="Imágenes" icon="image" href="/pacientes/imagenes">
    Galería de radiografías y fotografías clínicas del paciente.
  </Card>

  <Card title="Recetas" icon="prescription" href="/pacientes/recetas">
    Prescripciones médicas con previsualización e impresión profesional.
  </Card>

  <Card title="Recordatorios" icon="bell" href="/pacientes/recordatorios">
    Emails programados con seguimiento de apertura y métricas de engagement.
  </Card>
</CardGroup>

***

## Cómo acceder

Hay dos formas de acceder a la ficha de un paciente:

<Tabs>
  <Tab title="Búsqueda rápida" icon="magnifying-glass">
    Usa el buscador global para acceder rápidamente desde cualquier lugar del sistema.

    <Steps>
      <Step title="Abre el buscador">
        Haz clic en el **ícono de lupa** en la barra superior derecha
      </Step>

      <Step title="Busca el paciente">
        Escribe el nombre, apellido o documento de identidad del paciente (RUT, DNI, Cédula, etc., según el país de la clínica)
      </Step>

      <Step title="Selecciona">
        Haz clic en el paciente de los resultados para abrir su ficha
      </Step>
    </Steps>

    <Tip>
      Esta es la forma más rápida cuando estás trabajando en cualquier módulo y necesitas revisar la ficha sin cambiar de sección.
    </Tip>
  </Tab>

  <Tab title="Desde el listado" icon="list">
    Accede desde el listado completo de pacientes en Configuración.

    <Steps>
      <Step title="Ve a Configuración">
        Haz clic en **Configuración** en el menú lateral
      </Step>

      <Step title="Selecciona Clientes">
        Haz clic en **Clientes** en el menú de configuración
      </Step>

      <Step title="Busca y selecciona">
        Usa el buscador de la tabla para filtrar y haz clic en el nombre del paciente
      </Step>
    </Steps>

    <Info>
      Desde este listado también puedes crear nuevos pacientes y ver estadísticas generales.
    </Info>

    ### Abrir la ficha en una pestaña aparte

    En el menú **⋯** de cada paciente del listado tienes dos opciones para acceder a la ficha:

    * **Abrir Ficha**: abre la ficha en la pestaña actual, reemplazando el listado
    * **Abrir Ficha en nueva pestaña**: abre la ficha en una pestaña nueva del navegador, manteniendo el listado abierto

    <Tip>
      "Abrir Ficha en nueva pestaña" es útil cuando estás revisando varios pacientes seguidos: deja el listado abierto en una pestaña y abre cada ficha en otra pestaña para volver al listado sin perder filtros ni búsquedas.
    </Tip>
  </Tab>
</Tabs>

### Navegación en la ficha

Una vez en la ficha del paciente, encontrarás las siguientes pestañas:

* **Sesiones**: Historial de citas
* **Evoluciones**: Notas clínicas y tratamientos
* **Imágenes**: Radiografías y fotografías clínicas
* **Recetas**: Prescripciones médicas
* **Recordatorios**: Emails programados al paciente

***

## Conceptos Básicos

<AccordionGroup>
  <Accordion title="¿Qué es una Sesión?" icon="calendar-check">
    Una sesión es una cita agendada en el calendario. Incluye información sobre:

    * Fecha y hora programada
    * Profesional que atiende
    * Tratamiento planificado
    * Estado actual (agendada, confirmada, cancelada, etc.)

    Todas las citas que agendes en el Calendario aparecerán automáticamente en la sección Sesiones de la ficha del paciente.
  </Accordion>

  <Accordion title="¿Qué es una Evolución?" icon="tooth">
    Una evolución es una nota clínica que registra un tratamiento realizado. Incluye:

    * Fecha del tratamiento
    * Profesional que atendió
    * Observaciones clínicas
    * Piezas dentales tratadas

    Las evoluciones se crean manualmente después de atender al paciente y quedan como registro permanente del historial clínico.
  </Accordion>

  <Accordion title="¿Cuál es la diferencia entre Sesión y Evolución?" icon="circle-question">
    **Sesión (Cita):**

    * Se crea al agendar en el Calendario
    * Representa una cita futura o pasada
    * Puede cancelarse o marcarse como inasistencia
    * Enfocada en la gestión administrativa

    **Evolución (Nota clínica):**

    * Se crea manualmente después de atender
    * Representa un tratamiento realizado
    * Incluye detalles clínicos y piezas tratadas
    * Enfocada en el registro médico

    **Ejemplo:** Agendar una cita para limpieza dental crea una Sesión. Después de realizar la limpieza, registras una Evolución con las observaciones clínicas.
  </Accordion>

  <Accordion title="¿Qué son las Imágenes?" icon="image">
    Las imágenes son archivos visuales asociados al paciente que incluyen:

    * Radiografías (periapicales, panorámicas, bitewing)
    * Fotografías intraorales y extraorales
    * Documentos escaneados

    Puedes subir múltiples imágenes a la vez y verlas en una galería con visor ampliado y zoom.
  </Accordion>

  <Accordion title="¿Qué es una Receta?" icon="prescription">
    Una receta es una prescripción médica que el profesional crea para el paciente. Incluye:

    * Fecha de la prescripción
    * Profesional que la emitió
    * Contenido de la receta con formato

    Las recetas se pueden previsualizar e imprimir con un formato profesional que incluye los datos de la clínica, paciente y profesional.
  </Accordion>

  <Accordion title="¿Qué es un Recordatorio?" icon="bell">
    Un recordatorio es un email programado para enviarse al paciente en una fecha y hora específica. Incluye:

    * Fecha y horario de envío (mañana, tarde o noche)
    * Mensaje personalizado con formato
    * Seguimiento de apertura

    Los recordatorios son útiles para recordar citas próximas, tratamientos pendientes o indicaciones post-operatorias. Puedes ver métricas como tasa de apertura y estado de cada email.
  </Accordion>
</AccordionGroup>

***

## Explora más

Aprende más sobre cada sección de la Ficha del Paciente:

<Check>
  **Siguiente paso:** Comienza explorando las [Sesiones](/pacientes/sesiones) para ver cómo revisar el historial de citas del paciente.
</Check>