Implemente le mini-jeu Memory (retournement de cartes, mode paire/single)
document_engine/labels/memory_config.py (nouveau) : modele de donnees, meme convention resolve_X/sanitize_X que quiz_config.py/ association_config.py - DEFAULT_MEMORY_CONFIG, sanitize_memory_config. Chaque carte a un recto ET un verso, chacun avec image/texte independants et tous deux optionnels ; seul le verso doit avoir au moins l'un des deux non vide (rien a reveler/apparier sinon) - le recto peut rester entierement vide (dos de carte generique "?" par defaut). Liste tronquee a MAX_CARDS=8. Cote serveur, routes/document/document_element_update.py revalide desormais aussi memory avant persistance. Le rendu (_render_memory) affiche un resume reel (nombre de cartes, mode) et, des qu'au moins une carte existe, un plateau de retournement REELEMENT interactif en Mode Apercu (_render_memory_player) : en mode "paire", chaque carte definie est DUPLIQUEE en deux instances partageant le meme card_index (appariement classique) ; en mode "single", une seule instance par carte (simple retournement, sans appariement - "c'est donc un retourner de carte classique plus un jeu memory"). Les instances sont melangees (random.shuffle, documente dans CODE_QUALITY.md) puis embarquees en JSON dans data-memory-config. Cote editeur, le panneau Proprietes propose un bascule segmentee Paire/Simple et une liste de cartes repetable, chaque carte avec ses deux faces (recto/verso) editables independamment (image + texte). Extrait au passage forgeDocEscapeHtml (ex-forgeDocEscapeForTextarea, generalise pour couvrir aussi les attributs) reutilise pour les deux mini-jeux. Le plateau jouable (static/document/js/document-editor.js) est une vraie carte-retournement CSS 3D (perspective/rotateY), contenu de chaque face construit via DOM (textContent/img.src, jamais innerHTML avec le texte du createur - meme precaution que le plateau Association) : bon appariement verrouille en vert, mauvais reinitialise apres un delai, ecran de resultat une fois le jeu termine (les deux modes), et un "Recommencer" qui remelange reellement les cartes (Fisher-Yates cote client). Tests : 11 tests purs (tests/document/test_memory_config.py, sans Flask, dont un qui verifie explicitement la duplication en mode paire vs son absence en mode single) + 1 test de route verifiant la sanitization a l'ecriture. SKIP=djlint : backlog H021 pre-existant, aucun template touche ici. ruff/mypy --strict/vulture/bandit/import-linter/eslint/stylelint tous verts ; 62 tests document verifies frais. Verification manuelle live complete : ajout, sanitization sur carte invalide, rendu du plateau, et simulation DOM du gameplay reel dans les DEUX modes (mode paire : mauvais appariement puis bon appariement puis jeu complet ; mode single : retournement puis jeu complet) - script de diagnostic non conserve dans le depot. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Sonnet 5
parent
cf46da3388
commit
4111081e1a
@@ -13,11 +13,11 @@ toujours en position absolue (`parent_id = NULL`).
|
||||
être top-niveau ou enfants d'une rangée.
|
||||
|
||||
## `MINIGAME_KINDS: tuple[str, ...]`
|
||||
`("quiz", "association", "memory", "mots", "scenario", "zones")` — `"quiz"`
|
||||
et `"association"` sont implémentés (voir `quiz_config.py`/
|
||||
`association_config.py` ci-dessous) ; les 4 autres gardent un panneau
|
||||
Propriétés minimal (emplacement réservé), formulaires de contenu dédiés
|
||||
hors périmètre de cette passe.
|
||||
`("quiz", "association", "memory", "mots", "scenario", "zones")` —
|
||||
`"quiz"`, `"association"` et `"memory"` sont implémentés (voir
|
||||
`quiz_config.py`/`association_config.py`/`memory_config.py` ci-dessous) ;
|
||||
les 3 autres gardent un panneau Propriétés minimal (emplacement réservé),
|
||||
formulaires de contenu dédiés hors périmètre de cette passe.
|
||||
|
||||
## `ELEMENT_LIBRARY: dict[str, dict[str, Any]]`
|
||||
Bibliothèque affichée dans le panneau gauche, groupée par catégorie
|
||||
@@ -38,8 +38,9 @@ Attributs posés à la création d'un élément de ce type (voir
|
||||
texte (`content/style` + `bold/italic/underline/align/color`),
|
||||
image (`src/alt`), bouton (`label/target`), rangée (`gap/align/justify`),
|
||||
quiz (`DEFAULT_QUIZ_CONFIG`, voir `quiz_config.py`), association
|
||||
(`DEFAULT_ASSOCIATION_CONFIG`, voir `association_config.py`), autre
|
||||
mini-jeu (`theme_color`), ou `{}` pour un `kind` inconnu.
|
||||
(`DEFAULT_ASSOCIATION_CONFIG`, voir `association_config.py`), memory
|
||||
(`DEFAULT_MEMORY_CONFIG`, voir `memory_config.py`), autre mini-jeu
|
||||
(`theme_color`), ou `{}` pour un `kind` inconnu.
|
||||
- **Exceptions** : aucune.
|
||||
|
||||
## `quiz_config.py` — modèle de données du mini-jeu Quiz
|
||||
@@ -102,3 +103,39 @@ levée qui ferait échouer tout le reste du mini-jeu). La liste finale est
|
||||
tronquée à `MAX_PAIRS`.
|
||||
- **Retour** : dict complet (mêmes clés que `DEFAULT_ASSOCIATION_CONFIG`).
|
||||
- **Exceptions** : aucune.
|
||||
|
||||
## `memory_config.py` — modèle de données du mini-jeu Memory
|
||||
|
||||
Troisième mini-jeu implémenté : l'apprenant retourne des cartes pour
|
||||
constituer des paires identiques (mode `"paire"`) ou simplement révéler
|
||||
chaque carte une fois (mode `"single"`, sans appariement — voir
|
||||
`document_engine/rendering/render_document_element.py`::
|
||||
`_render_memory_player`). Même convention que `quiz_config.py`.
|
||||
|
||||
### `MIN_CARDS`, `MAX_CARDS: int`
|
||||
Bornes de validation (`2`/`8` cartes DÉFINIES par le créateur — en mode
|
||||
`"paire"`, le plateau affiche le double, chaque carte étant dupliquée).
|
||||
`MIN_CARDS` n'est pas imposé par `sanitize_memory_config` (même logique
|
||||
que `MIN_PAIRS` côté Association) — recommandation pour le panneau
|
||||
Propriétés, pas une contrainte technique du rendu.
|
||||
|
||||
### `CARD_MODES: tuple[str, ...]`
|
||||
`("paire", "single")`.
|
||||
|
||||
### `DEFAULT_MEMORY_CONFIG: dict[str, Any]`
|
||||
`{"theme_color": "#ff5f2e", "mode": "paire", "cards": []}`.
|
||||
|
||||
### `sanitize_memory_config(raw_config: Any) -> dict[str, Any]`
|
||||
Valide/nettoie une config de memory arbitraire (JSON venu du client) —
|
||||
jamais ne lève, renvoie toujours un dict COMPLET fusionné sur
|
||||
`DEFAULT_MEMORY_CONFIG`. `mode` retombe sur `"paire"` s'il n'est pas dans
|
||||
`CARD_MODES`. Chaque carte de `raw_config["cards"]` est validée
|
||||
indépendamment (voir `_sanitize_card`/`_sanitize_card_face`, privées) :
|
||||
chaque face (`recto`/`verso`) a un `image` et un `text` indépendants et
|
||||
tous deux optionnels, MAIS le `verso` doit avoir au moins l'un des deux
|
||||
non vide (rien à révéler/apparier sinon) — le `recto`, lui, peut rester
|
||||
entièrement vide (dos de carte générique "?" par défaut côté rendu). Une
|
||||
carte invalide est silencieusement supprimée de la liste. La liste finale
|
||||
est tronquée à `MAX_CARDS`.
|
||||
- **Retour** : dict complet (mêmes clés que `DEFAULT_MEMORY_CONFIG`).
|
||||
- **Exceptions** : aucune.
|
||||
|
||||
Reference in New Issue
Block a user