Skip to content

Dynamic BPE Agent Delegation

To prevent human bottlenecks during manual reviews, BPEVeriFlow provides BPE Executives with the ability to dynamically reassign officers to any verification desk in real time.


1. State Propagation Lifecycle

When an Executive modifies an assignment in the Executive Command Center, the change propagates immediately across all connected UI surfaces:

sequenceDiagram
    participant Exec as "🏛️ Executive Dashboard"
    participant State as "VerificationContext (Reducer)"
    participant App as "Applicant Portal"
    participant Cert as "Concession Certificate"

    Exec->>State: assignAgent(deskNumber, officerId, officerName)
    State->>State: ASSIGN_AGENT reducer updates desks[deskIndex]
    State->>App: Reactive re-render — officer badge updates in sidebar
    State->>Cert: Officer name binds to digital signature line on certificate

Real-Time Cross-Portal Propagation

Assignment changes are reflected immediately in the applicant's portal header, the Executive Command Center's Priority SLA Queue, and the digital signature block of the final Bid Bond Certificate — all without requiring a page reload.


2. Reducer Implementation

The state change is handled in VerificationContext.tsx:

VerificationContext.tsx — ASSIGN_AGENT case
case "ASSIGN_AGENT":
  return {
    ...state,
    desks: state.desks.map((d) =>
      d.deskNumber === action.payload.deskNumber
        ? {
            ...d,
            officerId: action.payload.officerId,
            officerName: action.payload.officerName,
          }
        : d
    ),
  };

The assignAgent() dispatcher is also exposed in ExecutiveCommandCenter.tsx via the useVerification() hook:

ExecutiveCommandCenter.tsx — dropdown handler
onChange={(e) => {
  const agent = AVAILABLE_AGENTS.find(a => a.id === e.target.value);
  if (agent) {
    assignAgent(desk.deskNumber, agent.id, agent.name);
  }
}}

3. Executive Assignment Panel

The control interface is embedded in the Executive Command Center (src/components/dashboard/ExecutiveCommandCenter.tsx). The UI presents a 5-column grid:

  1. Desk Badge & Name — Visual label of the desk stage (e.g., "Desk 3 — Finance QC").
  2. Officer Dropdown — Populates all 6 available agents from the roster.
  3. Real-Time Dispatch — Selecting an officer immediately calls assignAgent() and updates global state — no submit button needed.

4. Available BPE Officers Roster

The following officers can be dynamically assigned to any desk at any time:

ID Name Title Department Default
usr-002 Chidinma Eze Verification Officer Document Review Unit Desks 1 & 2
usr-005 Tunde Bakare Finance Analyst Finance Audit Dept Desk 3
usr-006 Victoria Nwachukwu Compliance Officer Legal & Compliance Desk 4
usr-007 Alao Adebayo Biometric Agent Identity & Biometric Desk Desk 5
usr-008 Ibrahim Yusuf Senior Officer Privatisation Review Committee Unassigned (Fallback)
usr-009 Grace Okon Compliance Officer Legal & Compliance Unassigned (Fallback)

Fallback Officers

Officers usr-008 and usr-009 are unassigned by default and serve as overflow resources. Assign them to any desk experiencing high backlog or SLA breach risk — the Executive Command Center's Desk-by-Desk Throughput panel highlights which desks are underperforming.