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>

routes/document/__init__.py

@@ -19,4 +19,6 @@ from . import (  # noqa: F401 - enregistre les routes definies dans chaque modul
     document_page_move,
     document_page_rename,
     document_render,
+    document_theme_apply,
+    document_theme_preview,
 )

routes/document/document_edit.py

@@ -44,6 +44,8 @@ def document_edit(slug: str) -> str:
         for el in document_engine.list_document_elements(slug, active_page["id"])
     ]
 
+    active_theme = document_engine.get_document_theme_entry(support["theme"]) if support["theme"] else None
+
     return render_template(
         "document/document_edit.html",
         support=support,
@@ -53,4 +55,18 @@ def document_edit(slug: str) -> str:
         rendered_document=document_engine.render_document(active_elements),
         element_library=document_engine.ELEMENT_LIBRARY,
         element_kind_labels=document_engine.ELEMENT_KIND_LABELS,
+        active_theme=active_theme,
+        # Seuls les champs utiles à la modale "Utiliser un modèle" côté
+        # client (voir static/document/js/document-editor.js) — jamais le
+        # `seed_pages` complet, inutilement volumineux et non nécessaire
+        # côté client (l'aperçu et l'application se font tous deux en
+        # appelant le serveur, voir document_theme_preview.py/
+        # document_theme_apply.py). Pas de route JSON dédiée pour une
+        # donnée 100% statique côté serveur : le catalogue tient déjà
+        # dans le contexte de cette page (voir document_engine/themes/
+        # theme_catalog.py).
+        document_themes=[
+            {"id": t["id"], "name": t["name"], "category": t["category"], "description": t["description"]}
+            for t in document_engine.DOCUMENT_THEMES
+        ],
     )

routes/document/document_theme_apply.py

@@ -0,0 +1,34 @@
+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>/theme/apply", methods=["POST"])
+def document_theme_apply(slug: str) -> Response | tuple[Response, int]:
+    """Applique un thème visuel au support — voir document_engine/themes/.
+    `mode` décide du sort du contenu ACTUEL :
+    - "keep_content" (défaut) : seul le thème change, le contenu du
+      support reste tel quel.
+    - "template_content" : le contenu du support est intégralement
+      remplacé par le contenu de démonstration du thème (voir
+      document_engine.replace_document_content) — action destructive,
+      dont la confirmation est à la charge du client (voir
+      static/document/js/document-editor.js, aucune confirmation ici
+      côté serveur : ce n'est pas son rôle)."""
+    payload = request.get_json(force=True) or {}
+    theme_id = str(payload.get("theme_id", ""))
+    theme = document_engine.get_document_theme_entry(theme_id)
+    if theme is None:
+        return jsonify({"error": "thème introuvable"}), 404
+    mode = payload.get("mode", "keep_content")
+    if mode not in ("keep_content", "template_content"):
+        return jsonify({"error": "mode invalide"}), 400
+
+    db.set_document_theme(slug, theme_id)
+    if mode == "template_content":
+        document_engine.replace_document_content(slug, theme["seed_pages"])
+
+    return jsonify({"ok": True, "theme_id": theme_id})

routes/document/document_theme_preview.py

@@ -0,0 +1,23 @@
+from flask import render_template
+from werkzeug.exceptions import NotFound
+
+import document_engine
+from core.flask_app import app
+
+
+@app.route("/document/<slug>/theme/<theme_id>/preview")
+def document_theme_preview(slug: str, theme_id: str) -> str:
+    """Aperçu isolé (destiné à un <iframe>, voir la modale "Utiliser un
+    modèle" dans static/document/js/document-editor.js) de la première
+    page de démonstration d'un thème — RÉELLEMENT rendue par le moteur
+    (document_engine.render_document), jamais une image statique ou une
+    resucée manuelle du CSS : ce qui est prévisualisé est EXACTEMENT ce
+    qui s'affichera une fois le thème appliqué. `slug` sert uniquement à
+    la garde de propriété (core/auth_guard.py, générique sur toute route
+    <slug>) — l'aperçu ne dépend d'aucune donnée de CE support."""
+    theme = document_engine.get_document_theme_entry(theme_id)
+    if theme is None:
+        raise NotFound
+    elements = document_engine.seed_blocks_to_elements(theme["seed_pages"][0])
+    rendered_page = document_engine.render_document(elements)
+    return render_template("document/document_theme_preview.html", theme=theme, rendered_page=rendered_page)