Docs/Dashboard/Dashboard Overview

Dashboard Overview

Product version: 1.0.0+1 Last updated: 2026-08-13 Audience: Tenant Owners, Tenant Employees, Platform Staff, Regular Users

What Is the Dashboard?

SanadiqCloud has three home screens. They are not interchangeable.

Audience Screen Purpose
Tenant owner / employee with an organization Merchant Dashboard /dashboard One-tenant operational overview
Platform admin / staff with no tenant selected Admin Dashboard /admin/dashboard Application-level platform health
User without an organization Home /home Create or join an org — not the KPI API

You need dashboard:read to open the merchant or admin KPI dashboards. Without it, the app shows unauthorized.

Data flow

Domain services → RabbitMQ events → dashboard-service dsb_* projections
                                          ↓
                         GET /api/dashboard/v1/dashboard/app
                         GET /api/dashboard/v1/dashboard/tenant/{id}
                                          ↓
                              Flutter dashboard pages

The merchant page also overlays live inventory so stock warnings match item detail. Dashboard-service stays read-only.

Merchant vs admin

The merchant dashboard is scoped to the active organization (KPIs, subscription, stock, inventory, business, requisitions, activity).

The admin dashboard is application-level only (users, organizations, billing, payment failures, platform activity). It does not show tenant inventory, stock, requisitions, catalog mix, or media.

See Merchant Dashboard, Admin Dashboard, and KPI Reference.

Permissions

Missing product:read / inventory:read (and similar) does not hide summary cards. Those permissions mainly control whether tapping a card navigates.

  • Side rail (tablet/desktop) or drawer (mobile)
  • Pull down to refresh
  • Wide screens: section grids; narrow: stacked cards
  • Arabic RTL and English LTR use the same layout

Related: Merchant Dashboard | Admin Dashboard | KPI Reference | Getting Started