Instructor performance, lessons and reviews¶
Applies to: Owner, Administrator, Manager, Finance, Viewer (reports); everyone with Instructors.View (calendar and reviews). Last reviewed: 2026-11-18.
DriveFlow has no single "instructor performance" page. The figures about an instructor are spread over five places:
| Where | What it tells you |
|---|---|
| Instructors list | Today's lessons and total lessons per instructor. |
| Instructor calendar | One instructor's lessons by week or day, upcoming and completed. |
| Instructor reviews | Star ratings and comments from students. |
| Reports | Lessons, completed, cancelled, hours, completion rate, driving-test pass rate, sign-offs per instructor. |
| Instructor earnings | Money earned per lesson (Enterprise). |
Instructors list figures¶
Open OPERATIONS > Instructors > Instructors.
| Column | How it is calculated |
|---|---|
| Today's Lessons | Number of the instructor's lessons whose start time is today, excluding lessons with status Cancelled. |
| Total Lessons | Number of all the instructor's lessons, past and future, excluding Cancelled. No-shows and scheduled lessons are included. |
Instructor calendar¶
This is the way to see one instructor's upcoming and completed lessons, and therefore their students.
- Open OPERATIONS > Instructors > Instructors.
- Open the row menu and click Calendar (or open View and click Calendar). The address is
/instructors/{id}/calendar.
The page title is Instructor Calendar. It shows the instructor's name, instructor number and branch, three cards, and a week or day calendar of their lessons.
| Card | Meaning |
|---|---|
| Today's Lessons | Lessons in the period shown that start today. |
| Completed | Lessons in the period shown with status Completed. |
| Lessons Shown | All lessons in the week or day on screen. |
Note
The cards follow the calendar: move to another week and the numbers change. They are not all-time totals.
- Click a lesson to see its details (student, vehicle, times, status).
- Users with
Lessons.Createsee Schedule Lesson and can click an empty slot; the Schedule Lesson form opens with this instructor already chosen. Scheduling itself is described in Lesson management. - The back arrow returns to the Instructors page.
Screenshot to be added
Screen: Instructor Calendar page. Should show: week view with lessons, the three cards and the Schedule Lesson button.
An instructor who signs in and does not manage lessons sees only their own lessons here and everywhere else; see Instructor user accounts.
Seeing an instructor's students¶
There is no "students of this instructor" list. Use one of:
- the instructor's calendar (each lesson names its student), or
- REPORTING > Reports > Lesson Report, whose lesson details table names the instructor and student for every lesson in the period.
Instructor reviews¶
Students rate their instructor after a completed lesson, from the student portal. Staff can read the reviews but cannot add, edit or delete them.
How a review is created (student side)¶
- A student may rate each of their own completed lessons once, with 1 to 5 stars and an optional comment of up to 1,000 characters.
- A lesson can be rated for up to 90 days after it took place.
- Messages the student may see: "Please choose a rating from 1 to 5 stars.", "You can rate a lesson once it has been completed.", "Lessons can be rated for up to 90 days afterwards.", "You've already rated this lesson."
The student portal is described in the student portal documentation and the student-facing folders written by other authors.
Reading reviews (staff side)¶
- Open OPERATIONS > Instructors > Reviews (address
/instructorsreviews). NeedsInstructors.View. - The top of the page shows one card per instructor who has at least one review: name, stars, the average rating to one decimal, and the number of reviews. Instructors are ordered by highest average, then by most reviews.
- Click an instructor's card to list only their reviews; the heading changes to "Reviews for name". Click the card again, or Show all instructors, to list everything.
- The table shows Reviewed (date), Instructor, Student, Rating and Comment, 25 per page, newest first.
Screenshot to be added
Screen: Instructor reviews page. Should show: rating cards per instructor and the reviews table with Anonymous students.
How the average is calculated: the plain mean of all star ratings ever given to that instructor (not deleted). The stars on the card show the average rounded to the nearest whole star; the number beside them shows one decimal.
Who can see who wrote a review¶
| Signed-in user | Student column | Lesson column | Reviewed date |
|---|---|---|---|
| Owner | Student's name, linked to the student's profile | Lesson number, date and time | Exact date |
| Everyone else (Administrator, Manager, Instructor, …) | Anonymous | Not shown | Date only |
For non-owners the student and lesson details are removed on the server before the page receives them, and the page shows: "Reviews are anonymous so students can be honest. Only the school's owner can see who wrote them."
If nobody has been reviewed yet the page shows "No reviews yet".
Figures in the reports¶
All of these are under REPORTING > Reports and need Reports.View plus the permission named. Each report has a date range and a branch filter; the reports themselves are documented by the reporting author. The instructor figures and how they are worked out:
Reports > Overview: "Instructor Performance in selected period"¶
Needs Instructors.View. One row per instructor (not deleted; filtered to the chosen branch).
| Column | Calculation |
|---|---|
| Lessons | Lessons in the period with this instructor, every status. |
| Completed | Of those, status Completed. |
| Cancelled | Of those, status Cancelled. |
| Hours | Minutes from start to end of every lesson in the period that is not Cancelled, divided by 60, to one decimal. Scheduled and no-show lessons are included. |
Ordered by most lessons.
Reports > Lesson Report: "Instructor Performance"¶
Needs Lessons.View. One row per instructor who has at least one lesson in the period.
| Column | Calculation |
|---|---|
| Lessons | Lessons in the period, every status. |
| Completed / Scheduled / Cancelled | Lessons with that status. |
| Hours | As above: non-cancelled lesson time. |
| Completion | Completed ÷ Lessons × 100, to two decimals (shown to one). Cancelled lessons and no-shows are in the divisor, so they lower the rate. |
Reports > Driving Test Report: "Instructor Test Performance"¶
Needs DrivingTests.View. One row per instructor attached to at least one driving test in the period: total tests, passed, failed and pass rate = passed ÷ (passed + failed) × 100. Tests with no result yet are not in the divisor.
Reports > Sign-Off Report: "Instructor Sign-Offs"¶
Needs Lessons.View. Per instructor, how many lessons they have signed off and how many are still waiting. See the reporting documentation.
Reports > Instructor Earnings Report¶
Enterprise only. See Instructor earnings.
Limitations and notes¶
- The fuller instructor performance report has no screen. The API has
GET /api/reports/instructors/performance(and/export), which per instructor returns assigned, completed and cancelled lessons, no-shows, hours, driving tests scheduled/passed/failed, pass rate and active students (distinct students with a lesson in the period whose student status is Registered, Learners Pending, Learners Passed, In Training, Ready For Test or Test Booked). No page in the web app calls it; only the tables listed above are shown. - No targets, rankings or dashboards per instructor. Nothing compares an instructor against a target.
- Reviews are not part of any report or export, and there is no minimum number of reviews before an average is shown: one 5-star review gives 5.0.
- The Reviews menu item is always shown to users with
Instructors.View, even when the school's plan has no student portal; the page then simply stays empty. - An instructor can read the anonymous reviews of every instructor, including colleagues, because the default Instructor role has
Instructors.View. - Deleted instructors still appear on the Reviews page if they have reviews; they do not appear in the Overview's instructor table.
- "Hours" counts scheduled time, not time actually driven.
Related articles¶
- Instructor reports - the reporting side of instructor figures.
- Lesson reports - lesson details per instructor and student.
- Sign-off report - sign-offs per instructor.
- Instructor earnings - money earned per lesson.
- Student portal - where students write reviews.