๐ฌ Simulate:
UC-LMS.04 harness ยท 4 scenarios
Manage Cohort
Manage cohorts across your courses โ create, edit, and delete cohorts for cohort-mode courses
SCR-LMS.16 ยท UC-LMS.04
3 Cohorts
1 Active
| Course / Cohort | Start Date | End Date | Learners | Status | Forum | Approval | |
|---|---|---|---|---|---|---|---|
|
P
Batch 1/2024
Introduction to Python Programming
|
1 Jun 2024 | 31 Aug 2024 | 25 | active | Forum | Approval | Edit |
|
P
Batch 2/2024
Introduction to Python Programming
|
1 Oct 2024 | 31 Dec 2024 | 0 | unpublished | โ | โ | Edit |
|
D
Batch 1/2024
Modern Digital Marketing
|
1 Jan 2025 | 31 Mar 2025 | 18 | closed | Forum | Approval | Edit |
Uses sub-flows:
Screen Flow (from flow.puml):
โ Create Cohort / Edit (AF-2A) โ Cohort Editor
โ Self-pace auto-cohort (AF-1A) โ self (read-only)
โ [*] Exit
๐ Spec notes โ UC-LMS.04 / SCR-LMS.16 (fields, actions, requirements)
Identity
- Screen: SCR-LMS.16 โ Manage Cohort List
- Use case: UC-LMS.04 โ Manage Cohort
Brief description
Cohort list page used by instructors to manage group-based learning cohorts across all of their courses. A course search field at the top filters the table to a selected course. The top has a Create Cohort button (scoped to the selected course); each row has Edit and Delete buttons.
Fields
filter_course_id"Search Course" โ text (autocomplete) ยท default="" ยท alwayscourse_name"Course" โ text ยท always visible ยท read-onlycohort_name"Cohort Name" โ text ยท always ยท read-onlystart_date"Start Date" โ date ยท always ยท read-onlyend_date"End Date" โ date ยท always ยท read-onlymember_count"Enrollment Count" โ computed ยท always ยท read-onlystatus"Status" โ enum [draft, active, closed, unpublished] ยท always ยท read-onlyhas_forum_indicator"Forum" โ boolean ยท always ยท read-onlyrequire_approval_indicator"Require Approval" โ boolean ยท always ยท read-only in all cases (only a Super Admin may change it for a self-paced auto-cohort)
Actions
create_cohort"Create Cohort" โ enabled when filter_course_id != '' AND Course.access_mode == cohort ยท triggers UC-LMS.04-M-2edit_cohort"Edit" โ enabled when Course.access_mode == cohort ยท triggers UC-LMS.04-A-2A-1delete_cohort"Delete" โ enabled when Course.access_mode == cohort ยท triggers UC-LMS.04-A-2B-1 โ opens SCR-LMS.18 dialog
Additional requirements
- When the user changes filter_course_id the table reloads automatically; if no course is selected, cohorts from all courses are shown and the "Course" column always shows the course title per row.
- Self-pace mode โ Create / Edit / Delete buttons are all disabled (not hidden), and Require Approval is shown read-only (defaults off; only a Super Admin may change it) + note "Managed automatically by the system".
- After redirect back from a successful save (SCR-LMS.17) or delete (SCR-LMS.18), the system shows a success toast that auto-dismisses after 3 seconds.
โณ Embedded dialog: SCR-LMS.18 โ Cohort Delete Confirmation Dialog
Brief: Dialog to confirm cohort deletion. Checks active_member_count first: if > 0 โ block; if = 0 โ enable confirm button (soft delete).
Fields
cohort_nameโ text ยท read-onlyactive_member_countโ computed ยท read-onlyblock_messageโ visible when active_member_count > 0 ยท read-only
Actions
confirm_delete"Confirm Delete" โ enabled when active_member_count == 0 ยท triggers UC-LMS.04-A-2B-3cancel"Cancel" โ always ยท dismiss dialog