Waybill

logistics · Last updated Apr 29, 2026

All notable changes to this app are recorded here. Newest entries on top.

Initial scaffold. A logistics marketplace where senders pick a verified driver at a Nigerian motor park, enter the recipient's details, and pay in the app. The recipient gets a no-login link to track the package as the driver updates the status.
Vehicle types covered: bus, trailer, van, truck — pick the right one for the load.
Driver verification: pending → verified → rejected. Senders can only book verified, active drivers.
Status flow: Assigned → Picked Up → On the Way → Almost There → Delivered (plus Cancelled). Each update is timestamped and goes into the recipient's tracking page.
Public tracking link: /p/{senderUuid}/waybill/track?token=... — no login needed; the share token in the URL is the secret. Recipients see the driver's name, phone, plate, vehicle, current status, and any location note.
Public driver profile at /p/{...}/waybill/driver?id=... so park admins can share verified driver listings.
Sender ratings (1–5 stars) per delivered waybill so future senders can pick well.

Shared-DB app (shared_database: true). One DB at data/shared/waybill.db with members(pancho_user_id PK, role, status) as the workspace gate.
Four roles: admin, park_admin (manages a park's drivers), driver, sender (default for new installs).
lib/payments.php introduces a Paystack split-payment helper pattern not present in any other app — wb_create_paystack_split_transaction(), wb_verify_paystack_payment(), wb_create_paystack_subaccount(). At Tier B these return { error: 'not configured' } so the UI surfaces the gap. Tier C will POST to /transaction/initialize with a split object and /subaccount for driver onboarding.
Graceful degradation: a verified driver without a paystack_subaccount_code can still be booked — gross goes 100% to the platform and the admin sees a warning to settle manually. Tighten in Tier C.
New audit table paystack_split_log for troubleshooting failed splits without polluting audit_log.