Service Provider Portal Guide

Portal URL

https://admin.test.emali2.damplabs.com

Source of Truth for This Refresh

• Route tree: emali2-frontend/apps/admin-console/src/App.tsx
• Agent routes and data shaping: emali2-frontend/apps/admin-console/src/pages/AgentsPage.tsx, AgentChildrenPage.tsx, services/adminApi.ts
• Agent commission and share behavior: current backend agent services and transaction services
• Live browser evidence: output/playwright/refresh-20260325/ using admin1 / password

What Changed

• /app/agents is now an alias route that redirects to /app/organizations; direct agent detail and child-agent routes remain available for targeted oversight.
• Agent detail and hierarchy views surface tills, shortcodes, and superAgentShareRate, so the service-provider guide now treats those values as operational data rather than backend-only metadata.
• /app/agents/:agentId/children is now a first-class admin route for reviewing hierarchy, child counts, till coverage, and aggregate float.
• Super-agent commission behavior now includes explicit share-split guidance where relevant to operational review and troubleshooting.

What This Guide Covers

1. The current service-provider/admin route inventory, including aliases, finance routes, and lending governance routes.
2. Detailed route notes for organization oversight, agent detail, child-agent hierarchy, approvals, and ledger operations.
3. Role-aware workflows for platform admins and specialized service-provider operators.

Read In This Order

1. Service Provider Page-by-Page Guide
2. Service Provider Task Workflows

Representative Screens