williamandClaude Sonnet 5
4111081e1a
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>
94 lines
3.0 KiB
Python
94 lines
3.0 KiB
Python
"""
|
|
document_engine — support de formation : entité racine séparée du jeu 2D
|
|
(voir docs/plan/PLAN.md). Un support = un seul document, structuré en deux
|
|
couches sur le même canevas :
|
|
- le flux de contenu (titre/paragraphe/image/bouton/mini-jeux), organisé
|
|
en rangées ("row") par le moteur d'inférence de layout (voir
|
|
document_engine/rendering/render_document_element.py) ;
|
|
- la couche de formes libres (rectangle/cercle/triangle/trait), position-
|
|
nées en absolu (x/y/width/height/rotation/z_index).
|
|
|
|
Tout est stocké dans support.db (voir db/supports/) : une seule table,
|
|
_document_elements, portant les deux couches via parent_id (NULL = top-
|
|
niveau ou forme libre, sinon = enfant d'une rangée).
|
|
|
|
Aucun import croisé avec game_engine ou tout module lié au jeu 2D — voir
|
|
le contrat import-linter dans pyproject.toml (game_engine | document_engine
|
|
sont un même palier, mutuellement isolés).
|
|
|
|
Ce module se contente de ré-exporter l'intégralité de l'API publique du
|
|
paquet (pattern "un fichier = une fonction, un dossier = une responsabi-
|
|
lité", voir game_engine/__init__.py).
|
|
"""
|
|
|
|
from .elements.add_document_element import add_document_element
|
|
from .elements.delete_document_element import delete_document_element
|
|
from .elements.get_document_element import get_document_element
|
|
from .elements.list_document_elements import list_document_elements
|
|
from .elements.move_document_element import move_document_element
|
|
from .elements.update_document_element_attributes import update_document_element_attributes
|
|
from .labels.association_config import (
|
|
DEFAULT_ASSOCIATION_CONFIG,
|
|
MAX_PAIRS,
|
|
MIN_PAIRS,
|
|
sanitize_association_config,
|
|
)
|
|
from .labels.element_kind_labels import (
|
|
CONTENT_KINDS,
|
|
ELEMENT_KIND_LABELS,
|
|
ELEMENT_LIBRARY,
|
|
MINIGAME_KINDS,
|
|
SHAPE_KINDS,
|
|
element_default_attributes,
|
|
)
|
|
from .labels.memory_config import (
|
|
CARD_MODES,
|
|
DEFAULT_MEMORY_CONFIG,
|
|
MAX_CARDS,
|
|
MIN_CARDS,
|
|
sanitize_memory_config,
|
|
)
|
|
from .labels.quiz_config import (
|
|
DEFAULT_QUIZ_CONFIG,
|
|
MAX_CHOICES,
|
|
MAX_TIMER_SECONDS,
|
|
MIN_CHOICES,
|
|
MIN_TIMER_SECONDS,
|
|
quiz_total_points,
|
|
sanitize_quiz_config,
|
|
)
|
|
from .rendering.render_document_element import render_document, render_document_element
|
|
|
|
__all__ = [
|
|
"CARD_MODES",
|
|
"CONTENT_KINDS",
|
|
"DEFAULT_ASSOCIATION_CONFIG",
|
|
"DEFAULT_MEMORY_CONFIG",
|
|
"DEFAULT_QUIZ_CONFIG",
|
|
"ELEMENT_KIND_LABELS",
|
|
"ELEMENT_LIBRARY",
|
|
"MAX_CARDS",
|
|
"MAX_CHOICES",
|
|
"MAX_PAIRS",
|
|
"MAX_TIMER_SECONDS",
|
|
"MIN_CARDS",
|
|
"MIN_CHOICES",
|
|
"MIN_PAIRS",
|
|
"MIN_TIMER_SECONDS",
|
|
"MINIGAME_KINDS",
|
|
"SHAPE_KINDS",
|
|
"add_document_element",
|
|
"delete_document_element",
|
|
"element_default_attributes",
|
|
"get_document_element",
|
|
"list_document_elements",
|
|
"move_document_element",
|
|
"quiz_total_points",
|
|
"render_document",
|
|
"render_document_element",
|
|
"sanitize_association_config",
|
|
"sanitize_memory_config",
|
|
"sanitize_quiz_config",
|
|
"update_document_element_attributes",
|
|
]
|