@fraza/core 0.3.8 → 0.3.12

package/dist/docs/06-modules/forms/{installation.md → 01-installation.md}

@@ -4,16 +4,17 @@ description: Installer @fraza/module-forms, créer les tables, vérifier les dé
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/forms/configuration
-    - 06-modules/forms/affichage
+    - 06-modules/forms/02-configuration
+    - 06-modules/forms/06-affichage
 ---
 
-Cette page couvre l'installation de `@fraza/module-forms` dans un projet déjà structuré par `@fraza/start`. Le module n'est jamais déclaré à la main : il est découvert au boot par scan des dépendances, comme décrit dans [Cycle de vie d'un module](../../02-guides/cycle-de-vie-d-un-module.md).
+Cette page installe `@fraza/module-forms` dans un projet créé par `npx @fraza/start`. Le module n'est jamais déclaré à la main : il est découvert au boot par scan des dépendances, comme décrit dans [Cycle de vie d'un module](../../02-guides/cycle-de-vie-d-un-module.md).
 
 ## Prérequis
 
-- Un projet généré par `npx @fraza/start`, avec `@fraza/core` installé.
-- **`NEXT_PUBLIC_URL` renseignée.** Ce n'est pas une recommandation : sans elle, toute soumission est rejetée. Voir plus bas.
+- Un projet créé par `npx @fraza/start`, avec `@fraza/core` à jour.
+- **`NEXT_PUBLIC_URL` renseignée.** Sans elle, toute soumission est rejetée. Voir [Vérifier l'origine publique](#vérifier-lorigine-publique).
+- Aucun compte : le paquet est publié sur npmjs.
 
 ## Installer
 
@@ -23,54 +24,52 @@ npm i @fraza/module-forms
 
 Ajouter la variable d'activation à `.env.local`, et aux variables de la plateforme en production :
 
-```bash
+```dotenv
 #------ MODULE - FORMS ------#
 FRAZA_MODULE_FORMS=true
 ```
 
 Sans ce drapeau, le module est ignoré : aucune table, aucune route, aucune entrée d'admin.
 
-Régénérer les manifestes puis créer les tables :
+Régénérer les manifestes, puis créer les tables :
 
 ```bash
 npx fraza-modules sync    # déclenché automatiquement au postinstall
-npx fraza-db init         # crée fraza_forms_form et fraza_forms_submission
+npx fraza-db init         # crée les tables fraza_forms_*
 ```
 
-## Version de core exigée
+`fraza-db init` est idempotent : sur une base qui a déjà les tables, il applique les migrations en attente sans toucher aux données. Il crée `fraza_forms_form`, `fraza_forms_submission` et `fraza_forms_storage_deletion`, la file des fichiers à retirer du stockage. Il enregistre aussi les permissions `forms.view` et `forms.manage`, et les attribue au rôle `admin`. Voir [Modèle de données](./07-modele-de-donnees.md).
+
+La tâche planifiée `forms-retention` demande la table `fraza_cron_runs` du core, créée par `npx fraza-db migrate`.
 
-Le module réclame `@fraza/core` 0.1.0 ou plus, et le boot refuse une combinaison plus ancienne en nommant le module. C'est ce core qui sait générer `app/.fraza/public-pages.server.js`, le manifeste par lequel la page publique `/za/forms/<slug>` s'enregistre.
+## Projet monté à la main
 
-Si `app/za/[...path]/page.js` ne porte pas encore l'import du manifeste, par exemple sur un projet monté à la main, le doctor l'ajoute :
+La page publique `/za/forms/<slug>` s'enregistre par le manifeste `app/.fraza/public-pages.server.js`, que génère `fraza-modules sync`. Le start template importe déjà ce manifeste dans `app/za/[...path]/page.js`. Sur un projet monté à la main, le doctor ajoute l'import :
 
 ```bash
 npx fraza-doctor --fix
 npx fraza-modules sync
 ```
 
-`fraza-db init` saute les tables déjà présentes, et crée aussi `fraza_forms_storage_deletion`. Les migrations `001-truncate-stored-ips` et `002-queue-storage-deletions` passent par `npx fraza-db migrate`. La tâche `forms-retention` demande la table `fraza_cron_runs` du core. Voir [Modèle de données](./modele-de-donnees.md).
-
 ## Vérifier l'origine publique
 
-C'est l'étape que l'on oublie, et elle rend le module inutilisable si elle manque.
+C'est l'étape que l'on oublie, et elle rend le module inutilisable si elle manque. Dans `.env.local`, et dans les variables de la plateforme en production avec l'adresse du site :
 
-```bash
+```dotenv
 NEXT_PUBLIC_URL=https://exemple.com
 ```
 
 Le routeur du core protège toute requête modifiante par une **comparaison d'origine**. L'en-tête `Origin` de la requête doit correspondre à l'origine déclarée dans cette variable. Si elle n'est pas renseignée, la comparaison échoue systématiquement et la soumission remonte en `403`.
 
-En local, placer `NEXT_PUBLIC_URL=http://localhost:3000` dans `.env.local`. Voir [Fichiers d'environnement](../../01-demarrage/03-configuration.md#fichiers-denvironnement).
+En local, `@fraza/start` a déjà écrit `NEXT_PUBLIC_URL=http://localhost:3000` dans `.env.local`. Voir [Fichiers d'environnement](../../01-demarrage/03-configuration.md#fichiers-denvironnement).
 
-Le symptôme est trompeur : le formulaire s'affiche, se remplit, et l'envoi échoue sans message explicite côté visiteur.
-
-Voir [Soumissions](./soumissions.md) pour le détail de cette protection.
+Le symptôme est trompeur : le formulaire s'affiche, se remplit, et l'envoi échoue sans message explicite côté visiteur. Voir [Soumissions](./05-soumissions.md) pour le détail de cette protection.
 
 ## Activer les courriels
 
-Les notifications à l'équipe et les accusés de réception passent par le service de courriel du core, donc par le fournisseur configuré pour le projet.
+Les notifications à l'équipe et les accusés de réception passent par le service de courriel du core, donc par le fournisseur configuré pour le projet. Dans `.env.local` :
 
-```bash
+```dotenv
 FRAZA_EMAIL_RESEND_APIKEY=re_...
 FRAZA_EMAIL_FROM_ADDRESS=noreply@exemple.com
 FRAZA_EMAIL_FROM_NAME=Exemple
@@ -78,9 +77,7 @@ FRAZA_EMAIL_FROM_NAME=Exemple
 
 Sans ces variables, le module fonctionne : les soumissions sont enregistrées et consultables dans l'admin, seuls les courriels ne partent pas. Leur échec n'a jamais d'effet sur la soumission.
 
-Les courriels passent par la table `fraza_email_outbox` du core, créée par `npx fraza-db migrate`. Sans elle, ils ne sont pas mis en file (erreur journalisée), et la soumission reste enregistrée.
-
-Voir [core/email](../../03-reference/01-cores/email.md).
+Les courriels passent par la table `fraza_email_outbox` du core, créée par `npx fraza-db migrate`. Sans elle, ils ne sont pas mis en file (erreur journalisée), et la soumission reste enregistrée. Voir [core/email](../../03-reference/01-cores/email.md).
 
 ## Activer les champs fichier
 
@@ -96,7 +93,7 @@ Créer un formulaire depuis `/admin/forms`, lui donner un slug, puis l'ouvrir di
 /za/forms/<slug>
 ```
 
-Cette page est enregistrée par le module au boot, il n'y a rien à câbler. Elle sert avant tout à vérifier l'installation : pour un vrai site, préférer un bloc du BlockEditor écrit dans le projet ou le composant `FormEmbed`. Voir [Affichage](./affichage.md).
+Cette page est enregistrée par le module au boot, il n'y a rien à câbler. Elle sert avant tout à vérifier l'installation : pour un vrai site, préférer un bloc du BlockEditor écrit dans le projet ou le composant `FormEmbed`. Voir [Affichage](./06-affichage.md).
 
 ## Vérifier
 
@@ -107,9 +104,7 @@ Cette page est enregistrée par le module au boot, il n'y a rien à câbler. Ell
 2. `Formulaires` apparaît dans la barre latérale de l'admin, avec les items `Formulaires` et `Soumissions`.
 3. Créer un formulaire, l'ouvrir à `/za/forms/<slug>`, l'envoyer, puis retrouver la soumission dans `/admin/forms/submissions`.
 
-Si l'envoi échoue, vérifier d'abord `NEXT_PUBLIC_URL`, puis attendre trois secondes avant de valider : un envoi trop rapide est refusé par la protection anti-robot. Voir [Soumissions](./soumissions.md).
-
-Les permissions du module sont enregistrées et attribuées au rôle `admin` pendant `fraza-db init`. Un module ajouté après coup n'a donc besoin que d'un `npx fraza-db init` pour que `forms.view` et `forms.manage` apparaissent dans `/admin/roles`.
+Si l'envoi échoue, vérifier d'abord `NEXT_PUBLIC_URL`, puis attendre trois secondes avant de valider : un envoi trop rapide est refusé par la protection anti-robot. Voir [Soumissions](./05-soumissions.md).
 
 ## Mettre à jour
 
@@ -117,9 +112,9 @@ Les permissions du module sont enregistrées et attribuées au rôle `admin` pen
 npx fraza-update
 ```
 
-La commande installe la dernière version de tous les paquets Fraza du site, toutes à la fois : tous les paquets Fraza à leur dernière version fonctionnent ensemble. Mettre à jour `@fraza/module-forms` seul, par `npm i`, laisserait le core et les autres modules en arrière.
+La commande installe la dernière version de tous les paquets Fraza du site, toutes à la fois, puis enchaîne `fraza-modules sync`, `fraza-db migrate` et `fraza-doctor`. Tous les paquets Fraza à leur dernière version fonctionnent ensemble : mettre à jour `@fraza/module-forms` seul, par `npm i`, laisserait le core et les autres modules en arrière.
 
-Les notes de version sont livrées avec le package, dans `node_modules/@fraza/module-forms/CHANGELOG.md`.
+Les notes de version sont livrées avec le paquet, dans `node_modules/@fraza/module-forms/CHANGELOG.md`.
 
 ## Notes
 

package/dist/docs/06-modules/forms/{configuration.md → 02-configuration.md}

@@ -4,7 +4,7 @@ description: Variable d'activation, dépendances d'origine, de courriel et de st
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/forms/soumissions
+    - 06-modules/forms/05-soumissions
     - 03-reference/06-configuration/variables-d-environnement
 ---
 
@@ -30,7 +30,7 @@ En revanche, trois services du core conditionnent son fonctionnement. Les ignore
 | `FRAZA_STORAGE_*` | Les champs de type fichier échouent. Le reste du formulaire fonctionne. |
 | `FRAZA_ENCRYPTION_KEY` | Aucun jeton de délai n'est émis : le délai minimal n'est pas vérifié, avec un avertissement au journal. |
 | Table `fraza_email_outbox` (`npx fraza-db migrate`) | Aucun courriel n'est mis en file. Les soumissions sont enregistrées. |
-| `FRAZA_NAME`, `FRAZA_LOGO_URL`, `FRAZA_SITE_URL` | La [page publique dédiée](./affichage.md#page-publique-dédiée) s'affiche sans marque : ni logo dans la barre, ni nom en pied de page. Le formulaire lui même fonctionne. |
+| `FRAZA_NAME`, `FRAZA_LOGO_URL`, `FRAZA_SITE_URL` | La [page publique dédiée](./06-affichage.md#page-publique-dédiée) s'affiche sans marque : ni logo dans la barre, ni nom en pied de page. Le formulaire lui même fonctionne. |
 
 La première ligne mérite d'être répétée : c'est la panne la plus fréquente de ce module, et la moins lisible. Le routeur du core compare l'en-tête `Origin` de la requête à l'origine déclarée. Sans variable, il n'y a rien à comparer et la protection refuse tout.
 
@@ -56,7 +56,7 @@ La première, `Général`, porte le titre, le slug, la description et le statut.
 
 Le mode « redirection » remplace le message par une navigation vers l'URL donnée, exécutée par le navigateur après la réponse du serveur. Une adresse en `https://` ou `http://`, ou une page du site comme `/merci` ; toute autre est refusée à l'enregistrement.
 
-Voir [Soumissions](./soumissions.md) pour l'effet exact de chacun de ces réglages sur le pipeline.
+Voir [Soumissions](./05-soumissions.md) pour l'effet exact de chacun de ces réglages sur le pipeline.
 
 ## Statut d'un formulaire
 
@@ -85,7 +85,7 @@ Elles ne suffisent pas seules : les routes et les écrans d'admin exigent d'abor
 
 `forms.view` suffit à **lire le contenu des soumissions**, y compris les données personnelles qu'elles portent et les pièces jointes. Ce n'est pas une permission de simple consultation de structure, à garder en tête au moment de la distribuer.
 
-Le point de soumission public, lui, n'exige aucune permission. Voir [Soumissions](./soumissions.md).
+Le point de soumission public, lui, n'exige aucune permission. Voir [Soumissions](./05-soumissions.md).
 
 ## Entrées d'admin
 
@@ -93,11 +93,11 @@ Le module enregistre une section contenant deux items.
 
 | Élément | Valeur |
 |---|---|
-| Section | `Formulaires`, icône `ChecklistIcon`, ordre 75. |
+| Section | `Formulaires`, groupe `content`, icône `ChecklistIcon`, ordre 75. |
 | Item 1 | `Formulaires`, `/admin/forms`, icône `ChecklistIcon`, permission `forms.view`. |
 | Item 2 | `Soumissions`, `/admin/forms/submissions`, icône `InboxIcon`, permission `forms.view`. |
 
-L'ordre 75 place la section après les modules de contenu. Voir [Étendre l'admin](../../02-guides/etendre-l-admin.md).
+Le groupe `content` range la section dans la partie Contenu de la barre latérale, et l'ordre 75 la place après les pages. Voir [Étendre l'admin](../../02-guides/etendre-l-admin.md).
 
 ## Notes
 

package/dist/docs/06-modules/forms/{champs.md → 03-champs.md}

@@ -4,8 +4,8 @@ description: Catalogue des types de champs, options de configuration, largeurs,
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/forms/soumissions
-    - 06-modules/forms/affichage
+    - 06-modules/forms/05-soumissions
+    - 06-modules/forms/06-affichage
 ---
 
 Un formulaire est une liste ordonnée de champs, composée au glisser-déposer dans l'onglet Champs du constructeur. Les champs sont stockés en JSON avec le formulaire, il n'y a pas de table de champs.
@@ -101,7 +101,7 @@ Les champs fichier d'un formulaire totalisent 50 Mo au plus (`maxFiles × maxSiz
 
 `ALL` lève la restriction de famille, pas les contrôles de contenu du core : le SVG reste refusé quel que soit le réglage, la signature binaire doit correspondre à l'extension déclarée quand cette extension est connue, et le contenu est inspecté à la recherche de balises exécutables. La taille maximale du champ s'applique toujours.
 
-Le point de soumission compte les fichiers envoyés sous le nom du champ, `maxFiles` au plus, vérifie chacun, puis les téléverse tous une fois la soumission entière validée. Voir [Soumissions](./soumissions.md).
+Le point de soumission compte les fichiers envoyés sous le nom du champ, `maxFiles` au plus, vérifie chacun, puis les téléverse tous une fois la soumission entière validée. Voir [Soumissions](./05-soumissions.md).
 
 ### Longueur des textes
 
@@ -139,6 +139,6 @@ La même lecture (`readSubmission` de `fields.js`) tourne dans le navigateur ava
 
 ## Notes
 
-- Les champs sont stockés en JSON dans le formulaire, sans schéma en base. Leur définition est vérifiée à l'enregistrement du formulaire, voir [Modèle de données](./modele-de-donnees.md).
+- Les champs sont stockés en JSON dans le formulaire, sans schéma en base. Leur définition est vérifiée à l'enregistrement du formulaire, voir [Modèle de données](./07-modele-de-donnees.md).
 - Le type `checkbox` porte une propriété `consentText` créée à l'ajout du champ. Elle n'est ni modifiable dans le constructeur, ni rendue nulle part. Ne pas compter dessus.
 - L'ordre des champs dans le constructeur est l'ordre de rendu, l'ordre du tableau récapitulatif des courriels, et l'ordre de la fiche de soumission.

package/dist/docs/06-modules/forms/{admin.md → 04-admin.md}

@@ -4,13 +4,13 @@ description: Liste des formulaires, constructeur à deux onglets, boîte de réc
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/forms/champs
-    - 06-modules/forms/soumissions
+    - 06-modules/forms/03-champs
+    - 06-modules/forms/05-soumissions
 ---
 
 Le module ajoute une section `Formulaires` à la barre latérale de l'admin, avec deux entrées : les formulaires et leurs soumissions. Cette page décrit ce que fait l'interface, y compris les quelques comportements qui surprennent.
 
-L'accès à la section demande `forms.view`, en plus de `admin.access`. Sans elle, `/admin/forms` répond 404, comme une page inconnue. Créer, modifier, dupliquer et supprimer demandent `forms.manage`. Voir [Configuration](./configuration.md).
+L'accès à la section demande `forms.view`, en plus de `admin.access`. Sans elle, `/admin/forms` répond 404, comme une page inconnue. Créer, modifier, dupliquer et supprimer demandent `forms.manage`. Voir [Configuration](./02-configuration.md).
 
 ## Écrans
 
@@ -36,7 +36,7 @@ Sous 1024 px, la liste compacte montre le titre, la date de modification, le nom
 | Dupliquer | Copie titrée `<titre> (copie)`, slug ré-unicifié, statut `inactive`. Aucune soumission copiée. |
 | Supprimer | Après confirmation. Supprime **les soumissions du formulaire** et leurs fichiers, dans une transaction. |
 
-La confirmation de suppression nomme les soumissions et leurs pièces jointes. Elle est irréversible, et les pièces jointes sont retirées du stockage objet. Voir [Modèle de données](./modele-de-donnees.md).
+La confirmation de suppression nomme les soumissions et leurs pièces jointes. Elle est irréversible, et les pièces jointes sont retirées du stockage objet. Voir [Modèle de données](./07-modele-de-donnees.md).
 
 ## Constructeur
 
@@ -48,11 +48,11 @@ Un bouton `Voir` ouvre la page publique dans un nouvel onglet. Il n'apparaît qu
 
 Trois colonnes : la palette, le canevas, l'inspecteur.
 
-La **palette** liste les types de champs en quatre familles, `Basique`, `Choix`, `Avancé` et `Mise en page`. Cliquer sur un type l'ajoute à la fin, le glisser le dépose à la position visée. Voir [Champs](./champs.md) pour le catalogue.
+La **palette** liste les types de champs en quatre familles, `Basique`, `Choix`, `Avancé` et `Mise en page`. Cliquer sur un type l'ajoute à la fin, le glisser le dépose à la position visée. Voir [Champs](./03-champs.md) pour le catalogue.
 
 Le **canevas** affiche les champs à leur largeur réelle, donc côte à côte quand ils sont en demi ou en tiers. Chaque bloc porte son libellé, son type et son nom, et une poignée pour le déplacer. La croix de suppression n'apparaît qu'au survol.
 
-L'**inspecteur** n'apparaît que lorsqu'un champ est sélectionné, et un champ qui vient d'être ajouté l'est automatiquement. Il porte les réglages du type sélectionné, décrits dans [Champs](./champs.md) : pour un champ fichier, « Nombre de fichiers maximal » et « Taille maximale par fichier (Mo) », bornés ; pour un texte ou un paragraphe, « Longueur maximale (caractères) ».
+L'**inspecteur** n'apparaît que lorsqu'un champ est sélectionné, et un champ qui vient d'être ajouté l'est automatiquement. Il porte les réglages du type sélectionné, décrits dans [Champs](./03-champs.md) : pour un champ fichier, « Nombre de fichiers maximal » et « Taille maximale par fichier (Mo) », bornés ; pour un texte ou un paragraphe, « Longueur maximale (caractères) ».
 
 ### Onglet Réglages
 
@@ -94,12 +94,12 @@ La carte `Réponses` affiche les champs **dans l'ordre du formulaire**, avec le
 
 Les champs cachés **apparaissent** dans cette carte, contrairement aux courriels qui les excluent. Une case de consentement s'affiche en `Oui` ou `Non`, une liste de cases à cocher en valeurs séparées par des virgules.
 
-La carte `Fichiers` n'apparaît que s'il y en a. Chaque pièce jointe se télécharge par la route protégée du module, dans un nouvel onglet. Voir [API](./api.md).
+La carte `Fichiers` n'apparaît que s'il y en a. Chaque pièce jointe se télécharge par la route protégée du module, dans un nouvel onglet. Voir [API](./08-api.md).
 
-La carte `Détails techniques` expose le statut, le réseau de l'adresse IP (`/24` ou `/48`), ou `—` quand le formulaire n'en garde aucune, le navigateur et la page d'origine. Le navigateur et la page d'origine viennent des en-têtes de la requête et sont falsifiables. Voir [Soumissions](./soumissions.md).
+La carte `Détails techniques` expose le statut, le réseau de l'adresse IP (`/24` ou `/48`), ou `—` quand le formulaire n'en garde aucune, le navigateur et la page d'origine. Le navigateur et la page d'origine viennent des en-têtes de la requête et sont falsifiables. Voir [Soumissions](./05-soumissions.md).
 
 ## Notes
 
 - Aucun écran n'adapte ses boutons à la permission : un compte qui n'a que `forms.view` voit les actions d'écriture et se fait refuser par l'API au moment de les utiliser.
 - La duplication d'un formulaire ne demande pas de confirmation. Elle est sans risque, la copie étant créée inactive.
-- Le constructeur ne prévisualise pas le formulaire. Pour le voir tel que le visiteur le verra, ouvrir sa page publique avec le bouton `Voir`. Voir [Affichage](./affichage.md).
+- Le constructeur ne prévisualise pas le formulaire. Pour le voir tel que le visiteur le verra, ouvrir sa page publique avec le bouton `Voir`. Voir [Affichage](./06-affichage.md).

package/dist/docs/06-modules/forms/{soumissions.md → 05-soumissions.md}

@@ -4,8 +4,8 @@ description: Pipeline de soumission, vérification d'origine, anti-robots, pièc
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/forms/modele-de-donnees
-    - 06-modules/forms/api
+    - 06-modules/forms/07-modele-de-donnees
+    - 06-modules/forms/08-api
 ---
 
 Une soumission traverse neuf étapes, dans cet ordre. Comprendre lesquelles rejettent et lesquelles laissent passer est la clé du diagnostic quand un formulaire ne fonctionne pas.
@@ -42,13 +42,13 @@ Trois conséquences directes :
 - Si aucune des deux variables n'est renseignée, **toute** soumission est refusée. C'est la panne la plus fréquente à l'installation.
 - Une soumission depuis la même origine passe automatiquement, sans jeton à gérer côté client.
 
-Voir [Configuration](./configuration.md).
+Voir [Configuration](./02-configuration.md).
 
 ## Format de la requête
 
 Le corps doit être un formulaire encodé. Les composants du module envoient du **`multipart/form-data`**, seul encodage capable de porter des fichiers. Le parseur accepte aussi `application/x-www-form-urlencoded` pour un formulaire sans pièce jointe. Un corps JSON est refusé dans tous les cas.
 
-Chaque champ de saisie est envoyé sous son `name`, plus deux champs techniques décrits ci-dessous. Les composants fournis par le module s'en chargent. Voir [Affichage](./affichage.md).
+Chaque champ de saisie est envoyé sous son `name`, plus deux champs techniques décrits ci-dessous. Les composants fournis par le module s'en chargent. Voir [Affichage](./06-affichage.md).
 
 ## Anti-robots
 
@@ -82,7 +82,7 @@ Seules les **métadonnées** sont enregistrées avec la soumission : nom du cham
 
 Ces fichiers sont **privés**. Aucune URL publique n'existe : ils ne sont accessibles que par la route de téléchargement de l'admin, protégée par `forms.view`.
 
-Supprimer une soumission retire ses fichiers du stockage, et supprimer un formulaire vide son dossier `forms/<id>/`, après la réponse, depuis la file `fraza_forms_storage_deletion`. Voir [Modèle de données](./modele-de-donnees.md). Une soumission refusée ne laisse aucun fichier : tous sont vérifiés avant le premier téléversement, et ceux déjà envoyés sont retirés si un envoi ou l'enregistrement échoue.
+Supprimer une soumission retire ses fichiers du stockage, et supprimer un formulaire vide son dossier `forms/<id>/`, après la réponse, depuis la file `fraza_forms_storage_deletion`. Voir [Modèle de données](./07-modele-de-donnees.md). Une soumission refusée ne laisse aucun fichier : tous sont vérifiés avant le premier téléversement, et ceux déjà envoyés sont retirés si un envoi ou l'enregistrement échoue.
 
 ## Ce qui est enregistré
 
@@ -97,7 +97,7 @@ L'adresse IP est lue par `getIpFromRequest` du core, comme la clé de limitation
 
 L'agent utilisateur et le référent sont pris tels quels dans les en-têtes, **sans la vérification `FRAZA_TRUST_PROXY`** : un appelant peut les falsifier, ils servent au diagnostic.
 
-Voir [Modèle de données](./modele-de-donnees.md).
+Voir [Modèle de données](./07-modele-de-donnees.md).
 
 ## Courriels
 
@@ -135,7 +135,7 @@ Le serveur bascule une soumission `new` en `read` quand il la sert à sa fiche,
 
 La liste `/admin/forms/submissions` filtre par statut et par formulaire, cinquante par page, du plus récent au plus ancien.
 
-Il n'existe **pas d'export**. Les soumissions se consultent une par une. Voir [Administration](./admin.md) pour le détail des écrans.
+Il n'existe **pas d'export**. Les soumissions se consultent une par une. Voir [Administration](./04-admin.md) pour le détail des écrans.
 
 ## Rétention
 

package/dist/docs/06-modules/forms/{affichage.md → 06-affichage.md}

@@ -4,7 +4,7 @@ description: Les trois façons de rendre un formulaire sur le site, leurs diffé
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/forms/soumissions
+    - 06-modules/forms/05-soumissions
     - 02-guides/blocs-personnalises
 ---
 
@@ -123,5 +123,5 @@ Son rendu suit le [thème du projet](../../02-guides/personnaliser-l-apparence.m
 
 ## Notes
 
-- Les trois voies passent par le même point de soumission et sont donc soumises aux mêmes contrôles d'origine et anti-robots. Voir [Soumissions](./soumissions.md).
-- Un projet qui veut d'autres champs que ceux de `FormRenderer` écrit son propre îlot client, sur le même contrat : jeton de `/token` dans `_t`, champ `_hp` vide, envoi en `multipart/form-data`, `details.fieldErrors` en retour. Voir [API](./api.md).
+- Les trois voies passent par le même point de soumission et sont donc soumises aux mêmes contrôles d'origine et anti-robots. Voir [Soumissions](./05-soumissions.md).
+- Un projet qui veut d'autres champs que ceux de `FormRenderer` écrit son propre îlot client, sur le même contrat : jeton de `/token` dans `_t`, champ `_hp` vide, envoi en `multipart/form-data`, `details.fieldErrors` en retour. Voir [API](./08-api.md).

package/dist/docs/06-modules/forms/{modele-de-donnees.md → 07-modele-de-donnees.md}

@@ -4,7 +4,7 @@ description: Tables fraza_forms_form, fraza_forms_submission et fraza_forms_stor
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/forms/soumissions
+    - 06-modules/forms/05-soumissions
     - 03-reference/01-cores/database
 ---
 
@@ -44,7 +44,7 @@ Un tableau d'objets, dans l'ordre de rendu. Chaque champ porte au minimum `id`,
 
 Il n'existe aucun schéma de base sur ce JSON : la définition est vérifiée par le module à l'enregistrement du formulaire, qui refuse avec un message en français un nom invalide ou en double, un champ à options sans option ou avec une valeur vide ou répétée, des champs fichier au-delà de 50 Mo au total, plus de 100 champs. À la lecture, chaque champ est normalisé : nombres ramenés dans leurs bornes (`maxLength`, `maxFiles`, `maxSizeMb`), options en chaînes, identifiants remplis.
 
-Voir [Champs](./champs.md) pour la structure complète par type.
+Voir [Champs](./03-champs.md) pour la structure complète par type.
 
 ### Structure de `settings`
 
@@ -133,6 +133,6 @@ Les fichiers laissés par des soumissions supprimées avant cette version, dans
 ## Notes
 
 - `dropTables` supprime les trois tables et la fonction du déclencheur, dans l'ordre qui respecte la clé étrangère. Il ne supprime toujours aucun fichier du stockage objet.
-- Une soumission est supprimée après `retentionDays` jours par la tâche `forms-retention`, voir [Soumissions](./soumissions.md#rétention). Sans réglage, elle est gardée sans limite.
+- Une soumission est supprimée après `retentionDays` jours par la tâche `forms-retention`, voir [Soumissions](./05-soumissions.md#rétention). Sans réglage, elle est gardée sans limite.
 - Migrations, appliquées par `npx fraza-db migrate` : `001-truncate-stored-ips` réduit les adresses déjà enregistrées, par lots de 1000, sans effet si on la relance. `002-queue-storage-deletions` crée la file et le déclencheur, aussi posés par `createTables()` sur une base neuve, et met en file le dossier de chaque formulaire supprimé avant elle (les trous de la séquence des identifiants).
 - Le commentaire d'en-tête du module mentionne une clé `sourceUrl` dans `meta`. Elle n'est jamais écrite, le tableau de cette page fait foi.

package/dist/docs/06-modules/forms/{api.md → 08-api.md}

@@ -4,7 +4,7 @@ description: Routes HTTP d'admin et publiques, et fonctions serveur importables
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/forms/soumissions
+    - 06-modules/forms/05-soumissions
     - 03-reference/01-cores/api
 ---
 
@@ -25,7 +25,7 @@ Le module expose ses formulaires de trois façons : des routes HTTP d'admin, tro
 import { getPublicFormById } from '@fraza/module-forms/server';
 ```
 
-`@fraza/module-forms/server` est délibérément séparé de `/public` : il ne contient aucun composant, et reste donc importable depuis un Server Component sans tirer de code client. C'est ce qu'utilise un bloc du BlockEditor écrit dans le projet. Voir [Affichage](./affichage.md).
+`@fraza/module-forms/server` est délibérément séparé de `/public` : il ne contient aucun composant, et reste donc importable depuis un Server Component sans tirer de code client. C'est ce qu'utilise un bloc du BlockEditor écrit dans le projet. Voir [Affichage](./06-affichage.md).
 
 ## API
 
@@ -101,7 +101,7 @@ L'ordre de déclaration compte : les chemins de soumissions sont déclarés **av
 
 `GET /forms/public/:slug/token` renvoie `{ token }`, le jeton du délai minimal, `null` sans `FRAZA_ENCRYPTION_KEY`. Elle répond `404` si le formulaire est absent ou inactif. `FormRenderer` l'appelle à son montage.
 
-`POST /forms/public/:slug/submit` est le point de soumission, compté par le préréglage `public_form`. Il exige un corps en `multipart/form-data`, refuse le JSON, et attend en plus des champs du formulaire les deux champs techniques `_hp` et `_t`, le jeton de la route précédente. Voir [Soumissions](./soumissions.md).
+`POST /forms/public/:slug/submit` est le point de soumission, compté par le préréglage `public_form`. Il exige un corps en `multipart/form-data`, refuse le JSON, et attend en plus des champs du formulaire les deux champs techniques `_hp` et `_t`, le jeton de la route précédente. Voir [Soumissions](./05-soumissions.md).
 
 Chaque formulaire a son plafond de corps : ses champs fichier à leur taille maximale, plus 1 Mio pour le texte. La route, elle, est plafonnée à 51 Mio, le plus grand formulaire possible. Au-delà du plafond du formulaire, la réponse est un 413 « L'envoi dépasse la taille acceptée par ce formulaire (N Mo). ».
 
@@ -109,7 +109,7 @@ Une réponse d'erreur est l'erreur d'API du core, `{ error, code, message, detai
 
 ### Aucune de ces routes n'est ouverte à un autre domaine
 
-Les routes publiques n'exigent ni session ni permission, mais le routeur du core applique une **vérification d'origine** sur toute requête modifiante. La soumission depuis un domaine tiers est donc refusée par construction, et sans `NEXT_PUBLIC_URL` renseignée, toute soumission l'est. Voir [Configuration](./configuration.md).
+Les routes publiques n'exigent ni session ni permission, mais le routeur du core applique une **vérification d'origine** sur toute requête modifiante. La soumission depuis un domaine tiers est donc refusée par construction, et sans `NEXT_PUBLIC_URL` renseignée, toute soumission l'est. Voir [Configuration](./02-configuration.md).
 
 ## Notes
 

package/dist/docs/06-modules/forms/index.md

@@ -4,28 +4,40 @@ description: Constructeur de formulaires, collecte des soumissions, notification
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/forms/installation
-    - 06-modules/forms/champs
+    - 06-modules/forms/01-installation
+    - 06-modules/forms/03-champs
 ---
 
 `@fraza/module-forms` ajoute un constructeur de formulaires à l'admin, une boîte de réception pour les soumissions, et un point de soumission public. Un formulaire se compose au glisser-déposer, sans code.
 
+```bash
+npm i @fraza/module-forms
+```
+
+| Paquet | `@fraza/module-forms` |
+|---|---|
+| Licence | MIT, Fraza Libre. |
+| Registre | npmjs, sans compte ni configuration. |
+| Activation | `FRAZA_MODULE_FORMS=true` |
+
+L'activation, la création des tables et les services dont dépendent les soumissions sont dans [Installation](./01-installation.md).
+
 ![Le constructeur de formulaire, sa palette de champs à gauche et le formulaire en cours à droite](../../assets/modules/forms/constructeur.light.webp)
 
-La palette range les types de champs par famille, et chaque champ posé porte sa largeur : pleine, demie ou tiers de ligne en écran large. L'URL publique s'affiche sous le titre, le formulaire y est servi dès qu'il est enregistré. Voir [Champs](./champs.md) pour le catalogue complet.
+La palette range les types de champs par famille, et chaque champ posé porte sa largeur : pleine, demie ou tiers de ligne en écran large. L'URL publique s'affiche sous le titre, le formulaire y est servi dès qu'il est enregistré. Voir [Champs](./03-champs.md) pour le catalogue complet.
 
 ## Pages de cette section
 
 | Page | Contenu |
 |---|---|
-| [Installation](./installation.md) | Installer le module, créer les tables, vérifier les dépendances. |
-| [Configuration](./configuration.md) | Variables d'environnement, permissions, entrées d'admin. |
-| [Champs](./champs.md) | Catalogue des types de champs et validation appliquée. |
-| [Administration](./admin.md) | Constructeur, liste des formulaires et boîte de réception. |
-| [Soumissions](./soumissions.md) | Pipeline de soumission, anti-spam, fichiers, courriels, rétention. |
-| [Affichage](./affichage.md) | Les trois façons de rendre un formulaire sur le site. |
-| [Modèle de données](./modele-de-donnees.md) | Tables `fraza_forms_form`, `fraza_forms_submission` et `fraza_forms_storage_deletion`. |
-| [API](./api.md) | Routes HTTP et fonctions serveur importables. |
+| [Installation](./01-installation.md) | Installer le module, créer les tables, vérifier les dépendances. |
+| [Configuration](./02-configuration.md) | Variables d'environnement, permissions, entrées d'admin. |
+| [Champs](./03-champs.md) | Catalogue des types de champs et validation appliquée. |
+| [Administration](./04-admin.md) | Constructeur, liste des formulaires et boîte de réception. |
+| [Soumissions](./05-soumissions.md) | Pipeline de soumission, anti-spam, fichiers, courriels, rétention. |
+| [Affichage](./06-affichage.md) | Les trois façons de rendre un formulaire sur le site. |
+| [Modèle de données](./07-modele-de-donnees.md) | Tables `fraza_forms_form`, `fraza_forms_submission` et `fraza_forms_storage_deletion`. |
+| [API](./08-api.md) | Routes HTTP et fonctions serveur importables. |
 
 ## Ce que le module apporte
 
@@ -50,11 +62,11 @@ Le module n'a aucune dépendance de code au-delà du core, mais deux de ses fonc
 | Courriels de notification et de confirmation | La configuration courriel du core, Resend ou SMTP. |
 | Champs de type fichier | Le stockage objet du core. |
 
-La première est la cause de panne la plus fréquente, et la moins visible : le formulaire s'affiche correctement et échoue à l'envoi. Voir [Configuration](./configuration.md).
+La première est la cause de panne la plus fréquente, et la moins visible : le formulaire s'affiche correctement et échoue à l'envoi. Voir [Configuration](./02-configuration.md).
 
 ## Ce que le module ne fait pas
 
-- **Il n'enregistre pas de bloc BlockEditor**, et `@fraza/start` n'en livre pas non plus. Un projet écrit le sien en quelques lignes, ou passe par une autre voie d'affichage. Voir [Affichage](./affichage.md).
+- **Il n'enregistre pas de bloc BlockEditor**, et `@fraza/start` n'en livre pas non plus. Un projet écrit le sien en quelques lignes, ou passe par une autre voie d'affichage. Voir [Affichage](./06-affichage.md).
 - Il ne propose ni logique conditionnelle entre champs, ni étapes multiples, ni calculs.
 - Il n'exporte pas les soumissions. Elles se consultent une par une dans l'admin.
 
@@ -62,4 +74,4 @@ La première est la cause de panne la plus fréquente, et la moins visible : le
 
 - Le champ `version` du manifeste suit la version du paquet : [`fraza-module sync-version`](../../03-reference/05-cli/fraza-module.md#sync-version), lancé par chaque build, la recopie dans `src/version.js`, et `prepublishOnly` refuse de publier si les deux divergent.
 - Supprimer un formulaire supprime ses soumissions et leurs fichiers, dans une transaction, c'est explicite et irréversible.
-- Chaque valeur est vérifiée selon le type de son champ, dans le navigateur puis sur le serveur. Voir [Champs](./champs.md).
+- Chaque valeur est vérifiée selon le type de son champ, dans le navigateur puis sur le serveur. Voir [Champs](./03-champs.md).

package/dist/docs/06-modules/index.md

@@ -60,9 +60,9 @@ Ils sont indépendants et cohabitent sans conflit. Une page nommée `blogue` et
 
 ## Version documentée
 
-Chaque module suit son propre cycle de publication, indépendant de celui du core. La page d'accueil d'un module indique donc la version qu'elle documente.
+Cette section décrit la dernière version publiée de chaque module. Tous les paquets Fraza à leur dernière version fonctionnent ensemble, et `npx fraza-update` les installe ensemble : un projet à jour lit donc la documentation de ses modules.
 
-Si la version installée est plus récente, ses notes de version sont livrées avec elle, dans `node_modules/<module>/CHANGELOG.md`. Elles sont donc consultables hors ligne, sans accès au dépôt. `npx fraza-update` les affiche automatiquement après une mise à jour.
+Ce qui a changé d'une version à l'autre est dans les notes de version, livrées avec chaque module dans `node_modules/<module>/CHANGELOG.md`, et consultables hors ligne. `npx fraza-update` les affiche automatiquement après une mise à jour.
 
 ## Ce qui reste dans le dépôt du module