DriveFlow notification reference¶
Applies to: Owner, Administrator, support staff, SuperAdmin, developers. Last reviewed: 2026-11-18.
Documentation version 1.0 - last updated 2026-11-18
This is the single-document reference for how DriveFlow CRM sends messages. It is self-contained; each section links to a detailed page in the notifications section. Everything here describes what the code does today, including the parts that are unfinished.
Prefer a quick overview?
Notifications at a glance summarises who receives which message, when and by which channel, in plain terms.
Contents¶
- Summary
- Architecture
- Channels
- Trigger matrix
- Events that send nothing
- Schedules
- Settings
- Templates
- Notification log
- Troubleshooting summary
- Known limitations
- Source map
1. Summary¶
| Question | Answer |
|---|---|
| Channels | Email, SMS, WhatsApp, Android push. Plus a live alert bell in the web header (not a delivery channel). |
| Email provider | SMTP through TenantSmtpEmailService: the school's own SMTP server if set, otherwise the platform's. |
| SMS provider | Vodacom Messaging HTTP API (VodacomSmsService), one platform account. Prepaid credits per school. |
| WhatsApp provider | Meta WhatsApp Cloud API (MetaWhatsAppService), one platform number, free-form text only. Monthly add-on per school. |
| Push provider | Firebase Cloud Messaging (FirebasePushSender), Android only. Needs the Mobile App plan feature. |
| Scheduler | Hangfire, running inside the API process, SQL Server storage. |
| Who configures what | Platform (server configuration): global SMTP, SMS, WhatsApp, Firebase, app URL. School: channel switches, per-message switches, reminder timing, quiet hours, payment reminder rules, own SMTP. |
| Templates | Fixed in code. Not editable. |
| Opt-outs | None per person. Push can be switched off per phone in the app. |
| Retries | None, except that a failed automatic payment reminder email is attempted again on the next daily run. |
| Delivery record | Notifications table, shown at Settings > System > Notification Log. |
| Failure effect | A notification failure never fails the booking, payment or other action that caused it. |
2. Architecture¶
2.1 Engine events¶
flowchart TD
A["BUSINESS EVENT<br/>staff or student action in the web app / mobile app,<br/>a PayFast callback, or a Hangfire job"] --> B["HANDLER OR JOB<br/>BookLessonHandler, CancelLessonHandler, RescheduleLessonCommandHandler,<br/>StudentSignOffLessonCommand handler, ApproveBookingCommandHandler,<br/>RejectBookingCommandHandler, RegisterStudentHandler, RecordPaymentCommand handler,<br/>PaymentProcessingService, LessonReminderJob, DrivingTestReminderJob,<br/>InvoiceReminderService"]
B -- "INotificationDispatcher.SendAsync(NotificationEvent, NotificationContext)" --> C["DISPATCHER NotificationDispatcher<br/>1 tenant (company) in scope?<br/>2 CompanyNotificationSettings present and active?<br/>3 NotificationPreference for the event enabled?<br/>4 quiet hours (non-urgent events are skipped)<br/>5 channels = company switch AND per-event tick<br/>6 drop SMS / WhatsApp without the plan feature (ISubscriptionAccessService)<br/>7 add Push when the plan has MOBILE_APP<br/>8 recipient from NotificationRecipientResolver (student or instructor record)<br/>9 content from NotificationContentFactory + NotificationEmailTemplate<br/>10 receipt PDF for PaymentReceived (IGeneratedDocumentService)"]
C --> E["EmailNotificationChannel<br/>IEmailService: TenantSmtpEmailService<br/>to SMTP"]
C --> S["SmsNotificationChannel<br/>ISmsService: VodacomSmsService<br/>to Vodacom HTTP API<br/>(SmsCreditService reserves / refunds credits)"]
C --> W["WhatsAppNotificationChannel<br/>IWhatsAppService: MetaWhatsAppService<br/>to Meta Cloud API"]
C --> P["PushNotificationChannel<br/>IPushSender: FirebasePushSender<br/>to FCM, then the Android app"]
E --> R["RECIPIENT<br/>student / instructor"]
S --> R
W --> R
P --> R
R --> L["LOG<br/>Notification row per channel: Sent or Failed (+ error text)"]
All channels implement INotificationChannel.
2.2 Direct emails¶
flowchart TD
A["BUSINESS EVENT<br/>invoice created or sent, reminder due, receipt, quote, new user,<br/>portal invite, forgot password, school registration,<br/>subscription payment, test email"] --> B["SERVICE<br/>InvoiceEmailService, InvoiceReminderService, PaymentReceiptEmailService,<br/>QuoteService, UserService, StudentPortalAccessService,<br/>PasswordRecoveryService, RegistrationEmailService,<br/>SubscriptionInvoiceEmailService, EmailSettingsService"]
B --> C["IEmailService<br/>TenantSmtpEmailService"]
C --> D["SMTP"]
D --> R["RECIPIENT"]
C --> L["LOG<br/>Notification row (not for user, invite, reset or test emails)"]
A third, older path exists: ReminderService -> NotificationService (INotificationService). Only the document expiry job uses it, and it does not work as intended (section 6.5).
Detail: Notification system overview.
3. Channels¶
| SMS | Push | In-app bell | |||
|---|---|---|---|---|---|
| Service class | TenantSmtpEmailService |
VodacomSmsService |
MetaWhatsAppService |
FirebasePushSender |
HeaderService |
| Unused alternatives in the code | SmtpEmailService, SendGridEmailService, MailKitEmailService |
TwilioSmsService, AzureSmsService |
LoggingWhatsAppService |
- | - |
| Platform configuration | Platform email server | Vodacom SMS account | Meta WhatsApp account | Firebase key | None |
| School configuration | Own SMTP at Settings > Email (optional) | None | None | None | None |
| School switch | Email (default on) | SMS (default off) | WhatsApp (default off) | None | None |
| Plan / add-on | Every plan | Plan feature SMS + prepaid credits | Plan feature WhatsApp + paid monthly add-on | Plan feature Mobile App | Running subscription |
| Recipients | Students, instructors, customers, users, schools | Students (instructors only if ticked from the mobile settings screen) | As SMS | Students and instructors signed in on Android | Signed-in staff |
| Used by direct emails | Yes | No | No | No | No |
| Cost in DriveFlow | None | 1 credit per SMS part (160 / 153 characters; 70 / 67 with special characters); refunded if the send fails | None per message | None | None |
| "Sent" means | SMTP server accepted | Provider API accepted | Meta API accepted | FCM accepted at least one device | - |
| Timeout | 30 s | 15 s | 15 s | SDK default | - |
| Retry | None | None | None | None (FCM holds for offline phones) | - |
| Main caveat | Port 465 not supported | Disabled provider still logs Sent and uses a credit | 24-hour rule: no approved templates, so most unsolicited messages are refused | Android only | Live list, no history |
Detail: email, SMS, WhatsApp, push, in-app.
4. Trigger matrix¶
Terms:
- Engine = through
NotificationDispatcher: Email if on, SMS and WhatsApp if switched on and ticked, Push if the plan has the Mobile App. - Email only = direct email; never SMS, WhatsApp or push.
- Standard gating = settings active; message Enabled; channel master switch and per-message tick on; plan feature and credits/add-on for SMS and WhatsApp; Mobile App feature and Firebase for push.
- Standard failure = caught; Failed row with error text; business action succeeds; no retry.
- Urgent = sent even in quiet hours.
Rows are numbered as on the Notification triggers page (A = engine, B = direct email).
4.1 Through the engine¶
| # | Event | Recipient | Channel(s) | Triggering code (class/handler) | Timing | Template | Required configuration / gating | Failure and retry behaviour |
|---|---|---|---|---|---|---|---|---|
| A1 | Student registered | Student | Engine | RegisterStudentHandler -> StudentWelcome |
Immediate | "Welcome to <school>" |
Standard gating. Non-urgent: dropped in quiet hours. | Standard failure |
| A2 | Lesson booked by staff | Student | Engine | BookLessonHandler -> LessonBooked |
Immediate, one per date | "Driving Lesson Confirmed" | Standard gating. Urgent. | Standard failure |
| A3 | Lesson booked by staff | Instructor | Engine | BookLessonHandler -> InstructorLessonAssigned |
Immediate, one per date | "New Lesson Assigned" | Standard gating. Urgent. | Standard failure |
| A4 | Lesson request approved | Student | Engine | ApproveBookingCommandHandler -> LessonBooked |
Immediate | "Driving Lesson Confirmed" + "Note from your school" | Standard gating. Urgent. | Standard failure |
| A5 | Lesson request approved | Instructor | Engine | ApproveBookingCommandHandler -> InstructorLessonAssigned |
Immediate | "New Lesson Assigned" | Standard gating. Urgent. | Standard failure |
| A6 | Change request approved | Student | Engine | ApproveBookingCommandHandler.ApproveChangeAsync -> LessonRescheduled |
Immediate | "Driving Lesson Rescheduled" | Standard gating. Urgent. | Standard failure |
| A7 | Change request approved | Instructor | Engine | Same -> InstructorLessonRescheduled |
Immediate | "Lesson Rescheduled" | Standard gating. Urgent. | Standard failure |
| A8 | Lesson or change request declined | Student | Engine | RejectBookingCommandHandler -> LessonRequestDeclined |
Immediate | "Lesson Request Declined" | Standard gating. Urgent. | Standard failure |
| A9 | Lesson rescheduled by staff | Student | Engine | RescheduleLessonCommandHandler -> LessonRescheduled |
Immediate | "Driving Lesson Rescheduled" | Standard gating. Urgent. | Standard failure |
| A10 | Lesson rescheduled by staff | Instructor (the one before the move) | Engine | RescheduleLessonCommandHandler -> InstructorLessonRescheduled |
Immediate | "Lesson Rescheduled" | Standard gating. Urgent. | Standard failure |
| A11 | Lesson cancelled | Student | Engine | CancelLessonHandler -> LessonCancelled |
Immediate, one per day | "Driving Lesson Cancelled" | Standard gating. Urgent. | Standard failure |
| A12 | Lesson cancelled | Instructor | Engine | CancelLessonHandler -> InstructorLessonCancelled |
Immediate, one per day | "Lesson Cancelled" | Standard gating. Urgent. | Standard failure |
| A13 | Lesson completed (student sign-off) | Student | Email + Push only | StudentSignOffLessonCommand handler -> LessonCompleted |
Immediate | "Driving Lesson Completed" | Not in settings: follows the Email master switch; cannot be switched off alone. Urgent. | Standard failure |
| A14 | Lesson reminder | Student | Engine | LessonReminderJob -> LessonReminder |
Every 15 min check; default 24 h before | "Driving Lesson Reminder" | Standard gating; status Scheduled; held in quiet hours | Marked reminded even if delivery failed; no retry |
| A15 | Driving test reminder | Student | Engine | DrivingTestReminderJob -> DrivingTestReminder |
Every 15 min check; default 24 h before | "Driving Test Reminder" | Standard gating; status Booked; held in quiet hours | As above |
| A16 | Payment recorded by staff | Student | Engine | RecordPaymentCommand handler -> PaymentReceived |
Immediate | "Payment Received" + receipt PDF | Standard gating. Urgent. Nothing for walk-in payments. | Standard failure; sent without PDF if it cannot be built |
| A17 | Online payment confirmed | Student | Engine | PaymentProcessingService.FinalizeSuccessfulTransactionAsync -> PaymentReceived |
Immediate on gateway confirmation | "Payment Received" + receipt PDF | Standard gating. Urgent. | Standard failure |
| A18 | Payment reminder, text part | Student | SMS + WhatsApp + Push only | InvoiceReminderService.SendTextRemindersAsync -> PaymentReminder (Email skipped) |
Right after the reminder email succeeded | "Payment Reminder" | Standard gating; student invoices only; non-urgent: dropped in quiet hours | Standard failure |
4.2 Direct emails¶
| # | Event | Recipient | Channel(s) | Triggering code (class/handler) | Timing | Template | Required configuration / gating | Failure and retry behaviour |
|---|---|---|---|---|---|---|---|---|
| B1 | First invoice at registration | Student | Email only | RegisterStudentHandler -> InvoiceEmailService.TrySendAsync |
Immediate | "Invoice <n>" + PDF |
Settings active, Email on, Invoice Issued enabled with Email ticked | Failed row + server warning; no retry |
| B2 | Extra lesson invoiced | Student | Email only | LessonTopUpService -> TrySendAsync |
Immediate | "Invoice <n>" + PDF |
As above | As above |
| B3 | Assessment invoiced | Student | Email only | StudentAssessmentFeatures -> TrySendAsync |
Immediate | "Invoice <n>" + PDF |
As above | As above |
| B4 | Quote converted to invoice | Student / customer | Email only | QuoteService (convert) -> TrySendAsync |
Immediate | "Invoice <n>" + PDF |
As above | As above |
| B5 | Send Email on an invoice | Student / customer | Email only | InvoicesController POST {id}/send -> InvoiceEmailService.SendAsync |
Immediate | "Invoice <n>" + PDF |
Invoices.View; Payments feature; ignores notification settings |
Error shown to user; Failed row |
| B6 | Automatic payment reminder | Student / customer on the invoice | Email only (+ text part above) | InvoiceReminderJob -> InvoiceReminderService.ProcessDueRemindersAsync |
Daily | "Payment due soon: ..." / "Payment reminder: ... is overdue" + PDF | Settings active, Email on, Payment Reminder enabled with Email ticked; rules in Settings > Payments; invoice has an email | Failed row; counters not advanced, so retried next day |
| B7 | Send Reminder on an invoice | Student / customer | Email only (+ text part) | InvoicesController POST {id}/remind -> InvoiceReminderService.SendNowAsync |
Immediate | As above | Invoices.View; unpaid invoice; ignores notification settings |
"The reminder could not be sent: ..." |
| B8 | Email Receipt | Student / customer | Email only | PaymentsController POST {id}/send-receipt -> PaymentReceiptEmailService |
Immediate | "Payment receipt: <n>" + PDF |
Payments.View or Payments.Create; payment Successful |
"The receipt email could not be sent: ..."; Failed row |
| B9 | Quote emailed | Student / customer | Email only | QuotesController POST {id}/send -> QuoteService.SendAsync |
Immediate | "Quote <n> from <school>" + PDF |
Quotes.Edit; Quotes feature; not rejected |
"The quote email could not be sent: ..."; Failed row |
| B10 | Staff user created | New user | Email only | UserService.SendAccountEmailAsync |
Immediate | "Welcome to <school>" + temporary password |
None | Server log only; not in the log |
| B11 | Admin resets a user's password | User | Email only | UserService.SendAccountEmailAsync |
Immediate | "Your new <school> password" |
None | Server log only; not in the log |
| B12 | Invite to portal / Resend invite | Student | Email only | StudentPortalAccessService.InviteAsync |
Immediate | "Your <school> student portal" |
Student Portal feature; student email present | Error shown to user; not in the log |
| B13 | Forgot password | User | Email only | PasswordRecoveryService.RequestResetAsync |
Immediate | "Reset your <school> password" (link valid 60 min) |
Platform:AppUrl set; max 3 per address per 15 min; active account |
Server log only; not in the log |
| B14 | School registers | School email + owner email | Email only | RegistrationEmailService (from AuthService, OrganisationRegistrationService) |
Immediate | "Welcome to DriveFlow" | Platform mail server | Failed row in the school's log; registration succeeds |
| B15 | School registers | Platform:AdminEmail |
Email only | RegistrationEmailService |
Immediate | "New DriveFlow registration: <school>" |
Skipped when the setting is empty | As above |
| B16 | Subscription / add-on / SMS bundle payment confirmed | School email | Email only | SubscriptionPaymentProcessor -> SubscriptionInvoiceEmailService.TrySendAsync |
Immediate on PayFast confirmation | "Your DriveFlow invoice <n> (paid)" + PDF |
School email present | Server warning; Failed row; payment stays applied |
| B17 | SuperAdmin billing action raising an invoice | School email | Email only | SchoolSubscriptionAdminService -> TrySendAsync |
Immediate | "Your DriveFlow invoice <n>" + PDF |
School email present | As above |
| B18 | Subscription invoice sent from Settings > Billing | School email | Email only | BillingController POST invoices/{id}/send |
Immediate | As above | Subscription.Manage |
Error shown to user |
| B19 | Send Test Email | Typed address | Email only | EmailSettingsService.SendTestEmailAsync |
Immediate | "DriveFlow Test Email" | Email.Manage |
Error shown to user; not in the log |
| B20 | Document expiring within 30 days | Intended: uploader | Email only | DocumentExpiryJob -> ReminderService -> NotificationService |
Daily | "Document Expiry Reminder" | None | Not working: addressed to a user id, fails, marked as reminded, never retried |
Detail and content notes: Notification triggers.
5. Events that send nothing¶
No sending code exists for these events
No-show; instructor sign-off; a new lesson request or change request (bell only); lesson deletion; daily instructor schedule (setting exists, sender does not); driving test booked, changed, cancelled or result; learner's test events; leads and lead follow-ups (bell only); trial ending, subscription expiring or expired, add-on lapsing, low SMS credits; failed subscription payment; vehicle licence, roadworthy, insurance or service dates (bell only); fleet alerts (bell only); instructor earnings, sales commissions and payouts; refunds, deleted payments, voided invoices; guardians and emergency contacts; instructor reviews.
6. Schedules¶
Registered in DriveFlow.Infrastructure/Hangfire/HangfireJobRegistration.cs at API start-up.
| Job id | Cron | Class | Purpose |
|---|---|---|---|
lesson-reminders |
*/15 * * * * |
LessonReminderJob |
Lesson reminders |
driving-test-reminders |
*/15 * * * * |
DrivingTestReminderJob |
Driving test reminders |
document-expiry-reminders |
Daily 07:00 | DocumentExpiryJob |
Document expiry (not working) |
invoice-reminders |
Daily 08:00 | InvoiceReminderJob |
Mark invoices overdue; payment reminders |
subscription-expiry |
Hourly | SubscriptionExpiryJob |
Status change only; sends nothing |
meta-lead-requeue |
*/15 * * * * |
MetaLeadImportJob |
Lead import; sends nothing |
report-generation |
Daily 23:00 | ReportGenerationJob |
Reports; sends nothing |
Note
No time zone is passed, so the daily times are Hangfire's default, UTC.
6.1 Lesson reminders¶
| Rule | Value |
|---|---|
| Number per lesson | One |
| When | Start time minus "send before"; default 1,440 minutes (24 hours); school-wide setting, 15 minutes to 31 days |
| Granularity | 15-minute job, so up to 15 minutes late |
| Eligible lessons | Status Scheduled, not deleted, student not deleted, start within 31 days |
| Cancelled lessons | Excluded by status at every run |
| Duplicate guard | Lesson.ReminderSentFor = start time reminded for |
| Reschedule | New start time differs from ReminderSentFor, so a new reminder is sent |
| Booked inside the window | Skipped; the confirmation covers it |
| Quiet hours | Held; sent at the first run after the window if the lesson is still ahead |
| Clock | Server local time (DateTime.Now); the branch time provider is not used |
| On delivery failure | Still marked as reminded; no retry |
6.2 Driving test reminders¶
Same rules with status Booked, start = test date + time, guard DrivingTest.ReminderSentFor, own "send before" setting.
6.3 Payment reminders¶
| Rule | Default | Setting (Settings > Payments) |
|---|---|---|
| Marked Overdue | Day after due date | Grace period |
| Due-soon email | 3 days before, once | Send a "payment due soon" email (0 = off) |
| Overdue reminders | On | After the due date: On / Off |
| First overdue reminder | 1 day after due | First reminder |
| Repeat | Every 7 days | Repeat every (0 = once) |
| Maximum | 3 | Maximum reminders |
Guards: Invoice.DueSoonReminderSentOn, ReminderCount, LastReminderSentOn. Stops when paid or cancelled. Manual reminders count towards the maximum.
6.4 Reminders on the phone¶
The student mobile app schedules local reminders at 18:00 the evening before and one hour before, for the next 10 lessons, independently of the server. See the mobile application documentation.
6.5 Document expiry¶
DocumentExpiryJob selects documents expiring within 30 days and emails Document.UploadedBy, which holds a user id rather than an email address. The send fails, the document is still marked as reminded, and the log row has no company.
Warning
Treat document expiry reminders as not implemented.
Detail: Lesson reminders.
7. Settings¶
7.1 School: Settings > Notifications (Notifications.View / Notifications.Manage)¶
| Setting | Default | Effect |
|---|---|---|
| Email (channel) | On | Master switch for automatic emails |
| SMS (channel) | Off | Master switch; needs plan + credits |
| WhatsApp (channel) | Off | Master switch; needs plan + paid add-on |
| Student Welcome | Enabled, Email | |
| Lesson Booking Confirmation | Enabled, Email | |
| Lesson Reminder | Enabled, Email, 1,440 minutes before | |
| Driving Test Reminder | Enabled, Email, 1,440 minutes before | |
| Lesson Rescheduled | Enabled, Email | |
| Lesson Cancelled | Enabled, Email | |
| Lesson Request Declined | Enabled, Email | |
| Payment Received | Enabled, Email | |
| Payment Reminder | Enabled, Email | Timing from Payment Settings |
| Invoice Issued | Enabled, Email | Email only whatever is ticked |
| New Lesson Assigned (staff) | Enabled | On/off only on the web |
| Lesson Rescheduled (staff) | Enabled | |
| Lesson Cancelled (staff) | Enabled | |
| Daily Instructor Schedule | Disabled | No effect |
| Quiet Hours | Off | Urgent messages still sent; reminders held; Student Welcome and text payment reminders dropped |
7.2 School: other pages¶
| Page | Permission | Settings |
|---|---|---|
| Settings > Payments | Settings.View / Settings.Manage |
Payment reminder rules (section 6.3) |
| Settings > Email | Email.View / Email.Manage |
Use DriveFlow default email, or own SMTP: SMTP Host, Port, SMTP Username, SMTP Password, Use SSL / TLS, Sender Name, Sender Email; Send Test Email |
| Settings > Billing | Subscription.View / Subscription.Manage |
Buy SMS bundles; pay the WhatsApp add-on |
| Mobile app > Settings | On the phone | Push on/off for that phone; local lesson reminders on/off |
7.3 Platform (server configuration)¶
The platform email server, the Vodacom SMS and Meta WhatsApp accounts, the Firebase key for push, the public web address used in links, the operator alert address and the billing issuer details are set in the server configuration by DriveFlow. The setting names and values are kept in the internal technical documentation.
7.4 Not configurable¶
Lesson Completed; push per event; templates; per-person opt-out; per-branch settings; CC or reply-to; SMS sender name; WhatsApp number; more than one reminder per lesson.
Detail: Notification settings.
8. Templates¶
Fixed in NotificationContentFactory (engine messages) and in each email service (documents and account emails), all rendered through NotificationEmailTemplate. SMS, WhatsApp and push use the plain-text form of the same content; push is cut to 240 characters. English only. Subject lines and full wording: Notification templates.
Content gaps to know: booking, reschedule and cancellation messages do not show the instructor, vehicle or branch; instructor messages do not show the student's name; "Previous time" is never filled.
9. Notification log¶
- Page: Settings > System > Notification Log (
/settings/system), permissionNotifications.View. - Columns: Date, Channel, Recipient, Subject, Status (Sent / Failed / Pending). Filters: Status, Channel (Email, SMS, WhatsApp), search on recipient or subject. Click a row to see the message as sent and the error text.
- API:
GET api/notifications/log,GET api/notifications/log/{id}. - Not logged: user password emails, portal invites, password reset emails, test emails, anything skipped before sending, push for people without the app, phone-local reminders.
- No resend, export, delivery tracking or clean-up.
Detail: Notification log.
10. Troubleshooting summary¶
| Problem | Most likely causes | Look at | Fix |
|---|---|---|---|
| Email not delivered | Channel or message switched off; no address on the record; quiet hours (welcome only); own SMTP details wrong; port 465; spam | Notification Log; Settings > Notifications; Settings > Email | Switch on; add address; correct SMTP and Send Test Email; resend manually |
| SMS not sent | No credits; channel or tick off; plan; no or invalid phone number; provider disabled or refusing | Log error text; Settings > Billing | Buy a bundle; tick SMS; fix the number; platform checks VodacomSms |
| WhatsApp failing | 24-hour rule (no templates); add-on unpaid; token or configuration; provider disabled | Log error text; Settings > Billing | Use email/SMS; pay the add-on; platform checks MetaWhatsApp |
| Push not appearing | Firebase not configured; plan without Mobile App; user not signed in or push off on the phone; instructor not linked to a user; Android permission | Server log "Push notifications are off"; log rows | Configure Firebase and restart; sign in; allow notifications |
| Duplicates | Phone-local reminders on top of the server reminder; several channels ticked; reschedule after a reminder; double lessons | - | Switch off phone reminders or extra channels |
| Delays / wrong time | 15-minute job; quiet hours hold; server time zone differs from the branch; daily jobs in UTC | Server time zone | Run the server in the schools' time zone |
| Nothing scheduled runs | API stopped; job registration failed | Server log; background job monitoring (platform team) | Start the API; fix the database connection |
| Document expiry reminders missing | Not working in this version | - | Check dates manually |
Server log categories: NotificationDispatcher, LessonReminderJob, DrivingTestReminderJob, InvoiceReminderJob, InvoiceReminderService, InvoiceEmailService, TenantSmtpEmailService, VodacomSmsService, MetaWhatsAppService, FirebasePushSender.
Detail: Notification troubleshooting.
11. Known limitations¶
- No automatic retry and no outbox; messages are sent inside the request.
- No template editing; English only.
- Quiet hours drop Student Welcome and SMS/WhatsApp/push payment reminders instead of delaying them, although the settings page says they are delayed.
- Reminder and quiet-hour timing uses the server clock, not the branch time zone.
- Daily Instructor Schedule is a setting with no sender.
- Lesson Completed is not configurable.
- Invoice Issued ignores its SMS and WhatsApp ticks.
- WhatsApp sends free-form text only; Meta's 24-hour rule blocks most messages.
- A disabled SMS or WhatsApp provider is logged as Sent; SMS credits are still used.
- Document expiry reminders do not reach anyone.
- A failed lesson or test reminder is not retried.
- Lessons with status Confirmed are not reminded.
- The rescheduled-lesson message for instructors goes to the previous instructor when the instructor is changed.
- Walk-in payments produce no automatic receipt email.
- Account emails and test emails are not in the Notification Log.
- The log has no link back to the lesson, invoice or event, and no Push filter.
- No delivery, bounce or read tracking on any channel.
- No messages for trial or subscription expiry.
12. Source map¶
Where each part lives in the code (for developers)
| Area | Location |
|---|---|
| Dispatcher, channels, content, credits, push | DriveFlow.Infrastructure/Notifications/ |
| Interfaces and models | DriveFlow.Application/Interfaces/Services/INotification*.cs, DriveFlow.Application/Notifications/Models/ |
| Event list | DriveFlow.Domain/Enums/NotificationEvent.cs |
| Settings entities | DriveFlow.Domain/Entities/Notifications/ |
| Log entity | DriveFlow.Domain/Notifications/Notification.cs |
| Defaults and settings service | DriveFlow.Infrastructure/Services/NotificationDefaults.cs, NotificationSettingsService.cs, NotificationLogService.cs |
| Email services | DriveFlow.Infrastructure/Email/, DriveFlow.Infrastructure/Services/*EmailService.cs, InvoiceReminderService.cs, DriveFlow.Infrastructure/Identity/UserAccountEmail.cs |
| SMS / WhatsApp | DriveFlow.Infrastructure/Sms/, DriveFlow.Infrastructure/Meta/WhatsApp/, DriveFlow.Infrastructure/Messaging/PhoneNumberNormalizer.cs |
| Jobs and schedule | DriveFlow.Infrastructure/Jobs/, DriveFlow.Infrastructure/Hangfire/HangfireJobRegistration.cs |
| Registration of providers | DriveFlow.Api/Program.cs |
| API | NotificationsController, MobilePushController, EmailSettingsController, InvoicesController, PaymentsController, QuotesController, BillingController |
| Web pages | DriveFlow.Web/Features/Settings/Pages/Notifications.razor, SystemSettings.razor, Email.razor, Payments.razor; DriveFlow.Web/Components/Layout/AppHeader.razor |
| Mobile | DriveFlow.Mobile/Services/Push/, DriveFlow.Mobile/Services/Student/LessonReminderService.cs, DriveFlow.Mobile/Components/Pages/SettingsNotifications.razor |
| Tests | DriveFlow.Tests/Notifications/, DriveFlow.Tests/Invoices/InvoiceReminderServiceTests.cs, DriveFlow.IntegrationTests/Notifications/ |