ActifActive BloquantBlocking

Rebuild du siteSite rebuild

Garantir que le site de documentation est toujours synchronisé avec l'état réel des tokens, des décisions et des composants.Ensure the documentation site is always synchronized with the actual state of tokens, decisions, and components.

Flux du pipelinePipeline flow

01 · Déclencheur01 · Trigger
Tokens, décisions ou guidelines modifiésTokens, decisions, or guidelines modified
site/build.js · tokens/*.json · decisions/ADR-*.md · guidelines/**/*.md · Brand/site/build.js · tokens/*.json · decisions/ADR-*.md · guidelines/**/*.md · Brand/
02 · Rebuild02 · Rebuild
node site/build.jsnode site/build.js
Génère toutes les pages HTML, CSS et JS. Compile les tokens en variables CSS. Copie logo, favicons et image sociale.Generates all HTML, CSS and JS pages. Compiles tokens into CSS variables. Copies logo, favicons and social image.
03 · Vérification03 · Verification
Assets · OG · Parité · CountAssets · OG · Parity · Count
logo.svg · social.png · favicon · og:image · twitter:card · lang-fr/en parity · nombre de fichiers attendulogo.svg · social.png · favicon · og:image · twitter:card · lang-fr/en parity · expected file count

Valeur métierBusiness value

Le site est la vitrine du système. Ce pipeline garantit que chaque changement est immédiatement reflété sur la documentation — assets, métadonnées et parité FR/EN inclus.The site is the system's showcase. This pipeline ensures every change is immediately reflected in the documentation — assets, metadata and FR/EN parity included.

Matrice de déclenchementTrigger matrix

Fichier modifiéChanged fileActionAction
site/build.jsRebuild completFull rebuild
tokens/primitives.jsonRebuild (tokens.css régénéré)Rebuild (tokens.css regenerated)
tokens/semantic.jsonRebuild (tokens.css régénéré)Rebuild (tokens.css regenerated)
decisions/ADR-*.mdRebuild (nouvelle page ADR générée)Rebuild (new ADR page generated)
guidelines/**/*.mdRebuild si contenu injectéRebuild if content injected
Brand/Rebuild + copie assets (logo, favicons, image sociale)Rebuild + copy assets (logo, favicons, social image)

ContrôlesChecks

  1. node site/build.js exit 0 (aucune erreur de compilation)node site/build.js exit 0 (no compilation error)
  2. Nombre de fichiers générés ≥ baseline (37 + ADRs + nouvelles pages)Generated file count ≥ baseline (37 + ADRs + new pages)
  3. logo.svg présent dans site/dist/logo.svg present in site/dist/
  4. social.png présent dans site/dist/social.png present in site/dist/
  5. Chaque page : og:title, og:description, og:image présentsEach page: og:title, og:description, og:image present
  6. twitter:card, twitter:domain présentstwitter:card, twitter:domain present
  7. Parité bilingue : chaque lang-fr a un lang-en correspondantBilingual parity: each lang-fr has a corresponding lang-en
  8. validateCssVars() exit 0 : aucune var(--agtc-…) orphelinevalidateCssVars() exit 0: no orphaned var(--agtc-…)

CommandeCommand

cd site && node build.js
Contribuer à ce projet Contribute to this project

Ce système est ouvert aux contributions — tokens, composants, décisions architecturales, corrections d'accessibilité ou documentation. Toute amélioration est bienvenue. This system welcomes contributions — tokens, components, architectural decisions, accessibility fixes, or documentation. Every improvement counts.

Voir sur GitHub View on GitHub