Ajoute le système de modèles/thèmes de document ("Utiliser un modèle")
Nouveau bouton dans le topbar de l'éditeur, à côté d'Aperçu, qui ouvre une modale listant les thèmes du catalogue (document_engine/themes/). Cliquer un thème charge un VRAI aperçu (rendu serveur réel dans un iframe, jamais une resucée CSS côté client) avec le choix de garder le contenu actuel ou de le remplacer par le contenu de démonstration du modèle. Architecture pensée pour une centaine de thèmes futurs : chaque thème est une feuille de style externe (static/document/themes/<id>.css) qui habille les classes fixes du moteur, jamais du code qui en changerait la structure. Premier thème implémenté pour valider le mécanisme : "Sécurité Incendie" (6 pages de contenu réel, quiz inclus). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
william
co-authored by
Claude Sonnet 5
Claude Sonnet 5
parent
a34bcf4159
commit
864ae697fd
@@ -0,0 +1,10 @@
|
||||
from .securite_incendie_seed import SECURITE_INCENDIE_SEED_PAGES
|
||||
from .seed_blocks_to_elements import seed_blocks_to_elements
|
||||
from .theme_catalog import DOCUMENT_THEMES, get_document_theme_entry
|
||||
|
||||
__all__ = [
|
||||
"DOCUMENT_THEMES",
|
||||
"SECURITE_INCENDIE_SEED_PAGES",
|
||||
"get_document_theme_entry",
|
||||
"seed_blocks_to_elements",
|
||||
]
|
||||
@@ -0,0 +1,178 @@
|
||||
"""Contenu de démonstration du thème "Sécurité Incendie" (voir
|
||||
theme_catalog.py) — vraie curriculum de formation, jamais du texte de
|
||||
remplissage (voir CLAUDE.md, artifact-design : "Build with real content
|
||||
throughout, never lorem"). Un support qui applique ce thème en mode
|
||||
"utiliser le contenu du modèle" (voir routes/document/
|
||||
document_theme_apply.py) reçoit EXACTEMENT ces pages, entièrement
|
||||
modifiables ensuite comme n'importe quel contenu créé à la main."""
|
||||
|
||||
from typing import Any
|
||||
|
||||
SECURITE_INCENDIE_SEED_PAGES: list[list[dict[str, Any]]] = [
|
||||
# Page 1 — Titre
|
||||
[
|
||||
{"kind": "badge", "attributes": {"content": "Module obligatoire"}},
|
||||
{"kind": "titre", "attributes": {"content": "Formation Sécurité Incendie", "style": "titre1"}},
|
||||
{
|
||||
"kind": "paragraphe",
|
||||
"attributes": {
|
||||
"content": (
|
||||
"Reconnaître les risques, réagir dans les 3 premières minutes, protéger les "
|
||||
"personnes autour de vous. Durée : 25 min · à renouveler tous les 24 mois."
|
||||
)
|
||||
},
|
||||
},
|
||||
],
|
||||
# Page 2 — Objectifs
|
||||
[
|
||||
{"kind": "titre", "attributes": {"content": "À l'issue de ce module, vous saurez", "style": "titre2"}},
|
||||
{
|
||||
"kind": "liste_puces",
|
||||
"attributes": {
|
||||
"items": [
|
||||
"Identifier les causes principales d'un départ de feu sur un poste de travail",
|
||||
"Choisir le bon type d'extincteur selon la classe de feu rencontrée",
|
||||
"Déclencher l'alarme et évacuer en moins de 3 minutes",
|
||||
]
|
||||
},
|
||||
},
|
||||
{
|
||||
"kind": "badge",
|
||||
"attributes": {
|
||||
"content": (
|
||||
"Un feu peut doubler de volume toutes les 30 secondes — la rapidité de "
|
||||
"réaction compte autant que le geste."
|
||||
)
|
||||
},
|
||||
},
|
||||
],
|
||||
# Page 3 — Classes de feu
|
||||
[
|
||||
{"kind": "titre", "attributes": {"content": "Les 5 classes de feu", "style": "titre2"}},
|
||||
{
|
||||
"kind": "paragraphe",
|
||||
"attributes": {
|
||||
"content": (
|
||||
"Chaque classe correspond à un combustible différent — le mauvais "
|
||||
"extincteur peut aggraver l'incendie."
|
||||
)
|
||||
},
|
||||
},
|
||||
{
|
||||
"kind": "row",
|
||||
"attributes": {"gap": 10, "align": "stretch", "justify": "flex-start"},
|
||||
"children": [
|
||||
{
|
||||
"kind": "carte",
|
||||
"attributes": {"label": "A", "title": "Feux secs", "description": "Bois, papier, tissus"},
|
||||
},
|
||||
{
|
||||
"kind": "carte",
|
||||
"attributes": {"label": "B", "title": "Liquides", "description": "Essence, solvants"},
|
||||
},
|
||||
{"kind": "carte", "attributes": {"label": "C", "title": "Gaz", "description": "Butane, propane"}},
|
||||
{"kind": "carte", "attributes": {"label": "D", "title": "Métaux", "description": "Sodium, magnésium"}},
|
||||
{
|
||||
"kind": "carte",
|
||||
"attributes": {"label": "F", "title": "Huiles", "description": "Friteuses, graisses"},
|
||||
},
|
||||
],
|
||||
},
|
||||
{
|
||||
"kind": "badge",
|
||||
"attributes": {
|
||||
"content": (
|
||||
"⚠ Un feu électrique n'est pas une classe à part : coupez toujours le courant avant d'intervenir."
|
||||
)
|
||||
},
|
||||
},
|
||||
],
|
||||
# Page 4 — Méthode P.A.S.S.
|
||||
[
|
||||
{"kind": "titre", "attributes": {"content": "Utiliser un extincteur : la méthode P.A.S.S.", "style": "titre2"}},
|
||||
{
|
||||
"kind": "liste_numerotee",
|
||||
"attributes": {
|
||||
"items": [
|
||||
"Percuter — retirez la goupille de sécurité",
|
||||
"Approcher — à 2 ou 3 mètres du foyer",
|
||||
"Serrer — pressions courtes, pas en continu",
|
||||
"Balayer — la base des flammes, gauche à droite",
|
||||
]
|
||||
},
|
||||
},
|
||||
{
|
||||
"kind": "row",
|
||||
"attributes": {"gap": 12, "align": "center", "justify": "space-between"},
|
||||
"children": [
|
||||
{
|
||||
"kind": "badge",
|
||||
"attributes": {"content": "⚠ Jamais d'eau sur un feu électrique ou une friteuse en feu."},
|
||||
},
|
||||
{"kind": "bouton", "attributes": {"label": "Fiche consignes", "target": ""}},
|
||||
],
|
||||
},
|
||||
],
|
||||
# Page 5 — Évacuation
|
||||
[
|
||||
{"kind": "titre", "attributes": {"content": "Consignes d'évacuation", "style": "titre2"}},
|
||||
{
|
||||
"kind": "paragraphe",
|
||||
"attributes": {"content": "Dès que l'alarme retentit, l'évacuation est immédiate — aucune exception."},
|
||||
},
|
||||
{
|
||||
"kind": "liste_numerotee",
|
||||
"attributes": {
|
||||
"items": [
|
||||
"Cessez toute activité, laissez vos affaires sur place",
|
||||
"Suivez le fléchage vers la sortie la plus proche, jamais l'ascenseur",
|
||||
"Rejoignez le point de rassemblement, attendez l'appel de votre nom",
|
||||
"Ne retournez jamais à l'intérieur avant le signal du responsable",
|
||||
]
|
||||
},
|
||||
},
|
||||
],
|
||||
# Page 6 — Quiz (SEUL sur sa page : règle du moteur, voir
|
||||
# routes/document/document_element_add.py — respectée ici dès la
|
||||
# conception du contenu-seed, jamais contournée).
|
||||
[
|
||||
{
|
||||
"kind": "quiz",
|
||||
"attributes": {
|
||||
"theme_color": "#c8102e",
|
||||
"timer_enabled": False,
|
||||
"timer_seconds": 30,
|
||||
"questions": [
|
||||
{
|
||||
"text": (
|
||||
"Quelle classe de feu concerne les liquides inflammables comme l'essence ou les solvants ?"
|
||||
),
|
||||
"choices": ["Classe A", "Classe B", "Classe D"],
|
||||
"correct_index": 1,
|
||||
"points": 10,
|
||||
},
|
||||
{
|
||||
"text": "Quel est le premier geste de la méthode P.A.S.S. ?",
|
||||
"choices": [
|
||||
"Balayer la base des flammes",
|
||||
"Percuter (retirer la goupille)",
|
||||
"Approcher à 1 mètre",
|
||||
],
|
||||
"correct_index": 1,
|
||||
"points": 10,
|
||||
},
|
||||
{
|
||||
"text": "Que faire dès que l'alarme incendie retentit ?",
|
||||
"choices": [
|
||||
"Terminer sa tâche puis sortir",
|
||||
"Prendre l'ascenseur pour aller plus vite",
|
||||
"Évacuer immédiatement par les issues de secours",
|
||||
],
|
||||
"correct_index": 2,
|
||||
"points": 10,
|
||||
},
|
||||
],
|
||||
},
|
||||
}
|
||||
],
|
||||
]
|
||||
@@ -0,0 +1,30 @@
|
||||
from typing import Any
|
||||
|
||||
from ..labels.element_kind_labels import element_default_attributes
|
||||
|
||||
|
||||
def seed_blocks_to_elements(blocks: list[dict[str, Any]]) -> list[dict[str, Any]]:
|
||||
"""Convertit une liste de blocs de contenu-seed (voir theme_catalog.py
|
||||
— `seed_pages`) en une liste d'éléments "à plat" directement
|
||||
exploitable par `render_document_element.render_document` — ids
|
||||
synthétiques négatifs, JAMAIS persistés (aperçu d'un thème
|
||||
uniquement, voir routes/document/document_theme_preview.py ; pour la
|
||||
persistance réelle voir document_engine.replace_document_content,
|
||||
qui ne réutilise pas cette fonction — elle a besoin de vrais ids
|
||||
attribués par la base au fil des insertions)."""
|
||||
elements: list[dict[str, Any]] = []
|
||||
next_id = -1
|
||||
for block in blocks:
|
||||
next_id = _add_block(elements, block, parent_id=None, next_id=next_id)
|
||||
return elements
|
||||
|
||||
|
||||
def _add_block(elements: list[dict[str, Any]], block: dict[str, Any], parent_id: int | None, next_id: int) -> int:
|
||||
element_id = next_id
|
||||
next_id -= 1
|
||||
kind = block["kind"]
|
||||
attributes = {**element_default_attributes(kind), **block.get("attributes", {})}
|
||||
elements.append({"id": element_id, "kind": kind, "parent_id": parent_id, "attributes": attributes})
|
||||
for child in block.get("children", []):
|
||||
next_id = _add_block(elements, child, parent_id=element_id, next_id=next_id)
|
||||
return next_id
|
||||
@@ -0,0 +1,32 @@
|
||||
"""Catalogue des thèmes visuels applicables à un support (voir consigne
|
||||
du 24/09/2026 : le moteur ne porte QUE contenu et mécanisme — chaque
|
||||
thème est une feuille de style externe (`css_path`, servie telle quelle
|
||||
depuis static/) qui habille les mêmes classes fixes du moteur
|
||||
(.docPage/.docText/.docList/.docCard/.docBadge/.docMinigame/...), jamais
|
||||
du code Python qui en changerait la structure."""
|
||||
|
||||
from typing import Any
|
||||
|
||||
from .securite_incendie_seed import SECURITE_INCENDIE_SEED_PAGES
|
||||
|
||||
DOCUMENT_THEMES: list[dict[str, Any]] = [
|
||||
{
|
||||
"id": "securite-incendie",
|
||||
"name": "Sécurité Incendie",
|
||||
"category": "Prévention & sécurité",
|
||||
"description": "Rouge sécurité et ambre balisage, typographie signalétique — pour une formation réglementaire.",
|
||||
"css_path": "document/themes/securite-incendie.css",
|
||||
"font_url": (
|
||||
"https://fonts.googleapis.com/css2?"
|
||||
"family=Oswald:wght@500;600;700&family=Source+Sans+3:wght@400;500;600;700&display=swap"
|
||||
),
|
||||
"seed_pages": SECURITE_INCENDIE_SEED_PAGES,
|
||||
},
|
||||
]
|
||||
|
||||
|
||||
def get_document_theme_entry(theme_id: str) -> dict[str, Any] | None:
|
||||
"""- **Retour** : l'entrée du catalogue dont `id == theme_id`, ou
|
||||
`None` si aucun thème de ce catalogue ne porte cet id.
|
||||
- **Exceptions** : aucune."""
|
||||
return next((theme for theme in DOCUMENT_THEMES if theme["id"] == theme_id), None)
|
||||
Reference in New Issue
Block a user