Skip to content

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.

  1. Open OPERATIONS > Instructors > Instructors.
  2. 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.Create see 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)

  1. Open OPERATIONS > Instructors > Reviews (address /instructorsreviews). Needs Instructors.View.
  2. 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.
  3. 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.
  4. 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.