An custom-built logistics database, secure versioned API, and high-contrast mobile worker application designed to automate supermarket collections, track outreach operations, and safeguard volunteers on the road.
The secure, version-controlled central API and database synchronization engine built directly into the WordPress plugin core.
Operating inside the central plugin engine, the System Management module exposes private, encrypted REST API endpoints (/zero-hunger/v1) to keep volunteer devices and local administrator consoles fully synchronized. It guarantees high availability and database integrity.
Verifies requests using the cryptographically secure X-WP-Nonce header. Fallback WordPress role checks restrict endpoints to administrative capability codes (manage_options), preventing horizontal privilege escalations. Client portals run a real-time polling scheduler (every 10 seconds) to detect and sync database shifts.
Performs pre-flight file checks on updates (ZIP packages or URL packages) before server-side extraction. The system parses zero-hunger-plugin.php metadata to verify Semantic Versioning (MAJOR.MINOR.PATCH) compatibility, audits directories for write access, and structures files using Unix forward slashes (/) to prevent Windows backslash encoding from breaking Linux deployments.
Takes automated database pre-update snapshots of the zerohunger_db settings, supports manual snapshots with custom annotations, and records timeline tables (timestamp, versions, author, status). It allows point-in-time database rollbacks with a single click, and provides admin panels to download or upload JSON backup files to clone system states instantly.
Automates schema updates with safe database merging rules (zh_migrate_database) that preserve existing logs. Seeds new attributes (emergency details, Outreach client counts, comments, store start dates) with safe defaults. Forces browser refreshes to prevent outdated asset execution by appending the software version constant (ZH_VERSION) to all static CSS/JS enqueues.
Performs automated maintenance when a volunteer profile is deleted, pruning orphaned shift assignments and deleting calendar references. This safe deletion cascade preserves historical collection logs intact for accurate annual reports.
Admin panel displaying semantic update packages, pre-flight audits, and point-in-time SQL snapshot logs.
The centralized ERP console where managers oversee retail store directories, schedule collections, allocate volunteers, track outreaches, and generate reports.
High-level KPI widgets tracking Total Stores, Collection Shifts, Outreach Events, Volunteers, and Assignments. Features a dynamic conic-gradient progress ring showing volunteer shift targets.
KPI ModulesSearchable partner directory. The Store Profile Editor manages Contact names, start dates, and logistical bay comments. The Weekly Shift Scheduler schedules pickups and generates unique event IDs.
LogisticsCombines volunteer directories on the left and weekly collections checklist on the right for drag-and-drop allocation. Supports multi-assignee shifts and designates "Lead" labels.
SchedulerSearchable venue directory. Sets complex recurring event rules (weekly, monthly like 1st/3rd Thursdays, and one-offs) and links volunteer teams with designated Supervisor star badges.
OutreachSearchable profiles tracking join dates, logins, and mandatory emergency contacts. Safe Deletion cascade removes volunteers from active schedules without corrupting historical logs.
ProfilesGenerates Daily Collection print reports, Volunteer metrics, and Store logs. The Completions Audit database includes column sorting, date-range filters, and CSV spreadsheet exports.
Reporting
Monitors active supermarket pickup schedules, driver location status, and database metrics.
Features a searchable volunteer roster alongside a calendar checklist to link drivers to supermarket collection runs.
| Store Name | Time | Assigned Volunteer | Status | Notes |
|---|---|---|---|---|
| M&S Foodhall Hook | 18:30 | Richard M. Lead | Completed | 12 crates bread logged. |
| Lidl Alton | 19:00 | Sarah K. | Active | In transit to store. |
Stores personal info, portal credentials configuration, and mandatory emergency contacts. Integrates a safe deletion cascade.
Pruning a volunteer profile will automatically wipe future assignments. All historical completions and tonnage audit records are protected and remain locked in the database.
Aggregates collected quantities, tracks venue outreach totals, and provides interactive columns sorting and CSV exports.
The dedicated mobile client environment designed for drivers to navigate routes, manage co-collectors, submit real-time data entries, and log status coordinates.
Engineered for fluid scaling on smartphones, the Volunteer Portal bridges on-the-ground drivers with operations control. It utilizes high-contrast layouts and responsive buttons suitable for nighttime and in-cab usage.
Presents a Monday–Sunday slider of cards highlighting today's scheduled runs. Numerical badges display active pickup collections (orange) and community outreaches (purple).
Allows Lead volunteers to click "Start Today's Run", triggering API state updates to active status. Features driving directions maps integration sorted chronologically, interactive collapsibles for completed stores, and co-collector checkboxes verification.
To finalize runs and upload datasets, drivers must click the mandatory safety checkbox ("I am Home Safe"). An unverified driver triggers automated flags in the Admin Operations portal, safeguarding late-night volunteers.
Lists upcoming outreaches, coordinates, and instructions. Displays yellow badges for designated team Supervisors. Volunteers check in on site to record local customer attendance counts and contributions.
A native Android WebView package supporting edge-to-edge statusbar overlays, hardware back button navigation hooks, and custom Google Maps scheme interception to launch native voice-guided navigation on the device.
