@fraza/core 0.3.7 → 0.3.10

package/dist/docs/06-modules/posts/{types-et-champs.md → 03-types-et-champs.md}

@@ -4,9 +4,9 @@ description: Syntaxe de déclaration d'un type de contenu, catalogue des types d
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/posts/taxonomies-et-relations
-    - 06-modules/posts/admin
-    - 06-modules/posts/modele-de-donnees
+    - 06-modules/posts/04-taxonomies-et-relations
+    - 06-modules/posts/05-admin
+    - 06-modules/posts/06-modele-de-donnees
 ---
 
 Un type de contenu se déclare entièrement en variables d'environnement. Le module en dérive le formulaire d'édition, le tableau d'admin, les colonnes de tri, les routes publiques et le rendu.
@@ -89,8 +89,8 @@ Déclarer le champ le rend en revanche obligatoire à la saisie : le formulaire
 
 Un type sans titre change trois choses :
 
-- le slug, s'il est déclaré, n'a plus de source à laquelle se rattacher. Il est généré sous la forme `post-<id>` et reste modifiable à la main. Voir [Modèle de données](./modele-de-donnees.md) ;
-- la liste d'admin affiche un extrait du contenu à la place du titre. Voir [Administration](./admin.md) ;
+- le slug, s'il est déclaré, n'a plus de source à laquelle se rattacher. Il est généré sous la forme `post-<id>` et reste modifiable à la main. Voir [Modèle de données](./06-modele-de-donnees.md) ;
+- la liste d'admin affiche un extrait du contenu à la place du titre. Voir [Administration](./05-admin.md) ;
 - les métadonnées publiques retombent sur le slug. Renseignez le titre SEO du post pour en donner un vrai.
 
 Combiné à l'absence de `slug`, vous obtenez un type sans titre ni URL, consommé uniquement par l'API ou par une relation depuis un autre post.
@@ -105,13 +105,13 @@ FRAZA_MODULE_POSTS_TYPE_ENCARTS=contenu:editor:Contenu
 
 C'est l'interrupteur qui distingue un type destiné au site d'un type purement interne, par exemple une liste de références utilisée uniquement par des relations.
 
-Les règles de génération et d'unicité du slug sont dans [Modèle de données](./modele-de-donnees.md).
+Les règles de génération et d'unicité du slug sont dans [Modèle de données](./06-modele-de-donnees.md).
 
 ### Le champ `created`
 
 Il expose `created_at` en écriture. La valeur soumise est refusée si elle n'est pas une date valide, et refusée si elle est dans le futur. Utile pour importer des archives ou antidater une publication.
 
-Il n'est modifiable qu'après coup : la création ignore toute valeur soumise et laisse la base poser l'horodatage courant. Le contrôle n'apparaît donc pas dans le formulaire de création, seulement dans celui d'édition. Voir [Administration](./admin.md).
+Il n'est modifiable qu'après coup : la création ignore toute valeur soumise et laisse la base poser l'horodatage courant. Le contrôle n'apparaît donc pas dans le formulaire de création, seulement dans celui d'édition. Voir [Administration](./05-admin.md).
 
 ### Les champs `image` et `thumbnail`
 
@@ -119,7 +119,7 @@ Les deux ouvrent le sélecteur du [registre média](../../03-reference/03-regist
 
 La valeur stockée est l'**identifiant** du média. À la lecture, le module l'enrichit en `{ id, filename, alt_text, caption, mime_type }`. Une référence orpheline renvoie `{ id, filename: null }` plutôt qu'une erreur.
 
-Voir [Intégrer les médias](../medias/integration.md).
+Voir [Intégrer les médias](../medias/05-integration.md).
 
 ### Le champ `gallery`
 
@@ -241,7 +241,7 @@ Chaque nom est résolu d'abord contre les champs déclarés du type, puis contre
 
 Le jeton `order` sert uniquement à choisir la position de la poignée. Sur un type réordonnable qui ne le liste pas, la poignée est ajoutée d'office en tête de tableau ; sur un type qui ne l'est pas, le jeton est écarté même s'il est listé.
 
-Variable absente ou vide, l'admin affiche tous les champs déclarés du type, à l'exception des champs `slug` et `editor`. Le détail du rendu de chaque colonne est dans [Administration](./admin.md).
+Variable absente ou vide, l'admin affiche tous les champs déclarés du type, à l'exception des champs `slug` et `editor`. Le détail du rendu de chaque colonne est dans [Administration](./05-admin.md).
 
 ## Ordre manuel
 
@@ -251,7 +251,7 @@ FRAZA_MODULE_POSTS_TYPE_EXPERTISES_ORDERABLE=true
 
 La comparaison est stricte : seule la chaîne `true` active le drapeau.
 
-Voir [Taxonomies et relations](./taxonomies-et-relations.md) pour l'effet sur le tri et sur la hiérarchie.
+Voir [Taxonomies et relations](./04-taxonomies-et-relations.md) pour l'effet sur le tri et sur la hiérarchie.
 
 ## Exemple complet
 
@@ -270,6 +270,6 @@ Ce fichier déclare deux types : un blogue plat avec deux niveaux de classement
 
 ## Notes
 
-- Le champ `template` n'est pas déclarable. Il est ajouté d'office à chaque post, vaut `default` en l'absence de choix, et sélectionne le template de rendu. Voir [Templates](./templates.md).
+- Le champ `template` n'est pas déclarable. Il est ajouté d'office à chaque post, vaut `default` en l'absence de choix, et sélectionne le template de rendu. Voir [Templates](./07-templates.md).
 - Le champ `seo` n'est pas déclarable non plus. Il est ajouté par le core quand `FRAZA_SEO` est actif. Le drapeau `seo` d'un champ déclaré est autre chose : il désigne la source du repli automatique, il ne crée pas de champ.
 - Le manifeste du module décrit les types de champs disponibles dans sa propre documentation de variable, mais cette liste y est incomplète : elle omet `link` et `parent`, tous deux valides. Le catalogue de cette page fait foi.

package/dist/docs/06-modules/posts/{taxonomies-et-relations.md → 04-taxonomies-et-relations.md}

@@ -4,8 +4,8 @@ description: Classer des posts par termes, les relier entre eux, les imbriquer e
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/posts/modele-de-donnees
-    - 06-modules/posts/api
+    - 06-modules/posts/06-modele-de-donnees
+    - 06-modules/posts/08-api
 ---
 
 Trois mécanismes relient un post à un autre contenu : les **taxonomies** le classent par termes, les **relations** le lient à des posts d'un autre type, la **hiérarchie** l'imbrique sous un post du même type. Les trois se déclarent comme des champs, et sont stockés hors des données JSON.
@@ -32,7 +32,7 @@ Le titre est unique dans sa taxonomie : un index unique porte sur `(type de post
 
 ### Administration
 
-Chaque taxonomie obtient son propre item dans la section d'admin du type, sous le libellé donné à la déclaration et avec l'icône `LayersIcon`. La liste des termes affiche pour chacun le nombre de posts qui l'utilisent. Voir [Administration](./admin.md).
+Chaque taxonomie obtient son propre item dans la section d'admin du type, sous le libellé donné à la déclaration et avec l'icône `LayersIcon`. La liste des termes affiche pour chacun le nombre de posts qui l'utilisent. Voir [Administration](./05-admin.md).
 
 Un terme utilisé par au moins un post **ne peut pas être supprimé**. La suppression échoue en `409`, code `term_in_use`, avec « Ce terme est utilisé par N post(s). L'en retirer avant de le supprimer. ». Le désactiver via `is_active` le retire des sélecteurs et de la route publique tout en conservant les classements existants.
 
@@ -99,7 +99,7 @@ Supprimer un parent ne supprime pas ses enfants : leur `parent_id` est remis à
 
 ### Fil d'Ariane
 
-La chaîne d'ascendants est calculée une fois par rendu et passée au template sous la propriété `breadcrumb`, de la racine jusqu'au post courant inclus. Pour un type sans champ `parent`, il est tiré du post lui-même, sans requête. Voir [Templates](./templates.md).
+La chaîne d'ascendants est calculée une fois par rendu et passée au template sous la propriété `breadcrumb`, de la racine jusqu'au post courant inclus. Pour un type sans champ `parent`, il est tiré du post lui-même, sans requête. Voir [Templates](./07-templates.md).
 
 ## Ordre manuel
 
@@ -123,7 +123,7 @@ Sans `sortBy`, la route applique déjà ce tri quand le type est réordonnable.
 
 ## Notes
 
-- Les taxonomies et les relations n'existent en base que si au moins un type les déclare. Après avoir ajouté le premier champ de ce genre, relancer `npx fraza-db init`. Voir [Modèle de données](./modele-de-donnees.md).
+- Les taxonomies et les relations n'existent en base que si au moins un type les déclare. Après avoir ajouté le premier champ de ce genre, relancer `npx fraza-db init`. Voir [Modèle de données](./06-modele-de-donnees.md).
 - Une taxonomie retirée de la déclaration d'un type cesse d'apparaître dans l'admin, mais ses termes et ses classements restent en base.
 - La recherche textuelle des routes de liste ne porte que sur le champ de titre. Ni les termes de taxonomie, ni les données des autres champs ne sont interrogés.
 - Le chemin public et le fil d'Ariane sont tronqués au-delà de 64 niveaux de hiérarchie.

package/dist/docs/06-modules/posts/{admin.md → 05-admin.md}

@@ -4,14 +4,14 @@ description: Tuile du tableau de bord, écrans du module, liste paginée et arbo
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/posts/taxonomies-et-relations
-    - 06-modules/posts/templates
-    - 06-modules/posts/api
+    - 06-modules/posts/04-taxonomies-et-relations
+    - 06-modules/posts/07-templates
+    - 06-modules/posts/08-api
 ---
 
 Le module ajoute une section d'admin par type déclaré, et en dérive l'interface d'édition. Un formulaire de post n'est donc jamais écrit à la main : il est reconstruit à chaque chargement depuis la déclaration du type. Cette page décrit ce que fait l'interface, y compris les quelques comportements qui surprennent.
 
-La structure du formulaire vient de [Types et champs](./types-et-champs.md). Ce qui suit couvre le rendu, pas la déclaration.
+La structure du formulaire vient de [Types et champs](./03-types-et-champs.md). Ce qui suit couvre le rendu, pas la déclaration.
 
 ## Écrans
 
@@ -25,7 +25,7 @@ La structure du formulaire vient de [Types et champs](./types-et-champs.md). Ce
 | `/admin/posts/<type>/taxonomies/<taxonomie>/new` | Création d'un terme. |
 | `/admin/posts/<type>/taxonomies/<taxonomie>/edit/<id>` | Édition d'un terme. |
 
-L'accès demande `posts.view` : sans elle, `/admin/posts` et ses sous-écrans répondent 404, comme une page inconnue. Créer, modifier, supprimer et réordonner demandent `posts.manage`, pour les posts comme pour les termes. Voir [Configuration](./configuration.md).
+L'accès demande `posts.view` : sans elle, `/admin/posts` et ses sous-écrans répondent 404, comme une page inconnue. Créer, modifier, supprimer et réordonner demandent `posts.manage`, pour les posts comme pour les termes. Voir [Configuration](./02-configuration.md).
 
 L'index des types n'a pas d'entrée dans la barre latérale : celle-ci pointe directement sur la liste de chaque type. Il reste atteignable à son URL, et affiche une carte par type avec son nombre de champs. Sans type déclaré, il affiche à la place un rappel de la variable à renseigner.
 
@@ -39,7 +39,7 @@ Le module pose une tuile « Contenus » sur `/admin`, à l'ordre 70, donc derri
 
 Une ligne par type déclaré, avec son icône de barre latérale, son total et un lien vers sa liste. Un type sans contenu garde sa ligne, à zéro : la liste des types est celle de la barre latérale, et un type qui disparaîtrait de la tuile le jour où on vide sa corbeille se lirait comme une panne.
 
-Le compte des privés ne s'affiche qu'au-dessus de zéro. Il compte les posts dont la visibilité vaut `private`, c'est-à-dire ceux que le rendu public refuse de servir. Il n'y a pas d'état de brouillon dans ce module : un post est public ou privé. Voir [Modèle de données](./modele-de-donnees.md).
+Le compte des privés ne s'affiche qu'au-dessus de zéro. Il compte les posts dont la visibilité vaut `private`, c'est-à-dire ceux que le rendu public refuse de servir. Il n'y a pas d'état de brouillon dans ce module : un post est public ou privé. Voir [Modèle de données](./06-modele-de-donnees.md).
 
 Les posts d'un type retiré de `FRAZA_MODULE_POSTS_TYPES` restent en base mais ne sont comptés nulle part : sans libellé ni section de navigation, ils n'ont ni ligne où se compter ni page où mener.
 
@@ -47,7 +47,7 @@ Les posts d'un type retiré de `FRAZA_MODULE_POSTS_TYPES` restent en base mais n
 
 Les deux derniers posts touchés, tous types confondus, chacun lié à son écran d'édition. La date est celle de `updated_at`, donc de la dernière écriture, pas de la publication : un post ancien remonte en tête si on le corrige.
 
-Un post est nommé comme la liste d'admin le nomme. Pour un type sans champ `title`, c'est donc un extrait de son premier champ `editor`, sinon de son premier champ `text`, et à défaut `#<id>`. Voir [Types et champs](./types-et-champs.md).
+Un post est nommé comme la liste d'admin le nomme. Pour un type sans champ `title`, c'est donc un extrait de son premier champ `editor`, sinon de son premier champ `text`, et à défaut `#<id>`. Voir [Types et champs](./03-types-et-champs.md).
 
 Le badge **Privé** ne marque que les lignes qui le sont : une colonne de « Public » répétés n'apprendrait rien et mangerait la largeur dont le titre a besoin.
 
@@ -98,7 +98,7 @@ Le glisser-déposer demande deux conditions réunies : le type porte le drapeau
 
 Un post ne se déplace qu'**à l'intérieur de sa fratrie**. Le lâcher sur une ligne d'un autre parent est refusé avec un message, sans requête.
 
-Le déplacement est appliqué immédiatement à l'affichage, puis persisté. Si le serveur refuse, la liste est rechargée pour se resynchroniser avec la base. Voir [Taxonomies et relations](./taxonomies-et-relations.md) pour la portée de l'ordre.
+Le déplacement est appliqué immédiatement à l'affichage, puis persisté. Si le serveur refuse, la liste est rechargée pour se resynchroniser avec la base. Voir [Taxonomies et relations](./04-taxonomies-et-relations.md) pour la portée de l'ordre.
 
 ### Actions de ligne
 
@@ -118,7 +118,7 @@ La colonne latérale est créée dès qu'un template est enregistré pour le typ
 
 Quand `FRAZA_SEO` est actif, la zone SEO du core apparaît sous la zone de contenu. Son aperçu d'URL utilise le chemin public du post, ou le chemin reconstruit depuis le slug en cours de saisie à la création.
 
-Laissées vides, la méta description et l'image de partage retombent sur le contenu du post. La zone SEO montre alors la valeur héritée en filigrane, et la compte dans son score, pour refléter ce que la page publique émettra. La pastille de la liste applique le même calcul. Voir [Repli SEO automatique](./types-et-champs.md#repli-seo-automatique).
+Laissées vides, la méta description et l'image de partage retombent sur le contenu du post. La zone SEO montre alors la valeur héritée en filigrane, et la compte dans son score, pour refléter ce que la page publique émettra. La pastille de la liste applique le même calcul. Voir [Repli SEO automatique](./03-types-et-champs.md#repli-seo-automatique).
 
 ### Titre et slug
 
@@ -126,13 +126,13 @@ Tant que le champ slug n'a pas été touché, il suit le titre à la frappe. Le
 
 Sur un type sans champ `title`, il n'y a rien à suivre : le champ slug reste vide et le serveur y pose `post-<id>` à l'enregistrement. Vous pouvez toujours saisir la valeur de votre choix.
 
-À l'édition, le slug est considéré comme touché **dès le chargement**. Renommer le titre d'un post existant ne change donc jamais son slug, ce qui reflète exactement la règle appliquée par le serveur. Voir [Modèle de données](./modele-de-donnees.md).
+À l'édition, le slug est considéré comme touché **dès le chargement**. Renommer le titre d'un post existant ne change donc jamais son slug, ce qui reflète exactement la règle appliquée par le serveur. Voir [Modèle de données](./06-modele-de-donnees.md).
 
 Le slug saisi est renormalisé à l'enregistrement, et suffixé s'il entre en collision avec celui d'un autre post du même type.
 
 ### Sélecteur de template
 
-Le sélecteur liste les templates enregistrés pour **ce type**, jamais ceux d'un autre. Voir [Templates](./templates.md).
+Le sélecteur liste les templates enregistrés pour **ce type**, jamais ceux d'un autre. Voir [Templates](./07-templates.md).
 
 Si le post porte un template qui n'existe plus, le sélecteur se réaligne sur le premier disponible, et l'enregistrement suivant écrit cette valeur. Le rendu public, lui, ne réécrit rien : il retombe sur `default` tant que le champ n'a pas été enregistré.
 
@@ -178,7 +178,7 @@ Sans `@fraza/module-medias` installé et activé, le bouton de sélection est re
 
 Chaque taxonomie déclarée a son propre écran, atteignable depuis la barre latérale. La liste est paginée à 20 termes, triable sur le titre, les dates et le statut.
 
-Deux colonnes méritent l'attention : le **nombre de posts** qui portent le terme, et son statut actif ou inactif. Un terme utilisé par au moins un post ne peut pas être supprimé ; le désactiver est la façon de le retirer de la circulation sans perdre les classements. Voir [Taxonomies et relations](./taxonomies-et-relations.md).
+Deux colonnes méritent l'attention : le **nombre de posts** qui portent le terme, et son statut actif ou inactif. Un terme utilisé par au moins un post ne peut pas être supprimé ; le désactiver est la façon de le retirer de la circulation sans perdre les classements. Voir [Taxonomies et relations](./04-taxonomies-et-relations.md).
 
 Un terme porte un titre, une description facultative et son drapeau d'activité. Il n'a pas de slug. Deux termes d'une même taxonomie ne portent pas le même titre : créer ou renommer un terme avec le titre d'un autre est refusé avec le message « Un terme porte déjà ce titre dans cette taxonomie. ».
 
@@ -193,7 +193,7 @@ Le seul contrôle bloquant côté navigateur est le titre, qui ne peut pas être
 ## Notes
 
 - Les deux plafonds de l'interface, 500 posts dans le sélecteur de parent et 1000 termes dans un sélecteur de taxonomie, ne sont pas réglables.
-- La recherche n'est pas exposée dans la liste d'admin, bien que la route la supporte. Passer par [l'API](./api.md) pour l'utiliser.
+- La recherche n'est pas exposée dans la liste d'admin, bien que la route la supporte. Passer par [l'API](./08-api.md) pour l'utiliser.
 - Un post privé reste éditable dans l'admin, mais son URL publique répond une page introuvable. Le bouton de lien disparaît alors de la ligne et de l'en-tête. Il n'y a pas de prévisualisation des posts privés.
 - Supprimer un post ne supprime pas ses enfants. Ils remontent à la racine du type, et leur URL publique change en conséquence.
 - Modifier une variable de déclaration demande un redémarrage du serveur : l'admin lit la configuration analysée au boot, pas le fichier d'environnement.

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

@@ -4,7 +4,7 @@ description: Les quatre tables du module, les écritures en transaction, les mig
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/posts/api
+    - 06-modules/posts/08-api
     - 03-reference/01-cores/database
 ---
 
@@ -52,7 +52,7 @@ Tous les autres champs déclarés y sont écrits sous leur nom, avec `null` quan
 - `template`, l'identifiant du template de rendu, `default` en l'absence de choix ;
 - `seo`, l'objet de métadonnées, forcé à un objet vide si la valeur soumise n'en est pas un.
 
-Seules les valeurs saisies sont stockées dans `seo`. La méta description et l'image de partage dérivées du contenu n'y sont jamais écrites : elles sont recalculées à chaque rendu depuis les champs du post. Voir [Repli SEO automatique](./types-et-champs.md#repli-seo-automatique).
+Seules les valeurs saisies sont stockées dans `seo`. La méta description et l'image de partage dérivées du contenu n'y sont jamais écrites : elles sont recalculées à chaque rendu depuis les champs du post. Voir [Repli SEO automatique](./03-types-et-champs.md#repli-seo-automatique).
 
 À la lecture, le module aplatit `data` au premier niveau de l'objet post tout en conservant l'objet brut sous `_data`. Un post lu porte donc `post.title` et `post._data.title`.
 
@@ -94,7 +94,7 @@ Table de liaison, plusieurs à plusieurs.
 
 Contrainte : `UNIQUE(post_id, taxonomy, term_id)`.
 
-Supprimer un post ou un terme retire les liaisons correspondantes par cascade. La suppression d'un terme encore utilisé est cependant refusée en amont, par le module. Voir [Taxonomies et relations](./taxonomies-et-relations.md).
+Supprimer un post ou un terme retire les liaisons correspondantes par cascade. La suppression d'un terme encore utilisé est cependant refusée en amont, par le module. Voir [Taxonomies et relations](./04-taxonomies-et-relations.md).
 
 ## `fraza_posts_relation`
 

package/dist/docs/06-modules/posts/{templates.md → 07-templates.md}

@@ -4,7 +4,7 @@ description: Écrire un template de post, les propriétés qu'il reçoit, la por
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/posts/admin
+    - 06-modules/posts/05-admin
     - 03-reference/01-cores/templates
     - 02-guides/contenu-public-et-templates
 ---
@@ -59,7 +59,7 @@ Aucun `children` n'est injecté, le template décide seul de sa structure.
 
 ### Deux clés non déclarables sur `post`
 
-`data` porte deux clés qui ne viennent d'aucune déclaration de champ, et qui sont donc aplaties comme les autres : `post.template`, l'identifiant du template retenu, et `post.seo`, l'objet de métadonnées. Voir [Modèle de données](./modele-de-donnees.md).
+`data` porte deux clés qui ne viennent d'aucune déclaration de champ, et qui sont donc aplaties comme les autres : `post.template`, l'identifiant du template retenu, et `post.seo`, l'objet de métadonnées. Voir [Modèle de données](./06-modele-de-donnees.md).
 
 Un type hiérarchique ajoute par ailleurs `post._path`, le chemin public reconstruit depuis la chaîne des parents. Sa valeur est celle de la propriété `url` : préférer `url`, qui est présente quel que soit le type. `_path` existe surtout pour l'admin, qui s'en sert pour le lien « voir » d'une ligne de liste.
 

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

@@ -4,8 +4,8 @@ description: Routes HTTP d'admin et publiques, et fonctions serveur importables
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/posts/modele-de-donnees
-    - 06-modules/posts/admin
+    - 06-modules/posts/06-modele-de-donnees
+    - 06-modules/posts/05-admin
     - 03-reference/01-cores/api
 ---
 
@@ -69,7 +69,7 @@ Le tri par défaut dépend du type : la colonne d'ordre en ascendant si le type
 
 Renvoie le post ou `null`, y compris quand il existe mais n'est pas public, ou qu'un de ses ancêtres ne l'est pas.
 
-Ses champs `editor` sont enrichis de leurs métadonnées médias, donc directement rendables. Ses taxonomies, relations et parent sont résolus. Les relations ne gardent que les posts visibles, sans leurs champs privés. Voir [Taxonomies et relations](./taxonomies-et-relations.md).
+Ses champs `editor` sont enrichis de leurs métadonnées médias, donc directement rendables. Ses taxonomies, relations et parent sont résolus. Les relations ne gardent que les posts visibles, sans leurs champs privés. Voir [Taxonomies et relations](./04-taxonomies-et-relations.md).
 
 Ses champs média le sont aussi : `image` et `thumbnail` portent un objet `{ id, filename, alt_text, caption, mime_type }`, `gallery` un tableau de ces objets dans l'ordre de la galerie. L'URL publique se construit à partir de `filename`, jamais stockée. Une référence dont le média a disparu apparaît comme `{ id, filename: null }`.
 

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

@@ -4,30 +4,42 @@ description: Types de contenu déclarés en variables d'environnement, avec taxo
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/posts/installation
-    - 06-modules/posts/types-et-champs
+    - 06-modules/posts/01-installation
+    - 06-modules/posts/03-types-et-champs
 ---
 
 `@fraza/module-posts` ajoute des types de contenu à l'admin, sans écrire une ligne de code. Un type, ses champs, ses taxonomies et ses relations sont déclarés dans les variables d'environnement, et le module en dérive la table, l'interface d'édition, les routes et le rendu public.
 
+```bash
+npm i @fraza/module-posts
+```
+
+| Paquet | `@fraza/module-posts` |
+|---|---|
+| Licence | MIT, Fraza Libre. |
+| Registre | npmjs, sans compte ni configuration. |
+| Activation | `FRAZA_MODULE_POSTS=true` |
+
+Le module demande en plus au moins un type déclaré. Le premier type, la création des tables et le rendu public sont dans [Installation](./01-installation.md).
+
 Le module est indépendant de `@fraza/module-pages`. Les deux peuvent cohabiter : posts réserve les URL de la forme `/<type>/<slug>`, pages sert de repli sur tout le reste.
 
 ![La liste d'un type de contenu déclaré, ici une équipe, avec ses colonnes propres](../../assets/modules/posts/liste.light.webp)
 
-Rien de cet écran n'est écrit en dur. Le libellé de la section, les colonnes affichées et la poignée de réordonnancement viennent de la déclaration du type dans les variables d'environnement. Un deuxième type déclaré donne une deuxième section, avec ses propres colonnes. Voir [Types et champs](./types-et-champs.md).
+Rien de cet écran n'est écrit en dur. Le libellé de la section, les colonnes affichées et la poignée de réordonnancement viennent de la déclaration du type dans les variables d'environnement. Un deuxième type déclaré donne une deuxième section, avec ses propres colonnes. Voir [Types et champs](./03-types-et-champs.md).
 
 ## Pages de cette section
 
 | Page | Contenu |
 |---|---|
-| [Installation](./installation.md) | Installer le module, créer les tables, brancher le rendu public. |
-| [Configuration](./configuration.md) | Variable d'activation, permissions, entrées d'admin. |
-| [Types et champs](./types-et-champs.md) | Déclarer un type de contenu et ses champs. |
-| [Taxonomies et relations](./taxonomies-et-relations.md) | Classer, relier et hiérarchiser des posts. |
-| [Administration](./admin.md) | Écrans d'admin, liste, formulaire, sélecteurs et termes. |
-| [Modèle de données](./modele-de-donnees.md) | Les quatre tables, les migrations, les règles de slug. |
-| [Templates](./templates.md) | Écrire un template de post et les propriétés qu'il reçoit. |
-| [API](./api.md) | Routes HTTP et fonctions serveur importables. |
+| [Installation](./01-installation.md) | Installer le module, créer les tables, brancher le rendu public. |
+| [Configuration](./02-configuration.md) | Variable d'activation, permissions, entrées d'admin. |
+| [Types et champs](./03-types-et-champs.md) | Déclarer un type de contenu et ses champs. |
+| [Taxonomies et relations](./04-taxonomies-et-relations.md) | Classer, relier et hiérarchiser des posts. |
+| [Administration](./05-admin.md) | Écrans d'admin, liste, formulaire, sélecteurs et termes. |
+| [Modèle de données](./06-modele-de-donnees.md) | Les quatre tables, les migrations, les règles de slug. |
+| [Templates](./07-templates.md) | Écrire un template de post et les propriétés qu'il reçoit. |
+| [API](./08-api.md) | Routes HTTP et fonctions serveur importables. |
 
 ## Ce que le module apporte
 
@@ -47,7 +59,7 @@ Il n'y a pas un module par type de contenu. `FRAZA_MODULE_POSTS_TYPES` déclare
 
 La conséquence pratique : ajouter un type de contenu ne demande ni installation, ni migration, ni redéploiement de schéma. Une variable d'environnement suffit, les tables étant déjà en place.
 
-Voir [Types et champs](./types-et-champs.md) pour la syntaxe.
+Voir [Types et champs](./03-types-et-champs.md) pour la syntaxe.
 
 ## Positionnement dans le rendu public
 
@@ -57,6 +69,6 @@ Une page CMS nommée `blogue` et un type de post nommé `blogue` peuvent donc co
 
 ## Notes
 
-- Un type sans champ de type `slug` n'est jamais rendu publiquement. C'est l'interrupteur qui distingue un type public d'un type purement interne. Voir [Types et champs](./types-et-champs.md).
+- Un type sans champ de type `slug` n'est jamais rendu publiquement. C'est l'interrupteur qui distingue un type public d'un type purement interne. Voir [Types et champs](./03-types-et-champs.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.
 - Le module lit et écrit des médias par le [registre média](../../03-reference/03-registres/media-registry.md) du core. Sans `@fraza/module-medias`, les champs `image`, `thumbnail` et `gallery` restent déclarables mais le sélecteur ne s'ouvre pas, et le module émet un avertissement au boot.

package/dist/shared/lib/version.js

@@ -1,4 +1,4 @@
-const CORE_VERSION = "0.3.7";
+const CORE_VERSION = "0.3.10";
 export {
   CORE_VERSION
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fraza/core",
-  "version": "0.3.7",
+  "version": "0.3.10",
   "description": "Starter kit Next.js avec un back-office modulaire, conçu au Québec.",
   "publishConfig": {
     "access": "public"

package/supported.json

@@ -12,7 +12,7 @@
     "next": {
       "floor": "16.0.0",
       "range": ">=16.0.0 <17.0.0",
-      "tested": "16.3.8"
+      "tested": "16.4.3"
     },
     "react": {
       "floor": "19.0.0",

package/dist/docs/06-modules/drive/installation.md

@@ -1,69 +0,0 @@
----
-title: Installation
-description: Installer @fraza-pro/module-drive, créer les tables et régler la taille des tranches d'envoi selon le proxy.
-related:
-  title: Étapes suivantes
-  links:
-    - 06-modules/drive/configuration
-    - 06-modules/drive/partages
----
-
-Cette page couvre l'installation de `@fraza-pro/module-drive` 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).
-
-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).
-
-## Prérequis
-
-- Un projet généré par `npx @fraza/start`, avec `@fraza/core` en version `0.1.14` ou plus, la première qui reconnaît la portée `@fraza-pro`.
-- 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).
-- Un **stockage objet compatible S3** configuré, Backblaze B2 ou Cloudflare R2. Sans lui, le module démarre mais aucun dépôt n'aboutit. Voir [Stocker des fichiers](../../02-guides/stocker-des-fichiers.md).
-- Un **PostgreSQL compilé avec ICU**, pour le tri naturel des noms. C'est le cas des images Docker officielles, et de la compilation par défaut depuis la version 16. Sans ICU, la migration du module s'arrête avec un message qui le dit.
-- `sharp`, dépendance de pair facultative du core, installé si l'on veut les miniatures d'images : sans elle, le module fonctionne à l'identique, sans vignettes. Le module n'a plus aucune dépendance de production : l'archive ZIP et les miniatures passent par le core.
-
-## Installer
-
-```bash
-npm i @fraza-pro/module-drive
-```
-
-Ajouter la variable d'activation à `.env.local`, et aux variables de la plateforme en production :
-
-```
-FRAZA_MODULE_DRIVE=true
-```
-
-Créez les tables :
-
-```bash
-npx fraza-db init
-```
-
-Puis redémarrez. L'entrée « Fichiers » apparaît dans la barre latérale de l'admin.
-
-## Mettre à jour
-
-Le schéma évolue par migrations versionnées. Après chaque mise à jour du paquet :
-
-```bash
-npx fraza-db migrate
-```
-
-Lancez-la avant de servir la nouvelle version. Le code s'appuie sur le schéma migré : sans la collation de tri, par exemple, les listes de fichiers échouent.
-
-## Aucune configuration du seau
-
-Il n'y a **aucune étape d'infrastructure**. Pas de règle CORS, pas de policy de seau, pas d'URL signée à faire circuler : tous les fichiers transitent par l'application, dans les deux sens, et le navigateur ne parle jamais au stockage.
-
-## Derrière un proxy
-
-Un proxy plafonne le corps d'une requête. Cloudflare l'arrête à 100 Mo sur le forfait gratuit, et refuse la requête avant qu'elle n'atteigne l'application.
-
-C'est pourquoi le navigateur découpe les fichiers : chaque tranche part dans sa propre requête, sous le plafond, et le serveur les réassemble dans le seau. Une tranche vaut 8 Mo par défaut, ce qui passe partout.
-
-Si votre proxy plafonne plus bas, alignez `FRAZA_MODULE_DRIVE_UPLOAD_CHUNK_MB` sur cette limite. Le minimum est 5, imposé par le stockage, donc un proxy qui plafonne sous 5 Mo empêche tout envoi de fichier volumineux.
-
-Le symptôme d'une valeur trop haute est net : les tranches partent puis échouent avec le code d'erreur du proxy, 413 chez la plupart.
-
-## Rien à câbler dans le projet
-
-Contrairement à `@fraza/module-medias`, ce module n'a **aucun fichier de route à monter**. Les binaires descendent par les routes `/za/api/drive/...`, qui existent déjà, et la page publique de partage passe par la sous-entrée `./public-page`, prise en charge par `npx fraza-modules sync`.