Global Zone › User Management › Learners
๐ŸŽฌ Simulate:

Learner List (Admin)

Search and Filter
Learner List 5 learners
Full name Email Account status
Souphavanh Keomanivong soupha.keo@gmail.com Active
Phounepheth Chanthavisouk phounepheth.c@nula.edu.la Active
Khamphone Sisavath khamphone.s@example.com Suspended
Viengsavanh Bounthong vieng.b@champassak.edu.la Active
Daovone Phommasack daovone.p@yahoo.com Revoked
๐Ÿ“ Spec notes โ€” UC-IDP.12 / SCR-IDP.33 (fields, actions, requirements)
Identity
  • Screen: SCR-IDP.33 โ€” Learner List (Admin)
  • Use case: UC-IDP.12 โ€” Manage Learner Profile & Access
Brief description

Learner list page for Super Administrators โ€” shows all learners in the system. Admins can search and filter the list by name/email/phone, institute, account status, and registration date range, then click a learner row to view or manage their profile on the Learner Detail page (SCR-IDP.34). The table displays: full name, email, account status. If there are no learners in scope or a search returns no results, the system displays an empty state with a context-appropriate hint.

Fields
  • keyword "Search by name / email / phone" โ€” text ยท optional ยท always visible
  • filter_institute "Institution" โ€” enum (all | โ€ฆ) ยท default: all ยท always
  • filter_status "Account status" โ€” enum (all | active | suspended | revoked) ยท default: all ยท always
  • filter_registered_from "Registered from" โ€” date ยท optional ยท always
  • filter_registered_to "To date" โ€” date ยท optional ยท always
  • col_fullname "Full name" โ€” computed (User.firstname + " " + User.lastname) ยท read-only ยท always
  • col_email "Email" โ€” text ยท read-only ยท always
  • col_status "Account status" โ€” enum (active | suspended | revoked) ยท read-only ยท always
  • empty_message "Empty state message" โ€” computed ยท visible when list_count == 0
Actions
  • select_learner "(Click a learner row)" โ€” enabled when list_count > 0 ยท triggers UC-IDP.12-M-4
  • search "Search" โ€” always enabled
  • clear_filters "Clear filters" โ€” enabled when any_filter_active
Additional requirements
  1. Super Administrator sees all learners system-wide. The institute filter is available to narrow results to learners affiliated with a specific institute. Requests for data outside the Super Administrator's scope are denied server-side.
  2. Empty state has 2 variants: (a) No learners in scope (no active filters) โ†’ "No learners in scope yet"; (b) Filter/search returns no results โ†’ "No learners match the specified criteria" + clear_filters enabled.
  3. If filter_registered_to < filter_registered_from โ†’ inline validation error "End date must not be earlier than start date"; do not send the request until the date range is valid.
๐Ÿ“ Reviewer notes (overlay)

Action overrides: Learners tab must NOT have an Import button. SCR-IDP.33 spec defines no import action of any kind (select_learner, search, clear_filters only) โ€” there is no import_learner action. Do not add any import/upload button to the Learner list.

Source: Prototype/screen-notes/manage-learner-profile-access/index.md โ€” applied as override layer at generation time