Appointments & Scheduling

Appointment status lifecycle

Every appointment moves through a defined lifecycle:

SCHEDULED → Created but not yet confirmed by the patient

CONFIRMED → Patient has confirmed (via WhatsApp/SMS, phone call, or self-booking)

ARRIVED → Patient is physically in the clinic; staff clicked "Mark Arrived" in the Waiting Room

IN_CHAIR → The doctor has started the consultation

COMPLETED → Session saved; invoice auto-generated

NO_SHOW → Patient did not arrive; no-show risk score updated for future predictions

CANCELLED → Appointment cancelled by staff or patient

The ARRIVED status was introduced to eliminate confusion between "confirmed on the phone" and "physically present".

Recurring appointments

For patients who need regular visits (e.g. physiotherapy sessions, monthly dermatology check-ins):

1. Book an appointment as normal
2. In the appointment modal, toggle Recurring
3. Set the pattern: daily, weekly, bi-weekly, monthly
4. Set an end date or number of occurrences
5. Click Save Series — all appointments are created at once

You can edit or cancel individual occurrences (without affecting the series) or cancel the entire series going forward.

Walk-in patients

For unscheduled walk-in patients:

• Click the + floating button on any screen
• Or press Shift+W from anywhere in the dashboard
• Or click Walk-in in the Waiting Room panel

The walk-in modal pre-fills today's date and the first available slot. You can override the time and assign to any doctor. Walk-ins appear immediately in the Waiting Room as ARRIVED.

Public self-booking

Patients can book their own appointments without calling the clinic:

1. Go to Settings → Self-Booking and enable the public booking page
2. Copy your booking link: clinit.app/book/[your-clinic-slug]
3. Share this link on your website, social media, or WhatsApp status

Patients select a doctor, date, and time slot. They receive an automatic confirmation. The appointment appears in your calendar as SCHEDULED. You can auto-confirm or require manual approval per your clinic settings.

The booking page shows your clinic logo, specialty, and only available (unfilled) slots.

iCal subscription

Subscribe to your clinic calendar in any calendar app (Google Calendar, Apple Calendar, Outlook):

1. Go to Settings → Calendar → iCal Export
2. Copy the iCal URL: doctor.clinit.app/api/calendar/ical?token=[token]
3. In your calendar app, add a "subscription" calendar using this URL

The calendar updates automatically. Appointment details, patient names, and appointment types are included. The token is specific to your account — treat it like a password.