Update README, spec and checklists for CE1-CM2 and tested platforms

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-13 02:11:58 +02:00 · 2026-10-12 17:16:34 +02:00
parent f4c69e1397
commit a82fc8b97b
8 changed files with 17 additions and 13 deletions
@@ -1,8 +1,8 @@
 # Les Aventuriers des mots (The Word Adventurers)
-An educational French-language game for 7-9 year olds (French grades CE1-CE2): an offline 2D adventure with an explorable map, a guide character, and grammar, spelling, and dictation exercises.
+An educational French-language game for 7-11 year olds (French grades CE1 to CM2): an offline 2D adventure with an explorable map, a guide character, and grammar, spelling, and dictation exercises.
-Open source project, in development. Current status: version 0.9.0, playable offline on Linux, Windows, macOS, Android and ChromeOS (macOS, Android and web builds untested on real hardware) — profiles, saves (with export and restore in the adult area), stars and an item collection, sound effects and music, settings (volumes, text size, animations), a progress dashboard for adults, three exercise types (multiple choice, sentence correction, dictation), CE1, CE2, CM1 and CM2 in three boards each (homophones, verbs, word spelling), 111 missions. All pedagogical content is still `draft` (awaiting validation) and dictation voices are placeholders (see `assets/CREDITS.md`; see `docs/specs/decisions.md` for scoping decisions and `docs/specs/cahier-des-charges.md` for the full specification, both in French — this is a French-curriculum product).
+Open source project, in development. Current status: version 0.9.2, playable offline on Linux, Android and in a web browser (hand-tested), with Windows, macOS and ChromeOS exports not yet tested on real hardware — profiles, saves (with export and restore in the adult area), stars and an item collection, sound effects and music, settings (volumes, text size, animations), a progress dashboard for adults, three exercise types (multiple choice, sentence correction, dictation), CE1, CE2, CM1 and CM2 in three boards each (homophones, verbs, word spelling), 111 missions. All pedagogical content is still `draft` (awaiting validation) and dictation voices are placeholders (see `assets/CREDITS.md`; see `docs/specs/decisions.md` for scoping decisions and `docs/specs/cahier-des-charges.md` for the full specification, both in French — this is a French-curriculum product).
 ## Tech stack
@@ -1,8 +1,8 @@
 # Les Aventuriers des mots
-Jeu éducatif de français pour les CE1-CE2 (7-9 ans) : une aventure 2D hors ligne, avec une carte à explorer, un personnage guide, et des exercices de grammaire, d'orthographe et de dictées.
+Jeu éducatif de français du CE1 au CM2 (7-11 ans) : une aventure 2D hors ligne, avec une carte à explorer, un personnage guide, et des exercices de grammaire, d'orthographe et de dictées.
-Projet open source, en développement. Statut actuel : version 0.9.0, jouable hors ligne sur Linux, Windows, macOS, Android et ChromeOS (versions macOS, Android et web non testées sur matériel) — profils, sauvegardes (avec export et restauration dans l'espace adulte), étoiles et collection d'objets, sons et musique, réglages (volumes, taille du texte, animations), tableau de progrès pour l'adulte, trois types d'exercices (choix multiple, correction de phrase, dictée), CE1, CE2, CM1 et CM2 en trois tableaux chacun (homophones, verbes, orthographe des mots), 111 missions. Contenu pédagogique entièrement en brouillon (`draft`, à valider) et voix des dictées provisoires (voir `assets/CREDITS.md` ; voir `docs/specs/decisions.md` pour les décisions de cadrage et `docs/specs/cahier-des-charges.md` pour la spécification complète).
+Projet open source, en développement. Statut actuel : version 0.9.2, jouable hors ligne sur Linux, Android et dans un navigateur (versions testées à la main), avec des exports Windows, macOS et ChromeOS non encore testés sur matériel — profils, sauvegardes (avec export et restauration dans l'espace adulte), étoiles et collection d'objets, sons et musique, réglages (volumes, taille du texte, animations), tableau de progrès pour l'adulte, trois types d'exercices (choix multiple, correction de phrase, dictée), CE1, CE2, CM1 et CM2 en trois tableaux chacun (homophones, verbes, orthographe des mots), 111 missions. Contenu pédagogique entièrement en brouillon (`draft`, à valider) et voix des dictées provisoires (voir `assets/CREDITS.md` ; voir `docs/specs/decisions.md` pour les décisions de cadrage et `docs/specs/cahier-des-charges.md` pour la spécification complète).
 ## Pile technique
@@ -1,12 +1,12 @@
 Cahier des charges fonctionnel et technique
-Jeu éducatif de français CE1–CE2 — Godot 4 / GDScript
+Jeu éducatif de français CE1 à CM2 — Godot 4 / GDScript
-Jeu éducatif CE1-CE2 sous Godot 4 et GDScript, fondé sur les règles du BLED. Style : aventure 2D avec carte, personnages et missions. Exercices : grammaire, orthographe et dictées. Public : plusieurs profils d'enfants sur appareil familial. Fonctionnement hors ligne : oui. Prévoir architecture modulaire, progression pédagogique CE1/CE2, système de correction explicative, sauvegarde et export Linux, Windows, macOS, Android et iOS.
+Jeu éducatif CE1 à CM2 sous Godot 4 et GDScript, fondé sur les règles du BLED. Style : aventure 2D avec carte, personnages et missions. Exercices : grammaire, orthographe et dictées. Public : plusieurs profils d'enfants sur appareil familial. Fonctionnement hors ligne : oui. Prévoir architecture modulaire, progression pédagogique CE1/CE2, système de correction explicative, sauvegarde et export Linux, Windows, macOS, Android et iOS.
-Direction artistique indicative : un monde de mots, des personnages attachants et une aventure adaptée aux enfants de 7 à 9 ans.
+Direction artistique indicative : un monde de mots, des personnages attachants et une aventure adaptée aux enfants de 7 à 11 ans.
 1. Présentation du projet
 Nom de travail : Les Aventuriers des mots
-L'objectif est de développer un jeu éducatif en 2D permettant aux enfants de CE1 et CE2 d'acquérir, de consolider et d'approfondir les règles de grammaire et d'orthographe françaises, à travers une aventure interactive inspirée de la progression pédagogique du BLED.
+L'objectif est de développer un jeu éducatif en 2D permettant aux enfants de CE1 à CM2 d'acquérir, de consolider et d'approfondir les règles de grammaire et d'orthographe françaises, à travers une aventure interactive inspirée de la progression pédagogique du BLED.
 Le jeu doit combiner trois dimensions :
 - Pédagogique : des règles clairement expliquées, des exercices progressifs, des dictées et des corrections détaillées.
 - Ludique : une carte à explorer, des personnages, des missions, des objets à collectionner et des récompenses.
@@ -14,7 +14,7 @@ Le jeu doit combiner trois dimensions :
 Le jeu ne doit pas être un simple questionnaire habillé d'un décor. La progression dans l'aventure doit donner du sens aux apprentissages, tandis que les mécanismes pédagogiques doivent garantir que l'enfant progresse réellement.
 Fiche d'identité
 Élément	Spécification
-Public cible	CE1 et CE2, environ 7–9 ans
+Public cible	CE1 à CM2, environ 7–11 ans (CM1 et CM2 ajoutés en cours de projet : voir decisions.md, points 38 à 40)
 Moteur	Godot 4.x, version stable retenue au démarrage
 Langage	GDScript typé
 Graphismes	2D, illustrations originales, animations
@@ -436,3 +436,5 @@ Les corrections et les dictées CE1/CE2 n'ont pas révélé d'autre problème ;
 - **Non vérifié** : aucune des trois nouvelles versions n'a été lancée sur un appareil. Le tactile (clavier virtuel Android pour les champs de saisie, taille des boutons), le stockage `user://` et l'audio sur Android/web restent à tester à la main.
 **Son sur la version web (0.9.1)** : Godot 4.6 joue par défaut les sons du web en mode « échantillon » (Web Audio direct), qui ignore les bus créés à l'exécution (Music/Effects) et leurs volumes. Réglage `audio/general/default_playback_type.web = Stream` : le son passe par le moteur audio comme sur bureau. **Non vérifié** : aucun navigateur avec sortie audio dans l'environnement de développement ; à tester à la main (premier clic requis par le navigateur avant tout son).
 **Lancement de la version web (0.9.2)** : `make serve-web` (export puis serveur local sur 127.0.0.1, ouverture du navigateur) et, dans l'archive ChromeOS, `lancer-web.sh` / `lancer-web.bat` / `lancer-web.py`. Retour de test manuel de l'utilisateur : Linux, Android et web fonctionnent ; Windows, macOS et ChromeOS restent à tester. README, cahier des charges (public CE1 à CM2, 7–11 ans) et listes de contrôle mis à jour pour CM1/CM2.
@@ -27,7 +27,7 @@ Tout ce qui suit ne peut pas être vérifié sans écran (rendu, mise en page, a
 - Profil CE1 : la carte « La forêt des accords » propose « Aller : La plage des sons » ; le tableau de la plage s'affiche avec son décor (mer, sable), ses 9 lieux sans chevauchement, et le bouton ramène à la forêt. Après une mission, on revient au tableau d'où l'on vient.
 - Jouer une mission de chaque règle de la plage (s/ss, ç, m devant m-b-p), dont une dictée : voix claire, énoncés sans répétition, indices et explications justes.
 - CE1 : trois tableaux (forêt, plage, montagne) ; CE2 : trois tableaux (marais, désert, île) ; chaque décor est distinct, le bouton « Aller : … » les parcourt en boucle. Jouer au moins une mission de chaque règle nouvelle (être/avoir/-er ; sujet-verbe, é/er, futur ; féminin, g/ge/gu, lettre muette) et vérifier : consigne claire, une seule bonne réponse, indice utile, aucune phrase déjà vue dans la même mission.
- Création de profil : seuls CE1 et CE2 sont proposés (CM1/CM2 n'ont pas encore de contenu).
+- Création de profil : jusqu'à la 0.5, seuls CE1 et CE2 étaient proposés ; voir la ligne suivante pour les quatre niveaux.
 ## CM1, CM2 et sortie du jeu (point 40 de `decisions.md`)
@@ -78,6 +78,8 @@ Tout ce qui suit ne peut pas être vérifié sans écran (rendu, mise en page, a
 ## Plateformes supplémentaires (0.9.0)
 **Testé à la main par l'utilisateur** : Linux, Android et version web (ok). Windows, macOS et ChromeOS restent à tester ; les remarques ci-dessous sont les vérifications structurelles faites avant ce test.
 - `make export-android` : APK structurellement vérifié (paquet, ABI arm64-v8a et x86_64, signature) ; **jamais installé** : à tester sur une tablette, notamment le clavier virtuel dans la dictée et les champs de correction, la taille des boutons au doigt, la sauvegarde et le son.
 - `make export-macos` : archive vérifiée (structure .app, signature ad hoc) ; **jamais lancée** (pas de Mac). Au premier lancement : clic droit > Ouvrir.
 - `make export-web` : fichiers générés ; **jamais ouvert dans un navigateur**. Servir `build/web/` avec `python3 -m http.server`, ouvrir dans Chrome, vérifier son (le navigateur exige un premier clic), sauvegarde et plein écran.
@@ -1,6 +1,6 @@
 class_name AdultGate
 extends RefCounted
-## Petite barriere devant l'espace adulte : un calcul qu'un enfant de CE1-CE2
+## Petite barriere devant l'espace adulte : un calcul qu'un enfant du primaire
 ## ne fait pas facilement de tete (produit d'un nombre a deux chiffres par un
 ## chiffre). Ce n'est pas une protection de securite, seulement un frein
 ## contre un clic par curiosite. Le hasard est injecte, jamais lu ici.
@@ -40,7 +40,7 @@ VOICE_NAME = "fr_FR-siwis-medium"
 VOICE_BASE_URL = "https://huggingface.co/rhasspy/piper-voices/resolve/main/fr/fr_FR/siwis/medium"
 # > 1.0 ralentit legerement le debit (duree des phonemes etiree), plus
-# confortable pour un enfant de 7-9 ans qu'une diction par defaut pensee
+# confortable pour un enfant de 7-11 ans qu'une diction par defaut pensee
 # pour un adulte.
 LENGTH_SCALE = 1.1
@@ -2,7 +2,7 @@ extends SceneTree
 ## Outil de developpement : charge une scene, attend quelques images puis
 ## enregistre le rendu en PNG. Usage (fenetre reelle, pas --headless) :
 ##   godot --path . --resolution 1152x648 -s res://tools/screenshot.gd -- \
-##       res://scenes/world/world_map.tscn out.png [CE1|CE2] [mission_id]
+##       res://scenes/world/world_map.tscn out.png [CE1|CE2|CM1|CM2] [mission_id]
 ## Cree un profil temporaire pour que les scenes qui lisent la progression
 ## fonctionnent, puis le supprime.