Booked Appointment to Check-In

The Appointment Check-In flow outlines the steps to locate pre-booked patient slots on the calendar, verify their registration, and transition them into the active clinical queue upon their physical arrival. This process bridges the scheduling system with live clinical workflows.

Detailed Step-by-Step Walkthrough

Step 1: Navigating the Calendar Grid View

When a patient with a pre-booked appointment arrives at the reception desk, the receptionist checks the calendar dashboard:

1. Navigate to the Calendar (/calendar) to open the main calendar interface (calendar-object-layout.vue).
2. The dashboard displays a resource-based calendar grid powered by the FullCalendar suite. Slots are color-coded to indicate appointment states (e.g., Light Gray for Draft, Green for Booked, Blue for Arrived/Checked-in).
3. Filter or select the specific doctor's column using the resource-timegrid or select-entity dropdown (select-entity-calendar.vue / select-entity-calendar-v2.vue).
4. Search for the patient's name on the daily or weekly calendar grid, or filter by tags (using appointment-tags.vue).

Step 2: Modifying Status in the Appointment Slideover

Once the scheduled slot is located, convert the booking into an active walk-in record:

1. Click on the patient's appointment block in the grid to open the Appointment Detail Slideover (appointment-details-slideover.vue / appointment-details.vue).
2. Confirm the patient's identity (HKID or Passport) and verification tags.
3. Locate the Status dropdown menu (which displays Booked).
4. Select Arrived (or click the prominent Check-In action button).
5. Verify context variables: designated doctor, appointment template, and clinic branch.
6. Click Confirm Check-In.
   • System Automation: The system executes a GraphQL mutation to update the appointment status.
   • Episode Generation: Upon marking the status as Arrived, the system automatically generates an Episode of Care (Case) entity and attaches the clinic's default Workflow Definition.

Step 3: Ticket Generation & Queue Dispatch

Upon checking in:

1. The calendar slot transitions to Blue, signifying that the patient has checked in.
2. The Workflow Definition's initial transition fires. An automated HTTP Action executes a GraphQL mutation to create a ticket in the QMS.
3. The patient is automatically added to the active queue list under the designated doctor's line (consultLineId defined in the workflow's context variables).
4. The Queue Monitor (/queue using queue-object-layout.vue) updates in real-time, placing the patient's card in the Triage Queue panel.
5. A physical queue ticket prints automatically with their ticket number, allowing the patient to proceed to the triage station.