Skip to content

Reports Overview, Driving Test Report and Vehicle Report

Applies to: school staff with Reports.View (Overview), plus DrivingTests.View (Driving Test Report) or Vehicles.View (Vehicle Report). Plan must include Reports. Last reviewed: 2026-11-18.

This page covers the operational side of reporting: the Reports Overview, the Driving Test Report and the Vehicle Report. Student, lesson, sign-off, instructor and financial reports have their own pages (links at the end).

The Reports menu

Sidebar > REPORTING > Reports. The group is shown to users with Reports.View when the school's plan includes the Reports feature.

Menu item Address Extra permission
Overview /reports none
Student Report /reports/students Students.View
Lesson Report /reports/lessons Lessons.View
Sign-Off Report /reports/sign-offs Lessons.View
Driving Test Report /reports/driving-tests DrivingTests.View
Financial Report /reports/financial Payments.View
Vehicle Report /reports/vehicles Vehicles.View
Instructor Earnings Report /reports/instructor-earnings InstructorEarnings.View and the Instructor Earnings plan feature

These eight are all the reports the application has. Opening a report address without the permissions shows "You don't have access to this report - Ask an administrator for access if you need it." with a Reports button. A SuperAdmin has no Reports menu, because a SuperAdmin belongs to no school.

Filters shared by every report

Control Meaning
From / To The period. Both dates are included in full.
Branch All branches or one branch. Inactive branches are listed too.
Period Quick ranges, counted from today: Today, This week (Monday to today), This month (1st to today), Last month, Last 30 days, Last 90 days, Year to date, Last year. Choosing one sets the dates and runs the report.
Generate Report Runs the report with the dates and branch in the boxes.
  • The period and branch are remembered while you move between report pages in the same session. The first time they are one month ago to today, all branches.
  • "Please select a date range." appears when a date is empty; "The start date cannot be after the end date." when they are the wrong way round.
  • A user whose sign-in is tied to one branch only ever gets that branch's data, whatever the Branch box says.
  • Parts of a report marked "as of today" ignore the period. Parts marked "in selected period" follow it.

Reports Overview

Sidebar > REPORTING > Reports > Overview. Page title Reports, subtitle "Business performance and operational insights." Needs Reports.View only.

The page generates itself when opened. Before the first result it shows "No report generated - Select a date range and generate a report."

Reports Overview page with the Students, Lessons, Driving Tests and Revenue cards and the period filters
The Reports Overview.

KPI cards

Card Figure Sub-text How it is calculated
Students Total students "n new in period · total as of today" Total: all students (of the branch) today. New: students created within the period.
Lessons Total lessons "n completed" Lessons starting in the period, every status. Completed: status Completed.
Driving Tests Total tests "n passed" Tests dated in the period, every status. Passed: result Passed.
Revenue Rand amount, no cents "n payments" Sum and number of Successful payments dated in the period. Only with Payments.View.

Revenue by Month (in selected period)

Only with Payments.View. One line per month in the period that has payments: month and money received.

Instructor Performance (in selected period)

Only with Instructors.View. Columns Instructor, Lessons, Completed, Cancelled, Hours. Described in Instructor reports.

Vehicle Utilisation (in selected period)

Only with Vehicles.View.

Column Meaning
Vehicle Vehicle number.
Registration
Lessons Lessons with this vehicle starting in the period, every status.
Tests Driving tests with this vehicle dated in the period.
Hours Time of the non-cancelled lessons with this vehicle.
Mileage The vehicle's current odometer reading in km (today's value, not the distance driven in the period).

Sorted by most lessons. With a branch selected, the list holds that branch's vehicles and vehicles shared with all branches.

Permissions inside the Overview

The server blanks what a user may not see, so the figures are not merely hidden:

Without Removed
Payments.View Revenue card, Revenue by Month (revenue, payment count and outstanding balance are sent as zero)
Instructors.View Instructor Performance
Vehicles.View Vehicle Utilisation

Note

The Students, Lessons and Driving Tests cards are shown to everyone with Reports.View, even without Students.View, Lessons.View or DrivingTests.View.

The Overview has no export.

Example

Period: Last 30 days. Students 214 ("18 new in period · total as of today"), Lessons 412 ("356 completed"), Driving Tests 22 ("15 passed"), Revenue R 86 400 ("143 payments"). In the last 30 days 18 students joined, 412 lessons were planned of which 356 were completed, 15 of 22 tests were passed and R 86 400 was received in 143 payments.

Driving Test Report

Sidebar > REPORTING > Reports > Driving Test Report (/reports/driving-tests). Subtitle "Test activity, pass rates and instructor performance." Needs Reports.View and DrivingTests.View.

A test belongs to the period by its test date. With a branch selected, the test's branch is used. Everything on this page follows the period.

Screenshot to be added

Screen: Driving Test Report. Should show: summary cards, Overall Pass Rate and Results by Licence Code.

Summary cards

Card How it is calculated
Total Tests All tests dated in the period, every status.
Passed Tests with result Passed; below it "x% pass rate".
Failed Tests with result Failed.
Booked Tests with status Booked (no result yet).

Overall Pass Rate

"Based on completed tests in the selected period."

Pass Rate = Passed x 100 / (Passed + Failed)      (2 decimals, shown with 1)

Booked and cancelled tests are left out of the rate. With no passed or failed tests the rate is 0.

Results by Licence Code

Grouped by the student's licence code, most tests first: Licence, Total Tests, Passed, Failed, Pass Rate. Tests of students without a licence code are not listed.

Instructor Test Performance

Grouped by the instructor on the test, best pass rate first: Instructor, Tests, Passed, Failed, Pass Rate. Tests without an instructor are not listed.

Testing Centre Performance

Grouped by testing centre, best pass rate first: Testing Centre, Tests, Passed, Failed, Pass Rate.

Daily Test Activity

One row per day with tests: Date, Total, Passed, Failed, Booked, Pass Rate.

Test Details

Newest first.

Column Meaning
Test Test number.
Date Test date and time.
Student
Instructor Empty when none was assigned.
Vehicle Vehicle number; empty when none.
Licence The student's licence code.
Testing Centre
Status The result (Passed, Failed) when there is one, otherwise the test's status (Booked, Cancelled, ...).

Example

Period: Last month. Total Tests 22, Passed 15 (75.0% pass rate), Failed 5, Booked 0. Fifteen of the twenty tests with a result were passed; the other two tests were cancelled or have another status. In Testing Centre Performance, "Randburg - Tests 9 - Passed 8 - Failed 1 - Pass Rate 88.9%" shows where students do best.

Export

Export > Excel, PDF or CSV. The file holds the Test Details rows for the period and branch, with columns TestNumber, TestDate, StudentName, InstructorName, Vehicle, LicenceCode, TestingCentre, Status. See Exporting reports. Messages: "Unable to generate driving test report.", "Unable to export driving test report.".

Vehicle Report

Sidebar > REPORTING > Reports > Vehicle Report (/reports/vehicles). Subtitle "Vehicle usage, availability, compliance and fleet overview." Needs Reports.View and Vehicles.View.

The page says: "Lessons and driving tests in the selected period. Fleet counts and compliance above and below are as of today." Only the Usage figures and the Lessons, Hours and Tests columns follow the period.

With a branch selected, the vehicles are those of that branch plus vehicles available to all branches, and usage counts lessons and tests at that branch.

Screenshot to be added

Screen: Vehicle Report. Should show: fleet cards, Usage, Compliance and the Vehicle Details table.

Fleet cards (as of today)

Card How it is calculated
Total Vehicles All vehicles that are not deleted, whatever their status (sold vehicles included).
Active Status Active.
Maintenance Status Maintenance.
Inactive Status OutOfService.

Usage (selected period)

Figure How it is calculated
Lessons Lessons in the period, added up over the listed vehicles (every status, cancelled lessons included).
Training Hours Time of the non-cancelled lessons, added up over the listed vehicles.
Driving Tests Tests in the period, added up over the listed vehicles.

Compliance (as of today)

"Vehicle documents requiring attention." For Insurance, Roadworthy and Licence Disc:

  • "n expired": vehicles whose expiry date is before today;
  • the second number: vehicles whose expiry date is today or within the next 30 days.

Vehicles without a date for a document are not counted for that document.

Licence Codes, Transmission, Fuel Type (as of today)

  • Licence Codes: number of vehicles per licence code. A vehicle with two codes is counted under both.
  • Transmission and Fuel Type: number of vehicles and share of Total Vehicles (1 decimal).

Vehicle Details

In vehicle-number order.

Column Meaning
Vehicle Vehicle number.
Registration
Make / Model With the year.
Licence Licence codes the vehicle is used for.
Transmission
Mileage Current odometer reading.
Lessons Lessons with this vehicle in the period (every status).
Hours Time of its non-cancelled lessons in the period.
Tests Driving tests with this vehicle in the period.
Insurance, Roadworthy, Licence Disc Expiry dates.
Status Vehicle status.

Example

Period: This month. Total Vehicles 8, Active 6, Maintenance 1, Inactive 1. Usage: Lessons 240, Training Hours 228.5 h, Driving Tests 9. Compliance: Roadworthy "1 expired" and 2 expiring. One vehicle's roadworthy certificate has lapsed and two more lapse within 30 days. In Vehicle Details, a vehicle with Lessons 2 next to others with 40 is hardly being used.

Export

Export > Excel, PDF or CSV. The file holds the Vehicle Details rows with columns VehicleNumber, RegistrationNumber, Make, Model, Year, Colour, LicenceCode, Transmission, FuelType, CurrentMileage, InsuranceExpiry, RoadworthyExpiry, LicenseDiscExpiry, Status, Lessons, DrivingTests, TotalHours. The file is titled "Vehicle Utilization Report". See Exporting reports. Messages: "Unable to generate vehicle report.", "Unable to export vehicle report.".

Limitations and notes

  • No kilometres per period. Mileage is the current odometer reading. Distance, fuel and cost reporting belong to Fleet Management (Enterprise), which has its own page; see the vehicle and fleet documentation.
  • Lessons counts include cancelled lessons; Hours do not.
  • Sold vehicles are in Total Vehicles and in the detail list. The header's vehicle notifications ignore sold vehicles; this report does not.
  • Two vehicle endpoints, one screen. The page loads its data from api/reports/vehicles and exports through api/reports/vehicles/utilization/export; both produce the same report. GET api/reports/vehicles/utilization (without export) is not called by any page.
  • Reports are not limited to an instructor's own lessons or tests when an instructor is given Reports.View.
  • No charts on these pages; all figures are cards, lists and tables.
  • No saved reports, schedules or emailed reports. A background job named "report-generation" runs nightly but only writes a log line; see Financial Report.
  • The Overview cannot be exported.

The Financial reports page covers the Financial Report.