Audit complet de mise en forme — Image (2e élément du tableau)

Implémente toutes les options manquantes identifiées pour l'élément
Image : dimensionnement/ratio/object-fit, filtres CSS, upload de
fichier (en plus de l'URL), lien/plein écran au clic, chargement
différé, légende, et tous les attributs de boîte partagés déjà créés
pour Titre/Paragraphe (padding/margin/fond/bordure/ombre/opacité/
position du bloc).

Système de pages : un support peut désormais avoir 0 page (un nouveau
support démarre vide), suppression de toutes les pages en un clic, et
la pagination automatique insère intelligemment la nouvelle page juste
après celle qui déborde plutôt qu'en toute fin de liste.

Bugs réels trouvés et corrigés en cours de route : le style de bloc
(dont align-self) ciblait l'élément interne au lieu de son enveloppe
(légende/lien) ; une image à sa taille native pouvait déclencher une
pagination infinie ; upload/mise à jour d'attribut ne déclenchaient
jamais le contrôle de débordement.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
william
2026-09-26 12:06:44 +02:00
co-authored by Claude Sonnet 5
parent 6c7675fad0
commit 9ad50c58b8
27 changed files with 1299 additions and 174 deletions
+28 -11
View File
@@ -4,13 +4,21 @@ 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.
(voir `document_engine/elements/`, filtré par `page_id`).
**Un support peut avoir 0 page** (retour utilisateur du 26/09/2026 :
"l'éditeur ne dois plus etre obliger d'avoir une page active ou créer,
il peut etre ouvert sans aucune page") — `create_support` n'en crée plus
aucune par défaut, et `ensure_document_pages_schema` ne recrée plus
"Page 1" dès que la table est vide (seule exception : la migration
ponctuelle et historique d'un support pré-pages qui avait déjà des
éléments sans `page_id`). `routes/document/document_edit.py` et le
frontend (`static/document/js/document-editor.js`) gèrent explicitement
cet état "aucune page" (pas de page active, canevas vide avec une
invite à en créer une). La garde "jamais supprimer la dernière page" a
été retirée du côté route (voir `delete_all_document_pages` ci-dessous
et `routes/document/document_page_delete.py`) : ce paquet n'a jamais
posé cette contrainte lui-même.
## `add_document_page(slug: str, title: str | None = None) -> int`
Ajoute une page en fin de la bande d'onglets. `title` par défaut :
@@ -87,9 +95,18 @@ 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).
Ne refuse JAMAIS de supprimer la dernière page restante — un support à
0 page est un état valide (voir plus haut).
- **Retour** : aucun.
- **Exceptions** : aucune.
## `delete_all_document_pages(slug: str) -> None`
Supprime TOUTES les pages du support d'un coup, et tous leurs éléments
de contenu avec elles (retour utilisateur : "une option dans page pour
supprimer toute les page d'un coup") — action destructive et
irréversible côté serveur, jamais appelée sans confirmation explicite
côté client (voir `static/document/js/document-editor.js`,
`forgeDocDeleteAllPages`). Le support se retrouve à 0 page, exactement
comme un support neuf.
- **Retour** : aucun.
- **Exceptions** : aucune.