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