App Methodology & Technical Functionality

Sthe Courier

App Methodology and Technical Functionality Document

Trainer & Knowledge Base Guide

Sthe Courier

Delivery Logistics Management Platform

Version 1.0  |  July 2026

Document Classification: Internal, Training & Reference

Compiled by: Mr. Bandile Mathebula

Technical and IT Manager

Table of Contents

1Platform Overview
2System Architecture & Technology Stack
3User Roles & Access Control
4Delivery Management
5Pricing & Billing Configuration
6Customer Management
7Driver Management
8Driver App & QR/Barcode Scanner
9Warehouse Management
10Dispatch Dashboard
11Billing & Financial Management
12Accounting & Payroll
13Staff Management
14Customer Portal
15Content Management
16Notifications & Communication
17Analytics & Reporting
18Document Generation
19Security & Compliance
20Contact & Support

About This Document

This is your go-to guide for the Sthe Courier platform. Whether you're onboarding new staff, training drivers, or just need a quick refresher on how something works, this document has you covered. It's written for admins, managers, ops staff, finance teams, and anyone else who needs to get stuck into the system.

We've broken everything down module by module so you can jump straight to what you need. Each section explains what the module does, the key features, and how things work day to day. No fluff, just the stuff you actually need to know.

How to use this document: Trainers, use this as your main reference when bringing new people on board. Each section works as a standalone training module, so you can pick and choose what's relevant. The tables are designed for quick lookup when you're in the middle of something and just need an answer fast.

1. Platform Overview

Sthe Courier is a cloud-based platform that handles the entire delivery process from start to finish. Booking, tracking, dispatch, driver app, billing, the lot. It brings three groups of people together in one place: customers who book and track their parcels, ops staff who keep things moving, and drivers out on the road doing the actual deliveries.

It runs on modern web tech, works on both desktop and mobile, and gives you real-time tracking, automatic pricing, QR and barcode scanning, warehouse management, billing, and proper reporting. Drivers get their own mobile app so they can manage everything from their phone while out on the road.

Core Capabilities

  • Full delivery booking, tracking, and status management from start to finish
  • Smart pricing engine with configurable rates, fuel surcharges, and custom pricing per client
  • Driver app with QR and barcode scanning for pickup, warehouse receipt, and delivery confirmation
  • Warehouse management with bin and shelf tracking so nothing goes missing
  • Account billing with credit limits, transactions, statements, and monthly invoicing
  • Customer self-service portal for booking, tracking, and wallet management
  • Proper document generation: waybills, invoices, quotes, statements, and payslips
  • Role-based access control with row-level security across all data
  • Real-time notifications through in-app alerts, email, and WhatsApp

2. System Architecture & Technology Stack

Technology Stack

LayerTechnologyWhat it does
FrontendReact + Vite + Tailwind CSSThe app itself, responsive and component-based
UI Componentsshadcn/ui + Radix UIClean, consistent interface building blocks
IconsLucide ReactAll the icons you see throughout the app
State ManagementTanStack React QueryHandles data fetching, caching, and live updates
ChartsRechartsDashboards and data visualisation
MapsReact-LeafletDispatch map view and live driver tracking
Scanninghtml5-qrcodeQR and barcode scanning through the phone camera
PDF GenerationjsPDF + html2canvasCreates PDF documents right in the browser
Barcode/QRjsbarcode + qrcode.reactGenerates barcodes and QR codes for waybills
BackendBase44 BaaSHandles auth, database, integrations, and hosting
PaymentsPaystack + StripeOnline payments and wallet top-ups

Data Model Overview

The platform's data is split across more than 25 entities, each one representing a core business object. Here are the main ones you'll come across:

EntityWhat it holds
DeliveryThe core delivery record with tracking, waybill, route, pricing, and status
PricingConfigStandard rate schedule per route, including base price, surcharges, and multipliers
CustomerPricingCustom pricing overrides for specific customers on specific routes
AccountBillingCustomer account with credit limit, balance, and custom pricing overrides
AccountTransactionIndividual charges and payments on a customer account
Wallet / WalletTransactionPrepaid wallet balance and full transaction history
DriverProfileDriver registration, vehicle details, and approval status
WarehouseItemParcel tracking inside the warehouse, including bin assignment
InvoiceInvoices and quotes with line items and VAT
CustomerProfileCustomer business details, VAT number, and billing address
StaffProfileStaff member details, department, and access level
PayslipEmployee payroll with UIF, PAYE, allowances, and deductions
AppNotificationIn-app notification messages

3. User Roles & Access Control

The platform uses role-based access control (RBAC) with row-level security (RLS) that's enforced at the database level. Every user gets a role, and that role decides what they can see, create, edit, or delete.

RoleAccess LevelWhat they can do
AdminFull AccessEverything, across all modules. User management, system config, driver creation and approval, the works.
ManagerHighOperations management, delivery bookings, pricing config, dispatch, driver management, staff approvals.
ExecutiveHigh (Read)Read access across everything, dashboards, financial reporting, content management.
FinanceMediumAccount billing, invoices and quotes, expenses, wallet management, transactions.
HRMediumStaff profiles, timesheets, payslip generation, staff approvals.
StaffStandardDelivery bookings, lodge entries, warehouse management, delivery operations.
DriverLimitedDriver app access, their assigned deliveries, QR/barcode scanning, GPS tracking, status updates.
CustomerSelf-ServiceBook deliveries, track parcels, manage wallet, view statements and invoices, update profile.
Row-Level Security: Customers can only see and manage their own deliveries, invoices, wallet, and profile. Drivers only see deliveries assigned to them. Staff and above get broader access depending on their role. RLS policies run on the server side, so even if someone tries to bypass the frontend, the data stays locked down.

4. Delivery Management

This is the heart of the platform. The Delivery Management module is where you book new deliveries, lodge historical entries, manage waybill numbers, track delivery status, and edit bookings after they've been created.

4.1 Booking New Deliveries

Staff and managers can book new deliveries through the Admin Book Delivery screen. Here's what the booking process covers:

  • Customer Selection: Pick from existing customers (pulled from billing accounts, registered users, and customer profiles) or type in details manually for walk-in customers
  • Route Configuration: Choose pickup and delivery locations from supported cities, or enter addresses manually
  • Package Details: Enter the package description, weight, and dimensions
  • Service Type: Pick from Express, Standard, Scheduled, or Overnight
  • Waybill Number: Enter the customer's waybill number so it links to the booking
  • Pricing: Price gets calculated automatically by the pricing engine, with an option to override the base price manually if needed
  • Scheduling: Set scheduled pickup and estimated delivery dates
Admin Book Delivery โ€” New Booking Form
New BookingLodge PastBrowse
Customer
Acme Logistics (Pty) Ltd
Waybill Number
WB-2026-0451
Pickup Location
Johannesburg
Delivery Location
Cape Town
Package Weight (kg)
15.5
Service Type
Express (1.8x)
Total Price (incl. VAT & Fuel Surcharge):R 482.30
Book Delivery

Figure 4.1: The booking form where staff select a customer, configure the route, enter package details, and the price calculates automatically.

4.2 Lodge Past Entries

Sometimes deliveries happen before they're captured in the system. The Lodge Past Entries feature lets staff record those after the fact. You can do it one at a time through a form, or bulk import via CSV if you've got a stack of historical data. Lodge entries work the same way as new bookings, with customer selection (including manual entry), waybill numbers, and automatic pricing.

4.3 Waybill & Tracking Numbers

Every delivery has two key reference numbers:

FieldWhat it is
Tracking NumberA unique ID the system generates (like ST12345678). This is what customers use to track their parcels and what the scanner reads.
Waybill NumberThe customer's own reference number linked to the booking. Also scannable via QR or barcode.

4.4 Delivery Status Workflow

StatusWhat it meansHow it gets triggered
PendingBooking created, waiting for confirmationNew booking
ConfirmedBooking confirmed and scheduledStaff confirms it
Picked UpParcel collected from senderDriver scans (Pick-Up) or manual update
In TransitParcel en route or sitting at the warehouseDriver scans (Warehouse) or manual update
Out for DeliveryFinal delivery attempt underwayDriver or dispatch updates it
DeliveredSuccessfully delivered to the recipientDriver scans (Delivery) with proof photo
CancelledDelivery cancelledStaff or admin cancels it

Every status change gets logged in the delivery's status_history with the timestamp, new status, and any notes or proof photos. So you've always got a full paper trail of where the parcel's been and when.

4.5 Post-Booking Editing

Once a delivery is booked and confirmed, staff can still go back and edit the package weight. The system recalculates all the surcharges on the spot based on the new weight, so the pricing stays accurate even if the actual weight turns out different from what was first captured.

4.6 Manual Base Price Override

Staff can manually override the base charge on a booking without messing with the other surcharge calculations (fuel, VAT, per-kg, service multipliers). Handy for negotiated rates or special cases where the standard pricing doesn't quite fit, but you still want everything else to calculate normally.

5. Pricing & Billing Configuration

The Pricing Management module is a flexible, multi-layered pricing engine that works out delivery costs based on route, distance, weight, service type, and customer-specific agreements. Pricing gets pulled from three tiers, checked in this order of priority:

  1. Manual Override: A staff-entered base price on the booking form (highest priority, trumps everything)
  2. Customer-Specific Pricing: Custom rates per customer per route (CustomerPricing entity)
  3. Account-Level Overrides: Custom base price, per-kg rate, or fuel surcharge on the customer's billing account (AccountBilling entity)
  4. Standard Rate Schedule: The default route pricing (PricingConfig entity, lowest priority)

5.1 Standard Rate Schedule

The standard rate schedule sets the default pricing for each route (city to city). Each route config includes:

ParameterDefault ValueWhat it means
Base PriceR180.00The flat base charge per delivery
Free Weight Cap10 kgFirst 10 kg is included in the base charge
Price per kg (above cap)R2.00 / kgEvery kg over the free cap costs extra
Fuel Surcharge38%Added on top of the subtotal (base + weight charge)
VAT15%Added on top of the total (subtotal + fuel surcharge)

5.2 Service Type Multipliers

Service TypeMultiplierWhat it means
Standard1.0x (no multiplier)Your standard delivery service
Scheduled1.2xPre-scheduled delivery
Express1.8xPriority express delivery
Overnight2.2xOvernight express delivery

5.3 Price Calculation Formula

Here's how the total delivery price gets worked out, step by step:

Step 1: Weight Charge = Base Price + (max(0, Weight - Free Cap) x Price per kg)
Step 2: Apply Service Multiplier: Subtotal = Weight Charge x Service Multiplier
Step 3: Fuel Surcharge = Subtotal x Fuel Surcharge Rate
Step 4: Pre-VAT Total = Subtotal + Fuel Surcharge
Step 5: VAT = Pre-VAT Total x VAT Rate
Step 6: Total Price = Pre-VAT Total + VAT

If the customer has a specific discount or markup, it gets applied at Step 1 before the multiplier kicks in.

5.4 Custom Pricing

You can set up custom pricing at two levels:

  • Customer-Specific Route Pricing: Individual base price, per-kg rate, fuel surcharge, markup, and discount per customer per route
  • Account-Level Overrides: Custom base price, per-kg rate, fuel surcharge, and discount percentage that apply to all deliveries on a billing account

5.5 Price Calculator

The Pricing Management module has a built-in Price Calculator that works out shipment costs in real-time based on route, service type, and weight. It pulls rates straight from the Standard Rate Schedule and any applicable custom pricing, so the price you see in the calculator is exactly what you'll get on the actual booking.

Pricing Management โ€” Price Calculator
Route
Johannesburg โ†’ Durban
Service Type
Standard
Weight (kg)
12.0
Distance (km)
568 km
Base Price (incl. 10kg free)R 180.00
Weight Charge (2kg ร— R2.00)R 4.00
Fuel Surcharge (38%)R 69.92
VAT (15%)R 38.09
Total PriceR 292.01

Figure 5.1: The Price Calculator showing a live cost breakdown for a Johannesburg to Durban shipment, including base price, weight charge, fuel surcharge, and VAT.

6. Customer Management

The Customer Management module is where you manage customer profiles, onboarding, documentation, delivery preferences, and recurring delivery schedules. Every customer is linked to the platform through their registered email address.

6.1 Customer Profiles

Each customer has a profile record with their business details: company name, registration number, VAT number, tax number, billing address, contact person, and industry. The preferred name field controls how the customer's name shows up on documents and statements.

6.2 Customer Onboarding

New customers go through an onboarding process that captures their business or individual details, billing info, and whatever compliance documents are needed. The onboarding status gets tracked so you can see who's completed everything and who still has outstanding items.

6.3 Document Management

Customers can upload compliance documents like ID documents, proof of address, company registration certificates, VAT certificates, tax clearance, bank statements, and signed agreements. Each document gets a review status (pending, approved, rejected) with a reason if it's rejected.

6.4 Delivery Preferences

Customers can set up delivery preferences like preferred pickup and delivery time windows, special instructions, and default recipient details. These preferences auto-populate when booking, so regular customers don't have to type the same stuff every time.

6.5 Recurring Deliveries

Customers who send parcels regularly can set up recurring delivery schedules. The system stores the recurring config (route, package details, frequency) and can generate individual delivery bookings off the back of it.

6.6 Sub-Accounts

Business customers can manage sub-accounts, which means multiple users or departments within a company can book deliveries under one billing account. Good for companies with multiple branches or departments that all share a central billing function.

7. Driver Management

The Driver Management module is where you register, approve, and keep an eye on drivers. Drivers are managed through DriverProfile records that capture their personal details, license info, vehicle details, and banking info for payments.

7.1 Driver Registration & Approval

Drivers can sign themselves up through the Driver App onboarding flow, or admins can add them manually. Either way, all driver registrations need to be approved before the driver can use the Driver App and start getting delivery assignments.

Approval StatusWhat it means
PendingWaiting for admin review, can't access the Driver App yet
ApprovedActive driver, can use the Driver App and get assignments
RejectedRegistration rejected, no access to the platform

7.2 Manual Driver Creation

Admins can add drivers manually from the Drivers Management page. The Add Driver form captures the driver's full name, email, phone, ID number, license details (number, code, expiry), and vehicle details (type, make, model, year, registration, colour). Manually added drivers are created as Approved and Active straight away, so they're ready for assignment immediately.

7.3 Driver Information Captured

CategoryFields
PersonalFull name, email, phone, ID number, profile photo
LicenseLicense number, code (B, C, C1, EC, EC1), expiry date, license photo
VehicleType (bike, car, van, truck), make, model, year, registration, colour
BankingBank name, account number, branch code (for driver payments)
EmergencyEmergency contact name and phone number

7.4 Delivery Assignment

Deliveries get assigned to drivers by storing the driver's name in the delivery's assigned_driver field. The Driver App filters deliveries so drivers only see the ones assigned to them. Approved drivers show up in the assignment dropdowns on the booking and dispatch screens.

8. Driver App & QR/Barcode Scanner

The Driver App is the mobile-first interface drivers use out in the field. It gives them access to their assigned deliveries, the QR/barcode scanner for status updates, GPS tracking, check-in and check-out, route optimisation, scheduling, analytics, and chat with dispatch.

8.1 QR/Barcode Scanner

The scanner uses the phone's camera to read QR codes and barcodes printed on parcel waybills. There are three scan types, and each one updates different fields and records:

Scan TypeDelivery StatusWhat else happens
Pick-UpStatus changes to Picked UpLogged in status history, customer gets an email
Received at WarehouseStatus changes to In TransitWarehouse item updated to "In Warehouse" with arrival date, customer gets an email
DeliveryStatus changes to DeliveredActual delivery date set, logged in status history, customer gets an email

The scanner matches the barcode value against both the tracking number and the waybill number, so parcels can be scanned using either reference. After a successful scan, the system automatically refreshes all the related data across the platform, including dispatch dashboards, delivery lists, and warehouse records.

How the scanner works: Pick a scan type, start the camera, point it at the QR code or barcode on the waybill, the system finds the matching delivery, updates the status and related records, shows you a confirmation screen with the delivery details, then you're ready to scan the next one.
Driver App โ€” QR/Barcode Scanner
What are you scanning?
๐Ÿ“ฆ
Pick-Up
๐Ÿญ
Warehouse
โœ…
Delivery
๐Ÿ“ท
Point at QR / barcode...
โœ“
All Done!
Picked Up confirmed
Tracking: ST12345678
Route: JHB โ†’ CPT
๐Ÿ“ธ Snap Proof Photo

Figure 8.1: The scanner screen (left) with the three scan type buttons and camera viewfinder, and the confirmation screen (right) shown after a successful Pick-Up scan, including the option to snap a proof photo.

8.2 GPS Tracking

The Driver App picks up the driver's GPS location and updates it on the regular. The location data sits on the DriverProfile and shows up on the Dispatch Dashboard's map, so dispatch can see where all their drivers are in real-time.

8.3 Check-In / Check-Out

Drivers can clock in and out of their shifts through the Driver App. Each clock-in/out creates a Timesheet entry with the clock-in time, clock-out time, total hours worked, and break duration. This feeds straight into payroll and payslip generation.

8.4 Route Optimisation

The Route AI feature suggests an optimised delivery sequence for the driver's active deliveries, cutting down travel distance and time. Drivers can check the suggested route and navigate to each stop through Google Maps.

8.5 Schedule & Analytics

The Schedule tab shows upcoming and scheduled deliveries. The Analytics tab gives drivers their performance numbers: total deliveries, completed count, active count, cancellation rate, and success rate. Handy for drivers and managers to track how things are going over time.

8.6 Driver Chat

Drivers can chat with dispatch through the in-app chat panel. Messages are stored as Message entities and update in real-time, so drivers and dispatchers stay in touch while out on the road.

9. Warehouse Management

The Warehouse Management module tracks parcels inside the warehouse from the moment they arrive to when they get dispatched. Each parcel is recorded as a WarehouseItem linked to its delivery via tracking number and delivery ID.

Warehouse Management โ€” Item List
Tracking #CustomerBinStatus
ST12345671Acme LogisticsA-12In Warehouse
ST12345672Bolt ExpressB-04Ready for Dispatch
ST12345673Metro Freightโ€”Incoming
ST12345674Acme LogisticsC-09Dispatched

Figure 9.1: The warehouse items table showing tracking numbers, customer names, assigned bin locations, and colour-coded status badges for each parcel.

9.1 Warehouse Item Status Workflow

StatusWhat it means
IncomingParcel is expected at the warehouse but hasn't arrived yet
In WarehouseParcel is physically there and stored
Ready for DispatchParcel is prepped and queued for outgoing dispatch
DispatchedParcel has left the warehouse and is on its way

9.2 Bin/Shelf Assignment

Each warehouse item can be assigned to a specific bin or shelf location (the bin_number field), so staff can find parcels quickly when it's time to dispatch them. The system tracks arrival and dispatch dates for each item.

9.3 Warehouse Alerts

The system can send alerts when parcels have been sitting in the warehouse past a certain threshold, so staff know to prioritise dispatch and nothing gets forgotten about.

10. Dispatch Dashboard

The Dispatch Dashboard gives you a real-time view of all active deliveries and where your drivers are. Here's what you get:

  • Map View: Interactive map showing delivery locations and live driver GPS positions
  • Delivery Assignment: Assign or reassign deliveries to available drivers
  • Status Overview: Real-time view of all delivery statuses across the operation
  • Driver Status: Keep an eye on who's available, who's on delivery, and who's off duty
Dispatch Dashboard โ€” Map View & Active Deliveries
๐Ÿ“
๐Ÿ“
๐Ÿšš
๐Ÿšš
Live Driver Tracking
Active Deliveries
ST12345671
JHBโ†’CPT
In Transit
ST12345672
JHBโ†’DBN
Out for Delivery
ST12345673
DBNโ†’CPT
Picked Up

Figure 10.1: The dispatch dashboard with an interactive map showing delivery location pins and live driver positions, alongside a sidebar listing active deliveries with their current statuses.

11. Billing & Financial Management

The Billing module looks after customer account billing, transactions, wallets, invoices, quotes, and statements. It handles both prepaid wallet payments and post-paid account billing with credit limits.

11.1 Account Billing

Each customer can have an AccountBilling record that sets up their billing config:

FieldWhat it means
Account NumberAuto-generated ID (like STC-00123)
Account StatusActive, Suspended, or Closed
Pricing PlanStandard, Business, Enterprise, or Custom
Credit LimitThe max outstanding balance allowed (default: R5,000)
Current BalanceWhat's currently outstanding and unpaid
Payment Terms7, 14, 30, or 60 days
Billing Cycle DayDay of the month invoices get generated (default: 25th)
Custom PricingPer-account base price, per-kg rate, fuel surcharge, and discount overrides
Account Billing โ€” Customer Accounts
Acme Logistics
STC-00123 ยท Enterprise
Balance:R 2,450.00
Limit:R 10,000.00
Bolt Express
STC-00124 ยท Business
Balance:R 0.00
Terms:30 days

Figure 11.1: Account billing cards showing each customer's account number, pricing plan, current outstanding balance, credit limit, and payment terms.

11.2 Account Transactions

Every delivery charge and payment on an account gets recorded as an AccountTransaction. Transactions have types (delivery charge, payment, credit, adjustment) and statuses (pending, invoiced, paid). When monthly invoices get generated, pending transactions get marked as invoiced and linked to the invoice.

11.3 Wallet System

Customers can keep a prepaid wallet balance. Top-ups go through Paystack or Stripe. Delivery charges can be deducted from the wallet, and each deduction gets recorded as a WalletTransaction. The wallet tracks total topped up, total spent, and current balance.

11.4 Invoices & Quotes

The platform generates proper invoices and quotes with line items, quantities, unit prices, VAT, discounts, and totals. Each invoice or quote includes client details, banking details, payment terms, and tracking/waybill references when linked to a delivery. Invoices move through statuses: draft, sent, paid (or overdue if it slips past the due date).

11.5 Customer Statements

Customer statements summarise account activity over a billing period: opening balance, all transactions (charges and payments), and closing balance. Statements can be generated for individual customers, or customers can view their own in the portal.

11.6 Monthly Invoice Generation

The platform can automatically generate monthly invoices. On the configured billing cycle day, it collects all pending account transactions for each customer, creates an invoice, and marks the transactions as invoiced. You can trigger this manually or set it up to run on a schedule.

12. Accounting & Payroll

The Accounting module is where you manage business expenses, employee payroll, and financial reporting. It ties into the billing and staff management modules so you get one unified view of the finances.

12.1 Expense Management

Expenses get recorded with a category, amount, VAT, date, supplier, and receipt attachment. Categories cover fuel, vehicle maintenance, salaries, office, insurance, marketing, utilities, driver payments, warehouse, and other. Expenses go through an approval workflow: pending, then approved or rejected.

FieldWhat it means
CategoryFuel, Vehicle Maintenance, Salaries, Office, Insurance, Marketing, Utilities, Driver Payments, Warehouse, Other
VATVAT amount calculated at 15% (you can adjust the rate per expense)
ReceiptUploaded receipt image for audit purposes
StatusPending, Approved, or Rejected

12.2 Payslip Generation

The Payslip Generator puts together proper payslips for employees and drivers. Each payslip includes:

  • Basic salary and pay period
  • Multiple allowances (each with a description and amount)
  • Multiple deductions (each with a description and amount)
  • UIF employee contribution (1%) and UIF employer contribution (1%)
  • PAYE (Pay As You Earn) tax deduction
  • Gross pay, total deductions, and net pay calculations
  • Banking details for the employee

Payslips move through statuses: draft, issued, paid. The generator pulls from the employee's StaffProfile or DriverProfile to fill in personal and banking details automatically.

Payslip Generator โ€” Sample Payslip
STHE COURIERPayslip ยท June 2026
Bandile Mathebula
Driver ยท EMP-0042
Earnings
Deductions
NET PAYR 8,340.00

Figure 12.1: A generated payslip showing the employee's earnings (basic salary and allowances) alongside deductions (PAYE and UIF), with the net pay calculated at the bottom.

12.3 Financial Dashboard

The Financial Dashboard gives you a bird's eye view of the business's financial health: revenue, expenses, outstanding balances, and profitability. It pulls data from deliveries, invoices, expenses, and account transactions all in one place.

13. Staff Management

The Staff Management module looks after internal staff profiles, timesheets, departmental structure, and task assignment. Staff members are linked to the platform through their registered email and assigned a department and role.

13.1 Staff Profiles

Each staff member has a StaffProfile record with:

FieldWhat it means
DepartmentAdmin, Marketing, Operations, HR, Finance, or Executive
Staff RoleStaff, Team Lead, Manager, Department Head, Executive, or Admin
Access LevelRead Only, Standard, or Full Access
Approval StatusPending, Approved, Rejected, or Suspended
Employee IDInternal employee identifier
Start DateWhen they started working

13.2 Timesheets

Staff clock in and out through the platform. Each session creates a Timesheet record with the date, clock-in time, clock-out time, hours worked, and break duration. Timesheet data feeds into payroll and payslip generation.

13.3 Departments

The platform supports six departments, each with its own dashboard and task management:

  • Admin: System administration and user management
  • Marketing: Marketing campaigns and content
  • Operations: Delivery operations, dispatch, and warehouse
  • HR: Human resources, staff management, and payroll
  • Finance: Billing, invoicing, expenses, and accounting
  • Executive: Strategic oversight and reporting

13.4 Task Management

Tasks can be assigned to staff members with priority levels (low, medium, high, urgent), due dates, and statuses (pending, in progress, review, completed, cancelled). Tasks are department-scoped and visible to the person assigned, the person who assigned it, and management.

14. Customer Portal

The Customer Portal is the self-service interface where customers can book deliveries, track parcels, manage their wallet, view billing statements, send messages, and manage their account settings.

FeatureWhat it does
New DeliveryBook a new delivery with automatic pricing
Track DeliveryReal-time tracking by tracking number or waybill number
WalletCheck balance, top up via Paystack or Stripe, see transaction history
BillingView invoices, quotes, and account statements
MessagesChat with Sthe Courier support staff
Account SettingsUpdate profile, business details, and delivery preferences
Recurring DeliveriesSet up and manage recurring delivery schedules
Customer Portal โ€” Self-Service Dashboard
Sthe CourierCustomer Portal
๐Ÿ“ฆ
New Delivery
๐Ÿ”
Track Parcel
๐Ÿ’ณ
Wallet
๐Ÿ“„
Invoices
๐Ÿ’ฌ
Messages
โš™๏ธ
Settings
Wallet Balance:R 1,250.00

Figure 14.1: The customer portal home screen where customers can book new deliveries, track parcels, manage their wallet, view invoices, send messages, and update account settings.

15. Content Management

The Content Management module lets admins edit the text, images, and button labels on the public-facing website pages (Home, About, Services, Contact). Content is stored as ContentBlock entities, each identified by a unique section key. You can edit text, swap images, add videos, change button labels, and update URLs.

Changes made through the Content Management screen show up on the website straight away, so non-technical staff can update marketing content without needing a developer.

16. Notifications & Communication

The platform keeps customers and staff in the loop through a few different channels:

ChannelHow it works
In-App NotificationsReal-time notifications in the portal, shown in the notification bell. Types: delivery update, payment, wallet, system, alert.
EmailAutomatic emails for delivery status updates, booking confirmations, and billing comms. Sent from admin@sthecourier.co.za and billing@sthecourier.co.za.
WhatsAppWhatsApp notifications for delivery updates and customer comms (via backend function integration).

Delivery status update emails include the tracking number, new status, and any notes or proof-of-delivery photos. Customer notifications fire off automatically when delivery statuses change, whether that's a staff member updating it manually or a driver scanning a barcode out in the field.

17. Analytics & Reporting

The platform has proper analytics dashboards for keeping tabs on operational and financial performance:

  • Delivery Analytics: Total deliveries, completion rates, average delivery times, cancellation rates
  • Driver Performance: Per-driver delivery counts, completion rates, and active assignments
  • Financial Reports: Revenue, expenses, outstanding balances, and profitability
  • Operational Metrics: Warehouse throughput, dispatch efficiency, and route performance
  • Customer Insights: Top customers, delivery frequency, and account health

18. Document Generation

The platform generates professional, branded PDF documents for all the operational and financial workflows. Everything comes out branded as Sthe Courier with consistent formatting and layout.

DocumentWhat it's forWhat's on it
WaybillParcel tracking documentTracking number, waybill number, QR/barcode, route, package details, pricing
InvoiceBilling documentLine items, VAT, discounts, totals, banking details, payment terms
QuotePrice quotationSame structure as invoice but with quote status
StatementAccount statementOpening balance, transactions, closing balance, billing period
PayslipEmployee payrollGross pay, deductions, UIF, PAYE, net pay, banking details

All PDFs include the Sthe Courier logo, company contact details, and professional formatting. Banking details are laid out on individual lines with bank name, account number, branch code, and account type. Documents can be downloaded straight from the platform or emailed to customers.

19. Security & Compliance

19.1 Row-Level Security (RLS)

The platform uses row-level security across all critical entities. RLS policies are enforced at the database level, so users can only get to data they're actually allowed to see. Here are the key principles:

  • Customers can only see and manage their own deliveries, invoices, wallet, and profile
  • Drivers only see deliveries assigned to them and their own profile
  • Staff access is scoped by role (admin, manager, executive, finance, hr, staff)
  • Create, read, update, and delete operations are individually controlled per entity
  • RLS policies use both data-level conditions (like customer_email matching the user's email) and role-based conditions

19.2 Authentication

User authentication is handled by the Base44 platform, which looks after secure sessions, token-based auth, and email verification. Users join the platform through admin invitations and get assigned the right role for their job.

19.3 POPIA & Privacy Compliance

The platform includes a POPIA (Protection of Personal Information Act) compliance page, Terms of Service, and Privacy Policy. These spell out how customer and staff personal information gets collected, used, and protected, in line with South African data protection regulations.

19.4 Data Protection

Sensitive documents (IDs, licenses, bank statements) are stored securely and access-controlled. Document uploads by customers get reviewed and approved by admins before being accepted. All data is transmitted over encrypted connections.

20. Contact & Support

DepartmentEmail
General Administrationadmin@sthecourier.co.za
Billing & Accountsbilling@sthecourier.co.za

For platform support, technical help, or account-related queries, drop a line to the right department above. For urgent operational issues, get hold of your assigned Sthe Courier account manager or dispatch team directly.

Sthe Courier, Delivery Logistics Management Platform
Methodology & Technical Functionality Document, Version 1.0, July 2026
This document is classified as Internal, Training & Reference. Distribution restricted to authorised personnel.

base44
Edit with Base44