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,95 @@
|
||||
"""Modèle de données du mini-jeu Memory
|
||||
(document_engine/labels/memory_config.py) — sans Flask, teste directement
|
||||
sanitize_memory_config, et le rendu du plateau."""
|
||||
|
||||
from typing import Any
|
||||
|
||||
import document_engine as doc_engine
|
||||
|
||||
|
||||
def test_sanitize_memory_config_on_missing_input_returns_full_defaults() -> None:
|
||||
assert doc_engine.sanitize_memory_config(None) == {"theme_color": "#ff5f2e", "mode": "paire", "cards": []}
|
||||
|
||||
|
||||
def test_sanitize_memory_config_keeps_a_valid_card() -> None:
|
||||
raw = {
|
||||
"theme_color": "#123456",
|
||||
"mode": "single",
|
||||
"cards": [{"recto": {"image": "", "text": "?"}, "verso": {"image": "cat.png", "text": "Chat"}}],
|
||||
}
|
||||
config = doc_engine.sanitize_memory_config(raw)
|
||||
assert config["theme_color"] == "#123456"
|
||||
assert config["mode"] == "single"
|
||||
assert config["cards"] == [{"recto": {"image": "", "text": "?"}, "verso": {"image": "cat.png", "text": "Chat"}}]
|
||||
|
||||
|
||||
def test_sanitize_memory_config_allows_a_fully_blank_recto() -> None:
|
||||
raw = {"cards": [{"recto": {}, "verso": {"text": "Chat"}}]}
|
||||
config = doc_engine.sanitize_memory_config(raw)
|
||||
assert config["cards"] == [{"recto": {"image": "", "text": ""}, "verso": {"image": "", "text": "Chat"}}]
|
||||
|
||||
|
||||
def test_sanitize_memory_config_drops_a_card_with_a_fully_blank_verso() -> None:
|
||||
raw = {"cards": [{"recto": {"text": "Indice"}, "verso": {"image": "", "text": " "}}]}
|
||||
assert doc_engine.sanitize_memory_config(raw)["cards"] == []
|
||||
|
||||
|
||||
def test_sanitize_memory_config_falls_back_to_paire_on_invalid_mode() -> None:
|
||||
assert doc_engine.sanitize_memory_config({"mode": "n_importe_quoi"})["mode"] == "paire"
|
||||
|
||||
|
||||
def test_sanitize_memory_config_caps_cards_at_max() -> None:
|
||||
raw = {"cards": [{"verso": {"text": f"Carte {i}"}} for i in range(doc_engine.MAX_CARDS + 3)]}
|
||||
config = doc_engine.sanitize_memory_config(raw)
|
||||
assert len(config["cards"]) == doc_engine.MAX_CARDS
|
||||
|
||||
|
||||
def test_sanitize_memory_config_ignores_garbage_top_level_input() -> None:
|
||||
assert doc_engine.sanitize_memory_config("n'importe quoi") == doc_engine.DEFAULT_MEMORY_CONFIG
|
||||
|
||||
|
||||
def _memory_element(attributes: dict[str, Any]) -> dict[str, Any]:
|
||||
return {"id": 1, "kind": "memory", "parent_id": None, "order_index": 0, "attributes": attributes}
|
||||
|
||||
|
||||
def test_render_memory_without_cards_shows_only_the_badge() -> None:
|
||||
html = doc_engine.render_document_element(_memory_element(doc_engine.DEFAULT_MEMORY_CONFIG), {})
|
||||
assert "0 carte" in html
|
||||
assert "docMemoryPlayer" not in html
|
||||
|
||||
|
||||
def test_render_memory_with_cards_includes_the_interactive_board() -> None:
|
||||
config = doc_engine.sanitize_memory_config(
|
||||
{"mode": "paire", "cards": [{"verso": {"text": "Chat"}}, {"verso": {"text": "Chien"}}]}
|
||||
)
|
||||
html = doc_engine.render_document_element(_memory_element(config), {})
|
||||
assert "docMemoryPlayer" in html
|
||||
assert "data-memory-config=" in html
|
||||
assert "2 cartes" in html
|
||||
assert "mode paire" in html
|
||||
|
||||
|
||||
def test_render_memory_duplicates_cards_in_paire_mode_only() -> None:
|
||||
import json
|
||||
|
||||
config = doc_engine.sanitize_memory_config({"mode": "paire", "cards": [{"verso": {"text": "Chat"}}]})
|
||||
html_paire = doc_engine.render_document_element(_memory_element(config), {})
|
||||
start = html_paire.find('data-memory-config="') + len('data-memory-config="')
|
||||
end = html_paire.find('"', start)
|
||||
embedded = json.loads(html_paire[start:end].replace(""", '"'))
|
||||
assert len(embedded["cards"]) == 2
|
||||
assert embedded["cards"][0]["card_index"] == embedded["cards"][1]["card_index"] == 0
|
||||
|
||||
config_single = doc_engine.sanitize_memory_config({"mode": "single", "cards": [{"verso": {"text": "Chat"}}]})
|
||||
html_single = doc_engine.render_document_element(_memory_element(config_single), {})
|
||||
start2 = html_single.find('data-memory-config="') + len('data-memory-config="')
|
||||
end2 = html_single.find('"', start2)
|
||||
embedded_single = json.loads(html_single[start2:end2].replace(""", '"'))
|
||||
assert len(embedded_single["cards"]) == 1
|
||||
|
||||
|
||||
def test_render_memory_escapes_card_text_in_embedded_json() -> None:
|
||||
config = doc_engine.sanitize_memory_config({"cards": [{"verso": {"text": '"><script>alert(1)</script>'}}]})
|
||||
html = doc_engine.render_document_element(_memory_element(config), {})
|
||||
assert "<script>alert(1)</script>" not in html
|
||||
assert "<script>" in html
|
||||
Reference in New Issue
Block a user