Set-OPS-Public/docs/schemas-flux.md

97 lines
6.1 KiB
Markdown
Raw Normal View History

# Les pages publiées — où elles sont, et ce qu'elles montrent
> **Pour qui :** le **mainteneur**, quand il cherche une page existante ou qu'il en
> écrit une neuve. Les pages elles-mêmes visent d'autres lecteurs — ce tableau le dit
> pour chacune.
**Ce fichier est la liste entière**, pas seulement celle de la série des flux. Une page
publiée qui n'y figure pas est une page qu'on ne retrouvera pas : elle vit sur une adresse
que personne ne devine, et elle vieillira sans que quiconque s'en aperçoive.
La série des flux, elle, obéit à une règle propre : ces pages expliquent **comment les
choses sont configurées et interconnectées**. Ce ne sont pas des comptes rendus — elles ne
relatent aucun incident, ne datent aucune panne et ne comptent aucune machine tombée. Ce
travail-là appartient au `CHANGELOG.md` et à `docs/decisions-architecture.md`. Une page de
cette série répond à une seule question : *par où passe telle chose, et pourquoi par là*.
## La série
| # | Page | Ce qu'elle montre |
|---|---|---|
| 1 | [La chaîne de l'heure](https://claude.ai/code/artifact/fd050fd8-12b1-4db0-91a3-eac7cf19ee65) | Du satellite aux machines par la frontière — une seule sortie |
| 2 | [La vie d'un certificat](https://claude.ai/code/artifact/77f067e0-336d-445a-ac31-c6f8eab10d73) | Racine, émission, renouvellement, consommateurs, contrôle |
| 3 | [Comment un nom devient une adresse](https://claude.ai/code/artifact/8cdc642f-f1ea-4ff2-ab87-41d2e1d93fd3) | Le plancher, le résolveur, l'autoritatif — dans cet ordre |
| 4 | [D'où vient un paquet](https://claude.ai/code/artifact/5c669f67-ad83-4b4f-9255-98dc0040db7b) | Le cache, ses deux faces, et les deux langues d'apt |
| 5 | [Une identité, un mot de passe](https://claude.ai/code/artifact/3ea86b63-893f-4795-b391-1f75876dace7) | L'annuaire, la fédération, la passerelle — et qui a droit à quoi |
| 6 | [Ce qu'on ne peut pas refaire](https://claude.ai/code/artifact/fd0073dc-6ad8-401d-a5a6-f31d304e7092) | La sauvegarde : ce qui part, ce qui ne part pas, qui vérifie |
| 7 | [Trois canaux, trois sens](https://claude.ai/code/artifact/306bde34-f29c-4396-b43c-7dfeefc259aa) | Verdicts poussés, chiffres tirés, journaux expédiés |
| 8 | [Le trajet d'un courriel](https://claude.ai/code/artifact/0b9b96ea-8d7d-4c40-8461-897a2c11a829) | Deux machines, un annuaire, une remise vérifiée |
## Ce qui les relie
| Page | Ce qu'elle montre |
|---|---|
| [Ce qui relie un locataire à son site](https://claude.ai/code/artifact/28f81e5d-4e71-48ee-aadc-43c4ba9353f9) | Les six liens de la filiation, et ce que coupe chacun |
## Pages destinées à quelqu'un d'autre que le mainteneur
Registre différent : pas de nom de logiciel en titre, pas de vocabulaire de doctrine.
| Page | Pour qui |
|---|---|
| [La maison TechnoLibre](https://claude.ai/code/artifact/bc2b441f-3f39-4659-8399-e61615f778cf) | Le propriétaire d'un écosystème — ce qu'il ouvre, où sont ses affaires |
| [Où commence le système](https://claude.ai/code/artifact/3bffbc9c-018e-4e42-95d1-103b98139589) | Positionnement face à Coolify et Cloud in a Bottle |
| [Deux sites, un tunnel](https://claude.ai/code/artifact/8cbc0ddc-6110-4bc6-906d-90e6a0eba987) | Plan de niveau 3 des deux sites reliés |
| [Un écosystème Set-OPS](https://claude.ai/code/artifact/6ca4514e-6227-4bb6-b07e-ef6690cc156a) | Article promotionnel — résultat et capacités |
| [Inventaire libre](https://claude.ai/code/artifact/ee444b6a-0605-4dce-972d-b9f090f2011e) | La liste des logiciels libres de la solution |
## La page commerciale
Une seule page en quatre parties — le moteur, les offres, les tarifs, la valeur. C'est la
seule qui **affirme un état** (« éprouvé ») et **un prix** ; elle se relit donc chaque fois
qu'une capacité change de camp.
| Page | Ce qu'elle porte |
|---|---|
| [Capacités, offres, tarifs et valeur](https://claude.ai/code/artifact/28369c71-c7c4-43f3-abfe-8dcf0fc50c8b) | Dix piliers, huit offres, la grille tarifaire, le calculateur et les réserves |
Les chiffres qu'elle avance se **mesurent** : nombre de rôles, de preuves, d'affirmations au
registre, de lignes de documentation. Les recompter avant de republier, plutôt que de les
reconduire.
## Plus anciennes, gardées pour mémoire
Elles n'ont pas été revues depuis leur publication et peuvent décrire un état dépassé.
| Page | Ce qu'elle montrait | Publiée |
|---|---|---|
| [Plan, dérivation, preuve](https://claude.ai/code/artifact/c7d996bf-8d99-4377-b5a8-91ad7d63ab39) | La méthode du moteur, en une page | 2026-08-26 |
| [Préparer ton site pour TechnoLibre](https://claude.ai/code/artifact/1edbb622-6bb5-4560-9e93-8953b5caec42) | La préparation du site d'un partenaire | 2026-08-12 |
| [Réseau Chezlepro — les trois plans](https://claude.ai/code/artifact/78584a01-7b45-4e2a-b8bd-e4aa3ecd5341) | Les trois plans du réseau, avant la fusion du lien de sortie | 2026-08-04 |
## La règle d'écriture
**Garder le mécanisme et sa raison. Retirer l'anecdote, la date, la durée, le nombre de
machines touchées.**
Un réglage mérite souvent son explication — `harden-below-nxdomain: no` n'a aucun sens sans
savoir que la racine signée nie le domaine `internal.`. Ça reste. Ce qui ne reste pas, c'est
combien de temps il a fallu pour le comprendre.
Les chiffres sont admis quand ils donnent un **ordre de grandeur utile** (« un écosystème
de quatorze machines demande environ 1,3 Go de paquets »), pas quand ils racontent une
soirée particulière.
## Quand les relire
Une page décrit une configuration : elle vieillit quand la configuration change. Les points
à revérifier après une modification d'architecture sont, dans l'ordre :
- un **service prêté** ajouté ou retiré → pages 4, 6 et celle des liens
- un **renumérotage** → toutes les pages qui portent une adresse
- une **bascule** (résolveur, cache, sauvegarde) → pages 3, 4, 6
- un **rôle neuf avec une sonde** → page 7
- une **capacité qui passe de la feuille de route au service** → la page commerciale, où
elle porte un badge d'état et parfois un prix. C'est la relecture la plus facile à
oublier, parce qu'une bonne nouvelle ne ressemble pas à une tâche.