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

# Turnero Appointments — Module Overview and Field Guide

> Learn how Turnero's appointment module works — scheduling, filtering, real-time table updates, and exporting for daily clinic operations.

The Appointments module is the heart of Turnero's daily clinic workflow. It lets front-desk staff schedule, edit, and track patient appointments, while doctors receive live updates as their schedule fills.

## The Appointments Table

When you open the **Appointments** section, Turnero automatically loads all appointments for today. The table displays the following columns for each appointment:

| Column               | Description                                |
| -------------------- | ------------------------------------------ |
| **Name**             | Full name of the patient                   |
| **DNI**              | Patient's national ID number               |
| **Health Insurance** | Patient's obra social (insurance provider) |
| **Reason**           | Reason for the visit (motivo)              |
| **Doctor**           | Name of the assigned doctor                |
| **Date**             | Date of the appointment                    |
| **Time**             | Scheduled time slot                        |

Use the **Doctor** filter dropdown to narrow the table to a single doctor's schedule, or use the **Date** picker to jump to a different day. Doctors logged in with the Medico role are automatically filtered to see only their own appointments.

## Real-Time Updates

Turnero keeps every logged-in user in sync automatically. When any appointment is created, edited, or when a patient checks in, the appointments table updates live for all active users — no page refresh required. Changes are pushed directly to each connected browser the moment they occur.

## Appointment Fields

Every appointment in Turnero is built from the following fields:

<ParamField path="Name" type="string" required>
  Full name of the patient (Nombre).
</ParamField>

<ParamField path="Dni" type="number" required>
  Patient's national ID number (DNI). Used to identify returning patients.
</ParamField>

<ParamField path="MedicId" type="select" required>
  The assigned doctor for this appointment (Médico). Selected from the list of registered doctors.
</ParamField>

<ParamField path="DateTurn" type="date" required>
  The appointment date (Fecha), formatted as dd/MM/yyyy.
</ParamField>

<ParamField path="TimeId" type="select" required>
  The scheduled time slot (Hora). Must be chosen from the pre-configured time slots set up by an Admin.
</ParamField>

<ParamField path="SocialWork" type="string">
  Patient's health insurance provider (Obra Social). Optional.
</ParamField>

<ParamField path="Reason" type="string">
  Reason for the visit (Motivo). Optional — walk-in appointments created through the public page have this set automatically to "Turno espontáneo".
</ParamField>

<ParamField path="Accessed" type="boolean">
  Whether the patient has checked in (Ingresado). Updated by the Medico role using the Check In button.
</ParamField>

## Next Steps

<CardGroup cols={2}>
  <Card title="Schedule an Appointment" href="/appointments/scheduling" icon="calendar-plus">
    Create, edit, filter, and delete appointments from the authenticated scheduling interface.
  </Card>

  <Card title="Public Walk-In Booking" href="/appointments/public-booking" icon="person-walking-arrow-right">
    Let walk-in patients self-register from a public page — no login required.
  </Card>
</CardGroup>
