Platform Summary Dashboard
🎬 Simulate:

Platform Summary Dashboard

Date range:
User Summary
847
Total Users
692
Students
48
Instructors
62
Program Admins
5
Super Admins
8
Tag Admins
32
Sale Admins
Platform Entities
12
Institutions
38
Faculties
124
Study Programs (Majors)
Student Status
Learner Type Active Inactive Subtotal
TVET 415 83 498
External 172 22 194
Total 587 105 692

Screen Flow (UC-ANL.07):

→ exit → [*]
📝 Spec notes — UC-ANL.07 / SCR-ANL.18 (fields, actions, requirements)
Identity
  • Screen: SCR-ANL.18 — Platform Summary Dashboard
  • Use case: UC-ANL.07 — View Platform Summary Dashboard
Brief description

The Platform Summary Dashboard gives Super Administrator a real-time platform-wide overview on a single page. Four sections present KPI data: (1) User Summary — total registered users with per-role breakdown; (2) Platform Entities — counts of active institutions, faculties, and study programs (majors); (3) Student Status — 2×2 cross-table of learner type (TVET / External) × account status (Active / Inactive). An optional date range filter narrows date-sensitive figures. An Export button opens the shared Export Dialog (SCR-ANL.17) for CSV/Excel/PDF download. All data is read-only.

Regions
  • Filter Bar — date_from / date_to inputs + Apply button
  • User Summary — total_users KPI + per-role breakdown
  • Platform Entities — institutions / faculties / majors KPI cards
  • Student Status — 2×2 cross-table (TVET/External × Active/Inactive)
Fields
  • date_from "From" — date · optional · Filter Bar · editable
  • date_to "To" — date · optional · Filter Bar · editable · validation: date_to ≥ date_from when both set
  • total_users "Total Users" — number · computed · User Summary · read-only
  • users_students "Students" — number · computed · User Summary · read-only
  • users_instructors "Instructors" — number · computed · User Summary · read-only
  • users_program_admins "Program Administrators" — number · computed · User Summary · read-only
  • users_super_admins "Super Administrators" — number · computed · User Summary · read-only
  • users_tag_admins "Tag Admins" — number · computed · User Summary · read-only
  • users_sale_admins "Sale Admins" — number · computed · User Summary · read-only
  • total_institutions "Institutions" — number · computed · Platform Entities · read-only (not date-filtered)
  • total_faculties "Faculties" — number · computed · Platform Entities · read-only (not date-filtered)
  • total_majors "Study Programs (Majors)" — number · computed · Platform Entities · read-only (not date-filtered)
  • students_tvet_active "TVET — Active" — number · computed · Student Status · read-only
  • students_tvet_inactive "TVET — Inactive" — number · computed · Student Status · read-only
  • students_external_active "External — Active" — number · computed · Student Status · read-only
  • students_external_inactive "External — Inactive" — number · computed · Student Status · read-only
Actions
  • apply_filter "Apply" — always enabled · triggers UC-ANL.07-M-2
  • export "Export" — always enabled · triggers UC-ANL.07-A-3B-1 · opens the Export Dialog (SCR-ANL.17)
Additional requirements
  1. All KPI figures must refresh within 5 minutes of underlying data changes (user registration, institution/faculty/major configuration, student status update). [refs: SS-ANL.02]
  2. Computation rules: Total Users = all registered accounts (excludes deleted/disabled) broken down by role; Institutions / Faculties / Majors = counts of active records (not date-filtered); Student Status = 2×2 cross-table (TVET/External × Active/Inactive). [refs: —]
  3. Export supports 3 formats (CSV, Excel, PDF) via the shared Export Dialog. Execution path (immediate download vs. background generation with notification) is determined by the estimated row count of the output. [refs: SS-ANL.03]
  4. Every export is audited, covering 5 event types (requested / generation complete / downloaded / generation failed / rejected). [refs: SS-ANL.06]
Scenario notes
  • AF-1A "Platform has no user or institution data yet" — all KPI values display as 0; empty-state prompt shown.
  • AF-3A "Selected date range has no matching activity" — date-sensitive KPIs (User Summary, Student Status) display 0 for the selected period; Platform Entities (Institutions, Faculties, Majors) retain their actual current-state values.
  • AF-3B "Super Administrator selects Export from the dashboard" — clicking Export opens the Export Dialog (SCR-ANL.17); auto-opened when this scenario is selected.
↳ Embedded dialog: SCR-ANL.17 — Export Dialog
Brief description: Shared modal dialog used by every report screen that supports export (Institution Aggregated Report, Institution Detail, Platform Summary Dashboard). Shows a scope summary, lets the user pick a format (CSV/Excel/PDF), and confirms to generate and download.
Fields:
  • scope_summary "What will be exported" — text · computed · read-only
  • format "Format" — enum (csv/excel/pdf) · required · default: csv
Actions:
  • generate "Generate & Download" — always enabled · triggers UC-ANL.07-A-3B-3 (also shared by UC-ANL.06-A-3A-3, UC-ANL.06-A-5C-3)
  • cancel "Cancel" — always enabled · no UC step (dismisses dialog)
Additional requirements:
  1. When the requested export is estimated to take longer than a few seconds, the dialog shows an in-progress indicator instead of an immediate download link. [refs: SS-ANL.03]