@fraza/core 0.3.8 → 0.3.10

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

@@ -1,53 +1,52 @@
 ---
 title: Installation
-description: Installer le module de facturation, créer les tables et déclarer le webhook Stripe.
+description: Installer le module de facturation, créer les tables, renseigner l'émetteur et déclarer le webhook Stripe.
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/facturation/configuration
-    - 06-modules/facturation/paiements
+    - 06-modules/facturation/02-configuration
+    - 06-modules/facturation/05-paiements
 ---
 
-Ce module est distribué sous la licence Fraza Pro : son utilisation en production demande une licence par projet, renouvelée chaque année, qui comprend les mises à jour, la conformité et le support. Voir [Licence et propriété](../../04-architecture/07-licence-et-propriete.md).
+Cette page installe `@fraza-pro/module-billing` 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). Son utilisation en production demande une licence Fraza Pro : voir [Licence et propriété](../../04-architecture/07-licence-et-propriete.md).
 
-## Installer
+## Prérequis
+
+- Un projet créé par `npx @fraza/start`, avec `@fraza/core` à jour.
+- Le token du registre Fraza dans le `.npmrc` du projet, sans lequel `npm i` échoue : `npm login --registry=https://registry.fraza.ca/`, puis `npx fraza-key`. Voir [Modules Pro](../../01-demarrage/01-installation.md#modules-pro).
+- `NEXT_PUBLIC_URL` renseignée : les liens de paiement envoyés aux clients en sont dérivés.
 
-Le paquet demande la ligne `@fraza-pro:registry=https://registry.fraza.ca/` et le token du registre dans le `.npmrc` du projet, sans lesquels `npm i` échoue. `npx @fraza/start` écrit déjà la ligne de portée. Le token s'obtient avec `npm login --registry=https://registry.fraza.ca/`, puis `npx fraza-key` le reprend dans le projet. Voir [`fraza-key`](../../03-reference/05-cli/fraza-key.md).
+## Installer
 
 ```bash
 npm i @fraza-pro/module-billing
 ```
 
-Activer dans `.env.local`, et dans les variables de la plateforme en production :
+Ajouter la variable d'activation à `.env.local`, et aux variables de la plateforme en production :
 
-```bash
+```dotenv
+#------ MODULE - BILLING ------#
 FRAZA_MODULE_BILLING=true
 ```
 
-Sans cette variable, le module est chargé mais n'enregistre rien : ni tables, ni routes, ni entrée d'admin, ni tâches planifiées.
+Sans ce drapeau, le module est chargé mais n'enregistre rien : ni tables, ni routes, ni entrée d'admin, ni tâches planifiées.
 
-Puis régénérer les manifestes et créer les tables :
+Régénérer les manifestes, puis créer les tables :
 
 ```bash
-npx fraza-modules sync   # auto-déclenché par postinstall
-npx fraza-db init        # crée les treize tables fraza_billing_*
+npx fraza-modules sync    # déclenché automatiquement au postinstall
+npx fraza-db init         # crée les treize tables fraza_billing_*
 ```
 
-`fraza-db init` accorde aussi les permissions `billing.view` et `billing.manage` au rôle `admin`, et applique les migrations en attente.
-
-Sur un site déjà en service, une mise à jour du module se termine par `npx fraza-db migrate`, qui applique les évolutions de schéma que la création de tables ne peut pas atteindre. `002-drop-job-lock` y supprime `fraza_billing_job_lock` : les tâches se verrouillent maintenant dans `fraza_cron_runs` du core. Voir [Modèle de données](./modele-de-donnees.md#migrations).
+`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 enregistre aussi les permissions `billing.view` et `billing.manage`, et les attribue au rôle `admin`. Voir [Modèle de données](./08-modele-de-donnees.md).
 
 ## Version du core
 
-Le module fonctionne avec la dernière version de `@fraza/core` : tous les paquets Fraza à leur dernière version fonctionnent ensemble. Installer la dernière version de tous les paquets Fraza du site, toutes à la fois :
-
-```bash
-npx fraza-update
-```
+Le module suit la dernière version de `@fraza/core` : tous les paquets Fraza à leur dernière version fonctionnent ensemble, et `npx fraza-update` les met à jour ensemble.
 
 Un core en retard ne dériverait pas `FRAZA_MODULE_BILLING` du nom du paquet : le module y resterait désactivé, sans erreur.
 
-Trois choses viennent du core et n'ont aucun substitut dans le module : la génération de `app/.fraza/public-pages.server.js`, le manifeste par lequel la page de paiement s'enregistre ; la transmission des paramètres d'URL aux pages publiques, sans laquelle le retour de Stripe n'affiche aucun bandeau, et l'affichage en ligne d'un document, sans lequel les visionneuses de PDF restent vides. Les deux dernières échouent en silence sur un core en retard.
+Trois choses viennent du core et n'ont aucun substitut dans le module : la génération de `app/.fraza/public-pages.server.js`, le manifeste par lequel la page de paiement s'enregistre ; la transmission des paramètres d'URL aux pages publiques, sans laquelle le retour de Stripe n'affiche aucun bandeau ; et l'affichage en ligne d'un document, sans lequel les visionneuses de PDF restent vides. Les deux dernières échouent en silence sur un core en retard.
 
 Sur un projet dont `app/za/[...path]/page.js` n'importe pas encore ce manifeste, il faut ajouter l'import. La correction est automatique :
 
@@ -60,9 +59,9 @@ Sans elle, `/za/billing/<token>` échoue au rendu sur « Could not find the modu
 
 ## Renseigner l'émetteur
 
-Une facture doit nommer qui l'émet. Sans ces variables, le bloc émetteur du PDF est vide.
+Une facture doit nommer qui l'émet. Sans ces variables, le bloc émetteur du PDF est vide. Dans `.env.local` :
 
-```bash
+```dotenv
 FRAZA_MODULE_BILLING_COMPANY_NAME=Mon entreprise inc.
 FRAZA_MODULE_BILLING_COMPANY_ADDRESS=123 rue Principale
 FRAZA_MODULE_BILLING_COMPANY_CITY=Montréal
@@ -74,28 +73,28 @@ FRAZA_MODULE_BILLING_COMPANY_PHONE=514 555 0100
 
 Une entreprise inscrite aux fichiers de la TPS et de la TVQ doit faire figurer ses numéros sur toute facture de plus de 30 $ :
 
-```bash
+```dotenv
 FRAZA_MODULE_BILLING_GST_NUMBER=123456789 RT0001
 FRAZA_MODULE_BILLING_QST_NUMBER=1234567890 TQ0001
 ```
 
 Ces numéros sont recopiés sur chaque facture au moment de l'émission, pas à l'affichage. Une facture déjà émise garde donc les numéros en vigueur ce jour-là.
 
-La liste complète est dans [Configuration](./configuration.md).
+La liste complète est dans [Configuration](./02-configuration.md).
 
 ## Courriels
 
-Le module envoie sept courriels par la [file d'envoi](../../03-reference/01-cores/email.md#file-denvoi) du core, qui demande la table `fraza_email_outbox` (`npx fraza-db migrate`) et la configuration courriel du projet, Resend ou SMTP. `NEXT_PUBLIC_URL` doit être renseignée : les liens de paiement envoyés aux clients en sont dérivés.
+Le module envoie sept courriels par la [file d'envoi](../../03-reference/01-cores/email.md#file-denvoi) du core, qui demande la table `fraza_email_outbox` (`npx fraza-db migrate`) et la configuration courriel du projet, Resend ou SMTP.
 
 Sans configuration de courriel, tout le reste du module fonctionne : l'émission réussit, le courriel est mis en file, et la tâche `fraza:email-outbox` du core le reprend jusqu'à son dernier essai.
 
-Le contenu de chaque message est décrit dans [Courriels](./courriels.md).
+Le contenu de chaque message est décrit dans [Courriels](./07-courriels.md).
 
 ## Paiement par carte
 
-Le paiement par carte demande `STRIPE_SECRET_KEY` et `STRIPE_WEBHOOK_SECRET` :
+Le paiement par carte demande `STRIPE_SECRET_KEY` et `STRIPE_WEBHOOK_SECRET`. Dans `.env.local` :
 
-```bash
+```dotenv
 STRIPE_SECRET_KEY=sk_…
 STRIPE_WEBHOOK_SECRET=whsec_…
 ```
@@ -117,7 +116,7 @@ Déclarer l'endpoint dans le tableau de bord Stripe, sur `https://exemple.ca/za/
 | `refund.updated` | Suit son statut : en attente, réussi, échoué. |
 | `charge.refunded` | Relit chez Stripe les remboursements du paiement, pour un endpoint qui n'aurait coché que lui. |
 
-Sans le webhook, un client peut payer sans que la facture soit créditée. Un retour de navigateur n'est pas une preuve de paiement, et le module ne l'utilise que pour afficher un bandeau. Une tâche relit aussi Stripe chaque nuit et rattrape ce que le webhook a manqué. Voir [Paiements](./paiements.md#réconciliation).
+Sans le webhook, un client peut payer sans que la facture soit créditée. Un retour de navigateur n'est pas une preuve de paiement, et le module ne l'utilise que pour afficher un bandeau. Une tâche relit aussi Stripe chaque nuit et rattrape ce que le webhook a manqué. Voir [Paiements](./05-paiements.md#réconciliation).
 
 ### Vérifier en local
 
@@ -135,7 +134,9 @@ Le solde ne doit pas bouger : l'événement est reconnu comme un doublon et igno
 
 ## Virement Interac
 
-```bash
+Dans `.env.local` :
+
+```dotenv
 FRAZA_MODULE_BILLING_INTERAC_ENABLED=true
 FRAZA_MODULE_BILLING_INTERAC_EMAIL=paiements@exemple.ca
 ```
@@ -146,17 +147,38 @@ Si `FRAZA_ENCRYPTION_KEY` est configurée, la réponse est chiffrée en base. El
 
 ## Tâches planifiées
 
-Quatre tâches quotidiennes sont enregistrées automatiquement. Les désactiver sur une instance qui ne doit pas les exécuter :
+Quatre tâches quotidiennes sont enregistrées automatiquement. Pour les désactiver sur une instance qui ne doit pas les exécuter :
 
-```bash
+```dotenv
 FRAZA_MODULE_BILLING_CRON=false
 ```
 
-Aucun réglage n'est nécessaire pour un déploiement à plusieurs instances : chaque tâche est planifiée avec le verrou de `@fraza/core/cron`, dans `fraza_cron_runs` : une seule instance exécute un déclenchement donné. Elles demandent cette table du core (`npx fraza-db migrate`).
+Aucun réglage n'est nécessaire pour un déploiement à plusieurs instances : chaque tâche est planifiée avec le verrou de `@fraza/core/cron`, dans `fraza_cron_runs`, et une seule instance exécute un déclenchement donné. Elles demandent cette table du core (`npx fraza-db migrate`).
+
+## Vérifier
+
+1. La connexion à la base répond :
+   ```bash
+   npx fraza-db test
+   ```
+2. `Facturation` apparaît dans la barre latérale de l'admin.
+3. Créer un client, puis une facture avec une ligne à 100,00 $ en TPS et TVQ. Le total affiché doit être 114,98 $.
+4. Émettre la facture. Elle reçoit un numéro de la forme `FAC-2026-0001` et le client reçoit le courriel avec le PDF joint.
+5. Ouvrir le lien public dans une fenêtre de navigation privée. La ventilation des taxes et les numéros d'inscription doivent y figurer.
+
+## Mettre à jour
+
+```bash
+npx fraza-update
+```
+
+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-pro/module-billing` seul, par `npm i`, laisserait le core et les autres modules en arrière.
+
+`fraza-db migrate` applique les évolutions de schéma que la création de tables ne peut pas atteindre. `002-drop-job-lock` y supprime `fraza_billing_job_lock` : les tâches se verrouillent maintenant dans `fraza_cron_runs` du core. Voir [Modèle de données](./08-modele-de-donnees.md#migrations).
+
+Les notes de version sont livrées avec le paquet, dans `node_modules/@fraza-pro/module-billing/CHANGELOG.md`.
 
-## Vérifier l'installation
+## Notes
 
-1. La section « Facturation » apparaît dans l'admin.
-2. Créer un client, puis une facture avec une ligne à 100,00 $ en TPS et TVQ. Le total affiché doit être 114,98 $.
-3. Émettre la facture. Elle reçoit un numéro de la forme `FAC-2026-0001` et le client reçoit le courriel avec le PDF joint.
-4. Ouvrir le lien public dans une fenêtre de navigation privée. La ventilation des taxes et les numéros d'inscription doivent y figurer.
+- Le module dépend de `@fraza/core` en `peerDependency`. Il n'embarque pas sa propre copie du core.
+- Désinstaller le module ne supprime pas les tables. `dropTables` est exporté depuis `@fraza-pro/module-billing` pour le faire explicitement.

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

@@ -4,8 +4,8 @@ description: Variables d'environnement du module de facturation, permissions et
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/facturation/taxes
-    - 06-modules/facturation/recurrences-et-rappels
+    - 06-modules/facturation/04-taxes
+    - 06-modules/facturation/06-recurrences-et-rappels
 ---
 
 Toute la configuration passe par des variables d'environnement, lues une fois au démarrage et mises en cache. Changer une valeur demande un redéploiement.
@@ -21,7 +21,7 @@ Les tâches ne sont jamais enregistrées pendant `next build`, quelle que soit l
 
 ## Émetteur
 
-Ces valeurs remplissent le bloc émetteur de la facture et du reçu. Elles n'habillent **pas** les courriels : leur expéditeur, leur logo et leur pied viennent de la configuration du site, `FRAZA_EMAIL_*` et `FRAZA_NAME`. Voir [Courriels](./courriels.md#lhabillage-appartient-au-site).
+Ces valeurs remplissent le bloc émetteur de la facture et du reçu. Elles n'habillent **pas** les courriels : leur expéditeur, leur logo et leur pied viennent de la configuration du site, `FRAZA_EMAIL_*` et `FRAZA_NAME`. Voir [Courriels](./07-courriels.md#lhabillage-appartient-au-site).
 
 | Variable | Défaut |
 |---|---|
@@ -58,7 +58,7 @@ Le nom, le logo et la cible du lien retombent sur la marque du site quand la var
 | `FRAZA_MODULE_BILLING_QST_NUMBER` | vide | Numéro d'inscription à la TVQ. |
 | `FRAZA_MODULE_BILLING_DEFAULT_TAX_PROFILE` | `gst_qst` | Profil des nouveaux clients, articles et lignes. |
 
-Les taux acceptent la virgule comme la période décimale. Ils sont convertis en parties par million et figés sur chaque facture au moment de l'émission. Voir [Taxes](./taxes.md).
+Les taux acceptent la virgule comme la période décimale. Ils sont convertis en parties par million et figés sur chaque facture au moment de l'émission. Voir [Taxes](./04-taxes.md).
 
 `..._TAXES_ENABLED=false` s'adresse à un émetteur qui n'est pas inscrit aux taxes : un travailleur autonome sous le seuil d'inscription, par exemple. Les sélecteurs de taxes disparaissent de l'admin, toute écriture est ramenée au profil `none`, et aucune facture ne porte de ligne de TPS ni de TVQ. `..._DEFAULT_TAX_PROFILE` n'a alors plus d'effet.
 
@@ -96,7 +96,7 @@ La séquence des factures et des transactions se remet à zéro chaque année. C
 | `FRAZA_MODULE_BILLING_OVERDUE_MAX_NOTICES` | `4` | Nombre maximal d'avis de retard. |
 | `FRAZA_MODULE_BILLING_ADMIN_EMAIL` | vide | Reçoit une copie au premier retard de chaque facture. |
 
-`FRAZA_MODULE_BILLING_REMINDER_DAYS` est trié par ordre décroissant et dédoublonné à la lecture, donc l'ordre de saisie n'a pas d'importance. Voir [Récurrences et rappels](./recurrences-et-rappels.md).
+`FRAZA_MODULE_BILLING_REMINDER_DAYS` est trié par ordre décroissant et dédoublonné à la lecture, donc l'ordre de saisie n'a pas d'importance. Voir [Récurrences et rappels](./06-recurrences-et-rappels.md).
 
 ## Virement Interac
 

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

@@ -4,8 +4,8 @@ description: Du brouillon à l'encaissement, ce que chaque étape fige et ce qui
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/facturation/paiements
-    - 06-modules/facturation/taxes
+    - 06-modules/facturation/05-paiements
+    - 06-modules/facturation/04-taxes
 ---
 
 ## Les cinq statuts
@@ -85,7 +85,7 @@ Un paiement se produit de trois façons : le client règle par carte sur la page
 
 Dans tous les cas, la même écriture, sous le verrou de la facture : une transaction rattachée à la facture, puis un recalcul immédiat de `paid_cents`, du statut et de la date de paiement à partir de la somme des transactions.
 
-Ce recalcul est ce qui manquait à l'ancien module, où seule la création d'un paiement mettait la facture à jour : modifier ou supprimer un paiement laissait la facture prétendre avoir reçu de l'argent qu'elle n'avait plus. Voir [Paiements](./paiements.md).
+Ce recalcul est ce qui manquait à l'ancien module, où seule la création d'un paiement mettait la facture à jour : modifier ou supprimer un paiement laissait la facture prétendre avoir reçu de l'argent qu'elle n'avait plus. Voir [Paiements](./05-paiements.md).
 
 ## Le solde
 
@@ -93,7 +93,7 @@ Ce recalcul est ce qui manquait à l'ancien module, où seule la création d'un
 solde = max(0, total + intérêts − payé)
 ```
 
-C'est le seul montant dû du module. Il sert à la session Stripe, au PDF, à la page publique, aux courriels et à la colonne « Solde ». Les intérêts, eux, courent sur `max(0, total − payé)` : voir [Récurrences et rappels](./recurrences-et-rappels.md). Une facture annulée a un solde nul : tout ce qu'elle a reçu est un excédent à rembourser.
+C'est le seul montant dû du module. Il sert à la session Stripe, au PDF, à la page publique, aux courriels et à la colonne « Solde ». Les intérêts, eux, courent sur `max(0, total − payé)` : voir [Récurrences et rappels](./06-recurrences-et-rappels.md). Une facture annulée a un solde nul : tout ce qu'elle a reçu est un excédent à rembourser.
 
 L'ancien module en avait deux : Stripe facturait `total − payé` pendant que l'interface affichait `total + intérêts − payé`. Un client qui payait une facture en retard par carte restait donc débiteur des intérêts sans en être informé.
 

package/dist/docs/06-modules/facturation/{taxes.md → 04-taxes.md}

@@ -4,8 +4,8 @@ description: Profils de taxes, base de calcul de la TPS et de la TVQ, règle d'a
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/facturation/facturation
-    - 06-modules/facturation/configuration
+    - 06-modules/facturation/03-facturation
+    - 06-modules/facturation/02-configuration
 ---
 
 ## Facturer sans taxes

package/dist/docs/06-modules/facturation/{paiements.md → 05-paiements.md}

@@ -4,8 +4,8 @@ description: Registre sérialisé, paiement par carte, virement Interac, saisie
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/facturation/installation
-    - 06-modules/facturation/modele-de-donnees
+    - 06-modules/facturation/01-installation
+    - 06-modules/facturation/08-modele-de-donnees
 ---
 
 ## Un seul registre
@@ -120,7 +120,7 @@ Le webhook peut manquer un paiement : endpoint non déclaré, secret changé, si
 
 Un reçu PDF est disponible pour chaque paiement, dans l'admin comme sur la page publique une fois la facture soldée. Il reprend la ventilation des taxes, que le client utilise pour ses propres crédits de taxe sur les intrants.
 
-Le courriel de reçu part automatiquement après un paiement par carte. Il porte le PDF en pièce jointe seulement quand le paiement solde la facture. Voir [Courriels](./courriels.md).
+Le courriel de reçu part automatiquement après un paiement par carte. Il porte le PDF en pièce jointe seulement quand le paiement solde la facture. Voir [Courriels](./07-courriels.md).
 
 ## Notes
 

package/dist/docs/06-modules/facturation/{recurrences-et-rappels.md → 06-recurrences-et-rappels.md}

@@ -4,8 +4,8 @@ description: Les quatre tâches planifiées, génération des factures réguliè
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/facturation/facturation
-    - 06-modules/facturation/configuration
+    - 06-modules/facturation/03-facturation
+    - 06-modules/facturation/02-configuration
 ---
 
 Quatre tâches quotidiennes, enregistrées dans [`core/cron`](../../03-reference/01-cores/cron.md).
@@ -71,13 +71,13 @@ Une copie interne part à `FRAZA_MODULE_BILLING_ADMIN_EMAIL` au premier retard d
 
 Chaque message occupe un créneau `(facture, type, numéro)` dans `fraza_billing_reminder`. Le créneau est **réservé avant la mise en file** par une insertion qu'un index unique partiel refuse de dupliquer. Pas de ligne insérée, pas de message.
 
-Si le courriel ne peut pas être mis dans la file d'envoi du core, la ligne est marquée en échec, ce qui libère le créneau et laisse le passage suivant réessayer. Une fois en file, l'envoi et ses reprises reviennent à la file. Voir [Courriels](./courriels.md).
+Si le courriel ne peut pas être mis dans la file d'envoi du core, la ligne est marquée en échec, ce qui libère le créneau et laisse le passage suivant réessayer. Une fois en file, l'envoi et ses reprises reviennent à la file. Voir [Courriels](./07-courriels.md).
 
 L'idempotence tient donc aux données, pas à l'horaire. Exécuter une tâche deux fois dans la journée n'envoie rien de plus, et une journée sautée est rattrapée.
 
 Une pause de 900 ms sépare deux envois, pour rester sous la limite de débit du fournisseur de courriel.
 
-Le contenu de ces messages est décrit dans [Courriels](./courriels.md).
+Le contenu de ces messages est décrit dans [Courriels](./07-courriels.md).
 
 ## Intérêts de retard
 

package/dist/docs/06-modules/facturation/{courriels.md → 07-courriels.md}

@@ -4,8 +4,8 @@ description: Les sept messages envoyés par le module, leur déclencheur, leur c
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/facturation/recurrences-et-rappels
-    - 06-modules/facturation/configuration
+    - 06-modules/facturation/06-recurrences-et-rappels
+    - 06-modules/facturation/02-configuration
 ---
 
 Le module envoie sept messages. Tous passent par la file d'envoi de [`core/email`](../../03-reference/01-cores/email.md), donc par le fournisseur configuré pour le projet, et tous sont bâtis sur le `BaseLayout` du core : ce sont les mêmes expéditeur, en-tête, largeur et pied que les courriels de compte que le client a déjà reçus.
@@ -22,7 +22,7 @@ Le module envoie sept messages. Tous passent par la file d'envoi de [`core/email
 | Remboursement | Remboursement Stripe réussi, lancé depuis l'admin ou le tableau de bord. | `Remboursement : facture FAC-2026-0001` | — |
 | Note de crédit | Annulation d'une facture émise, et bouton « Renvoyer » de la note. | `Note de crédit NC-2026-0001 : facture FAC-2026-0001 annulée` | La note de crédit en PDF. |
 
-La cadence des rappels et des avis de retard est décrite dans [Récurrences et rappels](./recurrences-et-rappels.md).
+La cadence des rappels et des avis de retard est décrite dans [Récurrences et rappels](./06-recurrences-et-rappels.md).
 
 ## Ce que porte un message
 
@@ -30,7 +30,7 @@ Toujours la même ossature, celle du `BaseLayout` : logo de l'émetteur, titre,
 
 L'encadré est ce qui porte l'état, par sa couleur : neutre pour une facture ou un rappel, vert pour un paiement reçu, rouge pour un retard. Ces couleurs, comme celle du bouton, viennent du [thème du projet](../../02-guides/personnaliser-l-apparence.md), dans ses valeurs claires : le vert est son `success`, le rouge son `danger`, le bouton sa couleur `primary`. Il ne contient que ce dont le lecteur a besoin pour décider : le numéro, le montant à payer, l'échéance, et l'acompte déjà versé s'il y en a un. Les montants, les dates et les identifiants y sont en chasse fixe.
 
-**La ventilation des taxes n'est pas dans les courriels.** Sous-total, TPS, TVQ et détail des lignes vivent sur le PDF joint et sur la [page publique](./paiements.md#la-page-publique). Un courriel qui recopie une facture complète est un courriel que personne ne lit, et la seule version qui fait foi reste le document.
+**La ventilation des taxes n'est pas dans les courriels.** Sous-total, TPS, TVQ et détail des lignes vivent sur le PDF joint et sur la [page publique](./05-paiements.md#la-page-publique). Un courriel qui recopie une facture complète est un courriel que personne ne lit, et la seule version qui fait foi reste le document.
 
 Deux exceptions à cette ossature :
 
@@ -56,7 +56,7 @@ Une seule exception, et elle est fonctionnelle plutôt que visuelle : l'**adress
 
 Cette même adresse est **écrite en toutes lettres** dans le message, sur la facture, l'avis de retard et l'avis de remboursement : « Si vous avez des questions sur cette facture, écrivez-nous à facturation@exemple.ca. » Le bouton de réponse y mène déjà, mais un courriel transféré, imprimé, ou lu dans un client qui masque les en-têtes perd cette information. Une adresse écrite dans le corps ne dépend pas de la façon dont le message est ouvert. Sans `..._COMPANY_EMAIL` configurée, la phrase invite simplement à répondre au courriel.
 
-L'émetteur, lui, signe le document : c'est sur la facture et sur le reçu que figurent sa raison sociale, son adresse, son logo et ses numéros d'inscription. Voir [Configuration](./configuration.md#émetteur).
+L'émetteur, lui, signe le document : c'est sur la facture et sur le reçu que figurent sa raison sociale, son adresse, son logo et ses numéros d'inscription. Voir [Configuration](./02-configuration.md#émetteur).
 
 L'alerte interne de retard est le seul message sans lien de support dans son pied : son destinataire travaille chez vous.
 

package/dist/docs/06-modules/facturation/{modele-de-donnees.md → 08-modele-de-donnees.md}

@@ -4,8 +4,8 @@ description: Les treize tables fraza_billing_, leurs colonnes, leurs contraintes
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/facturation/api
-    - 06-modules/facturation/facturation
+    - 06-modules/facturation/09-api
+    - 06-modules/facturation/03-facturation
 ---
 
 Treize tables, créées dans l'ordre ci-dessous par `fraza-db init` et supprimées dans l'ordre inverse. La création est idempotente : une table existante est ignorée, jamais modifiée.

package/dist/docs/06-modules/facturation/{api.md → 09-api.md}

@@ -4,8 +4,8 @@ description: Routes HTTP du module de facturation et fonctions serveur importabl
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/facturation/modele-de-donnees
-    - 06-modules/facturation/paiements
+    - 06-modules/facturation/08-modele-de-donnees
+    - 06-modules/facturation/05-paiements
 ---
 
 ## Fonctions serveur
@@ -184,5 +184,5 @@ Les routes de document répondent en `Content-Disposition: inline` : le navigate
 ## Notes
 
 - Les PDF sont rendus par le module et servis en ligne (`disposition: 'inline'`), ce que le core n'accorde qu'à un document produit par le serveur. L'en-tête de cadrage passe alors à `SAMEORIGIN` : les visionneuses du même site peuvent les afficher dans un cadre.
-- Le webhook Stripe n'est pas dans ce tableau : il appartient au core, sur `/za/api/payments/stripe/webhook`, et le module s'y abonne. Voir [Installation](./installation.md).
+- Le webhook Stripe n'est pas dans ce tableau : il appartient au core, sur `/za/api/payments/stripe/webhook`, et le module s'y abonne. Voir [Installation](./01-installation.md).
 - Les pages d'admin appellent ces routes par `apiFetch` du core, qui envoie le cookie de session. Sans lui, toute route d'admin répond 401.

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

@@ -4,33 +4,43 @@ description: Clients, factures avec ventilation TPS et TVQ, paiement Stripe et I
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/facturation/installation
-    - 06-modules/facturation/configuration
+    - 06-modules/facturation/01-installation
+    - 06-modules/facturation/02-configuration
 ---
 
 `@fraza-pro/module-billing` ajoute une section « Facturation » à l'admin : un fichier clients, un catalogue d'articles, des factures avec ventilation TPS et TVQ, et une page publique où le client règle sa facture par carte ou par virement Interac.
 
-Ce module est distribué sous la licence Fraza Pro : son utilisation en production demande une licence par projet, renouvelée chaque année, qui comprend les mises à jour, la conformité et le support. Voir [Licence et propriété](../../04-architecture/07-licence-et-propriete.md).
+```bash
+npm i @fraza-pro/module-billing
+```
+
+| Paquet | `@fraza-pro/module-billing` |
+|---|---|
+| Licence | Fraza Pro : une licence par projet en production, renouvelée chaque année, qui comprend les mises à jour, la conformité et le support. Voir [Licence et propriété](../../04-architecture/07-licence-et-propriete.md). |
+| Registre | `https://registry.fraza.ca/`, avec le token du projet. Voir [Modules Pro](../../01-demarrage/01-installation.md#modules-pro). |
+| Activation | `FRAZA_MODULE_BILLING=true` |
+
+L'activation, la création des tables et le webhook Stripe sont dans [Installation](./01-installation.md).
 
 Le module est autonome. Il porte ses propres clients plutôt que de dépendre d'un module externe, et se relie facultativement aux comptes du site par la colonne `user_id`.
 
 ![La liste des factures, ses totaux en tête et ses onglets de statut](../../assets/modules/facturation/factures.light.webp)
 
-Une facture ouverte dont l'échéance est passée affiche « En retard » dans la colonne « Statut », et le nombre de jours de retard sous l'échéance, alors que son statut stocké reste `sent` ou `partial` : c'est une déduction, pas un état stocké, et [Facturation](./facturation.md) explique pourquoi. Le décompte sous l'échéance ne paraît que tant qu'un solde reste dû. Une facture payée, annulée ou en brouillon n'en porte aucun. Le brouillon en tête de liste n'a ni numéro ni lien public, il ne les reçoit qu'à l'émission.
+Une facture ouverte dont l'échéance est passée affiche « En retard » dans la colonne « Statut », et le nombre de jours de retard sous l'échéance, alors que son statut stocké reste `sent` ou `partial` : c'est une déduction, pas un état stocké, et [Facturation](./03-facturation.md) explique pourquoi. Le décompte sous l'échéance ne paraît que tant qu'un solde reste dû. Une facture payée, annulée ou en brouillon n'en porte aucun. Le brouillon en tête de liste n'a ni numéro ni lien public, il ne les reçoit qu'à l'émission.
 
 ## Pages de cette section
 
 | Page | Contenu |
 |---|---|
-| [Installation](./installation.md) | Installer le module, créer les tables, déclarer le webhook Stripe. |
-| [Configuration](./configuration.md) | Variables d'environnement, permissions, entrée d'admin. |
-| [Cycle de vie d'une facture](./facturation.md) | Brouillon, émission, encaissement, annulation. |
-| [Taxes](./taxes.md) | Profils, base de calcul, arrondi, numéros d'inscription. |
-| [Paiements](./paiements.md) | Stripe, Interac, saisie manuelle et remboursements. |
-| [Récurrences et rappels](./recurrences-et-rappels.md) | Génération automatique, échelle de rappels, intérêts. |
-| [Courriels](./courriels.md) | Les sept messages, leur contenu et leur non-répétition. |
-| [Modèle de données](./modele-de-donnees.md) | Les treize tables `fraza_billing_*`. |
-| [API](./api.md) | Routes HTTP et fonctions serveur importables. |
+| [Installation](./01-installation.md) | Installer le module, créer les tables, déclarer le webhook Stripe. |
+| [Configuration](./02-configuration.md) | Variables d'environnement, permissions, entrée d'admin. |
+| [Cycle de vie d'une facture](./03-facturation.md) | Brouillon, émission, encaissement, annulation. |
+| [Taxes](./04-taxes.md) | Profils, base de calcul, arrondi, numéros d'inscription. |
+| [Paiements](./05-paiements.md) | Stripe, Interac, saisie manuelle et remboursements. |
+| [Récurrences et rappels](./06-recurrences-et-rappels.md) | Génération automatique, échelle de rappels, intérêts. |
+| [Courriels](./07-courriels.md) | Les sept messages, leur contenu et leur non-répétition. |
+| [Modèle de données](./08-modele-de-donnees.md) | Les treize tables `fraza_billing_*`. |
+| [API](./09-api.md) | Routes HTTP et fonctions serveur importables. |
 
 ## Ce que le module apporte
 
@@ -45,11 +55,11 @@ Une facture ouverte dont l'échéance est passée affiche « En retard » dans l
 | Tâches planifiées | Quatre : réconciliation Stripe, intérêts, récurrences, rappels. |
 | Documents | Facture, reçu et note de crédit en PDF, générés à la demande. |
 | Dépendances | `stripe` (SDK 23, appelé au premier paiement) et `@react-pdf/renderer` (chargé au premier PDF), installés avec le module. |
-| Courriels | Sept, du courriel d'émission à la note de crédit. Voir [Courriels](./courriels.md). |
+| Courriels | Sept, du courriel d'émission à la note de crédit. Voir [Courriels](./07-courriels.md). |
 
 ## Deux principes qui expliquent le reste
 
-**Le solde est calculé à un seul endroit.** `computeBalance` dans `money.js` produit le montant dû, et c'est ce nombre qui sert à la session Stripe, au PDF, à la page publique, aux courriels et à la colonne Solde. Aucune seconde formule ne peut diverger. Les intérêts, eux, courent sur la part impayée du total, voir [Récurrences et rappels](./recurrences-et-rappels.md).
+**Le solde est calculé à un seul endroit.** `computeBalance` dans `money.js` produit le montant dû, et c'est ce nombre qui sert à la session Stripe, au PDF, à la page publique, aux courriels et à la colonne Solde. Aucune seconde formule ne peut diverger. Les intérêts, eux, courent sur la part impayée du total, voir [Récurrences et rappels](./06-recurrences-et-rappels.md).
 
 **Le retard n'est pas un statut.** Une facture est `draft`, `sent`, `partial`, `paid` ou `cancelled`. Le retard se déduit de la date d'échéance et du solde, à la lecture. Une facture en retard reste donc `sent` ou `partial`, et ne peut pas disparaître de la requête qui alimente les avis de retard.
 
@@ -69,5 +79,5 @@ Une colonne `DECIMAL` revient de `pg` sous forme de chaîne, ce qui oblige à un
 
 - La page publique est protégée par un jeton de 64 caractères hexadécimaux, et rien d'autre. Toute personne qui détient le lien voit la facture et peut la payer. Le jeton n'expire pas et ne se révoque pas.
 - Les PDF publics s'affichent dans une visionneuse plutôt que de se télécharger. Le routeur du core sert par défaut en pièce jointe tout ce qui n'est pas une image ; les deux routes de document demandent explicitement l'affichage en ligne, ce qu'elles peuvent faire parce qu'elles rendent le document elles-mêmes au lieu de le relire depuis le stockage.
-- Le webhook Stripe est servi par le core, sur `/za/api/payments/stripe/webhook`. Le module s'y abonne : le projet hôte n'a aucune route à créer, seulement l'endpoint à déclarer chez Stripe. Voir [Installation](./installation.md).
+- Le webhook Stripe est servi par le core, sur `/za/api/payments/stripe/webhook`. Le module s'y abonne : le projet hôte n'a aucune route à créer, seulement l'endpoint à déclarer chez Stripe. Voir [Installation](./01-installation.md).
 - 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.

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