verifier / verifier (push) Has been cancelled

Details

documentation : la tournee des 74 documents, parce qu un balayage ne lit pas

La revision a commence par un balayage par motifs — chemins morts, cibles make
absentes, comptes derives. Il a trouve une trentaine d ecarts et rate presque
tout le reste : un motif ne voit que ce qui s exprime en motif.

make hote-planifier en est l exemple. La cible EXISTE, donc le controle passait
au vert. C est une cible depreciee qui refuse et sort en 2, recommandee par
AGENTS.md, et qui contredit la REGLE D OR du meme fichier trois ecrans plus
haut. Il fallait lire pour la voir.

74 documents lus un par un. 66 corriges, 8 exacts.

CE QUI ETAIT FRANCHEMENT FAUX

AGENTS.md, la source d autorite, annoncait la flotte pas encore executee contre
des VM reelles. Elle a ete rasee et remontee depuis zero trois fois.
ecosysteme-chezlepro.md, le document montre a un client, portait la meme
phrase : il se sous-vendait gravement.

courriel-conception.md s ouvrait sur aucun role n est encore ecrit, au-dessus de
son propre paragraphe 1 qui les nomme. autorisation.md se terminait sur rien n
est construit alors qu il rapporte des mesures datees du role en fonctionnement.
hebergeur-exploitation.md disait rien n est fait d un depot qui existe.
filiation-emancipation.md se contredisait a deux ecrans de distance.

DES MODELES DECRITS D APRES UN MONDE ANTERIEUR

Le resolveur : cinq documents decrivaient un Unbound par VM en opt-in, trois le
donnaient en exemple d integration FACULTATIVE — il est universel depuis le
2026-08-24. L adressage de nomenclature-vm.md : reseau unique, VLAN 11-15, VMID
a cinq chiffres. Le nommage SDN de sdn-evpn.md contre le code : c est le wiki
qui avait raison.

CE QUI CASSE AU PREMIER ESSAI

Le nom du gabarit dore etait faux a quatre endroits, dont la procedure qui le
FABRIQUE et le critere R2 de l epreuve d operateur independant.
preparer-un-site-hebergeur.md avertissait qu une VM faite a la main serait
detruite : raser derive du plan, il ne la detruira jamais — le risque est l
inverse. Un mot de passe d essai en clair dans un depot public.

DEUX PREUVES ETENDUES, ET UNE QUI SE TROMPAIT ELLE-MEME

P57 couvre les groupes : elle a signale aussitot 29 groupes annonces au-dessus d
un tableau qui en cite 40. P29 confronte le tableau de authentification.md aux
declarations reelles : 12 annonces, 21 reels.

Et P57 imposait un chiffre faux — 56 preuves alors que le depot en porte 57, la
conditionnelle vivant hors de tout comptage. Un garde-fou qui fait respecter une
erreur ajoute l assurance a l erreur.

CE QUI RESTE, ET QU AUCUNE PREUVE NE TIENT

Deux comptes trouves a la main. Et une lacune reelle : rien ne garde les
meta/acces.yml — ni qu un service web-sso en porte un, ni que le groupe qu il
nomme existe. P29 tient les positions d authentification, personne ne tient les
habilitations.

make prouver : CONFORME, 56 OK, 0 echec, 1 saute. 0 lien mort.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Crgis8CxCWkAGFA1ecBz3q

2026-09-06 16:18:23 -04:00

6.9 KiB

Raw Blame History

Note de conception — panneau « Intrants de base » du GUI

Pour qui : le mainteneur du GUI.

But : saisir depuis un endroit unique les intrants communs de l'écosystème, en distinguant constantes et défauts surchargeables.

Extension assumée du plan de contrôle (gelé — cf. positionnement.md), au même titre que le dimensionnement. Décidée le 2026-06-26.

Statut, revu le 2026-09-06 : le panneau est construit. Ce document reste la note de conception — il explique les arbitrages, pas l'état. Trois écarts entre ce qui était proposé et ce qui a été fait, et ils comptent :

La migration en répertoires n'a eu lieu que pour all/. group_vars/all/ porte bien 00-instance.yml (tenu à la main) et 10-intrants.yml (écrit par le GUI) ; proxmox.yml et modeles_vm.yml sont restés des fichiers plats. Le §3 les présente encore comme des répertoires.

Les constantes Proxmox ont déménagé chez l'hébergeur. L'accès au cluster (proxmox_api_*) n'est plus un intrant du tenant : il vit dans proxmox-hebergeur.yml, à côté d'underlay.yml, parce qu'un cluster appartient à qui possède le matériel. Cf. config-proxmox.md.

Les « points ouverts » du §8 sont tranchés par ce qui a été bâti : la liste de rappel des secrets attendus est bien dans le panneau, en lecture seule, et elle se recense (scripts/voute.py lister) au lieu d'être recopiée — trois copies manuelles avaient existé, toutes avaient divergé.

1. Décisions cadre (validées)

Secrets : hors périmètre. Le GUI n'affiche ni ne stocke aucun secret. Les vault_* et tokens Proxmox restent édités via Ansible Vault en ligne de commande. Le panneau peut, au plus, afficher une liste de rappel en lecture seule des secrets attendus (sans valeur).
Nomenclature : lecture seule dans le panneau — à une exception près, l'index, qui est le seul champ d'adressage saisissable (panneau Réseau, écrit chirurgicalement). Tout le reste — supernet, sous-réseaux, passerelles, VLAN, VMID — se dérive et P20 refuse qu'on l'écrive. (Ce point disait « l'édition de supernet/VLAN/catégories reste dans plan/nomenclature.yml » : ces valeurs n'y sont plus du tout.)
Conception avant code (cette note).

2. Modèle : constante vs défaut surchargeable

Constante — une seule valeur, pas de surcharge. Éditée uniquement au panneau ; apparaît en lecture seule dans les formulaires d'hôte (contexte).
Défaut surchargeable — valeur globale qui ressurgit comme défaut là où l'intrant réapparaît (hôte / groupe). Le formulaire d'hôte la montre pré-remplie et marquée « hérité » ; toute saisie locale devient une surcharge (badge « surchargé » + bouton « rétablir le défaut »).

Classification de départ : voir intrants-communs.md §2. Résumé : Constantes = domaine_interne, nomenclature, accès Proxmox, golden template, secrets. Défauts = timezone, nœud/stockage/pont Proxmox, DNS internes, politiques de durcissement, relais SMTP, ciuser/compte ansible.

3. Persistance — fichiers cibles, sans perte de commentaires

Contrainte : pas de dépendance non-stdlib (souveraineté) → pas de round-trip YAML préservant les commentaires (ruamel). Solution : fichiers possédés par le GUI, réécrits en bloc avec un en-tête généré (comme hosts.genere.yml), à côté des fichiers tenus à la main.

Domaine	Fichier possédé par le GUI	Tenu à la main (coexiste)
Identité + politiques (défauts)	`group_vars/all/10-intrants.yml`	`group_vars/all/00-instance.yml`
Proxmox (constantes + défauts)	`group_vars/proxmox/10-intrants.yml`	`group_vars/proxmox/00-base.yml`
Template/durcissement (défauts)	`group_vars/modeles_vm/10-intrants.yml`	`group_vars/modeles_vm/00-base.yml`

Migration légère : convertir group_vars/all.yml → répertoire group_vars/all/ (Ansible le supporte nativement). Idem proxmox.yml, modeles_vm.yml. Les valeurs existantes sont scindées : commentaires/contexte dans 00-*, valeurs pilotées par le GUI dans 10-intrants.yml. La précédence Ansible reste identique.

Les surcharges par hôte continuent de vivre dans plan/serveurs.yml (déjà supporté) ; par groupe, dans le group_vars/<groupe>/ correspondant.

4. Mécanique d'héritage (côté générateur)

Le panneau écrit les défauts dans les 10-intrants.yml.
instancier.py / les formulaires lisent ces défauts pour pré-remplir et marquer « hérité » ; une valeur présente dans serveurs.yml (hôte) prime et s'affiche « surchargé » (même logique setdefault que le dimensionnement).
Les constantes ne sont jamais réémises par hôte : un seul point de vérité.

5. Écran (UI)

Bouton « Intrants de base » dans l'en-tête du GUI → panneau modal/plein écran.
Sections repliables par domaine : Identité, Proxmox, Politiques de durcissement, Services centraux, Nomenclature (lecture seule), Secrets attendus (lecture seule).
Chaque champ porte un badge Constante / Défaut, et l'info-bulle d'aide (réutilise le mécanisme AIDES déjà en place).
Bandeau d'avertissement sur domaine_interne (changement à fort impact : re-dérive zones, FQDN, base DN…) → confirmation explicite.

6. Garde-fous

--syntax-check + ansible-inventory --list doivent rester verts après écriture.
Discipline diff-vide : make instancier montre l'impact, application via FORCE si intentionnel.
Aucune valeur secrète n'entre dans un fichier écrit par le GUI (vérifié par un test).

7. Périmètre proposé (MVP → suite)

MVP : domaine_interne (constante, avec garde-fou), fuseau_horaire (défaut), accès Proxmox (constantes), golden template (constantes), placement Proxmox par défaut (nœud/stockage/pont), + nomenclature et secrets en lecture seule.
Suite : politiques de durcissement (défauts par groupe), DNS internes, relais SMTP, endpoints services centraux.

8. Points ouverts — tranchés par ce qui a été construit

Question de juin	Réponse, telle que le code la donne
Migrer `group_vars/*.yml` → répertoires ?	Pour `all/` seulement. `proxmox.yml` et `modeles_vm.yml` sont restés plats — la migration n'a payé que là où le GUI écrivait vraiment.
Afficher la liste de rappel des secrets ?	Oui, en lecture seule — et recensée, jamais recopiée (`scripts/voute.py lister`, gardée par P18).
Périmètre MVP suffisant ?	Oui, et il a été dépassé : la couverture du GUI est désormais prouvée par P19, qui refuse un champ du plan que la console ne saurait pas éditer.

6.9 KiB Raw Blame History