Analytics & reports
Use the dashboards that exist today for operations, practitioner work, visit reports, finance summaries and platform health.
Who can do this: Owners, branch managers, receptionists and accountants use dashboard.operations; practitioners use dashboard.practitioner; finance users use finance.read and reports.financial; managers use reports.operational; platform admins use platform.admin for monitoring.
Where: Dashboard (/app/dashboard), My Dashboard (/app/doctor-dashboard), Doctor Analysis (/app/doctor-analysis), Visit Report (/app/patient-visit-report), Financial Dashboard (/app/financial-dashboard), Finance (/app/finance), Monitoring (/app/monitoring).

Before you start
- Use the screen for your role. Doctors and practitioners are redirected to My Dashboard.
- Financial reports require
finance.readorreports.financial. - Operational reports require
reports.operational. - Monitoring is platform-admin only.
Use Dashboard
- Open Dashboard. Result: Role-based widgets and quick actions appear.
- Review appointment and patient cards when you have clinical access. Result: Today's appointments and pending work are visible.
- Review finance cards when you have finance access. Result: Income, expenses and summary values appear.
- Click quick actions such as Register Patient, Book Appointment, View Appointments, Create Bill, Finance or Reports. Result: You jump to that workflow.
- If queue is enabled and you have
queue.manage, use the front-desk cockpit. Result: Queue work is visible on the dashboard.
Use My Dashboard
- Open My Dashboard.
Result:
/app/doctor-dashboardloads practitioner appointments, bills and packages. - Review Today's Schedule. Result: Timeline actions such as Check In and Complete appear where applicable.
- Use search, filters and pagination for patients, bills and appointments. Result: Practitioner-specific work is easier to find.
- Review low-balance package alerts. Result: Packages needing follow-up are visible.
The page still fetches some legacy OT report data internally, but user guidance should use Clinical documents for reports and notes.
Review Doctor Analysis
- Open Doctor Analysis. Result: Practitioner cards load.
- Review Unique Patients, Total Bills, Revenue and Collection Rate. Result: You can compare practitioner performance.
- Click Show patient & bill details. Result: The card expands with bill and appointment details.
- Click View ? on a bill. Result: Bill print opens.
Run Patient Visit Report
- Open Visit Report. Result: Current-month visits load.
- Set Start Date and End Date. Result: Date range changes.
- Choose Status or Doctor. Result: The table filters.
- Type in Search. Result: Patient name, phone, patient ID or appointment ID matches remain.
- Click Export CSV. Result: A CSV downloads.
- Click Print. Result: A landscape print report opens.
Use Financial Dashboard
- Open Financial Dashboard. Result: Summary cards and controls load.
- Select Branch Summary or All Branches. Result: Summary reloads for that branch.
- Enter a date range and load it. Result: Summary changes to that period.
- Use overview, income and expenses tabs. Result: Transaction data loads.
- Click Refresh Data. Result: Finance summary refreshes.

Use Finance transactions
- Open Finance. Result: Income or expenses tab opens.
- Select the financial year. Result: Transactions load for that year.
- Switch Income and Expenses. Result: The active tab refreshes.
- Add income or expense when permitted. Result: The record is saved and the list refreshes.
- Attach proof for expenses up to 500 KB. Result: Proof is included with the expense.
Monitor system health
- Open Monitoring. Result: Service health loads.
- Review Total Services, Services UP, Services DOWN and Health Score. Result: Platform status is visible.
- Toggle Auto-refresh. Result: Data refreshes every 30 seconds when enabled.
- Click Refresh. Result: Health, user and system statistics reload.
- Check Last updated. Result: You know the snapshot time.
Troubleshooting
| Problem / message | What it means | What to do |
|---|---|---|
| ?Loading dashboard?? stays visible | Dashboard requests are slow or blocked. | Refresh and check login. |
| ?Some dashboard sections could not be loaded ? Displayed results may be incomplete.? | Some practitioner dashboard calls failed. | Use the module page and retry later. |
| ?Unable to load visit data? | Visit report failed. | Reopen or refresh the report. |
| ?CSV exported!? does not appear | Download may be blocked. | Check browser downloads and retry. |
| ?Unable to load the financial summary right now.? | Financial summary API failed. | Click Retry or Refresh Data. |
| ?Unable to load branch options.? | Branch list failed. | Use All Branches or retry. |
| ?Please select date range? | Missing start or end date. | Enter both dates. |
| ?No data for this financial year yet. Try another year or add a new entry.? | Finance list is empty. | Pick another year or add data. |
| ?File too large. Max 500KB. Compress the image and try again.? | Expense proof too large. | Compress the file. |
| ?Monitoring data unavailable? | Health endpoints failed. | Click Retry. |
| ?No monitoring snapshot is available yet.? | No health data returned. | Refresh after backend health endpoints are reachable. |