# 2. Exam Results & Analytics — Test Cases

User Type: **Student**
Source: *Mi Digital Academy - Education CRM Features Document*
Spec: exam_results_analytics.md — every feature, sub-feature, and rule covered

---

## Test Execution Policy
- Zero tolerance: any deviation from documented behavior = FAILED = bug
- Every bug is immediately logged/reported (Bug ID, feature, sub-feature, expected vs actual, severity) and fixed 100% before the group passes
- Feature group passes only at 100% test pass rate

## Coverage Matrix
| Feature | Sub-feature / Rule | Test IDs |
|---------|--------------------|----------|
| 2.1 Exam Results View | Overall score and percentage | TC-ST-04-02-001 |
| 2.1 Exam Results View | Pass/fail status against the pass mark | TC-ST-04-02-002 |
| 2.1 Exam Results View | Time taken for the exam | TC-ST-04-02-003 |
| 2.1 Exam Results View | Per-question breakdown (Student answer, correct answer, marks) | TC-ST-04-02-004 |
| 2.1 Exam Results View | Section-wise score summary | TC-ST-04-02-005 |
| 2.1 Exam Results View | Results available immediately (auto-graded) or after grading (short answer) | TC-ST-04-02-006 |
| 2.1 Exam Results View | Retake option where allowed | TC-ST-04-02-007 |
| 2.1 Exam Results View | Results history list of all exams | TC-ST-04-02-008 |
| 2.1 Exam Results View | Results event logging (viewed, retaken) | TC-ST-04-02-009 |
| 2.1 Exam Results View | Audit logging of the exam results view | TC-ST-04-02-010 |
| 2.1 Exam Results View | Rule: The pass/fail status is computed against the configured pass mark. | TC-ST-04-02-001 |
| 2.1 Exam Results View | Rule: Auto-graded questions show results immediately; short-answer questions show results after grading. | TC-ST-04-02-002 |
| 2.1 Exam Results View | Rule: A retake is allowed only where the exam permits it; the attempt count is tracked. | TC-ST-04-02-003 |
| 2.1 Exam Results View | Rule: The per-question breakdown shows the correct answer for learning. | TC-ST-04-02-004 |
| 2.1 Exam Results View | Rule: Results events (viewed, retaken) are logged with the exam and the timestamp. | TC-ST-04-02-005 |
| 2.1 Exam Results View | Rule: The exam results view is audit-logged with the account, the exam, and the timestamp. | TC-ST-04-02-006 |
| 2.2 Performance Analytics | Score trend over time (line chart) | TC-ST-04-02-011 |
| 2.2 Performance Analytics | Subject-wise accuracy | TC-ST-04-02-012 |
| 2.2 Performance Analytics | Topic-wise accuracy (strengths and weaknesses) | TC-ST-04-02-013 |
| 2.2 Performance Analytics | Comparison against target scores | TC-ST-04-02-014 |
| 2.2 Performance Analytics | Average score and best score | TC-ST-04-02-015 |
| 2.2 Performance Analytics | Number of attempts per exam | TC-ST-04-02-016 |
| 2.2 Performance Analytics | Weak-topic identification for focused revision | TC-ST-04-02-017 |
| 2.2 Performance Analytics | Analytics feed the dashboard and AI Study Companion | TC-ST-04-02-018 |
| 2.2 Performance Analytics | Analytics event logging (viewed) | TC-ST-04-02-019 |
| 2.2 Performance Analytics | Audit logging of the performance analytics | TC-ST-04-02-020 |
| 2.2 Performance Analytics | Rule: Analytics are computed from completed, graded exams and assessments. | TC-ST-04-02-011 |
| 2.2 Performance Analytics | Rule: Topic-wise accuracy identifies strengths (above a threshold) and weaknesses (below a threshold). | TC-ST-04-02-012 |
| 2.2 Performance Analytics | Rule: The comparison against targets uses the Student's recorded target scores. | TC-ST-04-02-013 |
| 2.2 Performance Analytics | Rule: Analytics feed the dashboard and the AI Study Companion's recommendations. | TC-ST-04-02-014 |
| 2.2 Performance Analytics | Rule: Analytics views are logged with the timestamp. | TC-ST-04-02-015 |
| 2.2 Performance Analytics | Rule: The performance analytics is audit-logged with the account, the scope, and the timestamp. | TC-ST-04-02-016 |
| 2.3 Answer Review and Explanations | Per-question explanation of the correct answer | TC-ST-04-02-021 |
| 2.3 Answer Review and Explanations | Explanation of why the Student's answer was incorrect | TC-ST-04-02-022 |
| 2.3 Answer Review and Explanations | Reference to the relevant concept/topic | TC-ST-04-02-023 |
| 2.3 Answer Review and Explanations | Link to related learning content (video, article) | TC-ST-04-02-024 |
| 2.3 Answer Review and Explanations | Available for auto-graded questions immediately | TC-ST-04-02-025 |
| 2.3 Answer Review and Explanations | Available for short-answer questions after grading | TC-ST-04-02-026 |
| 2.3 Answer Review and Explanations | Review accessible from the results and the results history | TC-ST-04-02-027 |
| 2.3 Answer Review and Explanations | Review event logging | TC-ST-04-02-028 |
| 2.3 Answer Review and Explanations | Audit logging of the answer review and explanations | TC-ST-04-02-029 |
| 2.3 Answer Review and Explanations | Rule: Explanations are available for auto-graded questions immediately and for short-answer questions after grading. | TC-ST-04-02-021 |
| 2.3 Answer Review and Explanations | Rule: Each explanation references the relevant concept/topic. | TC-ST-04-02-022 |
| 2.3 Answer Review and Explanations | Rule: A link to related learning content is provided where available. | TC-ST-04-02-023 |
| 2.3 Answer Review and Explanations | Rule: Review is accessible from the results page and the results history. | TC-ST-04-02-024 |
| 2.3 Answer Review and Explanations | Rule: Review events are logged with the question and the timestamp. | TC-ST-04-02-025 |
| 2.3 Answer Review and Explanations | Rule: The answer review and explanations is audit-logged with the account, the question, and the timestamp. | TC-ST-04-02-026 |

## 2.1 Exam Results View

### TC-ST-04-02-001 — Overall score and percentage
**Type:** Positive
**Covers:** 2.1 → Overall score and percentage; Rule: The pass/fail status is computed against the configured pass mark.
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Overall score and percentage.
2. Observe the result and verify the full behavior: Overall score and percentage.
**Expected Result:** Overall score and percentage — delivered exactly as documented.
**Priority:** Critical

### TC-ST-04-02-002 — Pass/fail status against the pass mark
**Type:** Positive
**Covers:** 2.1 → Pass/fail status against the pass mark; Rule: Auto-graded questions show results immediately; short-answer questions show results after grading.
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Pass/fail status against the pass mark.
2. Observe the result and verify the full behavior: Pass/fail status against the pass mark.
**Expected Result:** Pass/fail status against the pass mark — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-003 — Time taken for the exam
**Type:** Positive
**Covers:** 2.1 → Time taken for the exam; Rule: A retake is allowed only where the exam permits it; the attempt count is tracked.
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Time taken for the exam.
2. Observe the result and verify the full behavior: Time taken for the exam.
**Expected Result:** Time taken for the exam — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-004 — Per-question breakdown (Student answer, correct answer, marks)
**Type:** Positive
**Covers:** 2.1 → Per-question breakdown (Student answer, correct answer, marks); Rule: The per-question breakdown shows the correct answer for learning.
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Per-question breakdown (Student answer.
2. Observe the result and verify the full behavior: Per-question breakdown (Student answer, correct answer, marks).
**Expected Result:** Per-question breakdown (Student answer, correct answer, marks) — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-005 — Section-wise score summary
**Type:** Positive
**Covers:** 2.1 → Section-wise score summary; Rule: Results events (viewed, retaken) are logged with the exam and the timestamp.
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Section-wise score summary.
2. Observe the result and verify the full behavior: Section-wise score summary.
**Expected Result:** Section-wise score summary — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-006 — Results available immediately (auto-graded) or after grading (short answer)
**Type:** Positive
**Covers:** 2.1 → Results available immediately (auto-graded) or after grading (short answer); Rule: The exam results view is audit-logged with the account, the exam, and the timestamp.
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Results available immediately (auto-graded) or after grading (short answer).
2. Observe the result and verify the full behavior: Results available immediately (auto-graded) or after grading (short answer).
**Expected Result:** Results available immediately (auto-graded) or after grading (short answer) — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-007 — Retake option where allowed
**Type:** Positive
**Covers:** 2.1 → Retake option where allowed
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Retake option where allowed.
2. Observe the result and verify the full behavior: Retake option where allowed.
**Expected Result:** Retake option where allowed — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-008 — Results history list of all exams
**Type:** Positive
**Covers:** 2.1 → Results history list of all exams
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Results history list of all exams.
2. Observe the result and verify the full behavior: Results history list of all exams.
**Expected Result:** Results history list of all exams — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-009 — Results event logging (viewed, retaken)
**Type:** Positive
**Covers:** 2.1 → Results event logging (viewed, retaken)
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Results event logging (viewed.
2. Observe the result and verify the full behavior: Results event logging (viewed, retaken).
**Expected Result:** Results event logging (viewed, retaken) — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-010 — Audit logging of the exam results view
**Type:** Positive
**Covers:** 2.1 → Audit logging of the exam results view
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, perform the action associated with: Audit logging of the exam results view.
2. Open the relevant activity / audit log and verify the event is recorded with the account, the action, and the timestamp.
**Expected Result:** The action is audit-logged — the account, the action, and the timestamp are recorded.
**Priority:** Critical

## 2.2 Performance Analytics

### TC-ST-04-02-011 — Score trend over time (line chart)
**Type:** Positive
**Covers:** 2.2 → Score trend over time (line chart); Rule: Analytics are computed from completed, graded exams and assessments.
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Score trend over time (line chart).
2. Observe the result and verify the full behavior: Score trend over time (line chart).
**Expected Result:** Score trend over time (line chart) — delivered exactly as documented.
**Priority:** Critical

### TC-ST-04-02-012 — Subject-wise accuracy
**Type:** Positive
**Covers:** 2.2 → Subject-wise accuracy; Rule: Topic-wise accuracy identifies strengths (above a threshold) and weaknesses (below a threshold).
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Subject-wise accuracy.
2. Observe the result and verify the full behavior: Subject-wise accuracy.
**Expected Result:** Subject-wise accuracy — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-013 — Topic-wise accuracy (strengths and weaknesses)
**Type:** Edge
**Covers:** 2.2 → Topic-wise accuracy (strengths and weaknesses); Rule: The comparison against targets uses the Student's recorded target scores.
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Topic-wise accuracy (strengths and weaknesses).
2. Observe the result and verify the full behavior: Topic-wise accuracy (strengths and weaknesses).
**Expected Result:** Topic-wise accuracy (strengths and weaknesses) — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-014 — Comparison against target scores
**Type:** Positive
**Covers:** 2.2 → Comparison against target scores; Rule: Analytics feed the dashboard and the AI Study Companion's recommendations.
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Comparison against target scores.
2. Observe the result and verify the full behavior: Comparison against target scores.
**Expected Result:** Comparison against target scores — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-015 — Average score and best score
**Type:** Positive
**Covers:** 2.2 → Average score and best score; Rule: Analytics views are logged with the timestamp.
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Average score and best score.
2. Observe the result and verify the full behavior: Average score and best score.
**Expected Result:** Average score and best score — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-016 — Number of attempts per exam
**Type:** Positive
**Covers:** 2.2 → Number of attempts per exam; Rule: The performance analytics is audit-logged with the account, the scope, and the timestamp.
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Number of attempts per exam.
2. Observe the result and verify the full behavior: Number of attempts per exam.
**Expected Result:** Number of attempts per exam — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-017 — Weak-topic identification for focused revision
**Type:** Edge
**Covers:** 2.2 → Weak-topic identification for focused revision
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Weak-topic identification for focused revision.
2. Observe the result and verify the full behavior: Weak-topic identification for focused revision.
**Expected Result:** Weak-topic identification for focused revision — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-018 — Analytics feed the dashboard and AI Study Companion
**Type:** Positive
**Covers:** 2.2 → Analytics feed the dashboard and AI Study Companion
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Analytics feed the dashboard and AI Study Companion.
2. Observe the result and verify the full behavior: Analytics feed the dashboard and AI Study Companion.
**Expected Result:** Analytics feed the dashboard and AI Study Companion — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-019 — Analytics event logging (viewed)
**Type:** Positive
**Covers:** 2.2 → Analytics event logging (viewed)
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Analytics event logging (viewed).
2. Observe the result and verify the full behavior: Analytics event logging (viewed).
**Expected Result:** Analytics event logging (viewed) — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-020 — Audit logging of the performance analytics
**Type:** Positive
**Covers:** 2.2 → Audit logging of the performance analytics
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, perform the action associated with: Audit logging of the performance analytics.
2. Open the relevant activity / audit log and verify the event is recorded with the account, the action, and the timestamp.
**Expected Result:** The action is audit-logged — the account, the action, and the timestamp are recorded.
**Priority:** Critical

## 2.3 Answer Review and Explanations

### TC-ST-04-02-021 — Per-question explanation of the correct answer
**Type:** Positive
**Covers:** 2.3 → Per-question explanation of the correct answer; Rule: Explanations are available for auto-graded questions immediately and for short-answer questions after grading.
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Per-question explanation of the correct answer.
2. Observe the result and verify the full behavior: Per-question explanation of the correct answer.
**Expected Result:** Per-question explanation of the correct answer — delivered exactly as documented.
**Priority:** Critical

### TC-ST-04-02-022 — Explanation of why the Student's answer was incorrect
**Type:** Positive
**Covers:** 2.3 → Explanation of why the Student's answer was incorrect; Rule: Each explanation references the relevant concept/topic.
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Explanation of why the Student's answer was incorrect.
2. Observe the result and verify the full behavior: Explanation of why the Student's answer was incorrect.
**Expected Result:** Explanation of why the Student's answer was incorrect — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-023 — Reference to the relevant concept/topic
**Type:** Positive
**Covers:** 2.3 → Reference to the relevant concept/topic; Rule: A link to related learning content is provided where available.
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Reference to the relevant concept/topic.
2. Observe the result and verify the full behavior: Reference to the relevant concept/topic.
**Expected Result:** Reference to the relevant concept/topic — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-024 — Link to related learning content (video, article)
**Type:** Positive
**Covers:** 2.3 → Link to related learning content (video, article); Rule: Review is accessible from the results page and the results history.
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Link to related learning content (video.
2. Observe the result and verify the full behavior: Link to related learning content (video, article).
**Expected Result:** Link to related learning content (video, article) — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-025 — Available for auto-graded questions immediately
**Type:** Positive
**Covers:** 2.3 → Available for auto-graded questions immediately; Rule: Review events are logged with the question and the timestamp.
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Available for auto-graded questions immediately.
2. Observe the result and verify the full behavior: Available for auto-graded questions immediately.
**Expected Result:** Available for auto-graded questions immediately — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-026 — Available for short-answer questions after grading
**Type:** Positive
**Covers:** 2.3 → Available for short-answer questions after grading; Rule: The answer review and explanations is audit-logged with the account, the question, and the timestamp.
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Available for short-answer questions after grading.
2. Observe the result and verify the full behavior: Available for short-answer questions after grading.
**Expected Result:** Available for short-answer questions after grading — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-027 — Review accessible from the results and the results history
**Type:** Positive
**Covers:** 2.3 → Review accessible from the results and the results history
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Review accessible from the results and the results history.
2. Observe the result and verify the full behavior: Review accessible from the results and the results history.
**Expected Result:** Review accessible from the results and the results history — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-028 — Review event logging
**Type:** Positive
**Covers:** 2.3 → Review event logging
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, set up the precondition and perform: Review event logging.
2. Observe the result and verify the full behavior: Review event logging.
**Expected Result:** Review event logging — delivered exactly as documented.
**Priority:** High

### TC-ST-04-02-029 — Audit logging of the answer review and explanations
**Type:** Positive
**Covers:** 2.3 → Audit logging of the answer review and explanations
**Preconditions:** A Student account is active and the Student is in the state required for this behavior.
**Steps:**
1. As a Student, perform the action associated with: Audit logging of the answer review and explanations.
2. Open the relevant activity / audit log and verify the event is recorded with the account, the action, and the timestamp.
**Expected Result:** The action is audit-logged — the account, the action, and the timestamp are recorded.
**Priority:** Critical