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>
51 lines
2.3 KiB
Python
51 lines
2.3 KiB
Python
from typing import Any
|
|
|
|
from flask import jsonify, request
|
|
from werkzeug.wrappers import Response
|
|
|
|
import db
|
|
import document_engine
|
|
from core.flask_app import app
|
|
|
|
|
|
@app.route("/document/<slug>/elements/<int:element_id>/update", methods=["POST"])
|
|
def document_element_update(slug: str, element_id: int) -> Response | tuple[Response, int]:
|
|
"""Remplace les attributs d'un élément — un formulaire du panneau
|
|
Propriétés (voir static/document/js/document-editor.js) envoie
|
|
systématiquement l'état complet de ses champs.
|
|
|
|
Quiz, Association et Memory sont les seuls kinds revalidés côté
|
|
serveur (sanitize_quiz_config/sanitize_association_config/
|
|
sanitize_memory_config, même convention que
|
|
game_engine/rendering/quiz_box_config.py côté jeu) : leur forme (liste
|
|
de questions/choix, liste de paires, liste de cartes) doit rester
|
|
structurellement correcte pour que le rendu ne plante jamais,
|
|
contrairement aux autres kinds (texte/forme/image...) dont les
|
|
attributs sont de simples valeurs scalaires sans structure à
|
|
garantir."""
|
|
element = document_engine.get_document_element(slug, element_id)
|
|
if element is None:
|
|
return jsonify({"error": "élément introuvable"}), 404
|
|
attributes: dict[str, Any] = request.get_json(force=True) or {}
|
|
if element["kind"] == "quiz":
|
|
attributes = document_engine.sanitize_quiz_config(attributes)
|
|
elif element["kind"] == "association":
|
|
attributes = document_engine.sanitize_association_config(attributes)
|
|
elif element["kind"] == "memory":
|
|
attributes = document_engine.sanitize_memory_config(attributes)
|
|
document_engine.update_document_element_attributes(slug, element_id, attributes)
|
|
element = db.assert_not_none(
|
|
document_engine.get_document_element(slug, element_id),
|
|
"element_id verifie present juste au-dessus, aucune suppression concurrente possible entre-temps ici",
|
|
)
|
|
elements_by_parent: dict[int | None, list[dict[str, Any]]] = {}
|
|
for el in document_engine.list_document_elements(slug):
|
|
elements_by_parent.setdefault(el["parent_id"], []).append(el)
|
|
return jsonify(
|
|
{
|
|
"ok": True,
|
|
"attributes": element["attributes"],
|
|
"rendered_html": document_engine.render_document_element(element, elements_by_parent),
|
|
}
|
|
)
|