Admin Spec — Content

Content

Domain 4 of the Enhanced Candidate A navigation structure. Contains: Video Lessons, Resources, Recordings, Tutorials, MCQ Questions, Quizzes. All 6 screens are existing screens relocated from the Program section. No new screens in this domain. Key change: Integration with Semester Hub > Setup Checklist (deep links with semester pre-filtering, "Return to Checklist" affordance)

1. Domain Overview

Content groups all passive learning materials that students consume. These screens were previously under "Program" alongside submissions and live sessions. In Enhanced Candidate A, submissions moved to Student Management (student activity) and live sessions moved to Scheduling (time-based events), leaving Content as a clean domain for curriculum materials.

Sidebar items:

Content
  Video Lessons                    <- from Program
  Resources                        <- from Program
  Recordings                       <- from Program
  Tutorials                        <- from Program
  MCQ Questions                    <- from Program
  Quizzes                          <- from Program

Key enhancement: All 6 content screens now support semester pre-filtering when accessed from the Setup Checklist. When the admin clicks "Configure -->" on a checklist item, the content screen opens pre-filtered to the relevant semester and level, with a "Return to Setup Checklist" banner at the top (see 01-global-patterns.md Section 4.2 for filter bar pattern; 04-semester-management.md Section 3.6 for the full Setup Checklist specification including deep link mechanics and return affordance).

What this spec covers: Because all 6 screens already exist and their core CRUD behavior is unchanged, this spec focuses on what changed -- new location, Setup Checklist integration, and role visibility adjustments. It does not repeat full field-by-field breakdowns of existing forms and tables.

Data tables referenced: lessonsnew, resources, recordings, tutorials, mcqquestion, quiz

Transition Hint

Per 01-global-patterns.md Section 6.4, all 6 content screens show "Formerly under Program" for the first 30 days after launch.

2. Screen: Video Lessons

2.1 Purpose

Manage video curriculum. Core content type -- the primary learning material students interact with. Relocated from Program > Video Lessons.

2.2 Entry Points

2.3 Layout

Filter bar + data table + pagination. Uses standard patterns from 01-global-patterns.md Sections 4.1 and 4.2.

2.4 Key Changes from Current

2.5 Existing Capabilities (preserved)

2.6 Actions

All existing CRUD actions preserved. No new actions. Admin only for create/edit/delete.

2.7 Role Visibility

3. Screen: Resources

3.1 Purpose

Manage downloadable materials (PDFs, documents) per level. Relocated from Program > Resources.

3.2 Entry Points

3.3 Layout

Filter bar + data table + pagination. Standard patterns.

3.4 Key Changes from Current

3.5 Existing Capabilities (preserved)

3.6 Actions

All existing CRUD actions preserved. Admin only for create/edit/delete.

3.7 Role Visibility

4. Screen: Recordings

4.1 Purpose

Store recorded live session replays for students who missed sessions. Relocated from Program > Recordings.

4.2 Entry Points

4.3 Layout

Filter bar + data table + pagination. Standard patterns.

4.4 Key Changes from Current

4.5 Existing Capabilities (preserved)

4.6 Actions

All existing CRUD actions preserved. Admin only for create/edit/delete.

4.7 Role Visibility

5. Screen: Tutorials

5.1 Purpose

Manage supplementary PDF-based learning materials. Relocated from Program > Tutorials.

5.2 Entry Points

5.3 Layout

Filter bar + data table + pagination. Standard patterns.

5.4 Key Changes from Current

5.5 Existing Capabilities (preserved)

5.6 Actions

All existing CRUD actions preserved. Admin only for create/edit/delete.

5.7 Role Visibility

6. Screen: MCQ Questions

6.1 Purpose

Build the question bank for quizzes. Individual multiple-choice questions that are assembled into quizzes (Section 7). Relocated from Program > MCQ Questions.

6.2 Entry Points

6.3 Layout

Filter bar + data table + pagination. Standard patterns.

6.4 Key Changes from Current

6.5 Existing Capabilities (preserved)

6.6 Actions

All existing CRUD actions preserved. Admin only for create/edit/delete.

6.7 Role Visibility

7. Screen: Quizzes

7.1 Purpose

Create assessments from the MCQ question bank (Section 6). Relocated from Program > Quizzes.

7.2 Entry Points

7.3 Layout

Filter bar + data table + pagination. Standard patterns.

7.4 Key Changes from Current

7.5 Existing Capabilities (preserved)

7.6 Actions

All existing CRUD actions preserved. Admin only for create/edit/delete.

7.7 Role Visibility

8. Setup Checklist Integration (Cross-Domain Pattern)

All 6 content screens share this integration pattern with the Semester Hub > Setup Checklist (fully specified in 04-semester-management.md Section 3.6). Summarized here for implementer reference.

8.1 Deep Link

Checklist item "Configure -->" navigates to the content screen with URL parameters:

/content/video-lessons?semester={id}&level={id}&from=checklist

8.2 Pre-Filtering

Semester and level dropdown filters auto-populate from URL parameters on page load. The admin can change the filters after landing -- this does not affect the return behavior.

8.3 Return Banner

When from=checklist is present in the URL, a persistent banner appears at the top of the content screen:

<-- Return to Setup Checklist for [Semester Name]

8.4 Return Behavior

Clicking the banner navigates back to Semester Hub > Setup Checklist tab with scroll position preserved (scroll position stored in session state before navigation). If the admin navigates away via sidebar or breadcrumb instead, the banner context is discarded.

8.5 Checklist Status Update

After content is saved on any content screen, the corresponding checklist item status auto-updates on the next visit to the Setup Checklist tab. Status is computed dynamically by querying actual content counts (e.g., count of lessonsnew where semester_id and level_tag_id match), not stored as a separate flag.

8.6 Which Screens Support Level Pre-Filtering

Screen Semester Filter Level Filter Reason
Video Lessons Yes Yes Content is level-scoped
Resources Yes Yes Content is level-scoped
Recordings Yes No Recordings are not level-scoped in the checklist
Tutorials Yes Yes Content is level-scoped
MCQ Questions Yes Yes Content is level-scoped
Quizzes Yes Yes Content is level-scoped

9. Cross-Domain References

From To Mechanism
Semester Hub > Setup Checklist All 6 Content screens "Configure -->" deep links with ?semester={id}&level={id}&from=checklist
All 6 Content screens Semester Hub > Setup Checklist "Return to Setup Checklist" banner (when ?from=checklist present)
Dashboard Content screens (indirect) Phase prompt --> Semester Hub > Setup Checklist --> Content deep links
TA sidebar Content > Recordings Direct sidebar link (TA view only)