Platform Documentation

Everything you need to know about Constituency Project - roles, features, and how to make the most of the platform.

Browse Online
On This Page

What is Constituency Project?

A digital platform designed to bring transparency, accountability, and citizen participation to constituency projects across Nigeria.

Constituency Project serves as a bridge between project owners (candidates), executors (contractors), and supporters (contributors). Every project is documented phase-by-phase with photos, updates, and verifiable progress tracking.

Platform Mission: To transform constituency projects from political promises into documented, verifiable community impact.

Platform Overview

Three Core Roles

Candidates, Contractors, and Contributors each have specific functions within the ecosystem.

Documentation System

Every project is broken into phases with media, updates, and progress tracking.

Wallet System

Contributors have wallets for funding, contractors can request withdrawals.

Report Keys

Secure access to detailed candidate reports via license keys.

Registration Process

Follow these steps to create your account and select your role:

  1. Step 1: Create Account

    Visit the registration page and provide your name, email, username, and password. Select your desired role (Candidate, Contractor, or Contributor).

  2. Step 2: Email Verification

    Verify your email address through the link sent to your inbox.

  3. Step 3: Complete Profile

    Fill in your role-specific details (bio, location, skills, etc.).

  4. Step 4: Admin Approval

    Your application will be reviewed and approved by an administrator.

Note: You can request a role change later through your profile settings.

Account Verification

All accounts must be verified by an administrator before full platform access is granted. This ensures the integrity of our community.

✓
Candidate Verification

Candidates must provide valid identification and proof of candidacy.

✓
Contractor Verification

Contractors need to provide business registration, skills, and experience.

✓
Contributor Verification

Contributors need valid identification to fund projects.

Role Categories

Candidate Role

Project owners who initiate and oversee constituency projects.

What Candidates Can Do:
  • Create Projects: Initiate new projects with detailed descriptions, budgets, and timelines
  • Manage Phases: Break down projects into manageable phases with weights and statuses
  • Review Applications: Review and approve contractor applications
  • Track Progress: Monitor project completion through contractor updates
  • Generate Reports: Access detailed reports of all projects and phases
How to Register as a Candidate:
  1. Select "Candidate" during registration
  2. Complete your profile with bio, district, state, and contact information
  3. Upload a profile photo and provide your position details
  4. Pay the application fee (if applicable)
  5. Wait for admin approval to start creating projects

Contractor Role

Skilled professionals who execute and document project work.

What Contractors Can Do:
  • Browse Projects: View available projects and apply to work on them
  • Submit Applications: Apply for projects that match your skills
  • Daily Reports: Submit daily progress reports with photos and comments
  • Track Earnings: Monitor payments and request withdrawals
  • Portfolio Building: Build a portfolio of completed projects
How to Register as a Contractor:
  1. Select "Contractor" during registration
  2. Complete profile with skills, occupation, and experience
  3. Upload credentials and certifications
  4. Wait for admin approval to start applying
  5. Once approved, browse and apply for projects

Contributor Role

Citizens who financially support projects and track community development.

What Contributors Can Do:
  • Fund Wallet: Add funds to your wallet via card, bank transfer, or USSD
  • Support Projects: Donate to projects you believe in
  • Track Impact: Monitor how your contributions are being used
  • Leaderboard Recognition: Get recognized as a top contributor
  • View Reports: Access candidate reports with valid license keys
How to Register as a Contributor:
  1. Select "Contributor" during registration
  2. Complete profile with location and bio
  3. Fund your wallet to start contributing
  4. Browse projects and support those you care about
  5. Track your impact and climb the leaderboard

Role Comparison

Feature Candidate Contractor Contributor
Create Projects
Apply for Projects
Fund Projects
Submit Daily Reports
Access Candidate Reports
Wallet (Receive Funds)
Wallet (Send/Withdraw)
Candidate Guide

Candidate Overview

Candidates are project owners who initiate and oversee constituency projects. They are responsible for creating projects, defining phases, and ensuring successful completion.

Project Creation

Create and manage multiple constituency projects

Progress Tracking

Monitor project completion in real-time

Candidate Registration

1
Initial Registration

Select "Candidate" as your role during the initial sign-up process. Provide your basic information including name, email, and password.

2
Complete Candidate Profile

After email verification, complete your candidate profile with:

  • Full name and contact information
  • District and state of representation
  • Professional bio and background
  • Profile photograph
  • Position details (e.g., House of Representatives, State Assembly)
3
Application Fee

Pay the required application fee (if applicable). This helps verify serious candidates and maintains platform integrity.

4
Admin Approval

Your application will be reviewed by administrators. Once approved, you can start creating projects and managing your portfolio.

Managing Projects

As a candidate, you have full control over your projects:

Create New Project
  • Title and description
  • Location details (state, LGA, ward)
  • Budget and timeline
  • Featured image
Edit Projects
  • Update project details
  • Modify budget (before approval)
  • Adjust timelines
  • Change featured image
Note: Once a project is approved by admin, it becomes active and can no longer be edited. Contractors can then apply to work on it.

Project Phases

Break down your projects into manageable phases for better tracking:

Example Phases for a School Construction Project:
  • Site clearing and preparation
  • Foundation laying
  • Structural framework
  • Roofing and finishing
  • Electrical and plumbing
  • Final inspection and handover
Phase Management Features:
  • Assign Weights: Give each phase a weight based on its importance (total weights sum to 100%)
  • Track Status: Monitor each phase as "pending", "in-progress", or "completed"
  • Auto-progress: Project progress automatically calculates based on completed phases

Working with Contractors

Once your project is active, contractors can apply to work on it:

1
Receive Applications

Contractors submit applications expressing interest in your project. Each application includes their qualifications and expected rate.

2
Review Applications

Review contractor profiles, their skills, past projects, and ratings. You can view their complete portfolio and verified work history.

3
Approve Contractor

Select the best contractor for your project. Once approved, they'll begin work and submit daily reports.

4
Monitor Progress

Track daily updates, view photos, and ensure the project is on schedule. You can communicate with the contractor through the platform.

Reports & Analytics

Access comprehensive reports on all your projects:

Project Reports
Detailed PDF reports per project
Progress Analytics
Track completion rates and timelines
Budget Tracking
Monitor spending against budget
License Keys: Your reports are accessible via license keys. You can request keys for public distribution or share them with stakeholders.
Contractor Guide

Contractor Overview

Contractors are skilled professionals who execute and document project work. They are the backbone of project implementation.

Project Execution
Complete projects with quality
Documentation
Submit daily reports with photos
Earnings
Get paid for completed work

Contractor Registration

1
Initial Registration

Select "Contractor" during sign-up. Provide your basic information.

2
Complete Contractor Profile

Fill in your professional details:

  • Skills and expertise (e.g., construction, electrical, plumbing)
  • Years of experience
  • Occupation and certifications
  • Location and service areas
  • Professional bio and portfolio
3
Verification

Upload credentials, certifications, and any relevant documents for verification.

4
Admin Approval

Your profile will be reviewed. Once approved, you can start applying for projects.

Applying for Projects

Browse available projects that match your skills and expertise.
Application Process:
  1. Browse Projects: Visit the Projects section to see all active projects seeking contractors.
  2. Review Project Details: Check project requirements, budget, timeline, and phases.
  3. Submit Application: Click "Apply" and provide:
    • Cover letter explaining why you're suitable
    • Expected rate (if not fixed)
    • Any additional notes
  4. Wait for Response: The candidate will review your application and either approve or reject it.
Application Statuses:
Pending Awaiting candidate review
Approved You can start working
Rejected Not selected for this project

Daily Reports

Once approved for a project, you must submit daily reports documenting your progress:

What to Include:
Work Description Detailed explanation of work done
Challenges Any issues encountered
Next Steps Planned activities
Photos Visual evidence (up to 5 photos)
Important: Reports are pending until approved by admin. Only approved reports become public.
How to Submit a Report:
  1. Go to "Submit Daily Report" in your dashboard
  2. Select the project and phase you're working on
  3. Write your report (minimum 10 characters)
  4. Upload photos (optional, max 5)
  5. Click "Submit Report"

Payments & Withdrawals

Your Wallet

All earnings are deposited into your wallet. Track your balance and transaction history.

  • View current balance
  • See transaction history
  • Track earnings per project
Withdrawals

Request withdrawals to your bank account:

  1. Click "Request Withdrawal"
  2. Enter amount (minimum ₦100)
  3. Provide bank details
Withdrawal Statuses:
Pending Awaiting admin approval
Approved Payment processed
Rejected Funds returned to wallet

Building Your Portfolio

Successfully completed projects build your reputation and help you win more contracts:

Ratings & Reviews

Candidates can rate your work. Good ratings increase your chances of being selected.

Completed Projects

All completed projects are displayed on your public profile.

Success Rate

Track your application success and project completion rates.

Contractor Leaderboard

Top contractors are featured and get priority for new projects.

Contributor Guide

Contributor Overview

Contributors are citizens who financially support projects and track community development. Your contributions make projects possible.

Fund Projects
Support initiatives you believe in
Track Impact
See how your funds are used
Get Recognized
Featured on leaderboards

Contributor Registration

1
Initial Registration

Select "Contributor" during sign-up. Provide your basic information.

2
Complete Profile

Fill in your details:

  • Location (district, LGA)
  • Bio (optional)
  • Profile photo
3
Email Verification

Verify your email address to activate your account.

4
Start Contributing

Fund your wallet and begin supporting projects immediately.

Wallet & Funding

Your wallet is your personal account for funding projects.
How to Fund Your Wallet:
Bank Transfer
1-2 business days
USSD
Mobile payment
Funding Request Status:
Pending Awaiting admin approval
Approved Funds added to wallet
Rejected Request declined

Supporting Projects

Once your wallet is funded, you can support projects that align with your interests:

1
Browse Projects

Explore active projects seeking contributions. Filter by location, type, or candidate.

2
Choose Amount

Select how much you want to contribute (minimum ₦100).

3
Select Payment Method

Pay from wallet or via bank transfer.

4
Confirm Contribution

Review and confirm your donation. You'll receive a confirmation.

Note: All contributions are verified by admin before being applied to projects.

Contributor Leaderboard

Top contributors are recognized on the public leaderboard:

#1 Rank

Gold Tier Benefits

Featured on homepage

Top 10

Silver Tier Benefits

Special recognition
Tiers Based on Contributions:
  • Platinum ₦1,000,000+
  • Gold ₦500,000 - ₦999,999
  • Bronze ₦100,000 - ₦499,999
  • Community Below ₦100,000

Tracking Your Impact

See the real difference your contributions make:

Contribution History
  • View all donations
  • See amounts and dates
  • Track total contributed
Supported Projects
  • List of projects you've funded
  • View project progress
  • See updates from contractors
Your Impact Matters

Every contribution helps bring essential projects to communities. Track your impact in real-time through our comprehensive reporting system.

Reports Guide

Report Overview

Candidate reports provide comprehensive documentation of all projects, phases, updates, and media associated with a candidate.

Each report includes:

Candidate Information
Bio, contact, location, and positions held
Project Details
All projects with descriptions and budgets
Phase Breakdown
Each project phase with status and progress
Media Gallery
Photos and documents for each phase

License Keys

License keys are required to access full candidate reports.
How License Keys Work:
  • One-Time Use: Each key can only be used once
  • Expiration: Keys expire after a set period (usually 30 days)
  • Candidate-Specific: Keys are tied to specific candidates
  • Admin Generated: Only administrators can create keys

Requesting License Keys

To request a license key for a candidate's report:

  1. Navigate to Candidate Profile: Find the candidate whose report you want
  2. Click "Request Key": On the preview page, click the request button
  3. Fill Form: Provide your name, email, phone, and reason for request
  4. Submit: Your request will be sent to administrators
  5. Wait for Approval: Admin will review and email you the key if approved

Report Format

Full reports include the following sections:

  • Name and photo
  • Contact details (email, phone)
  • Location (district, state)
  • Biography
  • Positions held with dates

  • List of all projects with status
  • Total projects count
  • Active vs completed projects
  • Total budget across all projects

  • Project title and description
  • Full location details
  • Start and completion dates
  • Estimated budget
  • Progress percentage
  • Phase-by-phase breakdown
  • Daily updates from contractors
  • Media files for each phase
Admin Topics

Admin Dashboard Overview

The admin dashboard provides a centralized view of all platform activities.

Applications
Review candidate, contractor, and contributor applications
License Keys
Generate and manage report access keys
Reports
Approve or reject daily contractor reports
Wallet
Manage funding and withdrawal requests

Managing Applications

Review and approve user applications for different roles:

C
Candidate Applications

Review candidate credentials, position details, and application fee payment. Approve to allow project creation.

CT
Contractor Applications

Verify skills, experience, certifications, and business registration. Approve to enable project applications.

CB
Contributor Applications

Verify identity and approve to enable wallet funding and project contributions.

Approval Process: Review each application carefully. Approved users gain full access to role-specific features.

Creating License Keys

Administrators can generate license keys for candidate reports:

  1. Navigate to Report Keys: Go to Report Keys → Generate Key
  2. Select Candidate: Choose the candidate from the dropdown
  3. Set Expiry: Choose number of days until key expires (1-365)
  4. Generate: Click "Generate License Key"
  5. Share Key: Copy the generated key and share with the requester
Note: Keys are one-time use and will expire after the set period.

Managing Key Requests

When users request license keys, they appear in the Key Requests section:

1
Review Request

Check the user's information and reason for request

2
Approve or Reject

Click "Approve" to generate a key, or "Reject" with a reason

3
Notify User

System automatically handles notification (email integration pending)

Report Approval

Contractor-submitted daily reports need admin approval:

  • Pending Reports: View all pending reports in the Reports → Pending section
  • Review Content: Check the comment and photos for appropriateness
  • Approve: Click "Approve" to make the report public
  • Reject: Provide a reason and click "Reject" to return the report

Wallet Management

Admins manage all financial transactions:

Pending Funding
  • Review funding requests
  • Approve to credit user wallets
  • Reject with reason
Pending Withdrawals
  • Review withdrawal requests
  • Approve to complete transaction
  • Reject to refund wallet

Role Change Requests

Users can request to change their role. As admin:

  1. View all requests in Role Requests section
  2. Review the user's current role and requested role
  3. Approve: System automatically:
    • Deletes existing role records
    • Creates new role with preserved data
    • Updates user role field
  4. Reject: Provide a reason and request is marked as rejected