Queue Management

Overview

The Queue Management system in SehaFile provides a real-time Kanban-style board that tracks every patient's progress through the clinic. The Queue Board divides patients into three columns: Waiting (amber), With Doctor (blue), and Completed (green). Each card shows the queue number, patient name, appointment type, and status with action buttons to advance patients through the flow.

Accessing the Queue Board

1. Navigate to Queue — From the sidebar click Appointments > Queue. This opens /appointments/queue which calls GET /appointments/queue to load today's queue.

Understanding the Board

Waiting Column (in the amber section)

Shows patients who have checked in but are not yet with a doctor. Each card displays:

• A circular badge with the queue number
• Patient name in Arabic
• Appointment type (e.g., first_visit, follow_up)
• An amber “in the waiting room” status badge
• A blue “Start Exam” button to move the patient to “With Doctor”

With Doctor Column (blue section)

Shows patients currently in consultation. Each card displays:

• Queue number and patient name
• A blue “With Doctor” status badge
• A green “Complete” button to finish the visit

Completed Column (green section)

Shows patients whose visits are done for the day. These cards have a green “Completed” badge and no action buttons.

Managing Patient Flow

1. Check in a scheduled patient — When a patient with an appointment arrives, find their appointment in the list and click Check-in. This calls POST /appointments/:id/check-in and moves them to the Waiting column with a queue number.
2. Add a walk-in — Click the + Walk-in button at the top. Fill in patient and doctor, then submit. The patient appears in the Waiting column immediately.
3. Start the examination — When the doctor is ready, click the blue “Start Exam” button on the waiting patient's card. The card moves to the “With Doctor” column.
4. Complete the visit — After the consultation, click the green “Complete” button. The card moves to the Completed column.

Queue Numbers

Queue numbers are assigned sequentially for the day, starting from 1. Each patient gets the next available number regardless of doctor. The number displays prominently on the patient's card and on the Waiting Room Display screen.

FAQ

Can I reorder patients in the queue?

The Queue Board shows patients in their check-in order. To prioritize a patient, use the Waiting List feature which supports manual reordering and priority levels.

Does the board auto-refresh?

The queue data loads when you open the page. Refresh the browser to see updates from other users or when statuses change.

What happens to no-shows?

If a patient does not check in by end of day, their appointment remains in “scheduled” status. You can manually mark it as “no_show” from the appointment details.