document_engine/labels/association_config.py (nouveau) : modele de
donnees, meme convention resolve_X/sanitize_X que quiz_config.py -
DEFAULT_ASSOCIATION_CONFIG, sanitize_association_config (chaque paire
doit avoir ses deux cotes non vides, sinon supprimee silencieusement ;
liste tronquee a MAX_PAIRS=8).
Cote serveur, routes/document/document_element_update.py revalide
desormais aussi l'association avant persistance (meme raisonnement que
pour le quiz). Le rendu (_render_association) affiche un resume reel
(nombre de paires) et, des qu'au moins une paire existe, un plateau de
glisser-deposer REELEMENT interactif en Mode Apercu
(_render_association_player) : les deux colonnes (termes/
correspondances) sont melangees independamment (random.shuffle,
melange d'affichage documente dans CODE_QUALITY.md) puis embarquees en
JSON dans un attribut data-assoc-config.
Cote editeur, le panneau Proprietes d'une association ("relier
visuellement deux champs qui vont ensemble") est une liste de paires
repetable, chaque ligne reliant visuellement un champ "Element" et un
champ "Correspondance" par un glyphe ↔. Le plateau jouable en Apercu
(static/document/js/document-editor.js) supporte deux facons de jouer,
toutes deux reelles : glisser-deposer HTML5 natif, ou cliquer une
carte puis son emplacement (repli pour les appareils sans support
fiable du drag) - bonne association verrouillee en vert, mauvaise
signalee puis reinitialisee, ecran de resultat une fois toutes les
paires associees.
Bug reel trouve ET corrige via simulation DOM complete (glisser-
deposer + clic simules, pas juste un chargement de page) : le
feedback visuel reutilisait la classe CSS du quiz via une
reaffectation de className qui supprimait au passage la classe
d'identite docAssocFeedback, rendant l'element introuvable des le
premier essai de match (aurait plante en usage reel des la premiere
tentative). Corrige en gardant toujours les deux classes ensemble.
Tests : 8 tests purs (tests/document/test_association_config.py, sans
Flask) + 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 ; 50 tests document verifies frais. Verification manuelle live
complete : ajout, sanitization sur paire invalide, rendu du plateau,
et simulation DOM du gameplay reel (glisser-deposer correct/incorrect,
clic-selection, progression, ecran de resultat) - script de
diagnostic non conserve dans le depot.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
97 lines
3.6 KiB
Python
97 lines
3.6 KiB
Python
"""Catalogue des types d'éléments du support de formation (voir
|
|
docs/plan/PLAN.md §1.2/§3.2) — bibliothèque groupée par catégorie visuelle
|
|
(panneau gauche de l'éditeur), libellés d'affichage, et attributs par
|
|
défaut posés à la création de chaque type."""
|
|
|
|
from typing import Any
|
|
|
|
from .association_config import DEFAULT_ASSOCIATION_CONFIG
|
|
from .quiz_config import DEFAULT_QUIZ_CONFIG
|
|
|
|
SHAPE_KINDS = ("rectangle", "cercle", "triangle", "trait")
|
|
CONTENT_KINDS = ("titre", "paragraphe", "image", "bouton")
|
|
MINIGAME_KINDS = ("quiz", "association", "memory", "mots", "scenario", "zones")
|
|
|
|
# "row" n'apparaît jamais dans la bibliothèque (créé implicitement par le
|
|
# moteur de layout au dépôt d'un élément à côté d'un autre) — absent de
|
|
# ELEMENT_LIBRARY, présent dans ELEMENT_KIND_LABELS pour l'affichage/debug.
|
|
ELEMENT_LIBRARY: dict[str, dict[str, Any]] = {
|
|
"mise_en_page": {"label": "Mise en page", "kinds": list(SHAPE_KINDS)},
|
|
"contenu": {"label": "Contenu", "kinds": list(CONTENT_KINDS)},
|
|
"minigames": {"label": "Mini-jeux", "kinds": list(MINIGAME_KINDS)},
|
|
}
|
|
|
|
ELEMENT_KIND_LABELS: dict[str, str] = {
|
|
"row": "Rangée",
|
|
"rectangle": "Rectangle",
|
|
"cercle": "Cercle",
|
|
"triangle": "Triangle",
|
|
"trait": "Trait",
|
|
"titre": "Titre",
|
|
"paragraphe": "Paragraphe",
|
|
"image": "Image",
|
|
"bouton": "Bouton",
|
|
"quiz": "Quiz",
|
|
"association": "Association",
|
|
"memory": "Memory",
|
|
"mots": "Mots mêlés",
|
|
"scenario": "Scénario",
|
|
"zones": "Zones à risque",
|
|
}
|
|
|
|
_SHAPE_DEFAULTS = {
|
|
"x": 40,
|
|
"y": 40,
|
|
"width": 160,
|
|
"height": 100,
|
|
"rotation": 0,
|
|
"z_index": 1,
|
|
"fill": "#ff5f2e",
|
|
"stroke": "#232a38",
|
|
"stroke_width": 2,
|
|
"label": "",
|
|
}
|
|
|
|
_TEXT_DEFAULTS = {
|
|
"bold": False,
|
|
"italic": False,
|
|
"underline": False,
|
|
"align": "left",
|
|
"color": "var(--forge-text)",
|
|
}
|
|
|
|
|
|
def element_default_attributes(kind: str) -> dict[str, Any]:
|
|
"""Attributs posés à la création d'un élément de ce type — cf.
|
|
docs/plan/PLAN.md §3.3/§3.4/§3.5 pour la liste des propriétés
|
|
éditables par panneau, ici juste leur valeur de départ."""
|
|
if kind in SHAPE_KINDS:
|
|
return dict(_SHAPE_DEFAULTS)
|
|
if kind == "titre":
|
|
return {"content": "Nouveau titre", "style": "titre1", **_TEXT_DEFAULTS}
|
|
if kind == "paragraphe":
|
|
return {"content": "Nouveau paragraphe de texte.", "style": "paragraphe", **_TEXT_DEFAULTS}
|
|
if kind == "image":
|
|
return {"src": "", "alt": ""}
|
|
if kind == "bouton":
|
|
return {"label": "Bouton", "target": ""}
|
|
if kind == "row":
|
|
return {"gap": 16, "align": "stretch", "justify": "flex-start"}
|
|
if kind == "quiz":
|
|
# Copie de "questions" (liste, jamais un simple dict(...) qui la
|
|
# partagerait par référence avec DEFAULT_QUIZ_CONFIG) : aucun appelant
|
|
# ne la mute en place aujourd'hui, mais la copier ici coûte rien et
|
|
# évite d'ancrer cette hypothèse fragile pour la suite.
|
|
return {**DEFAULT_QUIZ_CONFIG, "questions": list(DEFAULT_QUIZ_CONFIG["questions"])}
|
|
if kind == "association":
|
|
# Même raison de copie que "quiz" ci-dessus (voir association_config.py).
|
|
return {**DEFAULT_ASSOCIATION_CONFIG, "pairs": list(DEFAULT_ASSOCIATION_CONFIG["pairs"])}
|
|
if kind in MINIGAME_KINDS:
|
|
# Panneau Propriétés minimal (voir PLAN.md §3.5, dernier
|
|
# paragraphe : "état par défaut en attendant sa spécification") —
|
|
# décision actée : cœur complet + mini-jeux en emplacement
|
|
# réservé (memory/mots/scenario/zones), formulaires de contenu
|
|
# dédiés = chantier séparé.
|
|
return {"theme_color": "#ff5f2e"}
|
|
return {}
|