👑 Super Admin Dashboard APIs

Platform-wide oversight and administrative control endpoints

Overview API Inventory Endpoints Frontend Mapping Scalability → Admin Dashboard → Architecture

Executive Summary

The Super Admin Dashboard provides platform-wide visibility and control across all organizations. These APIs are restricted to users with the SuperAdmin role and provide access to aggregated platform data, global KPIs, and administrative functions.

✅ Platform Overview
Total orgs, users, devices, sessions across entire platform
✅ Global Analytics
Aggregated usage trends, top organizations, platform health
⚠️ Unbounded Queries
No pagination limits on some aggregation endpoints
🎯 Scalability Note
Current: ~1000 orgs. Needs optimization for 10K+ orgs

📊 API Inventory

Controller Route Endpoints Authorization Rate Limit
SuperAdminDashboardController /api/superadmindashboard 1 SuperAdmin only 60/min
AdminDashboardController /api/admindashboard 8 SuperAdmin+Admin 60/min
AdminAnalyticsController /api/adminanalytics 4 SuperAdmin+Admin 60/min
AdminOrganizationController /api/adminorganization 12 SuperAdmin+Admin 60/min
SystemObservabilityController /api/systemobservability 10+ SuperAdmin only 60/min

🔌 Key Endpoints

Platform Overview

GET /api/superadmindashboard
GET /api/superadmindashboard

Returns platform-wide summary including total organizations, users, devices, AI sessions, and aggregate usage time.

SuperAdmin only Existing

GET /api/admindashboard
GET /api/admindashboard

Dashboard summary scoped to organization for Admin, or all organizations for SuperAdmin.

SuperAdmin+Admin Existing

Metrics & Trends

GET /api/admindashboard/metrics
GET /api/admindashboard/metrics?fromDate=...&toDate=...

Detailed metrics including AI usage percentage, productivity scores, session counts, and trends.

SuperAdmin+Admin Existing

GET /api/admindashboard/trends
GET /api/admindashboard/trends

Time-series trend data for dashboard visualization (daily, weekly, monthly aggregations).

SuperAdmin+Admin Existing

Top Organizations & Users

GET /api/admindashboard/top-organizations
GET /api/admindashboard/top-organizations?limit=10

Returns top organizations by AI usage count. SuperAdmin sees all orgs; Admin sees their org only.

SuperAdmin+Admin Existing

GET /api/admindashboard/top-users
GET /api/admindashboard/top-users?organizationId=...&limit=10

Returns top users by AI usage within an organization or across platform.

SuperAdmin+Admin Existing

🅰️ Frontend Integration

Widget/Feature Angular Component API Endpoint Service Status
Platform Overview Card home.component.ts /api/superadmindashboard DashboardService Integrated
Organization KPIs home.component.ts /api/admindashboard DashboardService Integrated
AI Usage % home.component.ts /api/admindashboard/metrics DashboardService Integrated
Top Organizations home.component.ts /api/admindashboard/top-organizations DashboardService Integrated
Usage Trends Chart home.component.ts /api/admindashboard/trends DashboardService Integrated

📈 Scalability Considerations

✗
Unbounded Aggregations
SuperAdmin queries aggregate across all organizations without pagination limits. At scale (10K+ orgs), this may cause timeouts.
⚠
No Caching Layer
Dashboard KPIs re-queried on each request. Platform-wide metrics should be cached (Redis) with 5-15 minute TTL.
⚠
N+1 Query Risk
Some endpoints may trigger multiple queries per organization. Consider pre-aggregated summary tables.
✓
Proper Authorization
SuperAdmin endpoints correctly restricted with [Authorize(Roles="SuperAdmin")] attribute.
🔗 Cross-Cutting Concerns
▼

Security

  • ✓ JWT authentication required
  • ✓ Role-based authorization (SuperAdmin only)
  • ✓ Audit logging for all admin actions
  • ⚠ Consider rate limiting per SuperAdmin user

Database Dependencies

  • ✓ Organizations table
  • ✓ Users table
  • ✓ Sessions table
  • ✓ Devices table
  • ⚠ SessionDailySummary (underutilized)

Related Pages

→ Platform Analytics → Organization Management → Scalability Review → Performance Analysis