frontend-app-gradebook/documentation/testing/test-setup.md

Test Setup

Instructions for setting up environments and data for testing Gradebook.

Set up a course with graded content

A course with graded content is the first prerequisite to testing. Use an existing course (e.g. the DemoX Demonstration Course in Devstack) or see Building and Running an edX Course > Developing Your Course for notes on how to develop a course from scratch.

Notably, the course needs a grading policy and subsections with scoreable content. After creating subsections with content, they need to be configured with an "Assignment Type" to be included in grading.

Suggested resources:

• Establishing a Grading Policy For Your Course
• Adding Exercises and Tools
• Set the Assignment Type and Due Date for a Subsection

Enable Gradebook and feature toggles for course

See README.md #Quickstart for more detailed instructions.

As an admin user, visit Django Admin ({lms-url}/admin) to modify features.

• In Grades > Persistent Grades Enabled flag, click "Add persistent grades enabled flag"
  • Enable the flag globally or for the course and click "Save"
• In Django-Waffle > Switches, click "Add switch"
  • Set name to grades.assume_zero_grade_if_absent, select "Active", and click "Save"
• In Waffle_Utils > Waffle flag course overrides:
  • Add a new flag called grades.writeable_gradebook, select "Force On", and enable it for your course
  • Add a new flag called grades.bulk_management, select "Force On", and enable it for your course

Create a Master's track for testing Master's-only features

source

Add a Master's track in your course:

• As an admin user, go to Django Admin ({lms-url}/admin) > Course Modes and add a new course mode
• Set the Mode to "Master's"
• Set any valid price and currency values
• Click "Save"

Enroll a student in the Master's track:

• As a staff/admin user, go to {lms-url}/support/enrollment
• Search for the username or email of student to enroll
• In the results table row matching the user/course, click the "Change Enrollment" button
• Select the "Master's" enrollment mode and click "Submit enrollment change"

Setup different types of students in course

To fully test features the course should have at least:

• An audit-track student
• A master's-track student
• A staff member
• A non-staff user