Skip to content

Service Provider Page-by-Page Guide

This inventory is aligned to the current admin-console route tree as of the 2026-03-25 docs refresh.

Evidence and Access

  • Portal: https://admin.test.emali2.damplabs.com
  • Live browser evidence: output/playwright/refresh-20260325/
  • Verified admin account: admin1 / password
  • Primary implementation references:
  • emali2-frontend/apps/admin-console/src/App.tsx
  • emali2-frontend/apps/admin-console/src/pages/AgentsPage.tsx
  • emali2-frontend/apps/admin-console/src/pages/AgentChildrenPage.tsx
  • emali2-frontend/apps/admin-console/src/services/adminApi.ts

Public Entry Routes

Route Access Current Behavior
/ Session-aware Redirects authenticated admins into /app.
/login Public Service-provider sign-in entry.
/forbidden Public Explicit denial route for blocked access.

Core Operations, Risk, and Governance

Route Access Current Behavior
/app service_provider or system_admin Admin dashboard.
/app/transactions Admin Transaction monitoring list.
/app/transactions/:receiptNumber Admin Transaction detail and linked operational evidence.
/app/customers Admin Customer directory.
/app/customers/:customerId Admin Customer detail.
/app/holds Admin Hold queue.
/app/holds/:holdId Admin Hold detail.
/app/kyc-limits Admin KYC and limit controls.
/app/products-services Admin Product and service controls.
/app/organizations Admin Canonical organization oversight route.
/app/organizations/:orgId Admin Organization detail.
/app/agents Admin Alias route that redirects to /app/organizations.
/app/agents/:agentId Admin Direct agent detail route.
/app/agents/:agentId/children Admin Child-agent hierarchy route for super agents.
/app/staff-management Admin Staff management surface.
/app/user-management Admin Alias to staff management.
/app/roles-permissions Admin Alias to staff management/role administration.
/app/audit-trail Admin Platform audit review.
/app/platform-health Admin Platform health route.
/app/system-settings Admin System settings.
/app/security/2fa Admin Identity-backed two-factor route.

Finance, Ledger, and Reconciliation

Route Access Current Behavior
/app/bank-accounts Admin Bank-account inventory.
/app/ledger Admin Ledger account list.
/app/ledger/gl/:glAccountId Admin GL account ledger detail.
/app/ledger/accounts/:accountId Admin Ledger account detail.
/app/journals Admin Journal list.
/app/journals/:fineractTransactionId/transactions Admin Linked journal transactions.
/app/settlements Admin Settlements route, currently backed by the disbursements surface.
/app/settlements/:batchId Admin Settlement-batch detail.
/app/disbursements Admin Disbursement operations.
/app/commissions Admin Commission/disbursement operations route.
/app/reconciliation/runs Admin Reconciliation-run list.
/app/reconciliation/runs/:runId Admin Reconciliation-run detail.
/app/reconciliation/mismatches Admin Mismatch investigation list.
/app/reconciliation/mismatches/:mismatchId Admin Specific mismatch detail.
/app/fees Admin Fee configuration and review.
/app/fee-assessments Admin Fee-assessment route, currently backed by the fee surface.
/app/reports Admin Reporting workspace.
/app/reports/financial-statements Admin Financial statements route.
/app/reports/fixed-assets Admin Fixed assets route.

Lending, Integrations, and Campaigns

Route Access Current Behavior
/app/approvals Admin Approvals queue.
/app/approvals/:taskId Admin Approval-task detail.
/app/developer-integrations Admin Developer-integration requests.
/app/developer-integrations/:requestId Admin Integration-request detail.
/app/ussd-registry Admin USSD registry administration.
/app/loans/rules Admin Loan rules.
/app/loans/products Admin Loan products.
/app/loans/lenders Admin Lender registry.
/app/loans/operations Admin Loan-operations oversight.
/app/loans/operations/:loanId Admin Specific loan-operation detail.
/app/contributions/campaigns Admin Contribution campaign directory.
/app/contributions/campaigns/:campaignId/analytics Admin Campaign analytics route.

Dashboard Reference

Service provider dashboard

The admin dashboard remains the safest starting point for verifying that the service-provider session and navigation tree are healthy before drilling into a specific operations surface.

Deep Dive: /app/agents

Service provider agent alias route

Current behavior

  • /app/agents is no longer the canonical list route.
  • Opening it redirects into /app/organizations.
  • Service-provider users should treat organization oversight as the starting point for most agent discovery work, then use direct agent detail routes when they already know the target agent ID.

Deep Dive: /app/agents/:agentId

Current behavior

  • The detail route remains valid even though /app/agents is now an alias.
  • Agent detail is expected to surface current operational identifiers, including tills and shortcodes.
  • Agent data now carries superAgentShareRate, which matters when reviewing commission-split behavior for agents attached to a super agent.
  • Live screenshot evidence for this direct detail route was intentionally omitted from this refresh because the 2026-03-25 test deployment rendered the page blank with ReferenceError: Stack is not defined, even though the route remains mounted in the current admin console.

Deep Dive: /app/agents/:agentId/children

Service provider child-agent hierarchy

Current behavior

  • This route is the dedicated hierarchy summary for a selected super agent.
  • The page aggregates child count, total child float, and till coverage.
  • Child rows show till numbers directly and surface shortcode chips when available.
  • This is the preferred admin route for reviewing super-agent networks after you already know the parent agent ID.