Instructor availability¶
Applies to: Owner, Administrator, Manager and anyone who schedules lessons. Last reviewed: 2026-11-18.
This page explains how DriveFlow decides whether an instructor is free for a lesson, and what you can and cannot configure today.
Short version
An instructor is available when they are Active, teach the lesson's licence code, work at the lesson's branch, the time is inside the branch working hours, and they have no other lesson or pending lesson request overlapping that time (including the branch's buffer). Personal working hours and leave periods exist in the database design but there is no screen to enter them yet; see Limitations and notes.
What makes an instructor available¶
When a lesson is scheduled, the scheduling engine applies these checks in order.
| # | Check | Where it is set |
|---|---|---|
| 1 | The instructor's status is Active. On Leave, Suspended and Inactive instructors are never offered. | Instructors > Edit > Status |
| 2 | The instructor belongs to the lesson's branch. An instructor works at one branch only. | Instructors > Edit > Branch |
| 3 | The instructor has the lesson's licence code. | Instructors > Edit > Licence Codes |
| 4 | The lesson falls entirely inside the branch working hours for that day. | Settings > Scheduling (per branch) |
| 5 | The instructor has no personal working-hours record that excludes the time, and no unavailability block overlapping it. | Not configurable on any screen today |
| 6 | The instructor has no other lesson at that time. Cancelled lessons do not block. The branch's buffer minutes are added before and after each existing lesson. | Settings > Scheduling > buffer |
| 7 | The instructor has no pending lesson request (a student's online booking awaiting approval) at that time. | Lessons > Lesson requests |
If the vehicle chosen for the lesson is owned by an instructor, only that owner can be the instructor (see Instructor earnings).
flowchart TD
A[Lesson wanted: branch + licence code + date/time] --> B{Instructor Active?}
B -- No --> N[Not offered]
B -- Yes --> C{Same branch, has the licence code?}
C -- No --> N
C -- Yes --> D{Inside branch working hours?}
D -- No --> M1["The lesson must fall entirely within branch working hours (...)"]
D -- Yes --> E{Other lesson / pending request<br/>overlapping, plus buffer?}
E -- Yes --> M2["The instructor is not available at that time."]
E -- No --> F[Available]
Automatic choice of instructor¶
If the branch's scheduling settings allow automatic assignment and no instructor is chosen, the engine picks, among the instructors who pass every check:
- the one with the fewest lessons that day,
- then by name,
- so the same request always gives the same answer.
If automatic assignment is off and none is chosen, the booking fails with "An instructor must be selected for this lesson."
Messages you may see¶
| Message | Meaning |
|---|---|
| The selected instructor is not available for this lesson. | The chosen instructor is not Active, is at another branch, or does not have the lesson's licence code. |
| The instructor is not available at that time. | The chosen instructor has another lesson, a pending request, or (if ever recorded) working hours or leave that exclude the time. |
| No qualified instructor is available at that time. | Automatic assignment found nobody who passes all checks. |
| Instructor is not active. | When editing an existing lesson to an instructor whose status is not Active. |
| This instructor works at a different branch from the lesson. | When editing a lesson to an instructor from another branch. |
| Instructor is already teaching another lesson at that time. | When editing a lesson onto a time the instructor is busy. |
| This vehicle belongs to another instructor; only its owner can use it. | The chosen vehicle is instructor-owned and the chosen instructor is not the owner. |
How to make an instructor unavailable today¶
Because personal working hours and leave cannot be entered, use one of these:
The instructor is away for days or weeks¶
- Open OPERATIONS > Instructors > Instructors.
- Open the row menu and click Edit.
- Set Status to On Leave and click Save Instructor.
- Open the instructor's Calendar (row menu) and move or cancel the lessons already booked for the period. Changing the status does not do this for you.
- When they return: Edit > Status > Active.
On Leave blocks every date
While On Leave the instructor cannot be booked on any date, including dates after they return. If you need to book their lessons for after the leave, do that before setting On Leave, or set them back to Active, book, and set On Leave again.
The instructor is unavailable for part of a day¶
There is no "blocked time" entry. The options are:
- do not book them in that time (the calendar shows what is already booked), or
- shorten the branch working hours if the whole branch is closed for that time (Settings > Scheduling).
The instructor has left¶
Use Deactivate (status Inactive); see Instructor profiles.
Where to see an instructor's schedule¶
- Instructors > row menu > Calendar: that instructor's lessons by week or day. See Instructor performance.
- MAIN > Calendar: the school calendar; staff who manage lessons see everyone, an instructor sees only their own lessons.
Branch working hours¶
Opening and closing times per weekday, the slot interval, the buffer between lessons, the booking window, automatic assignment of instructors and vehicles and the maximum lessons per student per day are branch settings under Settings > Scheduling. They apply to every instructor at the branch. They are documented with lesson scheduling in Lesson management.
Limitations and notes¶
- Per-instructor working hours have no screen and no API. The table
InstructorWorkingHours(one row per instructor per weekday: closed, or a start and end time) exists and the scheduling engine reads it: an instructor with a row for a weekday is only available between those times, a "closed" row makes them unavailable that weekday, and an instructor with no row falls back to the branch hours. Nothing in the web app, the API or the mobile app creates these rows, so in practice every instructor follows the branch hours. (DriveFlow.Domain/Entities/Scheduling/InstructorWorkingHour.cs, read inDriveFlow.Infrastructure/Services/SchedulingEngine.cs.) - Leave / time off / blocked times have no screen and no API. The table
InstructorUnavailabilities(start, end, reason: Leave, Sick, Training, Public Holiday or Other, and notes) exists and the scheduling engine treats each row as a block with no buffer. Nothing creates these rows. Use the On Leave status as described above. (DriveFlow.Domain/Entities/Scheduling/InstructorUnavailability.cs.) - Working hours and leave are only checked by the scheduling engine (new bookings and available-slot lists). Editing an existing lesson's time or instructor checks status, branch and overlapping lessons, but not personal hours or leave.
- The Status "On Leave" has no dates. It is on or off; DriveFlow does not switch an instructor back automatically.
- Public holidays are not a calendar in the product; the "Public Holiday" reason exists only on the unused unavailability table.
- An instructor cannot be shared between branches. To have someone teach at two branches you would need two profiles with different emails, which also means two logins.
Related articles¶
- Instructor profiles - statuses and how to change them.
- Availability and conflicts - the lesson-side view of conflicts.
- Scheduling settings - branch working hours, buffer and auto-assignment.
- Instructor performance - the instructor calendar.
- Scheduling lessons - booking a lesson.