williamandClaude Sonnet 5
746feb3796
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>
4.8 KiB
document_engine/pages/
CRUD des pages d'un support de formation (_document_pages, voir
db/supports/create_support.py) — retour utilisateur du 21/09/2026:
"il faut implémenter un système de page". Un support est désormais
composé de plusieurs pages, chacune portant son propre flux d'éléments
(voir document_engine/elements/, filtré par page_id). Un support a
TOUJOURS au moins une page (create_support en crée une par défaut,
ensure_document_pages_schema en garantit une pour les supports plus
anciens) — la garde "jamais supprimer la dernière page" est un
garde-fou métier posé par l'appelant (voir
routes/document/document_page_delete.py), pas une contrainte de ce
paquet.
add_document_page(slug: str, title: str | None = None) -> int
Ajoute une page en fin de la bande d'onglets. title par défaut :
"Page N" (N = position 1-indexée + 1) si non fourni.
- Retour : l'
idde la nouvelle page. - Exceptions : aucune levée explicitement.
list_document_pages(slug: str) -> list[dict[str, Any]]
Toutes les pages du support, triées par order_index.
- Retour : liste de dicts (une ligne de table chacun).
- Exceptions : aucune.
get_document_page(slug: str, page_id: int) -> dict[str, Any] | None
Récupère une seule page par id.
- Retour : le dict de la page, ou
Nonesi l'id n'existe pas. - Exceptions : aucune.
update_document_page(slug: str, page_id: int, title: str) -> None
Renomme une page. Un titre vide (une fois .strip()-é) est
silencieusement ignoré — la page garde son titre précédent plutôt que de
se retrouver sans nom dans la bande d'onglets.
- Retour : aucun.
- Exceptions : aucune.
move_document_page(slug: str, page_id: int, new_index: int) -> None
Réordonne une page dans la bande d'onglets (glisser-déposer) —
renumérote intégralement order_index sur toutes les pages, même
principe que document_engine.move_document_element (jamais un
décalage un par un).
- Retour : aucun.
- Exceptions : aucune.
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 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.
delete_document_page(slug: str, page_id: int) -> None
Supprime une page ET ses éléments (DELETE FROM _document_elements WHERE page_id = ? explicite — la contrainte FOREIGN KEY ... ON DELETE CASCADE n'existe que pour les supports créés après l'ajout des pages,
voir db/supports/ensure_document_pages_schema.py pour les anciens).
Ne refuse JAMAIS de supprimer la dernière page restante — cette règle
est posée par l'appelant, pas par cette fonction bas niveau (même
découpage que routes/game/screens/screen_delete.py côté jeu, où le
garde-fou vit aussi dans la route).
- Retour : aucun.
- Exceptions : aucune.