Service Provider Page-by-Page Guide

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

Evidence and Access

• Portal: https://admin.test.emali2.damplabs.com
• Live browser evidence: output/playwright/refresh-20260325/ and output/playwright/docs-refresh-20260701/
• 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/:financeServiceTransactionId/transactions	Admin	Linked journal transactions from finance-service posting evidence.
/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 with workflow backlog, scoped approvals, aging groups, blocked batches, and authorization health.
/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, including staff-targeted lending programs and visibility controls.
/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

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

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

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.

Deep Dive: /app/approvals

Current behavior

• The approvals page combines the operational queue, maker-checker backlog, aging groups, blocked batch detection, and authorization health.
• Operators should use the summary cards first, then drill into View actions for scoped approval groups that need follow-up.

Deep Dive: /app/loans/products

Current behavior

• Staff-targeted products are labeled by target audience and visibility so operators can distinguish internal staff programs from consumer and organization programs.
• Product rows expose status, interest rate, principal range, and edit actions for authorized administrators.