Gamification: Quiz XP — 5 XP on first quiz pass

[ljm20088]

Parent PRD

#41

What to build

Award XP for quizzes. End-to-end: when a student passes a quiz for the first time, a 5 XP event is recorded; retaking or re-passing the same quiz awards nothing further.

• Extend quizScoringService.computeResult to record a 5 XP quiz_pass event as a side effect when the attempt passes AND no prior quiz_pass XP event exists for that quiz/user. See PRD "XP Awards" and user story 15.
• Reuse the xp_events table and award/dedup helper from the XP foundation slice.

Acceptance criteria

• Passing a quiz for the first time records exactly one 5 XP event
• Failing a quiz records no XP
• Re-passing or retaking an already-passed quiz records no additional XP
• Total XP / level (sidebar) reflect quiz XP
• Tests cover first-pass award, no-XP-on-fail, and no-XP-on-retake
• pnpm test and typecheck pass

Blocked by

• Blocked by Gamification: XP foundation — earn XP on lesson completion + level in sidebar #77

User stories addressed

• User story 2
• User story 15

[DataRalf]

Completed in commit 8ca4c78 on main

What changed

• Route wiring: submit-quiz action in courses.$slug.lessons.$lessonId.tsx now calls awardXp({ userId, amount: 5, sourceType: "quiz_pass", sourceId: quizId }) when a quiz attempt passes. The existing dedup in xpService (unique on userId + sourceType + sourceId) prevents double-award on retake.
• No service changes needed: the awardXp function from Gamification: XP foundation — earn XP on lesson completion + level in sidebar #77 already handles idempotent XP recording; failing quizzes simply don't trigger the call.

Tests

5 new tests in app/services/quizXp.test.ts:

• First-pass awards 5 XP
• Repeat-pass does not award additional XP (dedup)
• Failed quiz awards no XP
• Different quizzes award independently
• Quiz XP accumulates with lesson XP

All 392 tests passing, typecheck clean.

Acceptance criteria — all met

• Passing a quiz for the first time records a 5 XP event
• Re-passing or retaking the same quiz awards no additional XP
• Failing a quiz awards no XP
• Total XP / level (sidebar) reflect quiz XP
• Tests cover first-pass award, no-XP-on-fail, and no-XP-on-retake
• pnpm test and typecheck pass

[DataRalf]

Completed in commit 8ca4c78 on main

What changed

• Route wiring: submit-quiz action in courses.$slug.lessons.$lessonId.tsx now calls awardXp({ userId, amount: 5, sourceType: "quiz_pass", sourceId: quizId }) when a quiz attempt passes. The existing dedup in xpService (unique on userId + sourceType + sourceId) prevents double-award on retake.
• No service changes needed: the awardXp function from Gamification: XP foundation — earn XP on lesson completion + level in sidebar #77 already handles idempotent XP recording; failing quizzes simply don't trigger the call.

Tests

5 new tests in app/services/quizXp.test.ts:

• First-pass awards 5 XP
• Repeat-pass does not award additional XP (dedup)
• Failed quiz awards no XP
• Different quizzes award independently
• Quiz XP accumulates with lesson XP

All 392 tests passing, typecheck clean.

Acceptance criteria — all met

• Passing a quiz for the first time records a 5 XP event
• Re-passing or retaking the same quiz awards no additional XP
• Failing a quiz awards no XP
• Total XP / level (sidebar) reflect quiz XP
• Tests cover first-pass award, no-XP-on-fail, and no-XP-on-retake
• pnpm test and typecheck pass