Dashboard and header¶
Applies to: all school staff (each part is shown according to the user's permissions). Not used by students or SuperAdmins. Last reviewed: 2026-11-18.
The dashboard is the school's start page: today's lessons and tests, money received, what is outstanding, and shortcuts to common tasks. This page also covers the header bar at the top of every screen: search, the notifications bell and the user menu.
Where to find it¶
Sidebar > MAIN > Dashboard (/dashboard).
- The menu link is shown to users with
Dashboard.View. - The page itself has no permission of its own: any signed-in staff member can open
/dashboard, and each card or panel appears only with the matching permission (table below). The server also removes figures a user may not see, so they are not merely hidden on screen. - A SuperAdmin belongs to no school and is sent to Users (
/settings/users) instead. - A student is sent to the student portal.
- When the school's subscription has ended, users are sent to the subscription page instead.
Screenshot to be added
Screen: Dashboard. Should show: welcome banner with Refresh dashboard, the row of KPI cards, Upcoming Lessons and Upcoming Driving Tests.
Layout¶
The page is titled Your driving school at a glance ("Here's what's happening with your driving school today. Keep track of students, lessons, tests and payments in one place.") with a Refresh dashboard button. Figures are loaded when the page opens and when you click the button; the page does not refresh itself.
If loading fails the page shows Unable to load dashboard - "Please try again." with a Try Again button.
What each permission shows¶
| Part of the dashboard | Permission needed |
|---|---|
| Students card | Students.View |
| Lessons Today card, Upcoming Lessons panel | Lessons.View |
| Tests Today card, Upcoming Driving Tests panel | DrivingTests.View |
| Payments Today, This Month, This Year cards, Payments Overview, Recent Payments | Payments.View (all payments), or Payments.Create alone (own payments only) |
| Outstanding card and the Outstanding figure in Payments Overview | Payments.View |
| Financial Report button | Payments.View |
| Quick action Add Student | Students.Create |
| Quick action Schedule Lesson | Lessons.Create |
| Quick action Record Payment | Payments.Create |
| Quick action Book Driving Test | DrivingTests.Create |
A user with none of these sees only the banner.
KPI cards¶
Every card is clickable and opens the related page.
| Card | Figure | Sub-text | Exactly what is counted | Opens |
|---|---|---|---|---|
| Students | Total students | "n active" | All students that are not deleted. Active = status Registered, LearnersPending, LearnersPassed, InTraining, ReadyForTest or TestBooked. The Active card on the Student Directory uses a different definition under the same label (every status except Inactive), so the two figures can differ. | Students |
| Lessons Today | Number of lessons | "Scheduled lessons" | Lessons starting today (00:00 to 24:00) whose status is not Cancelled. Completed and no-show lessons of today are included. | Lessons |
| Tests Today | Number of tests | "Driving tests" | Driving tests dated today with status Booked. Tests already marked completed or cancelled are not counted. | Driving Tests |
| Payments Today | Rand amount | "Successful payments" | Sum of payments with status Successful and payment date today. | Payments |
| This Month | Rand amount | "Payments received" | Sum of Successful payments dated in the current calendar month. | Payments |
| This Year | Rand amount | "Since 1 Jan <year>" |
Sum of Successful payments dated from 1 January of this year. | Payments |
| Outstanding | Rand amount | "n unpaid invoices" | Sum of (Total - Amount Paid) of every invoice that is not Paid and not Cancelled, and the number of those invoices. All dates. | Invoices |
How the figures are counted
- "Payments" on the dashboard always means money received, counted on the payment date. Voided and refunded payments are excluded.
- Outstanding counts Draft and Credit invoices too. See Outstanding balances for how this compares with the Invoices page.
- "Today" and month boundaries use the server's local date.
Differences per role¶
Staff who record payments but cannot view them (Payments.Create without Payments.View, for example a receptionist):
- The first payment card is titled My Payments Today with "Recorded by you"; This Month also says "Recorded by you".
- All payment figures, the chart and Recent Payments cover only payments that user captured.
- The Outstanding card and the Financial Report button are not shown. School-wide invoice figures are never sent to this user.
Instructors who do not manage everyone's lessons: the lesson and driving-test figures and lists (Lessons Today, Tests Today, Upcoming Lessons, Upcoming Driving Tests) cover only that instructor's own lessons and tests. The same rule as on the Lessons page applies; see the lesson documentation. An instructor login that is not yet linked to an instructor record sees zero.
Users tied to one branch see only that branch's students, lessons, tests, invoices and payments. The dashboard has no branch selector.
Users without any payment permission see no payment cards or panels at all.
Upcoming Lessons¶
"Next scheduled lessons". Needs Lessons.View.
- The next 10 lessons with status Scheduled or Confirmed that start today or later, earliest first. Lessons from earlier today that are still Scheduled or Confirmed are included.
- Columns: Time (time and date), Student, Instructor, Vehicle (vehicle number), Status.
- View All opens the Lessons page.
- Empty text: "No upcoming lessons."
Upcoming Driving Tests¶
"Students booked for testing". Needs DrivingTests.View.
- The next 10 driving tests with status Booked dated today or later, ordered by date.
- Each entry shows the day and month, the student, the testing centre, the time and instructor, and the status.
- View All opens the Driving Tests page.
- Empty text: "No upcoming driving tests."
Payments Overview¶
"Payments received over the last 12 months" (or "Payments you recorded over the last 12 months").
- Four figures: Today, This Month, This Year, and Outstanding (the last only with
Payments.View). They are the same figures as the cards. - A line chart of money received per month for the current month and the 11 months before it. Each point is the sum of Successful payments dated in that month. Months with nothing received are plotted as zero. Month labels look like "Jul 26".
- When nothing was received in the 12 months: "No payments received in the last 12 months."
- Financial Report opens the Financial Report.
Screenshot to be added
Screen: Dashboard. Should show: Payments Overview panel with the four figures and the 12-month line chart, next to Recent Payments.
Recent Payments¶
"Latest payment activity" (or "Your latest payments").
- The 5 most recent payments by payment date, of any status, so a voided (Cancelled) or Refunded payment can appear here with its status chip.
- Each entry shows the student (or walk-in customer), receipt number and method, date and time, amount and status.
- View All opens the Payments page.
- Empty text: "No recent payments."
Quick Actions¶
"Common tasks". Each button appears only with its create permission.
| Button | What it does |
|---|---|
| Add Student | Opens the new-student page (/students/new). |
| Schedule Lesson | Opens the Schedule Lesson dialog. |
| Record Payment | Opens the Receive Payment dialog; see Payments. |
| Book Driving Test | Opens the Book Driving Test dialog. |
After a dialog is saved the dashboard reloads.
How to read the dashboard: example¶
On 18 November the owner sees: Students 214 (163 active); Lessons Today 27; Tests Today 3; Payments Today R 6 450.00; This Month R 98 300.00; This Year R 1 204 800.00; Outstanding R 41 300.00 (36 unpaid invoices).
- 27 lessons start today and are not cancelled.
- 3 tests are booked for today and have no result yet.
- R 6 450.00 has been recorded as received with today's date.
- 36 invoices are neither paid nor cancelled; together they have R 41 300.00 still to be paid.
The receptionist, who may record but not view payments, sees My Payments Today R 2 100.00 on the same day: only what she captured.
Header bar¶
The header is at the top of every staff page.
| Element | Purpose |
|---|---|
| Menu button | Shows or hides the sidebar. |
| Search (Ctrl K) | Global search. |
| Bell | Notifications needing attention. |
| Help (question mark) | Help Centre, Keyboard shortcuts, About DriveFlow. Hidden on small screens, where Help Centre moves into the user menu. |
| User button | Name and role; menu with My Profile, Change Password, Settings (with Settings.View) and Logout. The menu header shows the name, email, role and school ("DriveFlow Platform (all schools)" for a SuperAdmin). |
Search and the bell are hidden once the subscription has ended.
Search¶
Click Search or press Ctrl K (Cmd K on a Mac) to open Search DriveFlow. Type at least 2 characters. Enter opens the first result; Esc closes.
| Result type | Matches | Needs |
|---|---|---|
| Student | Name, student number, email, phone, identity number | Students.View |
| Instructor | Name, instructor number, email, phone | Instructors.View |
| Vehicle | Registration number, vehicle number, make and model | Vehicles.View |
| Invoice | Invoice number, student name, walk-in customer name | Invoices.View |
| Quote | Quote number, student name, customer name | Quotes.View and the Quotes plan feature |
| Lead | Name, email, phone | Leads.View and the Leads plan feature |
| Lesson | Lesson number | Lessons.View (own lessons only for instructors who do not manage lessons) |
| Driving test | Test number | DrivingTests.View |
Up to a handful of results are returned per type. A student result opens the student's profile; the other types open their list page filtered to that record.
Header notifications¶
The bell shows a red badge with the number of items needing attention (shown as 99+ above 99). The list is refreshed when the page loads, every 2 minutes, when the bell is opened, and with the refresh icon in the menu.
The menu is titled Notifications with "n items need attention" or "Nothing needs attention" / "You're all caught up." It shows up to 10 items; View all notifications opens the Notifications page (/notifications), which has a chip per type with its count and lists up to 100 items of each type ("Showing the first 100 of each type. Open the related page to see them all."). Clicking an item opens the related record.
Note
These are live reminders calculated from the current data. They are not messages: nothing is marked as read, and an item disappears when its cause is resolved. They are separate from the emails, SMS and WhatsApp messages sent to students (see the notifications documentation).
| Type (chip on the Notifications page) | What triggers it | Who sees it | Opens |
|---|---|---|---|
| Pickups | A Scheduled or Confirmed lesson with a pickup location, starting between now and the end of tomorrow. Shown as a warning when it starts within 2 hours. | Lessons.View |
Lessons, filtered to the lesson |
| Lessons | The same, for lessons without a pickup location. | Lessons.View |
Lessons |
| Sign-offs | A lesson with status "awaiting instructor sign-off". Title "Sign-off needed · <student>". Nothing in the application sets that status, so this item does not appear in practice. |
Lessons.View |
Lessons |
| Driving tests | A Booked driving test dated today, tomorrow or the day after. Warning when it is today. | DrivingTests.View |
Driving Tests |
| Overdue invoices | An invoice with a balance above zero that has status Overdue, or is unpaid with a due date before today. Shows the customer, balance and days overdue. | Invoices.View and Payments.View |
Invoices |
| Vehicles | Licence disc, roadworthy or insurance expiring within 30 days or already expired; a service due within 14 days by date, or within 500 km by mileage, or overdue. Sold vehicles are ignored. | Vehicles.View |
Vehicles |
| Extra lessons to book | A student has extra lessons (top-ups) that are not booked yet. Not shown for students who are Licensed or Inactive. | Lessons.View, and only for staff who see everyone's lessons |
The student's lessons tab |
| Lead follow-ups | An open lead follow-up due by the end of today, assigned to the user or to nobody. Overdue ones are shown as errors. | Leads.View and the Leads plan feature |
Follow-ups |
| Lesson requests | A student's online lesson request that is still pending and whose time has not passed. | Lessons.Create and the Online Booking add-on |
Lesson requests |
| Fleet | Fleet Management alerts: unusual fuel use, kilometres not logged, odometer readings that do not fit, services due by kilometres. | Fleet.View and the Fleet plan feature |
Fleet Management |
Instructors who do not manage everyone's lessons get lesson, pickup, sign-off and driving-test items for their own lessons and tests only.
Staff also get a pop-up when a student sends a lesson or change request; that belongs to online booking and is described in the lesson documentation.
Screenshot to be added
Screen: Header. Should show: bell menu open showing the Notifications list with different alert types.
Limitations and notes¶
- No date or branch filter on the dashboard. Periods are fixed (today, this month, this year, last 12 months). For other periods use the Reports.
- No automatic refresh of dashboard figures; use Refresh dashboard.
- The Students card does not follow a role restriction beyond
Students.View: it always shows school-wide (or branch-wide) totals. - Figures calculated but not shown on the web dashboard. The dashboard data also contains total and active instructors, total vehicles, today's completed / upcoming / cancelled lessons and this month's completed and cancelled lessons. The web page does not display them; the mobile owner dashboard uses the same data (see the mobile app documentation).
- Upcoming Driving Tests are ordered by date only, so two tests on the same day are not necessarily in time order.
- Recent Payments shows payments of every status, including voided ones.
- Lessons Today includes lessons already completed today, despite the sub-text "Scheduled lessons".
- Header notifications cannot be dismissed, snoozed or configured per user.
Related articles¶
- Reports Overview and operational reports - reports for any period and branch
- Financial reports - the school's Financial Report in short
- Payments - recording and viewing payments
- Outstanding balances - how unpaid invoice balances are counted
- In-app notifications - the header bell and Notifications page