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:
william
2026-09-20 14:13:28 +02:00
co-authored by Claude Sonnet 5
parent cf46da3388
commit 4111081e1a
12 changed files with 732 additions and 39 deletions
+111 -9
View File
@@ -500,27 +500,31 @@ img.docImage {
color: var(--doc-muted);
}
/* ---- Quiz/Association : mini-jeux interactifs en Mode Aperçu (voir
docs/plan/maquettes/document-formation-web.html — référence visuelle
du Quiz). Masqués en édition (seul .docMinigameBadge y est visible,
voir plus haut) ; jamais les deux visibles en même temps. ---- */
/* ---- Quiz/Association/Memory : mini-jeux interactifs en Mode Aperçu
(voir docs/plan/maquettes/document-formation-web.html — référence
visuelle du Quiz). Masqués en édition (seul .docMinigameBadge y est
visible, voir plus haut) ; jamais les deux visibles en même temps. ---- */
.docQuizPlayer,
.docAssocPlayer {
.docAssocPlayer,
.docMemoryPlayer {
display: none;
}
.docEditor3.docEditor3--preview [data-kind="quiz"] .docMinigameBadge,
.docEditor3.docEditor3--preview [data-kind="association"] .docMinigameBadge {
.docEditor3.docEditor3--preview [data-kind="association"] .docMinigameBadge,
.docEditor3.docEditor3--preview [data-kind="memory"] .docMinigameBadge {
display: none;
}
.docEditor3.docEditor3--preview [data-kind="quiz"] .docQuizPlayer,
.docEditor3.docEditor3--preview [data-kind="association"] .docAssocPlayer {
.docEditor3.docEditor3--preview [data-kind="association"] .docAssocPlayer,
.docEditor3.docEditor3--preview [data-kind="memory"] .docMemoryPlayer {
display: block;
}
.docEditor3.docEditor3--preview [data-kind="quiz"],
.docEditor3.docEditor3--preview [data-kind="association"] {
.docEditor3.docEditor3--preview [data-kind="association"],
.docEditor3.docEditor3--preview [data-kind="memory"] {
border: none;
background: transparent;
}
@@ -528,7 +532,9 @@ img.docImage {
.docEditor3.docEditor3--preview .docQuizPlayer,
.docEditor3.docEditor3--preview .docQuizPlayer *,
.docEditor3.docEditor3--preview .docAssocPlayer,
.docEditor3.docEditor3--preview .docAssocPlayer * {
.docEditor3.docEditor3--preview .docAssocPlayer *,
.docEditor3.docEditor3--preview .docMemoryPlayer,
.docEditor3.docEditor3--preview .docMemoryPlayer * {
/* .docEditor3--preview désactive pointer-events sur tout [data-element-id]
(voir plus bas) pour empêcher la sélection/le déplacement pendant
l'Aperçu — réactivé ici spécifiquement pour que ces mini-jeux restent
@@ -881,6 +887,102 @@ img.docImage {
font-size: 15px;
}
/* ---- Memory : panneau Propriétés — étiquette au-dessus de chaque champ
recto/verso (voir forgeDocRenderMemoryCardHtml). Réutilise
.docAssocPairRow/.docAssocPairInput (même carte, mêmes champs) plutôt
que de dupliquer leurs règles. ---- */
.docMemoryFaceLabel {
font-size: 11.5px;
font-weight: 700;
letter-spacing: 0.03em;
color: var(--doc-muted);
text-transform: uppercase;
margin-top: 4px;
}
/* ---- Memory : plateau de jeu (voir docs/plan/PLAN.md, "retourner des
cartes pour constituer des paires d'images identiques"). Réutilise
.docAssocTitle/.docAssocMeta/.docAssocResultCard (mêmes rôles visuels,
voir forgeDocRenderMemoryProps ci-dessus). ---- */
.docMemoryCardWrap {
background: linear-gradient(180deg, var(--doc-card), var(--doc-bg-2));
border: 1px solid var(--doc-border);
border-radius: 16px;
padding: 1.8rem;
}
.docMemoryGrid {
display: grid;
grid-template-columns: repeat(auto-fill, minmax(90px, 1fr));
gap: 12px;
}
.docMemoryCard {
aspect-ratio: 3 / 4;
perspective: 700px;
cursor: pointer;
}
.docMemoryCardInner {
position: relative;
width: 100%;
height: 100%;
transition: transform 0.4s ease;
transform-style: preserve-3d;
}
.docMemoryCard.is-flipped .docMemoryCardInner {
transform: rotateY(180deg);
}
.docMemoryCard.is-matched .docMemoryCardInner {
opacity: 0.55;
}
.docMemoryCardFace {
position: absolute;
inset: 0;
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
gap: 4px;
padding: 6px;
border-radius: 10px;
border: 1px solid var(--doc-border);
background: var(--doc-bg-2);
backface-visibility: hidden;
overflow: hidden;
text-align: center;
font-size: 12px;
color: var(--doc-text);
}
.docMemoryCardFace img {
max-width: 100%;
max-height: 60%;
object-fit: contain;
}
.docMemoryCardFront {
background: linear-gradient(135deg, var(--doc-accent), var(--doc-accent-2));
color: #14100c;
}
.docMemoryCardBackGlyph {
font-size: 26px;
font-weight: 800;
}
.docMemoryCardBack {
transform: rotateY(180deg);
border-color: var(--doc-accent);
}
.docMemoryCard.is-matched .docMemoryCardFace {
border-color: var(--doc-quiz-success-border);
}
.docUnknown {
font-size: 12.5px;
color: var(--doc-muted);