Dashboard — /rbac and /rbac/dashboard
The Dashboard is the landing page for RBAC. It gives you an at-a-glance picture of what is configured in your workspace and links into the rest of the module.
What you see
Stat cards
Four tiles summarize the current state. Each is clickable for members who have read access to the target surface:
- Total roles — how many roles exist in this workspace, with the active count as the subtitle. Tap to open Roles.
- Activity (Checks) — total permission-check evaluations and an
N allowed, M deniedsubtitle. Tap to open Analytics. - Total resources — resources registered with RBAC in this workspace, with the number of resource types as the subtitle. Tap to open Resources.
- Role assignments — active actor-role assignments. Tap to open the Agents listing.
Numbers come from the rbacAnalytics query plus the roles/resources queries (combined in useDashboardData). They are scoped to the current workspace.
Quick actions
The left column shows quick-action cards. Each is rendered only if you have the matching permission:
- Create role — opens
/rbac/roles/create(requiresrole:create). - Check permissions — opens the Permission Checker (any read access).
- Visibility rules — opens the Visibility page (read access; mutations require
visibility:write).
Recent activity
The right/main column lists the last few entries from the RBAC change log (rbacChangeHistory). Each row shows the description, the actor (changedBy), the entity type, and a relative timestamp. The footer link View full audit log drops into /rbac/analytics/audit for members with canViewAuditLog.
Note: this feed tracks RBAC configuration changes (role created, override added, assignment removed, etc.), not permission decisions. For permission decisions, use the Permission Checks tab on the Audit Log.
Things you can do
| Task | How |
|---|---|
| Refresh stats | Tap Refresh in the page header |
| Open a stat detail | Tap any clickable stat card |
| Create a role | Quick actions → Create Role (admins) |
| Open the audit log | View full audit log under Recent Activity |
Permissions you need
The dashboard is rendered as long as you have at least rbac:read (or module-rbac:role:read / module-rbac:permission:read as auth-level fallbacks). Workspace admins/owners bypass the check. Buttons and links are individually gated:
- Create role quick action — requires
role:create(admins). - Activity (Checks) stat is only clickable if you have
canViewAnalytics. - Total resources stat is only clickable if you have
canViewResources. - Role assignments stat is only clickable if you have
canViewActors. - View full audit log is only rendered if you have
canViewAuditLog.
If a quick action does not appear, your role does not include the corresponding permission. Ask a workspace admin to upgrade your role.
For the full list of RBAC actions and how they are evaluated, see modules/rbac/specs/06-permissions-authz.md.
Tips
- The numbers are computed from the
rbacAnalyticsaggregate — they may lag by a few seconds after a fresh change. Use Refresh to force a re-fetch. - The activity feed only shows RBAC events. For wider workspace activity, use the workspace activity feed.
- Numbers are scoped to this workspace. Switching workspaces will load different numbers.
- In the user variant (tabbed shell), the Dashboard is shown as the first tab alongside Roles and Permission Checker; the underlying page is the same.