mirror of
https://github.com/deunix-educ/aventuriers-des-mots.git
synced 2026-10-13 02:11:58 +02:00
Denis Defolie
2fe455f5d1
scripts/correction/: AnswerValidator (multiple choice, sentence correction via tap-the-faulty-word + retype) and DictationAnalyzer build the CorrectionResult structure from cahier des charges §6. Dictation analysis aligns words with WordAligner (Wagner-Fischer edit distance) before any character comparison, so an omitted or added word doesn't cascade into false errors on every following word. TextNormalizer handles non-breaking spaces, typographic apostrophes, and decomposed-vs-composed French accented characters via an explicit table (GDScript has no built-in NFC/NFD normalization). Error classification follows the data annotations only (rule_id present -> grammatical, absent -> unclassified), never a runtime linguistic guess. scripts/pedagogy/: DifficultyManager (per-skill difficulty from recent results), AttemptFlow (3-attempt graduated aid: hint, then explanation, then reveal, matching exercise-lifecycle.md's second gap), and ReviewScheduler (the five mastery states from §9, with session-counted spaced review intervals [1, 3, 6, 12] rather than wall-clock dates, since a family device's clock isn't trustworthy). All of it is pure: no scene tree, no clock or RNG read directly, every effectful input (session number, attempt outcome) is a parameter. 65 headless tests across both layers, including the word-omission-doesn't-cascade regression and the full decouverte -> acquise -> a_reviser -> acquise path. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
27 lines
993 B
GDScript
27 lines
993 B
GDScript
class_name AttemptFlow
|
|
extends RefCounted
|
|
## Aide graduee sur les tentatives successives d'un meme exercice, tant que la
|
|
## reponse est fausse (docs/specs/decisions.md point 7 ; exercise-lifecycle.md,
|
|
## ecart 2). Code pur.
|
|
|
|
enum SupportLevel { HINT, EXPLANATION, REVEAL }
|
|
|
|
const MAX_ATTEMPTS := 3
|
|
|
|
|
|
## attempt_number : numero de la tentative fautive en cours (1 pour la
|
|
## premiere erreur sur cet exercice, 2 pour la deuxieme, etc.).
|
|
static func support_level_for_attempt(attempt_number: int) -> SupportLevel:
|
|
if attempt_number <= 1:
|
|
return SupportLevel.HINT
|
|
if attempt_number < MAX_ATTEMPTS:
|
|
return SupportLevel.EXPLANATION
|
|
return SupportLevel.REVEAL
|
|
|
|
|
|
## Vrai quand la tentative fautive courante doit mettre fin a l'exercice (la
|
|
## reponse corrigee est alors montree, sans sanction, et la competence est
|
|
## marquee pour une revision avec d'autres exemples).
|
|
static func should_end_exercise(attempt_number: int) -> bool:
|
|
return attempt_number >= MAX_ATTEMPTS
|