Versions de la documentation

Chaque release majeure de Kohinos donne lieu à un snapshot HTML figé de cette documentation. La version courante est toujours servie à la racine de dochtml/ ; les versions antérieures sont conservées dans dochtml/versions/ et restent consultables hors-ligne.

Historique

Version doc	Date	Commit	Highlights	Archive
v3 — 2026-06-12 (courante)	2026-06-12	f558098fa	Verdict revue v3 : 🟢 GO CANARY. Phases 1 à 5 terminées (sécurité durcie, invariants financiers V1-V10, tests critiques, enums PHP 8.1, N+1 + a11y). Fonctionnalités trésorier/prestataire #40.1-40.4. Audit qualité au vert (PHPStan, CS, SSA 127 / SEPA 140, 0 vulnérabilité).	versions/v3-2026-06-12/ (non publié)
v3 — 2026-05-19	2026-05-19	8d60b1904	Refonte complète post-migration Symfony 7.2. Documentation utilisateur, développeur et devops consolidée. En-tête de version ajouté sur toutes les pages.	versions/v3-2026-05-19/ (non publié)

Politique de versionnement

La documentation HTML de Kohinos est versionnée selon les règles suivantes :

• Snapshot à chaque release majeure du Kohinos (v3, v4, …). Le script scripts/freeze-docs-version.sh copie l'arborescence courante de dochtml/ dans dochtml/versions/v<N>-YYYY-MM-DD-<short-sha>/.
• Pas de submodule, pas de SaaS (cf. .claude/rules/global.md : souveraineté + sobriété). Les archives sont des fichiers statiques, servies par le même serveur que la version courante.
• Idempotence : figer deux fois la même date+commit ne duplique pas l'archive (le script détecte le dossier existant).
• Aucune purge automatique : les archives anciennes restent disponibles tant que l'espace disque le permet. La rotation éventuelle est manuelle.
• Métadonnées en clair : chaque page porte un en-tête .doc-version indiquant la version du Kohinos, la date de génération et le commit court — pas de JS, pas d'appel réseau pour les retrouver.

Comment figer la version courante

# Aperçu (rien n'est copié)
./scripts/freeze-docs-version.sh --dry-run

# Création réelle de l'archive
./scripts/freeze-docs-version.sh

Le script crée dochtml/versions/v3-YYYY-MM-DD-<sha>/ et copie user/, dev/, devops/, assets/ et index.html. Pensez ensuite à mettre à jour le tableau ci-dessus et le lien « archive » correspondant.