mathly / openspec /specs /grades /spec.md
wzender's picture
Claude
Only the simulation is timed: lesson quizzes and exercise tests have no time limit (#3)
a1d7d52 unverified
|
Raw History Blame Contribute Delete
1.72 kB
# grades Specification
## Purpose
One grade scale and one rule for timed attempts across quizzes, exercise tests, the simulation and assignments, and the screen where a student sees all their grades.
## Requirements
### Requirement: One grade scale
Every grade SHALL be a whole number from 0 to 100. In a multiple-choice quiz or test every question SHALL be worth the same, and the grade SHALL be the share of right answers, rounded.
#### Scenario: Seven of ten
- **WHEN** a student answers 7 of 10 questions correctly
- **THEN** the grade is 70
#### Scenario: Eight of twelve
- **WHEN** a student answers 8 of 12 questions correctly
- **THEN** the grade is 67
### Requirement: When time ends
The simulation SHALL be the only timed attempt; a lesson quiz and an exercise test have no time limit. When the simulation's timer ends, the server SHALL submit it as it stands, and unanswered questions SHALL count as wrong. Closing or refreshing the app MUST NOT stop or reset the timer.
#### Scenario: Closed the app
- **WHEN** a student closes the app 5 minutes into a 15-minute simulation and opens it 20 minutes later
- **THEN** the simulation has been submitted with the answers given
#### Scenario: A quiz is not timed
- **WHEN** a student closes the app 5 minutes into a lesson quiz and opens it an hour later
- **THEN** the quiz is still open with the answers given
### Requirement: Grades screen
The student SHALL have a grades screen listing every grade they have: each lesson's quiz (best grade), and every exercise test, simulation and assignment grade as those exist.
#### Scenario: After a quiz
- **WHEN** a student finishes a lesson's quiz
- **THEN** the grades screen shows that lesson's best quiz grade