Project Overview
PBAT-KOH (operating publicly as Renewed Hope Ambassadors Lagos Students Wing at batkohsa.org) is an enterprise-scale grassroots mobilization and membership management platform engineered to streamline campus coordination across Lagos State tertiary institutions.
The platform connects state coordinators, campus captains, student volunteers, and executive leadership into a single verifiable digital ecosystem. It replaces traditional paper forms and uncontrolled WhatsApp registrations with a multi-portal architecture featuring unique captain referral coupon codes, institutional partitioning, and comprehensive administrative reporting.
The Real-World Challenge
Mobilizing thousands of student members across 14 autonomous higher education campuses presents massive logistical and data integrity obstacles:
✕ The Mobilization Bottlenecks
- Zero Attribution: Inability to know which campus captain or coordinator recruited which member, causing friction and zero performance accountability.
- Duplicate & Ghost Records: Paper forms and Google Sheets inevitably accumulate duplicated names, invalid phone numbers, and fabricated identities.
- Disconnected Campus Silos: Coordinators at UNILAG, LASU, and YABATECH had no shared platform to manage their respective campus captains.
- Slow Executive Reporting: Compiling state-wide mobilization numbers required days of manual spreadsheet reconciliation.
✓ The Digital Architecture
- Unique Referral Coupon Codes: Every campus captain receives an algorithmic coupon code automatically attributing newly registered members to their account.
- Duplicate Detection & Validation: Automated checks on email, phone, and voter identification number (VIN) format before database insertion.
- Hierarchical Role-Based Portals: Segmented workspaces for Public Registrants, Campus Captains, Campus Coordinators, and State Directors.
- Real-Time Analytics & Excel Exports: Executive dashboards with instant filtering across LGA, institution, captain, and registration dates.
The Solution Developed
I designed and built the complete PBAT-KOH platform as a decoupled client-server architecture consisting of the BHKYS React client application and the BAT-KOH Server Express/Node.js backend.
The platform implements four distinct operational portals:
Public Registration Portal
Accessible membership registration capturing personal data, 20 Lagos LGAs, institution selection, student/staff category, VIN format validation, and captain coupon attribution.
Campus Captains Portal
Personal captain dashboard displaying unique recruitment codes, real-time rosters of attributed members, and direct WhatsApp / Call shortcuts for rapid outreach.
Campus Coordinator Portal
Institution-level visibility allowing coordinators to supervise and compare the recruitment velocity of captains operating within their specific campus.
Executive Admin Portal
State-wide analytics dashboard, captain account provisioners, institutional filter toggles, audit views, and one-click formatted Excel data exports.
Supported Tertiary Institutions & Data Models
The platform hardens institutional relationships by strictly typing participating institutions into the database enum:
- UNILAG: University of Lagos
- YABATECH: Yaba College of Technology
- LASU: Lagos State University
- LASUSTECH: Lagos State University of Science and Technology
- LASUED: Lagos State University of Education
- FCE: Federal College of Education (Tech) Akoka
- OCEANOGRAPHY: Nigerian Institute for Oceanography and Marine Research
- FCFMT: Federal College of Fisheries and Marine Technology
- SACOED, LASCON, LASCOETH, LASCOHET, COOP-COLLEGE, LASCOCO
Attribution Workflow: When a campus captain registers, the system generates a unique referral string (e.g. CAP-UNILAG-102). When prospective members sign up via the public portal, entering this coupon attaches the captain's ObjectId to the member's record as referredBy, updating the captain's live attribution count in real time.
System Architecture
{ institution: 1, lgaOfRegistration: 1, couponCode: 1 } ensuring instantaneous aggregation queries across thousands of records.My Technical Contributions
- Backend & API Development: Built the entire BAT-KOH Express server, routing, controllers, and middleware from scratch.
- Referral Attribution Engine: Architected the coupon generation and relationship-linking system that binds students, captains, and campus coordinators.
- Administrative Data Export: Implemented server-side Excel generation allowing administrators to download filtered data sets categorized by LGA or campus.
- Frontend Architecture: Developed the BHKYS React application with role-protected dashboards, mobile-optimized registration flows, and real-time captain telemetry.
- Cloud Deployment: Configured production continuous deployment pipelines on Render (API) and Vercel (Client) with MongoDB Atlas clustering.
Technology Stack
Engineering Decisions & Integrity Safeguards
Rather than claiming direct, live electoral commission database integration where none existed, I engineered strict alphanumeric format and length validation for Voter Identification Numbers (VIN) to prevent typos and invalid structures while maintaining data privacy and honest documentation.
State leadership frequently requests multi-dimensional filters (e.g. "Show all Student members in Alimosho LGA under LASU registered by Captain X"). By creating compound MongoDB indices on institution, lgaOfRegistration, and couponCode, aggregation queries execute in sub-15ms.
Operational Impact & Value
PBAT-KOH transformed a traditionally opaque, manual mobilization process into a fully traceable, centrally monitored digital operation. By establishing clear attribution, campus captains were motivated by transparent performance metrics, coordinators could pinpoint low-activity institutions, and executive leadership gained real-time insight into mobilization progress across all 20 Local Government Areas of Lagos State.
Project Links & Live Deployment
The platform is publicly deployed and operational: