Ajoute l'alignement vertical du contenu d'une page, réglable depuis l'onglet "Pages"

Nouvelle colonne _document_pages.vertical_align (top/center/bottom, "top" par défaut, migration incluse pour les supports existants). Quand l'onglet "Pages" du panneau gauche est actif, le panneau Propriétés (droite) affiche maintenant l'alignement de la page active au lieu des propriétés d'un élément — un contrôle segmenté qui persiste via une nouvelle route dédiée et met à jour le canevas immédiatement. Le contenu-seed des thèmes porte désormais aussi ce réglage par page (seed_pages devient une liste de {vertical_align, blocks} plutôt qu'une liste de listes de blocs) : la page de titre du thème "Sécurité Incendie" est centrée verticalement, comme demandé, cohérente avec la maquette d'origine. L'aperçu de thème (iframe de la modale) reflète aussi ce réglage par page. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-24 10:24:48 +02:00
parent be62275675
commit 746feb3796
20 changed files with 500 additions and 215 deletions
@@ -76,6 +76,7 @@ from .pages.get_document_page import get_document_page
 from .pages.list_document_pages import list_document_pages
 from .pages.move_document_page import move_document_page
 from .pages.replace_document_content import replace_document_content
+from .pages.set_document_page_vertical_align import VERTICAL_ALIGNS, set_document_page_vertical_align
 from .pages.update_document_page import update_document_page
 from .rendering.render_document_element import render_document, render_document_element
 from .rendering.sanitize_svg_markup import sanitize_svg_markup
@@ -105,6 +106,7 @@ __all__ = [
    "MIN_TIMER_SECONDS",
    "MIN_WORDS",
    "MINIGAME_KINDS",
+    "VERTICAL_ALIGNS",
    "add_document_element",
    "add_document_page",
    "delete_document_element",
@@ -130,6 +132,7 @@ __all__ = [
    "sanitize_scenario_config",
    "sanitize_svg_markup",
    "seed_blocks_to_elements",
+    "set_document_page_vertical_align",
    "update_document_element_attributes",
    "update_document_page",
 ]
@@ -43,21 +43,42 @@ décalage un par un).
 - **Retour** : aucun.
 - **Exceptions** : aucune.

-## `replace_document_content(slug: str, seed_pages: list[list[dict[str, Any]]]) -> None`
+## `set_document_page_vertical_align(slug: str, page_id: int, vertical_align: str) -> None`
+Règle l'alignement vertical du CONTENU d'une page (`justify-content` de
+`.docPageContent`, voir `static/document/document-editor.css`) —
+réglable depuis le panneau Propriétés quand l'onglet "Pages" de
+l'éditeur est actif (retour utilisateur du 24/09/2026 : "quand je suis
+sur l'onglet page, dans les propriétés s'affiche l'option de
+l'alignement de la page"). Une valeur hors de `VERTICAL_ALIGNS`
+(`"top"`/`"center"`/`"bottom"`) retombe silencieusement sur `"top"`,
+même philosophie défensive que `update_document_page` pour un titre
+vide.
+- **Retour** : aucun.
+- **Exceptions** : aucune.
+
+### `VERTICAL_ALIGNS: tuple[str, ...]`
+`("top", "center", "bottom")` — valeurs valides de `vertical_align`,
+`"top"` étant la valeur par défaut posée en base (voir
+`db/supports/create_support.py`/`ensure_document_pages_schema.py`).
+
+## `replace_document_content(slug: str, seed_pages: list[dict[str, Any]]) -> None`
 Remplace TOUT le contenu du support par `seed_pages` — utilisée
 UNIQUEMENT quand le créateur choisit "utiliser le contenu du modèle" en
 appliquant un thème (voir `routes/document/document_theme_apply.py` et
 `document_engine/themes/`), jamais appelée sans confirmation explicite
 côté client (action destructive, irréversible côté serveur). `seed_pages`
-est une liste de pages, chaque page une liste de blocs
-`{"kind", "attributes", "children"}` (`children` optionnel, uniquement
-pour un bloc `kind="row"` — un seul niveau de profondeur, comme le moteur
-de rangées lui-même). Les attributs fournis sont fusionnés sur
-`element_default_attributes(kind)`, jamais un remplacement brut. Les
-nouvelles pages sont créées AVANT que les anciennes soient supprimées
-(jamais l'inverse) : passer par zéro page, même brièvement, déclenche le
-filet de sécurité de `ensure_document_pages_schema` (un support a
-toujours au moins une page), qui recréerait une "Page 1" vide parasite.
+est une liste de pages, chaque page un dict
+`{"vertical_align": "top"|"center"|"bottom", "blocks": [...]}`
+(`vertical_align` optionnel, retombe sur `"top"`) ; chaque bloc de
+`blocks` est `{"kind", "attributes", "children"}` (`children` optionnel,
+uniquement pour un bloc `kind="row"` — un seul niveau de profondeur,
+comme le moteur de rangées lui-même). Les attributs fournis sont
+fusionnés sur `element_default_attributes(kind)`, jamais un remplacement
+brut. Les nouvelles pages sont créées AVANT que les anciennes soient
+supprimées (jamais l'inverse) : passer par zéro page, même brièvement,
+déclenche le filet de sécurité de `ensure_document_pages_schema` (un
+support a toujours au moins une page), qui recréerait une "Page 1" vide
+parasite.
 - **Retour** : aucun.
 - **Exceptions** : aucune levée explicitement.

@@ -6,24 +6,28 @@ from ..labels.element_kind_labels import element_default_attributes
 from .add_document_page import add_document_page
 from .delete_document_page import delete_document_page
 from .list_document_pages import list_document_pages
+from .set_document_page_vertical_align import set_document_page_vertical_align


-def replace_document_content(slug: str, seed_pages: list[list[dict[str, Any]]]) -> None:
+def replace_document_content(slug: str, seed_pages: list[dict[str, Any]]) -> None:
    """Remplace TOUT le contenu du support par `seed_pages` — utilisé
    UNIQUEMENT quand le créateur choisit explicitement "utiliser le
    contenu du modèle" en appliquant un thème (voir routes/document/
    document_theme_apply.py, jamais appelée sans confirmation explicite
    côté client : action destructive, irréversible côté serveur).

-    `seed_pages` est une liste de pages, chaque page une liste de blocs
-    `{"kind": str, "attributes": dict, "children": [...]}` (`children`
-    optionnel, uniquement pour un bloc `kind="row"` — chaque enfant a la
-    même forme `{"kind", "attributes"}`, sans petit-enfant : le moteur de
-    rangées ne descend jamais à plus d'un niveau, voir document_engine/
-    rendering/render_document_element.py::_render_row). Les attributs
-    fournis sont FUSIONNÉS sur element_default_attributes(kind) (jamais un
-    remplacement brut) pour rester valides même si `seed_pages` n'en
-    précise qu'une partie."""
+    `seed_pages` est une liste de pages, chaque page un dict
+    `{"vertical_align": "top"|"center"|"bottom", "blocks": [...]}`
+    (`vertical_align` optionnel, retombe sur "top" — voir
+    set_document_page_vertical_align.VERTICAL_ALIGNS) ; chaque bloc de
+    `blocks` est `{"kind": str, "attributes": dict, "children": [...]}`
+    (`children` optionnel, uniquement pour un bloc `kind="row"` — chaque
+    enfant a la même forme `{"kind", "attributes"}`, sans petit-enfant :
+    le moteur de rangées ne descend jamais à plus d'un niveau, voir
+    document_engine/rendering/render_document_element.py::_render_row).
+    Les attributs fournis sont FUSIONNÉS sur
+    element_default_attributes(kind) (jamais un remplacement brut) pour
+    rester valides même si `seed_pages` n'en précise qu'une partie."""
    # Les nouvelles pages sont créées AVANT de supprimer les anciennes
    # (jamais l'inverse) : passer par zéro page, même un court instant,
    # déclenche le filet de sécurité de ensure_document_pages_schema (un
@@ -31,9 +35,12 @@ def replace_document_content(slug: str, seed_pages: list[list[dict[str, Any]]])
    # vide juste avant l'ajout de la première page du thème — bug réel
    # rencontré en écrivant les tests de cette fonction.
    old_page_ids = [page["id"] for page in list_document_pages(slug)]
-    for page_blocks in seed_pages:
+    for seed_page in seed_pages:
        page_id = add_document_page(slug)
-        for block in page_blocks:
+        vertical_align = seed_page.get("vertical_align")
+        if vertical_align:
+            set_document_page_vertical_align(slug, page_id, vertical_align)
+        for block in seed_page.get("blocks", []):
            _add_seed_block(slug, page_id, block, parent_id=None)
    for old_page_id in old_page_ids:
        delete_document_page(slug, old_page_id)
@@ -0,0 +1,20 @@
+from db.supports import connect_support, ensure_document_pages_schema
+
+VERTICAL_ALIGNS = ("top", "center", "bottom")
+
+
+def set_document_page_vertical_align(slug: str, page_id: int, vertical_align: str) -> None:
+    """Règle l'alignement vertical du CONTENU d'une page (`justify-content`
+    de `.docPageContent`, voir static/document/document-editor.css) —
+    réglable depuis le panneau Propriétés quand l'onglet "Pages" est actif
+    (retour utilisateur du 24/09/2026), jamais un attribut par élément (ça
+    concerne la page entière, pas un bloc de contenu particulier). Une
+    valeur hors de `VERTICAL_ALIGNS` retombe silencieusement sur "top"
+    (état par défaut) plutôt que de lever — même philosophie défensive que
+    `update_document_page` pour un titre vide."""
+    ensure_document_pages_schema(slug)
+    clean_align = vertical_align if vertical_align in VERTICAL_ALIGNS else "top"
+    conn = connect_support(slug)
+    conn.execute("UPDATE _document_pages SET vertical_align = ? WHERE id = ?", (clean_align, page_id))
+    conn.commit()
+    conn.close()
@@ -8,171 +8,193 @@ 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."
-                )
+SECURITE_INCENDIE_SEED_PAGES: list[dict[str, Any]] = [
+    # Page 1 — Titre (contenu centré verticalement, comme une page de
+    # garde — retour utilisateur du 24/09/2026)
+    {
+        "vertical_align": "center",
+        "blocks": [
+            {"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",
-                ]
+    {
+        "blocks": [
+            {"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."
-                )
+            {
+                "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"},
+    {
+        "blocks": [
+            {"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": "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": [
+            {
+                "kind": "row",
+                "attributes": {"gap": 10, "align": "stretch", "justify": "flex-start"},
+                "children": [
                    {
-                        "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,
+                        "kind": "carte",
+                        "attributes": {"label": "A", "title": "Feux secs", "description": "Bois, papier, tissus"},
                    },
                    {
-                        "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,
+                        "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"},
                    },
                    {
-                        "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,
+                        "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.
+    {
+        "blocks": [
+            {
+                "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
+    {
+        "blocks": [
+            {"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).
+    {
+        "blocks": [
+            {
+                "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,
+                        },
+                    ],
+                },
+            }
+        ],
+    },
 ]
@@ -17,14 +17,15 @@ Un dict par thème : `id` (identifiant stable, utilisé dans les URLs et
 persisté via `db.set_document_theme`), `name`, `category`, `description`
 (affichage dans la modale), `css_path` (chemin sous `static/`, passé à
 `url_for('static', filename=...)`), `font_url` (optionnel, lien Google
-Fonts), `seed_pages` (contenu de démonstration, voir
-`document_engine.replace_document_content`). L'auteur d'un thème est
-responsable de respecter les règles structurelles du moteur dans son
-`seed_pages` (ex. un mini-jeu seul sur sa page — voir
-`routes/document/document_element_add.py` — jamais revérifié
-automatiquement puisque ce contenu vient du thème, pas de l'utilisateur ;
-voir `tests/document/test_document_themes.py` pour la vérification
-statique de cette règle sur tout le catalogue).
+Fonts), `seed_pages` (contenu de démonstration — une liste de dicts
+`{"vertical_align": "top"|"center"|"bottom", "blocks": [...]}`, voir
+`document_engine.replace_document_content` pour la forme exacte de
+`blocks`). L'auteur d'un thème est responsable de respecter les règles
+structurelles du moteur dans son `seed_pages` (ex. un mini-jeu seul sur
+sa page — voir `routes/document/document_element_add.py` — jamais
+revérifié automatiquement puisque ce contenu vient du thème, pas de
+l'utilisateur ; voir `tests/document/test_document_themes.py` pour la
+vérification statique de cette règle sur tout le catalogue).

 ## `get_document_theme_entry(theme_id: str) -> dict[str, Any] | None`
 - **Retour** : l'entrée de `DOCUMENT_THEMES` dont `id == theme_id`, ou
@@ -32,8 +33,9 @@ statique de cette règle sur tout le catalogue).
 - **Exceptions** : aucune.

 ## `seed_blocks_to_elements(blocks: list[dict[str, Any]]) -> list[dict[str, Any]]`
-Convertit une liste de blocs de contenu-seed (`seed_pages[i]`) en une
-liste d'éléments "à plat" (id/kind/parent_id/attributes) directement
+Convertit une liste de blocs de contenu-seed (`seed_pages[i]["blocks"]`)
+en une liste d'éléments "à plat" (id/kind/parent_id/attributes)
+directement
 exploitable par `document_engine.render_document` — ids synthétiques
 NÉGATIFS, jamais persistés. Utilisée UNIQUEMENT pour l'aperçu d'un thème
 (voir `routes/document/document_theme_preview.py`, destiné à un