Set-OPS-Public/docs/schemas-flux.md
Daniel Allaire 4b759110bf pages publiees : la liste entiere, et la page qui affirme un prix
Le registre ne couvrait que la serie des flux. Quatre pages publiees n en
faisaient pas partie, dont la seule qui affirme un ETAT et un PRIX. Une page
absente de cette liste vit sur une adresse que personne ne devine, et vieillit
sans que quiconque s en apercoive.

La page commerciale a ete reprise sur mesure et non de memoire :

- collaboration et couche web passent de la feuille de route au service ;
  Nextcloud, Collabora et les deux briques web tournent sur des machines reelles
- Maison OBNL, Cabinet et Presence Web quittent le chantier
- les chiffres recomptes : 51 roles -> 68, 16 preuves -> 75, 54 affirmations ->
  70, 8600 lignes -> 12600
- huit piliers sous un titre qui en annoncait sept — le defaut que P59 garde
- une section neuve sur le modele hebergeur/locataires, qui manquait entierement
- les sections Honnetete vendaient des reserves devenues fausses ; elles portent
  maintenant celles qui sont vraies : aucune reprise exercee, aucun depart
  accompagne, une seule destination de sauvegarde

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Crgis8CxCWkAGFA1ecBz3q
2026-09-13 20:32:02 -04:00

6.1 KiB

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 Du satellite aux machines par la frontière — une seule sortie
2 La vie d'un certificat Racine, émission, renouvellement, consommateurs, contrôle
3 Comment un nom devient une adresse Le plancher, le résolveur, l'autoritatif — dans cet ordre
4 D'où vient un paquet Le cache, ses deux faces, et les deux langues d'apt
5 Une identité, un mot de passe L'annuaire, la fédération, la passerelle — et qui a droit à quoi
6 Ce qu'on ne peut pas refaire La sauvegarde : ce qui part, ce qui ne part pas, qui vérifie
7 Trois canaux, trois sens Verdicts poussés, chiffres tirés, journaux expédiés
8 Le trajet d'un courriel 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 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 Le propriétaire d'un écosystème — ce qu'il ouvre, où sont ses affaires
Où commence le système Positionnement face à Coolify et Cloud in a Bottle
Deux sites, un tunnel Plan de niveau 3 des deux sites reliés
Un écosystème Set-OPS Article promotionnel — résultat et capacités
Inventaire libre 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 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 La méthode du moteur, en une page 2026-08-26
Préparer ton site pour TechnoLibre La préparation du site d'un partenaire 2026-08-12
Réseau Chezlepro — les trois plans 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.