SaaS Dashboard.
Monitor partner subscription health, plan distribution, and platform usage from a single admin page.
The SaaS Dashboard gives super administrators a real-time overview of partner subscription health, plan distribution, and platform usage. Access it at Admin → SaaS Overview in the sidebar.
Access: Super administrators only (role 1). Managers cannot access this page.
What You See
The dashboard displays five sections:
Partner Status Breakdown
A full breakdown of all partner subscription statuses. Every partner is classified into exactly one of these states:
| Status | Meaning | Access |
|---|---|---|
| Active | Active paid subscription via Stripe | Full plan access |
| Trialing | In trial period | Full plan access |
| Past Due | Payment failed, in grace period | Restricted — shown in attention panel |
| Cancelled | Subscription ended or expired | Restricted |
| Incomplete | Initial payment pending or failed | Restricted |
| Suspended | Subscription paused, unpaid, or admin-blocked | Restricted |
| Manual | Billing disabled or null provider — admin manages plans externally | Full plan access |
| Legacy | Partner has a plan but no Stripe subscription — pre-existing from before billing was enabled | Full plan access |
| Billing Disabled | Billing provider is not configured for the installation | Full plan access |
Zero-count statuses are shown dimmed. The total partner count is displayed at the bottom.
How statuses are resolved: All status resolution goes through the
EntitlementService, which delegates to the active billing provider. In manual mode, all partners show asManual. In Stripe mode, the status is read directly from the Stripe subscription record. See Billing Configuration for the full mapping.
Plan Distribution
Horizontal progress bars showing how partners are distributed across plan tiers. Each bar displays the tier name, count, and percentage. Plan tiers are defined in config/plans.php.
Attention Required
A focused panel highlighting partners that need admin action:
- Trial Expiring Soon — Partners whose trial period ends within 7 days, with a link to each partner's edit page and remaining days
- Past Due — Partners with failed payments, linked to their management page
When no items need attention, the panel shows an "all clear" indicator.
Recent Registrations
The most recent partner registrations, showing business name, email, assigned plan, and time since registration. Each entry links directly to the partner's edit page in the admin CRUD.
Usage Overview
Aggregate resource counts across all partners:
| Metric | What It Counts |
|---|---|
| Partners | Total partner accounts |
| Staff | Total staff accounts across all partners |
| Loyalty Cards | Total loyalty cards created |
| Stamp Cards | Total stamp cards created |
| Vouchers | Total vouchers created |
Empty State
When no partners exist, the dashboard shows a prompt to add the first partner, with a direct link to the partner creation page.
Caching
Dashboard data is cached for 5 minutes to avoid expensive queries on every page load. Data refreshes automatically when the cache expires.
Localization
All dashboard labels are fully translated in all 11 supported locales (English, Arabic, German, Spanish, French, Indonesian, Italian, Japanese, Polish, Portuguese, Turkish).
Related Topics
- SaaS Setup Guide — End-to-end SaaS enablement walkthrough
- Billing Configuration — Configure manual or Stripe billing
- Partner Permissions & Limits — Control feature access per partner
- Health Center — System diagnostics and billing provider status
- Administration Overview — Full admin capabilities