Learner List (Admin)
| Full name | 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 |
Screen Flow (from flow.puml):
๐ Spec notes โ UC-IDP.12 / SCR-IDP.33 (fields, actions, requirements)
- Screen: SCR-IDP.33 โ Learner List (Admin)
- Use case: UC-IDP.12 โ Manage Learner Profile & Access
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.
keyword"Search by name / email / phone" โ text ยท optional ยท always visiblefilter_institute"Institution" โ enum (all | โฆ) ยท default: all ยท alwaysfilter_status"Account status" โ enum (all | active | suspended | revoked) ยท default: all ยท alwaysfilter_registered_from"Registered from" โ date ยท optional ยท alwaysfilter_registered_to"To date" โ date ยท optional ยท alwayscol_fullname"Full name" โ computed (User.firstname + " " + User.lastname) ยท read-only ยท alwayscol_email"Email" โ text ยท read-only ยท alwayscol_status"Account status" โ enum (active | suspended | revoked) ยท read-only ยท alwaysempty_message"Empty state message" โ computed ยท visible when list_count == 0
select_learner"(Click a learner row)" โ enabled when list_count > 0 ยท triggers UC-IDP.12-M-4search"Search" โ always enabledclear_filters"Clear filters" โ enabled when any_filter_active
- 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.
- 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.
- 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.
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.
Prototype/screen-notes/manage-learner-profile-access/index.md โ applied as override layer at generation time