DriveFlow Settings Reference¶
Documentation version 1.0 - last updated 2026-11-18
Applies to: school Owners and staff with settings permissions; SuperAdmin; developers and server administrators. Last reviewed: 2026-11-18.
This document lists every setting in DriveFlow in one place: what it does, where it is, who can change it, its default, what a change affects, and whether a restart is needed. It describes what the system does today. The same content, with more explanation, is in the folder 14-system-settings.
Note
No secret value appears in this document. Configuration key names, and where secret values are kept, are covered in the internal technical documentation.
Table of contents¶
Contents
- How to read this reference
- Where settings are and who may change them
- Company settings
- Branch settings
- Country, currency, time and VAT
- User settings
- Role settings
- Training settings
- Scheduling settings
- Notification settings
- Email server settings
- Integration settings
- Payment settings
- Subscription settings
- Security settings
- Platform settings set by the SuperAdmin
- Server configuration with no screen
- Values fixed in the code and seed data
- Fields and features that exist but do nothing
1. How to read this reference¶
Each table has these columns:
| Column | Meaning |
|---|---|
| Setting | The label exactly as on screen, or the configuration key |
| What it does | Its effect |
| Default | The value a new school, branch or installation starts with |
| Limits | Allowed values |
| Existing records | Whether a change reaches records that already exist |
Unless a table says otherwise:
- Menu path is given at the top of each section. All school settings are under ADMINISTRATION > Settings.
- Restart: no setting on a Settings page needs a restart. Configuration values need a restart of the API. Values in the code need a new deployment.
- Scope: a school's settings affect that school only. Scheduling settings are per branch.
Note
There is no change history, audit log, export, import or "reset to defaults" for settings.
2. Where settings are and who may change them¶
The Settings page (/settings)¶
Shown to users with Settings.View. One card per area:
| Card | Address | Permission to see the card |
|---|---|---|
| Organisation | /settings/organisation |
Company.View |
| Users & Access | /settings/users |
Users.View |
| Roles | /settings/roles |
Roles.View |
| Driving School | /settings/driving-school |
Settings.View |
| Scheduling | /settings/scheduling |
Scheduling.View |
| Payments | /settings/payments |
Settings.View |
| Notifications | /settings/notifications |
Notifications.View |
| Security | /settings/security |
None. Always shown. |
| Documents | /settings/documents |
Settings.View. The page reads "This section is not available yet." |
/settings/email |
Email.View | |
| Integrations | /settings/integrations |
Settings.View |
| Subscription | /settings/subscription |
Subscription.View |
| Billing | /settings/billing |
Subscription.View |
| System | /settings/system |
Settings.Manage or Notifications.View. The page itself needs Notifications.View. |
A SuperAdmin sees only Users & Access, Roles, Security and Subscription.
Default permissions of the built-in roles¶
A SuperAdmin can change these, so check Settings > Roles for the live state.
| Permission | Owner | Administrator | Manager | Instructor | Receptionist | Finance | Viewer |
|---|---|---|---|---|---|---|---|
| Settings.View, Settings.Manage | Yes | Yes | No | No | No | No | No |
| Scheduling.View | Yes | Yes | Yes | Yes | Yes | No | Yes |
| Scheduling.Manage | Yes | Yes | Yes | No | No | No | No |
| Notifications.View, .Manage | Yes | Yes | No | No | No | No | No |
| Email.View, .Manage | Yes | Yes | No | No | No | No | No |
| Subscription.View | Yes | Yes | No | No | No | No | No |
| Subscription.Manage | Yes | No | No | No | No | No | No |
| Users.View | Yes | Yes | No | No | No | No | No |
Owner always has every permission. Administrator has every permission except Roles.Delete, Subscription.Manage and InstructorEarnings.ViewOwn.
Messages about access¶
| Message | Meaning |
|---|---|
| You don't have access to this page | The view permission is missing |
| You can view these settings but not change them. | The change permission is missing (Scheduling, Notifications, Email, Payments) |
| {Feature} is not included in your {plan} plan. Upgrade your plan under Settings > Subscription to use it. | The plan lacks the feature |
| {Feature} is a paid add-on. Activate or renew it under Settings > Billing to use it. | The add-on is not paid |
| Your subscription has ended. Renew it under Settings > Subscription to continue using DriveFlow. | The subscription has ended |
3. Company settings¶
Menu: Settings > Organisation. View: Company.View. Change: Company.Edit. Not available to the SuperAdmin.
| Setting | What it does | Default | Limits | Existing records |
|---|---|---|---|---|
| Organisation Name | The registered name. Shown in the sidebar and header when there is no trading name, and in emails. | From registration | Required | Shown everywhere from now on |
| Trading Name | Shown instead of the organisation name when filled in | Empty | - | As above |
| Registration Number | Company registration number | Empty | - | - |
| VAT Number | Text only. Does not switch on any VAT calculation. | Empty | - | - |
| Email Address | Contact address. DriveFlow's invoices to the school are emailed here. Used in the salesperson self-referral check. | From registration | Required | New emails |
| Phone Number, Office Phone Number, Website | Contact details | Empty | - | - |
| Address Line 1, City, Province, Postal Code | Address | Empty | Required | - |
| Address Line 2 | Address | Empty | - | - |
| Country | The country chosen at registration | From registration | Cannot be changed | - |
| Terms and Conditions | Printed on quotes and invoices when filled in | Empty | - | Documents produced from now on |
| Logo | Shown in the sidebar and the student portal | None | PNG, JPG, JPEG, WEBP or SVG; upload at most 5 MB | - |
| Active (no screen) | Shown as Active or Inactive in the sidebar | Active | Nothing changes it | - |
4. Branch settings¶
Menu: Settings > Organisation, branches section. View: Branches.View. Add: Branches.Create. Edit, enable, disable: Branches.Edit.
| Setting | What it does | Default | Limits | Existing records |
|---|---|---|---|---|
| Branch code | Identifies the branch | - | Required, at most 20, unique in the school | - |
| Branch name | Shown in the sidebar and pickers | - | Required, at most 150 | - |
| Manager name | Information | Empty | - | - |
| Branch contact address | - | Required, valid address | - | |
| Phone number | Branch contact number | - | Required | - |
| Address line 1, Address line 2, Postal code | Address | Empty | - | - |
| City, Province | Address | - | Required | - |
| Opening time, Closing time | General opening hours. Not used by the booking engine: see Working Hours in section 9. | 08:00, 17:00 | Opening before closing | - |
| Enable / Disable | A disabled branch cannot be chosen for users or bookings | Enabled | The main branch cannot be disabled | Records are kept |
| Main branch | The branch created at registration | - | Cannot be moved to another branch | - |
| Number of branches | Limited by the plan: 1 (Free Trial, Starter), 5 (Professional), unlimited (Enterprise plans) | - | - | - |
| Time zone (no screen) | Intended for interpreting branch times | South Africa Standard Time | Cannot be set | - |
| Latitude, Longitude (no screen) | Not used | Empty | - | - |
Note
A branch cannot be deleted.
5. Country, currency, time and VAT¶
| Setting | Can it be set | Where | Value |
|---|---|---|---|
| Country of a school | Once, at registration | Registration form | South Africa or Zimbabwe in the seed data |
| Currency | No | Fixed | Rand ("R", ZAR) |
| Language | No | Fixed | English |
| Number and date format | No | Fixed in the web app | English (South Africa) |
| Branch time zone | No | Database field with no screen | South Africa Standard Time |
| Clock for reminders and quiet hours | No | - | The server's local clock |
| Clock for Sales Management months | No | - | UTC |
| VAT on a school's own invoices | No setting found | - | See the finance guides |
| VAT on DriveFlow's invoices to schools | Yes, server configuration | Server configuration (see section 17) | Off; 15% |
6. User settings¶
Menu: Settings > Users & Access. View: Users.View. Create: Users.Create. Edit, new password: Users.Edit. Disable, enable: Users.Disable. Delete: Users.Delete. The SuperAdmin can view all schools' users but cannot change any.
| Setting | What it does | Default | Limits | When it changes |
|---|---|---|---|---|
| First name, Last name | Shown in lists and emails | - | Required | A linked instructor profile follows |
| The sign-in name | - | Required; unique across all of DriveFlow | A linked instructor profile follows | |
| Phone number | Contact number | Empty | - | - |
| Branch | One branch, or "All branches" for the whole school | All branches | An active branch of the school | The user is signed out |
| Role | The user's permissions | - | Required. One role. Built-in or the school's own. Owner, Student and SuperAdmin cannot be chosen. | The user is signed out |
| Send a new password | Emails a new temporary password | Unticked | - | The old password stops working; all sessions end; the user must choose a password at next sign-in |
| Status | Active or Disabled | Active | You cannot disable your own account | Sessions stop at the next request |
A new user is emailed a temporary password and must choose their own at first sign-in.
7. Role settings¶
Menu: Settings > Roles. View: Roles.View. Create: Roles.Create. Change permissions: Roles.AssignPermissions. Delete: Roles.Delete.
| Setting | What it does | Limits | When it changes |
|---|---|---|---|
| Role Name | Identifies the role | Required; not a built-in name; unique among built-in roles and the school's roles. Cannot be renamed. | - |
| Permissions | What holders may do. 83 permissions in 26 categories. | At least one | Every holder is signed out |
| Delete | Removes a custom role | Only when no user holds it. No confirmation. | - |
| Kind of role | Roles | Who changes it |
|---|---|---|
| Locked | Owner (all permissions), Student (none), SuperAdmin (all) | Nobody |
| Built-in | Administrator, Manager, Instructor, Receptionist, Finance, Viewer | SuperAdmin only. Applies to every school and signs out every holder in every school. |
| Shared | Created by the SuperAdmin | SuperAdmin only |
| Custom | Created by a school | That school |
SuperAdmin changes to built-in roles survive restarts.
8. Training settings¶
Menu: Settings > Driving School. View: Settings.View. Change: Settings.Manage.
Licence codes (/settings/driving-school/licence-codes)¶
| Setting | What it does | Default | Existing records |
|---|---|---|---|
| Switch per licence code | Whether the school offers the code. The list is the codes of the school's country. | Not verified | Packages and courses using a switched-off code are kept, but new lessons for it are refused |
Training packages (/settings/driving-school/packages)¶
| Setting | What it does | Default | Limits |
|---|---|---|---|
| Package Name | Name shown when selling | - | Required |
| Description | Free text | Empty | 1000 characters |
| Package Type | Training, Assessment and the other types in the system | Training | Required |
| Licence Code | The code the package trains for | - | Required except for Assessment; must be an enabled code |
| Price | The price. With package items it is the total of the items and cannot be typed. | 0 | 0 or more |
| Number of Lessons | Lessons included | - | 0 or more |
| Lesson Duration (minutes) | Lesson length for this package. Empty: the branch default is used. | Empty | At least 1 |
| Package Validity (days) | How long the package is valid | Empty | At least 1 |
| Package Items (Qty, Unit price, Lesson price) | Builds the price. The lesson price item is used for instructor earnings. | None | - |
| Learner's Licence Package | Marks a learner's licence package | Off | Not for Assessment |
| Active | An inactive package cannot be sold | On | - |
Note
Deleting a package that is in use deactivates it instead. Whether a price change reaches courses already sold was not verified.
Package items¶
| Setting | What it does |
|---|---|
| Item name, Default price, Description (optional), Active | A reusable item for building package prices |
Testing centres¶
| Setting | Required | Default |
|---|---|---|
| Centre code, Centre name, Phone number, City, Province | Yes | - |
| Contact person, Email, Address line 1, Address line 2, Postal code | No | Empty |
| Active | - | On |
Documents¶
No settings. The page reads "This section is not available yet."
9. Scheduling settings¶
Menu: Settings > Scheduling. Per branch. View: Scheduling.View. Change: Scheduling.Manage.
Important
A change never moves or cancels lessons already booked. Two settings, Cancellation notice and No status changes before the date, apply at once to lessons (and tests) that are already booked.
| Setting | What it does | Default | Limits | Existing lessons |
|---|---|---|---|---|
| Default lesson duration (min) | Lesson length when the package has none | 60 | At least 15 on screen | New bookings |
| Booking slot interval (min) | Steps in which start times are offered; lessons must start on a step | 30 | At least 5 on screen | Reschedules must land on the new step |
| Buffer between lessons (min) | Gap kept free around each lesson | 0 | 0 or more | New bookings and reschedules |
| Minimum advance booking (hours) | Earliest a lesson can be booked before its start. Applies to staff too. | 2 | 0 or more | New bookings |
| Maximum advance booking (days) | How far ahead a lesson can be booked. Applies to staff too. | 60 | At least 1 | New bookings |
| Cancellation notice (hours) | Latest a lesson can be cancelled or changed before its start. Not applied to SuperAdmin, Owner, Administrator and Manager. 0 switches it off. | 24 | 0 or more | Applies at once to booked lessons |
| Working Hours: Open / Closed per day | Days on which lessons can be booked | Monday to Saturday open, Sunday closed | Seven days | New bookings |
| Working Hours: Opening, Closing | Lessons must fall entirely inside | Mon to Fri 08:00 to 17:00, Sat 08:00 to 13:00 | Closing after opening | New bookings |
| Allow same-day bookings | Off: no bookings for today, staff included | On | - | New bookings |
| Allow online bookings | Off: students cannot request lessons in the portal. Needs the Online Booking feature and add-on. | On | - | New requests |
| Automatically assign instructor | On: a free qualified instructor is picked when none is chosen | Off | - | New bookings |
| Automatically assign vehicle | On: a free suitable vehicle is picked when none is chosen | Off | - | New bookings |
| No status changes before the date | On: lessons cannot be started, signed off, completed or marked no-show, and test results not recorded, before their date | On | - | Applies at once to existing lessons and tests |
| Maximum lessons per student per day | Limit per student per day | 2 | 1 to 10 on screen | New bookings and reschedules |
10. Notification settings¶
Menu: Settings > Notifications. View: Notifications.View. Change: Notifications.Manage. Changes apply to messages sent from now on.
Channels¶
| Setting | Default | Needs |
|---|---|---|
| On | Nothing | |
| SMS | Off | The SMS feature and credits |
| Off | The WhatsApp feature and add-on | |
| Push | No setting. Sent automatically to app users when the plan has the mobile app. | - |
Notifications¶
Each student notification has an Enabled switch and Email, SMS and WhatsApp tick boxes. Staff notifications have a switch only.
| Notification | Default | Default channel | Note |
|---|---|---|---|
| Student Welcome | On | Skipped, not delayed, during quiet hours | |
| Lesson Booking Confirmation | On | Sent during quiet hours | |
| Lesson Reminder | On | See reminders | |
| Driving Test Reminder | On | See reminders | |
| Lesson Rescheduled | On | Sent during quiet hours | |
| Lesson Cancelled | On | Sent during quiet hours | |
| Lesson Request Declined | On | Sent during quiet hours | |
| Payment Received | On | Email with receipt | Sent during quiet hours |
| Payment Reminder | On | Timing is under Settings > Payments | |
| Invoice Issued | On | Only the email is sent | |
| New Lesson Assigned (staff) | On | - | |
| Lesson Rescheduled (staff) | On | - | |
| Lesson Cancelled (staff) | On | - | |
| Daily Instructor Schedule (staff) | Off | - | Not working: nothing sends it |
| Lesson Completed | Sent by email | - | No switch on the page |
Reminders and quiet hours¶
| Setting | What it does | Default | Limits | Existing lessons |
|---|---|---|---|---|
| Lesson Reminder: send before (minutes) | When the lesson reminder goes out | 1440 | 15 to 44640, steps of 15 | Applies to booked lessons not yet reminded |
| Driving Test Reminder: send before (minutes) | When the test reminder goes out | 1440 | 15 to 44640, steps of 15 | As above |
| Quiet Hours switch | Holds back non-urgent messages | Off | - | - |
| Quiet hours start, Quiet hours end | The window; may run over midnight | Empty | Both required | - |
Note
Only lesson and driving test reminders are really delayed by quiet hours. Reminders are checked every 15 minutes, by the server's clock, for lessons with status Scheduled and tests with status Booked. Notification wording cannot be edited.
Notification log¶
Menu: Settings > System. Permission: Notifications.View. Read-only list of every message with its status. No settings.
11. Email server settings¶
Menu: Settings > Email. View: Email.View. Change and test: Email.Manage. Applies to emails sent from now on.
| Setting | What it does | Default | Limits |
|---|---|---|---|
| Use DriveFlow default email | Emails go through the platform's server, with the platform's sender | Selected | - |
| Use my own SMTP server | Emails go through the school's server | - | Needs the fields below |
| SMTP Host | The school's mail server | Empty | Required |
| Port | Server port | 587 | Use 587. Port 465 is not supported and makes every email fail. |
| SMTP Username | Sign-in name | Empty | Required |
| SMTP Password | Password. Stored encrypted, never shown again. Empty keeps the saved one. | Empty | Required the first time |
| Use SSL / TLS | Encrypt the connection | On | - |
| Sender Name | The "from" name | Empty | Required. Used only with your own SMTP server. |
| Sender Email | The "from" address | Empty | Required, valid address. Used only with your own SMTP server. |
| Test email address + Send Test Email | Sends a test with the saved settings | - | Save first |
Warning
Port 465 is not supported and makes every email fail. Use 587.
12. Integration settings¶
Menu: Settings > Integrations. View: Settings.View. Connect, disconnect: Settings.Manage.
| Setting | What it does | Default | Needs |
|---|---|---|---|
| Facebook & Instagram: Connect Facebook Page | Links one Facebook Page; its lead forms then create leads in DriveFlow | Not connected | The Leads feature and add-on |
| Facebook & Instagram: Disconnect | Stops new leads. Existing leads are kept. | - | - |
| A notice only. Nothing can be set. | - | - |
13. Payment settings¶
Menu: Settings > Payments. View: Settings.View. Change: Settings.Manage. Two separate save buttons: Save Changes and Save online payments.
Overdue and reminders¶
| Setting | What it does | Default | Limits | Existing invoices |
|---|---|---|---|---|
| Grace period (days after due date) | When an unpaid invoice is marked Overdue | 0 | 0 to 90 | From the next daily run. An invoice already Overdue is not set back. |
| Send a "payment due soon" email (days before) | One email before the due date. 0 is off. | 3 | 0 to 30 | All unpaid invoices, from the next run |
| After the due date: On / Off | Reminders for overdue invoices | On | - | As above |
| First reminder (days after) | First overdue reminder | 1 | 1 to 90 | As above |
| Repeat every (days) | Gap between reminders. 0 sends one only. | 7 | 0 to 90 | As above |
| Maximum reminders | Most reminders per invoice | 3 | 1 to 20 | Counts already recorded are kept |
Important
Reminders run daily at 08:00 UTC (10:00 South African time) and need Email on and the Payment Reminder notification enabled under Settings > Notifications.
Online payments (PayFast)¶
| Setting | What it does | Default | Limits |
|---|---|---|---|
| On / Off | Students can pay invoices in the portal | Off | Needs merchant ID and key. Needs the Payments feature. |
| Merchant ID | The school's PayFast merchant number | Empty | Digits, at most 50 |
| Merchant key | The school's PayFast key. Encrypted, never shown again. | Empty | At most 100 |
| Passphrase | The school's PayFast passphrase. Encrypted, never shown again. | Empty | At most 100 |
| Remove the saved passphrase | Clears it | - | - |
| Allow part payments | On: students choose the amount | Off | - |
| Test mode (PayFast sandbox) | No real money moves | Off | - |
No settings exist for bank details, invoice numbering, a tax rate or payment methods.
14. Subscription settings¶
Menu: Settings > Subscription and Settings > Billing. View: Subscription.View. Change: Subscription.Manage (Owner only by default).
| Setting | What it does | Limits | Takes effect |
|---|---|---|---|
| Plan | Features and limits | Paid online through PayFast | When the payment is confirmed |
| Billing period | Monthly or annual | - | With the payment |
| Salesperson / Referral Code | Links the school to a salesperson | Only before the first payment | When applied |
| Cancel / Resume | Stops, or keeps, the subscription at the end of the period | - | At the end date |
| Add-on: activate, renew, cancel, undo | A feature paid month by month | No automatic renewal | With the payment / at the paid-up date |
| SMS bundle | Adds SMS credits | 100, 300 or 500 | With the payment |
| Plan | Monthly | Annual | Students | Instructors | Vehicles | Branches |
|---|---|---|---|---|---|---|
| Free Trial | R 0, 14 days | - | 10 | 2 | 2 | 1 |
| Starter | R 499 | R 4 990 | 100 | 5 | 5 | 1 |
| Professional | R 999 | R 9 990 | 1 000 | 25 | 15 | 5 |
| Enterprise | R 2 499 | R 24 990 | Unlimited | Unlimited | 30 | Unlimited |
| Enterprise Plus | R 3 999 | R 39 990 | Unlimited | Unlimited | 70 | Unlimited |
| Enterprise Custom | By quote | By quote | Unlimited | Unlimited | Unlimited | Unlimited |
| Add-on | Setup fee | Price |
|---|---|---|
| Leads | R 1 499 | R 1 499 per month |
| R 1 499 | R 1 499 per month | |
| Online Booking | None | R 499 per month |
| SMS | R 299 | 100 for R 55, 300 for R 150, 500 for R 225 |
Leads and WhatsApp together: 30% off. Plans, prices, limits and add-ons cannot be edited in the application.
Statuses: Trial, Active, Pending payment, Expired; Cancelled and Suspended also exist but nothing sets them (cancelling keeps Trial or Active, records the cancellation date and stops auto-renew).
Warning
Access stops at the end date. There is no grace period.
15. Security settings¶
Menu: Settings > Security. Open to every signed-in user.
The page has no settings
It holds a Change Password button, links to Users and Roles, and the student portal list.
| Setting | Value | Where it is set | Change needs |
|---|---|---|---|
| Normal session length | 480 minutes | Server configuration | Restart |
| "Remember me" session length | 30 days | Server configuration | Restart |
| Idle sign-out (not for "remember me") | 30 minutes; 0 is off | Web app configuration | Not verified |
| Minimum password length | 8 | Code | New deployment |
| Password must have a digit, upper case, lower case and symbol | Yes | Code | New deployment |
| Failed sign-ins before lockout | 5 (framework default) | Code | New deployment |
| Lockout time | 5 minutes (framework default) | Code | New deployment |
| Password reset link lifetime | 1 hour, single use | Code | New deployment |
| Password reset emails | 3 per address per 15 minutes | Code | New deployment |
| Account state remembered by the server | 1 minute | Code | New deployment |
| Password expiry, password history | None | - | - |
| Two-factor sign-in, email confirmation, refresh tokens, session list, single sign-on, IP restriction, audit log | Do not exist | - | - |
"Remember me"¶
| Not ticked | Ticked | |
|---|---|---|
| Session length | 8 hours | 30 days |
| Kept in the browser | For the tab only | Survives closing the browser |
| Idle sign-out | After 30 minutes | Never |
What ends sessions early¶
| Event | Effect |
|---|---|
| Own password change | All other sessions end, within 1 minute |
| Password reset by emailed link, or new password sent by an administrator | All sessions end, within 1 minute |
| Role or branch of the user changed | All sessions end at once |
| A role's permissions changed | All sessions of all holders end at once |
| User disabled | All sessions end at once |
| Student portal access deactivated | All sessions end, within 1 minute |
Signing out signs you out in that browser. A user may be signed in on any number of devices.
Student portal access¶
Per student, on the Security page (view: Students.View; act: Students.Edit): Invite to portal, Resend invitation, Activate, Deactivate. Inviting needs the Student Portal feature. No portal-wide settings exist.
16. Platform settings set by the SuperAdmin¶
| Setting | Menu | What it does | Default | Existing records | Restart |
|---|---|---|---|---|---|
| Built-in role permissions | Roles | Permissions of Administrator, Manager, Instructor, Receptionist, Finance, Viewer in every school | Seeded defaults | All holders are signed out | No |
| Shared roles | Roles > Create Role | A role every school can assign | None | - | No |
| Gateway fee: Payment gateway, Currency, Fee percentage, Fixed fee per transaction, Effective from, Effective to, Active | Sales Management > Gateway Fee Settings | The rate used to estimate a gateway fee when none is reported | PayFast 3.00%, R 0.00, ZAR, from 1 January 2026 | Existing commissions are never recalculated | No |
| Salesperson: Commission | Sales Management > Salespeople | Percentage of net eligible revenue | 20; 0 to 100 | Only schools that have not paid yet | No |
| Salesperson: Commission period | Sales Management > Salespeople | Months of commission per school | 12; 1 to 12 | Only schools that have not paid yet | No |
| Salesperson: Status | Sales Management > Salespeople | Whether new schools can use the code | Active | Existing referrals keep earning | No |
| School subscription: plan, billing period, start date, duration, agreed amount, payment status, payment reference | Subscriptions | Sets a school's subscription by hand | Professional, Annual, today, 12 months, list price, Paid | Replaces the current period; auto-renew off | No |
| School add-ons and SMS credits | Subscriptions > Add-ons | Activates, extends or deactivates add-ons; adds credits | - | - | No |
| School referral code | Subscriptions > Salesperson code | Links a school to a salesperson | None | Only before the first payment | No |
17. Server configuration with no screen¶
All need a restart of the API. Configuration key names, and where secret values such as passwords, keys and tokens are kept, are covered in the internal technical documentation.
| Area | Purpose | Default or supplied value |
|---|---|---|
| Database connection | The database | - |
| Sign-in tokens | Sign and check sign-in tokens | - |
| Session lengths | Normal and "remember me" sessions | 480 minutes, 30 days |
| Platform email server | The platform SMTP server | Port 587, SSL on, name DriveFlow |
| Platform alert address | Where platform alerts go | The platform owner's address |
| Web app address | Used in email links and password reset links | Empty in code |
| Billing issuer | The business on DriveFlow's invoices | The current issuer |
| VAT on DriveFlow's invoices | VAT registration and rate | Off, 0.15 |
| DriveFlow's own PayFast account | Subscription payments to DriveFlow | - |
| PayFast test mode, address and confirmation of notices | How DriveFlow talks to PayFast | Off in the supplied configuration, live address, on |
| PayFast return and notification addresses | Return and notification addresses, for subscriptions and student payments | The web app and API addresses |
| Other gateways (Paystack, Flutterwave, Stripe) | Not used for subscriptions | Empty |
| SMS sending switch | Switches SMS sending on. When off, messages are still logged as sent and credits used. | Off |
| SMS provider details and account | The platform SMS provider | Sender DriveFlow, country 27, 15 seconds |
| Platform WhatsApp number | WhatsApp sending | Off, v21.0, 27, 15 |
| Meta app | Facebook and Instagram lead capture | - |
| Push notifications | Off until set | Not set |
| Logging levels | Server logging | Information |
| Web app: API address and timeout | The API the web app calls | 100 seconds |
| Web app: idle sign-out | Idle sign-out | 30 |
Mobile app values (API address, web app address, environment, application id and version) are built into the app and need a new app release.
18. Values fixed in the code and seed data¶
| Value | Today | Change needs |
|---|---|---|
| Free trial length | 14 days | New deployment |
| Subscription grace period | None | New deployment |
| Password rules, lockout, reset link lifetime, reset email limit | See section 15 | New deployment |
| Web app language and formats | English (South Africa) | New deployment |
| Leads and WhatsApp discount | 30% | New deployment |
| Maximum commission period | 12 months | New deployment |
| Default salesperson terms | 20%, 12 months | New deployment |
| Longest manual subscription | 60 months | New deployment |
| Largest agreed amount | R 10 000 000 | New deployment |
| Sales dashboard range | 12 months default, 36 at most | New deployment |
| Logo files | PNG, JPG, JPEG, WEBP, SVG; 5 MB | New deployment |
| File storage | The uploads folder on the API server |
New deployment |
| Notification wording | Fixed | New deployment |
| Roles that bypass the cancellation notice | SuperAdmin, Owner, Administrator, Manager | New deployment |
| First SuperAdmin account | Created when the platform is installed; see the internal technical documentation. Change its password after the first sign-in. | New deployment |
| Job: lesson-reminders, driving-test-reminders, meta-lead-requeue | Every 15 minutes | New deployment |
| Job: subscription-expiry | Hourly | New deployment |
| Job: document-expiry-reminders, invoice-reminders, report-generation | Daily 07:00, 08:00, 23:00 UTC | New deployment |
| Plans, prices, limits, features | See section 14 | Migration |
| Add-ons, setup fees, SMS bundles | See section 14 | Migration |
| Countries, licence codes | South Africa, Zimbabwe; codes per country | Migration |
| Permissions and built-in roles | 83 permissions, nine roles | Start-up seeder |
Development tools and background-job monitoring are for developers only and are covered in the internal technical documentation.
19. Fields and features that exist but do nothing¶
Warning
The items below can be seen on screen, in the data or in the plan lists, but have no effect. Do not rely on them.
| Item | State |
|---|---|
| Audit log, and the permission AuditLogs.View | No table, no writer, no page |
| Refresh tokens | An empty class |
| Two-factor enabled (user field) | Never read or set |
| Email confirmed (user field) | Not required for signing in |
| School Active flag | Never changed |
| Subscription statuses Suspended and Cancelled | Never set |
| Branch time zone, latitude, longitude | No screen |
| Notification settings Active flag and the older notification fields | No screen; the older fields are not read |
| Payment Reminder "send before" minutes | Stored, not used |
| "Daily Instructor Schedule" notification | Has a switch; never sent |
| "Invoice Issued" SMS and WhatsApp tick boxes | Appear to have no effect |
| Settings > Documents | "This section is not available yet." |
| WhatsApp card on Settings > Integrations | A notice only |
| Sender Name and Sender Email with "Use DriveFlow default email" | Ignored |
| Permissions Branches.Delete and Lessons.OverrideCancellationNotice | Nothing checks them |
| Feature codes API, WHITE_LABEL, ACCOUNTING | Nothing checks them |
| An older email settings interface on the server | Not used by the web app |
| Paystack, Flutterwave and Stripe gateways | Registered; not used for subscriptions |
| SendGrid, MailKit, Twilio and Azure sender classes; the Serilog reference | In the code; not in use |
| SettingsNavigation, Smtp, SmtpSettingsForm components | Empty placeholders |
| Create, Edit, Disable and Delete user buttons for the SuperAdmin | Shown; refused by the server |