Skip to content

Organization Portal Guide

Portal URL

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

Source of Truth for This Refresh

  • Route tree: emali2-frontend/apps/org-console/src/App.tsx
  • Agent detail and hierarchy pages: emali2-frontend/apps/org-console/src/pages/AgentDetailsPage.tsx, AgentChildrenPage.tsx
  • Float behavior: emali2-frontend/apps/org-console/src/pages/FloatManagementPage.tsx
  • Organization API behavior: emali2-frontend/apps/org-console/src/services/orgApi.ts
  • Capability matrix: organization-portal-capability-matrix.md

What Changed

  • The organization portal now includes /app/agents/:agentId/children for super-agent and master-agent hierarchy drill-down.
  • Agent list and detail pages surface directory identifiers directly, including tills and shortcodes.
  • Agent detail pages expose the child-agent navigation path for eligible tiers and route users into the hierarchy summary page.
  • Float management is now explicitly driven by the selected organization unit. The page resolves the selected unit, loads its journal snapshot, and pairs that with organization-unit transactions.
  • Float top-up and customer deposit guidance must now be described as unit-scoped operations, not as generic float actions detached from organization context.

Live Evidence Status

  • Route and behavior verification in this refresh is based on the current frontend route tree, backend contracts, and browser smoke run on 2026-04-08.
  • orgadmin1, org1, and pnpadmin all authenticated successfully against the test realm, but they currently collapsed into the same Pick n Pay Eswatini org-admin context.
  • The dashboard-to-transactions mismatch observed on 2026-04-08 is now addressed in the frontend by aligning both screens to the same default 30-day org transaction contract.

What This Guide Covers

  1. The current organization route inventory, including organization-only routes, shared business routes, and common self-service routes.
  2. Detailed notes for agent hierarchy, child agents, unit-scoped float, and role-based organization context.
  3. The current capability inventory, including what is live end to end, restricted, hybrid/mock, and still roadmap.
  4. Practical workflows for operators who manage agents, tills, units, approvals, reports, and float.

Read In This Order

  1. Organization Capability Matrix
  2. Organization Page-by-Page Guide
  3. Organization Task Workflows