Aller au contenu

Index des décisions système (frontière cluster ↔ atlas)

Les décisions structurantes du système se répartissent sur deux dépôts (ADR 0077) : cluster (socle d’infrastructure) et atlas (applicatif/métier). Chaque dépôt tient sa propre série numérotée, si bien qu’un même numéro désigne deux décisions sans rapport (0033 = Orchestration Ansible DataOps côté cluster, Contrat d’interface côté atlas).

Cette page indexe les décisions qui décrivent la frontière entre les deux dépôts, en les préfixant CL- (cluster) / AT- (atlas) pour lever l’ambiguïté sans renuméroter quoi que ce soit. Ce n’est pas l’index exhaustif des ADR (voir l’index atlas et l’index cluster) : seulement le noyau transverse, pour lire la frontière d’un coup d’œil.

La frontière est conçue, pas accidentelle : le socle n’expose que des valeurs d’exemple génériques, le métier vit dans atlas, et un contrat machine-lisible est publié par cluster vers atlas (sens unique).

PréfixeDécisionRôle dans la frontière
CL-0023Plateforme d’exemple génériquePose la frontière : le métier vit dans atlas, le socle reste générique.
CL-0041dbt / data quality vivent dans atlasPrécise ce qui n’a pas sa place dans cluster (la transformation de données).
CL-0042Cas-limite des sandboxTranche les sandbox en faveur de la frontière.
CL-0043Contrat d’interface cluster → atlasLa source de vérité du contrat (fichiers contract/*.example.yaml).
AT-0033Contrat d’interface (vue atlas)Miroir applicatif de CL-0043 : ce que l’application attend et fournit.
AT-0077Topologie deux dépôts, frontière outilléeLa décision-chapeau : garder deux dépôts, outiller la frontière.

Le contrat opérationnel (déploiement, images, données)

Section intitulée « Le contrat opérationnel (déploiement, images, données) »

Comment l’application se déploie sur le socle, et ce qu’elle lui livre.

PréfixeDécisionRôle dans la frontière
AT-0029Architecture du pipeline de collaborationsPose le contrat de données (Parquet + manifest sur S3) consommé via le cluster.
AT-0043Publication des images sur GHCRComment atlas livre ses images au registry du socle.
AT-0069Scan, signature et provenance des imagesDurcit la chaîne d’approvisionnement des images livrées.
AT-0075Déploiement prod par digestatlas expose des placeholders, cluster injecte le digest immuable.
CL-0093Cache de flux sur CNPGLe socle fournit la base cache ; l’adaptateur vit côté atlas (AT-0085).

Tout changement d’un point de contact se reflète dans AT-0033 dans la même PR que le changement de code, et l’alignement avec la source cluster (CL-0043) est tenu par discipline. Les numéros restent homonymes entre dépôts ; les préfixes CL-/AT- de cette page sont une convention de lecture, pas une renumérotation.