🗓️

Calendar View

Visual day/week calendar with doctor filtering and color-coded appointment statuses

3 min read

Overview

The Calendar View provides a visual timeline of all appointments in your clinic. Instead of scrolling through a list, you see appointments plotted on a time grid from 8:00 AM to 8:00 PM. Each appointment appears as a color-coded block indicating its status. You can switch between Day and Week views and filter by specific doctor to focus on one schedule at a time.

Calendar day view showing appointments as color-coded blocks in a time grid, with navigation arrows and view mode toggle

Accessing the Calendar

  1. Navigate to Calendar — From the sidebar, click Appointments then select Calendar from the sub-menu. This opens /appointments/calendar.
  2. View Today's Schedule — The calendar defaults to today's date with the Day view active.

Calendar Features

Day/Week Toggle

In the top-right corner, two toggle buttons allow switching between views:

  • Day View — Shows a single day's appointments in an hourly grid with 12 time rows (8:00 AM to 7:00 PM).
  • Week View — Shows 7 days side-by-side with appointments in each column.

Date Navigation

Navigate between dates using:

  • Arrow buttons — Click the right/left arrows next to the date heading to move forward or backward one day (or one week in week view).
  • Date picker — Use the date input field below the header to jump to any specific date.

The header displays the current date in Arabic format (e.g., “السبت، 15 مارس 2026”) along with a count of appointments for that period.

Doctor Filter

Use the doctor dropdown above the calendar to filter appointments for a specific doctor. Select “All Doctors” to see the full clinic schedule. The API call uses GET /appointments/calendar?start=...&end=...&doctor_id=....

Status Color Coding

Each appointment block has a colored left border indicating its status:

  • Blue border + blue background — Scheduled (confirmed booking)
  • Green border + green background — Confirmed (patient confirmed attendance)
  • Amber border + amber background — Checked in (patient arrived, waiting)
  • Gray border + gray background — Completed
  • Red border + red background — Cancelled or No-show

Clicking an Appointment

Click any appointment block to open its details. From there you can check-in the patient, reschedule, or cancel the appointment.

Practical Usage

  1. Morning planning — Open the Day view at the start of your shift to see which patients are expected and when.
  2. Gap identification — Empty time rows indicate available slots. Use these to schedule walk-ins or same-day bookings.
  3. Week overview — Switch to Week view on Sundays to preview the upcoming week's workload and coordinate staffing.
  4. Doctor coordination — Use the filter to check a specific doctor's availability when a patient calls to book.
Tip: The calendar shows 12 hourly slots from 8 AM to 8 PM. If your clinic operates outside these hours, the view still captures any appointments booked in those hours.
Warning: The calendar does not auto-refresh. If another receptionist books an appointment while you are viewing the calendar, refresh the page to see the update.

FAQ

Is there a monthly view?

Currently SehaFile supports Day and Week views. A monthly overview is available at /appointments/overview which shows aggregate statistics rather than individual appointment blocks.

Can I drag and drop to reschedule?

Drag-and-drop rescheduling is not yet supported. To reschedule, click the appointment and use the edit form to change the date/time.

Why do some hours show no time slots?

Hours without any appointments simply show an empty row. This is normal and indicates available time.

Was this article helpful?