Manage Cohort › Cohort List
๐ŸŽฌ 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

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="" ยท always
  • course_name "Course" โ€” text ยท always visible ยท read-only
  • cohort_name "Cohort Name" โ€” text ยท always ยท read-only
  • start_date "Start Date" โ€” date ยท always ยท read-only
  • end_date "End Date" โ€” date ยท always ยท read-only
  • member_count "Enrollment Count" โ€” computed ยท always ยท read-only
  • status "Status" โ€” enum [draft, active, closed, unpublished] ยท always ยท read-only
  • has_forum_indicator "Forum" โ€” boolean ยท always ยท read-only
  • require_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-2
  • edit_cohort "Edit" โ€” enabled when Course.access_mode == cohort ยท triggers UC-LMS.04-A-2A-1
  • delete_cohort "Delete" โ€” enabled when Course.access_mode == cohort ยท triggers UC-LMS.04-A-2B-1 โ†’ opens SCR-LMS.18 dialog
Additional requirements
  1. 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.
  2. 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".
  3. 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-only
  • active_member_count โ€” computed ยท read-only
  • block_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-3
  • cancel "Cancel" โ€” always ยท dismiss dialog