Dashboard
Overview
The Dashboard is the landing page after login, providing a high-level snapshot of MMDA performance across properties, rate payers, bills, payments, and operational metrics. It combines summary widgets, trend charts, collection stats, and quick-access actions.
Navigate to: /, /dashboard, /operationaldashboard, /financialdashboard
Sidebar
The sidebar is server-driven (fetched from GET /sys/usermenu) and
adapts based on the logged-in user's role and permissions.
| Element | Description |
|---|---|
| iDARMS logo | Application branding |
| Navigation menu | Server-driven — modules appear based on user permissions |
| Calendar widget | Shows current month with date highlighting |
| Ghana tax SVG map | Visual map of Ghana's tax zones |
| User profile | Logged-in user name and avatar |
| Logout | Ends the session |
!!! tip "Things to check" - Sidebar items match the user's permissions (if RBAC were enabled) - Calendar highlights the current date - The Ghana map is interactive or informational (confirm behavior) - Collapsing/expanding the sidebar works on all screen sizes
Dashboard Tabs
The dashboard supports multiple views via tabs:
| Tab | Description |
|---|---|
| Operational Dashboard | Focuses on field activity, property inspections, and system operations |
| Financial Dashboard | Focuses on revenue, collections, outstanding amounts, and financial reports |
Navigate to: /operationaldashboard or /financialdashboard
Operational Dashboard Widgets
Property Statistics
| Widget | Description |
|---|---|
| Total Properties | Total registered properties across all MMDAs |
| Verified Properties | Properties that have completed inspection and verification |
| Pending Verification | Properties awaiting inspection or admin review |
| Under Inspection | Properties currently being inspected by agents |
Rate Payer Statistics
| Widget | Description |
|---|---|
| Total Rate Payers | All registered rate payers (Individual + Organisation) |
| Verified Rate Payers | Rate payers who completed OTP verification |
| Unverified Rate Payers | Rate payers pending OTP verification |
Bill Statistics
| Widget | Description |
|---|---|
| Bills Issued | Total bills generated in the current period |
| Bills Paid | Bills with full payment received |
| Outstanding Amount | Total unpaid amount across all bills |
| Overdue Bills | Bills past their due date |
Payment Snapshot
| Widget | Description |
|---|---|
| Total Collected | Sum of all payments received |
| Online Payments | Payments made via digital channels |
| Offline Payments | Payments collected manually (cash, cheque, etc.) |
| Payment Trends | Line/area chart showing payment volume over time |
Financial Dashboard Widgets
Revenue & Collection Widgets
| Widget | Description |
|---|---|
| Revenue by Category | Breakdown of revenue by property type, business category, etc. |
| Collection Rate | Percentage of billed amount actually collected |
| MMDA Collection Stats | Per-assembly collection performance |
| Top Assemblies | Ranked list of MMDAs by collection amount |
Expense & Budget Widgets
| Widget | Description |
|---|---|
| Total Expenses | Sum of recorded expenses |
| Budget vs Actual | Comparison of budgeted vs actual spending |
| Expense by Category | Breakdown of expenses by category |
| Budget Report | Summary of budget utilization |
Financial Reports Access
The financial dashboard provides quick access to key reports:
| Report | Description |
|---|---|
| Trial Balance | Sum of all debit and credit balances |
| Income Statement | Revenue minus expenses for the period |
| Balance Sheet | Assets, liabilities, and equity position |
| Cash Book | All cash transactions |
| Bank Book | All bank transactions |
Widget Details
Property by Zone Chart
A bar or pie chart showing property distribution across defined zones. Helps identify high-density areas for targeted billing.
Bill by Region Chart
A chart showing bill generation volume broken down by region. Useful for comparing MMDA-level billing activity.
System Stats
| Metric | Description |
|---|---|
| Total Users | Active back office users |
| Active Sessions | Currently logged-in users |
| API Response Time | Average response time |
| System Uptime | Current uptime percentage |
Support Resolution
| Metric | Description |
|---|---|
| Open Disputes | Disputes pending resolution |
| Resolved Disputes | Disputes marked as resolved |
| Average Resolution Time | Mean time from dispute filing to resolution |
| Resolution Rate | Percentage of disputes resolved |
Sidebar Calendar
| Element | Description |
|---|---|
| Month/Year | Current month and year display |
| Day grid | Calendar days with current date highlighted |
| Navigation arrows | Move between months |
Sidebar Ghana Tax Map
An SVG map of Ghana showing tax zones or MMDA boundaries. May be interactive (clickable regions) or informational.
!!! tip "Things to check" - Map regions are clickable (if interactive) and link to relevant MMDA data - Hovering over a region shows a tooltip with MMDA name and key stats - The map renders correctly on different screen sizes
API Endpoints
| Endpoint | Method | Description |
|---|---|---|
/sys/dashboard |
GET | Financial dashboard data |
/sys/dashboardop |
GET | Operational dashboard data |
!!! tip "Things to check" - Dashboard data loads within acceptable time (< 3 seconds) - Widgets show loading states while data is being fetched - Empty states (zero data) display correctly without broken UI - Chart tooltips show accurate values on hover - MMDA collection stats update after a new payment is recorded - Property counts reflect real-time data from the inspection workflow - Bill statistics sync with bill status changes across the system - The dashboard is responsive and scrolls properly on smaller screens