Skip to content

BPEVeriFlow System Overview

Live Demo

The BPEVeriFlow platform is running at http://localhost:3000. Use one of the demo accounts below to log in and explore each role's interface.

BPEVeriFlow is an enterprise-grade, AI-accelerated compliance routing and concession settlement platform designed for the Bureau of Public Enterprises (BPE), Nigeria. The platform streamlines public asset privatisation, bid vetting, and concession fee processing through automated workflows, government registry integrations, decentralized identity wallets, and Privacy-Enhancing Technologies (PETs).

System Objectives

Objective Mechanism
Frictionless Ingestion Self-Sovereign Identity (SSI) wallets auto-fill NIN, BVN, and CAC credentials at login
AI-Assisted Compliance Automated structural checks across 5 sequential desks with AI confidence scoring
Fraud Reduction Deepfake detection, AML/NFIU transaction flag rules, and signature consistency checks
Decentralized Auditing SHA-256 cryptographically chained audit ledger — every event is tamper-evident
Concession Settlement Simulated CBN RTGS wire transfer producing a printable multi-signature bond certificate

Platform Architecture

graph TD
    Browser([Browser / Applicant]) --> Next["Next.js 16 App<br/>(localhost:3000)"]

    subgraph "Next.js Resilience Boundary"
        Next --> |"API Routes"| Routes["/api/verify/:desk<br/>/api/ssi<br/>/api/exception"]
        Routes --> |"fetchWithRetry"| GW["Express Gateway<br/>(Port 4000)"]
        Routes -. "Offline Fallback" .-> Mock["Mock Responders<br/>(Local JS Modules)"]
    end

    subgraph "Backend Container Mesh"
        GW --> |":4001"| Identity["Identity Service<br/>(NIMC · CAC · SSI)"]
        GW --> |":4002"| Verify["Verify AI Engine<br/>(OCR · AML · ZKP)"]
        GW --> |":4003"| Exception["Exception Service<br/>(Human Review Queue)"]
    end

    subgraph "Context Layer (Client State)"
        Next --> RBAC["RBACContext<br/>(Auth · Permissions)"]
        Next --> VC["VerificationContext<br/>(Desk State · SLA · Scores)"]
        Next --> Wallet["WalletContext<br/>(SSI Credentials)"]
    end

Core Capabilities

5-Desk Sequential Processing:
Pre-Screening → Document Review → Finance QC → Due Process → Biometric Sign-off

Each desk applies AI classification scoring, with automatic escalation to human officers when confidence falls below threshold.

Offline-First Design:
If backend microservices are unavailable, Next.js API routes automatically fall back to high-fidelity mock responders. The UI continues to function without breaking the onboarding timeline or payment flow.

Executive Control:
BPE Executives can reassign any of the 6 available officers to any desk in real-time. Assignments propagate immediately to the applicant portal and the final concession certificate's digital signature block.

CBN RTGS Simulation:
After clearing all 5 desks, applicants settle a ₦15,000,000 concession bid bond via a simulated Central Bank of Nigeria RTGS transfer. A printable multi-signature certificate is generated upon disbursement.

Demo Accounts

The platform ships with 8 pre-configured demo accounts. All passwords are password. MFA-enabled accounts use demo code 123456.

Role Email MFA Access
👤 Applicant applicant@bpe.gov.ng ❌ Verification Portal, PETs, Message Center
🏛️ Executive executive@bpe.gov.ng ✅ Command Center, Agent Assignments, All Desks
📋 Verification Officer officer@bpe.gov.ng ✅ Desks 1–2, Exception Queue, Pipeline
📜 Auditor auditor@bpe.gov.ng ✅ Command Center, Audit Log, AI Fairness
⚖️ Compliance Officer compliance@bpe.gov.ng ✅ Desk 4, Audit Log, AI Fairness
💰 FIRS Finance Analyst analyst@firs.gov.ng ✅ Desk 3, Finance QC
👁️ NIMC Biometric Agent agent@nimc.gov.ng ✅ Desk 5, Biometrics
🔍 External Verifier verifier@bank.com ❌ Public Clearance Verifier only

Quick Navigation

  • Getting Started

    Set up the platform locally in under 5 minutes.

    Getting Started

  • User Guide

    Step-by-step guides for Applicants, Officers, and Executives.

    User Guide

  • Architecture

    Microservices mesh, resilience boundary, and state management.

    Architecture

  • PETs & Security

    ZKP biometrics, RBAC governance, and NDPR compliance.

    PETs & Security