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
@@ -0,0 +1,60 @@
|
||||
"""Modèle de données du mini-jeu Memory (voir docs/plan/PLAN.md §3.2) —
|
||||
l'apprenant retourne des cartes pour constituer des paires identiques
|
||||
(mode "paire") ou simplement révéler chaque carte une fois (mode
|
||||
"single", un retournement classique sans appariement). Même convention
|
||||
resolve_X/sanitize_X que quiz_config.py/association_config.py (aucun
|
||||
import croisé)."""
|
||||
|
||||
from typing import Any
|
||||
|
||||
MIN_CARDS = 2
|
||||
MAX_CARDS = 8
|
||||
CARD_MODES = ("paire", "single")
|
||||
DEFAULT_MODE = "paire"
|
||||
|
||||
DEFAULT_MEMORY_CONFIG: dict[str, Any] = {
|
||||
"theme_color": "#ff5f2e",
|
||||
"mode": DEFAULT_MODE,
|
||||
"cards": [],
|
||||
}
|
||||
|
||||
|
||||
def _sanitize_card_face(raw: Any) -> dict[str, str]:
|
||||
"""Une face de carte (recto ou verso) — image et texte tous deux
|
||||
optionnels et indépendants (le créateur peut mettre l'un, l'autre, ou
|
||||
les deux, voir docs/plan/PLAN.md)."""
|
||||
if not isinstance(raw, dict):
|
||||
return {"image": "", "text": ""}
|
||||
return {
|
||||
"image": str(raw.get("image", "")).strip(),
|
||||
"text": str(raw.get("text", "")).strip(),
|
||||
}
|
||||
|
||||
|
||||
def _sanitize_card(raw: Any) -> dict[str, Any] | None:
|
||||
"""None si la carte est invalide — un verso entièrement vide (ni image
|
||||
ni texte) n'aurait rien à révéler/apparier, contrairement au recto qui
|
||||
peut légitimement rester vide (dos de carte générique par défaut)."""
|
||||
if not isinstance(raw, dict):
|
||||
return None
|
||||
recto = _sanitize_card_face(raw.get("recto"))
|
||||
verso = _sanitize_card_face(raw.get("verso"))
|
||||
if not verso["image"] and not verso["text"]:
|
||||
return None
|
||||
return {"recto": recto, "verso": verso}
|
||||
|
||||
|
||||
def sanitize_memory_config(raw_config: Any) -> dict[str, Any]:
|
||||
config = dict(DEFAULT_MEMORY_CONFIG)
|
||||
if not isinstance(raw_config, dict):
|
||||
return config
|
||||
theme_color = raw_config.get("theme_color")
|
||||
if isinstance(theme_color, str) and theme_color:
|
||||
config["theme_color"] = theme_color
|
||||
mode = raw_config.get("mode")
|
||||
config["mode"] = mode if mode in CARD_MODES else DEFAULT_MODE
|
||||
raw_cards = raw_config.get("cards")
|
||||
if isinstance(raw_cards, list):
|
||||
cards = [c for c in (_sanitize_card(item) for item in raw_cards) if c is not None]
|
||||
config["cards"] = cards[:MAX_CARDS]
|
||||
return config
|
||||
Reference in New Issue
Block a user