# exercise-tests Specification

## Purpose
Two mixed practice tests per real test (with no time limit) that train the student under test conditions and aim at their weak skills, retakeable until they are good.

## Requirements

### Requirement: Created by the app
When a teacher sets a test, the app SHALL create 2 exercise tests for every student of the class and place them on the student's countdown.

#### Scenario: New test
- **WHEN** a teacher sets a test for a class of 25
- **THEN** each of the 25 students has exercise test 1 and exercise test 2 on their countdown

### Requirement: Like the real test
An exercise test SHALL have the real test's number of questions, mix questions from all the covered lessons, hide skill names, and give feedback only at the end. It SHALL have no time limit: only the simulation is timed.

#### Scenario: During the test
- **WHEN** a student answers a question in an exercise test
- **THEN** no right or wrong is shown until the test ends

#### Scenario: No timer
- **WHEN** a student starts an exercise test of a real test set for 30 minutes
- **THEN** it shows no timer and stays open until the student hands it in

### Requirement: Question mix
Exercise test 1 SHALL draw 60% of its questions from weak skills and 40% from other covered skills; exercise test 2 SHALL draw 30% and 70%. A weak skill is one in the learning state or answered wrong in an earlier exercise test. Not-started skills MUST NOT appear; they are listed as "practice these first". Missing weak questions are filled from other covered skills.

#### Scenario: Few weak skills
- **WHEN** exercise test 1 needs 7 weak questions and the student has weak skills for only 3
- **THEN** the other 9 questions come from other covered skills

#### Scenario: Not started
- **WHEN** a covered skill is not started
- **THEN** it has no question in the test and is listed under "practice these first"

### Requirement: Retakes
The student SHALL be able to start or retake an exercise test at any time. Each retake SHALL draw new questions; the best grade counts.

#### Scenario: Retake
- **WHEN** a student retakes exercise test 2
- **THEN** it has new questions, and their best grade of the two attempts counts

### Requirement: Result links back
After an exercise test the student SHALL see their grade and the weak skills found, each linked to its star on the path. The correct answers MUST NOT be shown.

#### Scenario: Result
- **WHEN** a student finishes an exercise test with mistakes in two skills
- **THEN** the result lists those two skills with links to their stars