Où trouver quoi — la carte de la documentation

Vous êtes ici : Démarrer — la page à ouvrir quand vous ne savez pas où chercher. La correspondance sujet → page du site → document qui fait foi, pour toute la plateforme. Lecture 6 min. Audience : tout le monde — c’est la porte d’entrée. Date : 2026-08-11 | Version : 1.0 — créée par la refonte de l’architecture d’information

Le principe central — le site explique, le dépôt fait foi

Ce site ne recopie aucun document interne. Il explique, met en perspective, et renvoie vers la source unique de chaque sujet. Un document interne a exactement un emplacement : le dépôt. Une page qui le recopierait créerait une deuxième vérité — et deux vérités divergent toujours, la question est seulement quand.

Conséquence pratique : si le site et un document du dépôt se contredisent, c’est le dépôt qui a raison — et c’est un défaut à signaler.

Comment lire ce site

Trois niveaux, du plus général au plus précis :

1. Le site explique

Vues d’ensemble, schémas, parcours de lecture, pourquoi les choses sont ainsi. C’est ici que vous comprenez un mécanisme sans avoir à lire du code.

2. Le dépôt décide

Décisions d’architecture, standards, savoir-faire, registres. C’est là que vit le détail contraignant — et la seule version qui fasse foi.

3. Le code prouve

Migrations, tests, gardes d’intégration continue. Ce qui n’est pas prouvé par un test finit par dériver ; le dépôt le sait et l’outille.

La carte des sujets

Chaque ligne dit où comprendre (page de ce site) et où vérifier (document du dépôt qui fait foi).

Plateforme de données

Sujet	Où comprendre	Où ça se décide
Comment une donnée entre, et pourquoi elle peut cesser d’être fraîche	Ingestion et fraîcheur	docs/standards/DATA_PIPELINE_LIFECYCLES.md
Ce qui est vérifié sur les données, et par qui	Qualité des données	packages/db/sql/quality-tests/README.md
La carte des schémas, le médaillon, l’isolation	Architecture de données	ADR-056, ADR-036
Où doit aller une nouvelle donnée analytique	Aiguillage des couches	ADR-074 (proposé), ADR-072
Faits, dimensions, grain, historisation	Modélisation dimensionnelle	ADR-072, ADR-071
Naissance, contrôle, conservation, destruction	Cycle de vie des données	docs/standards/DATA_GOVERNANCE.md
Où tournent les traitements, et ce que coûte le couplage	Compute et exécution	ADR-020, docs/standards/COMPUTE_MODEL.md

Exploitation

Sujet	Où comprendre	Où ça se décide
Lire un journal d’exécution, diagnostiquer un chargement	Lire un journal ETL	docs/architecture/DECISIONS.md
Procédures d’incident, reprise, rotation	(pas de page dédiée — voir la colonne de droite)	docs/runbooks/INDEX.md

Sécurité et accès

Sujet	Où comprendre	Où ça se décide
Qui a le droit de lire quoi, et comment c’est délégué	Modèle d’accès	ADR-061, ADR-067
Comment on s’authentifie, et pourquoi ainsi	Stratégie d’authentification	ADR-063, ADR-013
La défense en profondeur	Sécurité	docs/skills/SECURITY.skill.md
Accès de la plateforme à la base, sans mot de passe	Managed Identity	ADR-033, ADR-057
Renseignements personnels et Loi 25	Cycle de vie § Fin de vie	ADR-048

Gouvernance

Sujet	Où comprendre	Où ça se décide
Comment une décision se prend, se grave, se révise	Comment GS-Apps décide	docs/architecture/ADR-INDEX.md
La liste des décisions, à jour par construction	Index des décisions	(généré depuis le dépôt)
Les savoir-faire chargés avant de travailler	Index des savoir-faire	(généré depuis le dépôt)
Comment naît une nouvelle application	Naissance d’une application	ADR-073
Le parc : modules, conteneurs, préfixes	Parc applicatif	(généré depuis le dépôt)

Trois index sont générés, pas écrits

Les index des décisions, des savoir-faire et du parc applicatif sont dérivés du dépôt à chaque construction du site. Personne ne les tient à jour à la main : une décision ajoutée au dépôt apparaît au déploiement suivant. C’est le seul type de liste qui ne dérive jamais.

Ce qui n’est délibérément pas sur ce site

Le site est public-adjacent : il peut être lu hors de l’organisation. Certaines choses n’y entrent donc jamais, et ce n’est pas un oubli.

Catégorie	Pourquoi	Où ça vit
Valeurs réelles — volumes, montants, heures, immatriculations, noms de clients	Une mesure publiée devient une donnée d’affaires exposée	Rapports internes, base de données
Identifiants d’infrastructure — abonnements, locataires, groupes, adresses internes, comptes	Surface d’attaque	Registres internes
Détail exploitable d’incident	Un mode opératoire de panne est un mode opératoire d’attaque	docs/runbooks/
Contenu des décisions et standards	Règle de canonicité — une source, une vérité	Dépôt (liens ci-dessus)

Les exemples de ce site sont donc fictifs ou structurels : ils montrent une forme, jamais une valeur. Deux gardes automatiques le vérifient à chaque modification — voir Comment GS-Apps décide.

Vous ne trouvez toujours pas ?

Dans l’ordre :

1. La recherche du site (en haut) couvre toutes les pages.
2. L’index des décisions — si le sujet est une décision d’architecture, elle y est, avec son statut.
3. L’index des savoir-faire — si le sujet est une pratique (« comment on fait X »), le savoir-faire correspondant le porte.
4. Le sujet n’existe nulle part — c’est une information utile en soi : signalez-le. Une documentation dont on connaît les trous vaut mieux qu’une documentation qu’on croit complète.

Pour aller plus loin

• Vue d’ensemble — ce que fait la plateforme, en une page.
• Glossaire et Lexique technique — le vocabulaire, si un terme bloque la lecture.
• Comment GS-Apps décide — la mécanique de gouvernance qui tient cette carte à jour.