Home / Projects / PBAT-KOH
Organisational Technology · Mobilisation · Membership Systems

PBAT-KOH — Tertiary Mobilisation & Membership Management Platform

A centralized digital mobilization and membership tracking infrastructure designed to coordinate student leaders, campus captains, coupon referral attribution, and executive analytics across 14 Lagos tertiary institutions.

Primary Role Lead Full-Stack Engineer
Architecture BHKYS Client + BAT-KOH Express Backend
Campus Network 14 Tertiary Institutions across Lagos
Administrative Scope 20 LGAs · Captain Attribution Codes · Excel Export
01

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.

PBAT-KOH Official Web Platform Interface
Figure 4.1: Live portal interface for PBAT-KOH student registration and campus mobilization.
02

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.
03

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.

04

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.

05

System Architecture

PBAT-KOH Technical Topology Render + Vercel + Atlas
BHKYS Client
Component-driven React SPA hosted on Vercel. Form validation with regex-based Nigerian phone and VIN structure checks. Instant referral code verification API calls.
Node / Express
REST API deployed on Render with JWT authentication, institutional role-based access control (RBAC), and ExcelJS streaming export endpoints.
MongoDB Atlas
High-performance document store with compound indices on { institution: 1, lgaOfRegistration: 1, couponCode: 1 } ensuring instantaneous aggregation queries across thousands of records.
06

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.
07

Technology Stack

React.js Node.js Express.js MongoDB Atlas Mongoose ORM JWT Authentication ExcelJS Render Cloud Vercel CSS3 & Responsive UI
08

Engineering Decisions & Integrity Safeguards

1. VIN Format Validation vs. External KYC Architectural Honesty

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.

2. Compound Indexing for High-Velocity Filtering Database Performance

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.

09

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.

14
Lagos Institutions Supported
20
Local Government Areas
4
Hierarchical User Portals
100%
Digital Attribution Traceability