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.
Le noyau de la frontière
Section intitulée « Le noyau de la frontière »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éfixe | Décision | Rôle dans la frontière |
|---|---|---|
| CL-0023 | Plateforme d’exemple générique | Pose la frontière : le métier vit dans atlas, le socle reste générique. |
| CL-0041 | dbt / data quality vivent dans atlas | Précise ce qui n’a pas sa place dans cluster (la transformation de données). |
| CL-0042 | Cas-limite des sandbox | Tranche les sandbox en faveur de la frontière. |
| CL-0043 | Contrat d’interface cluster → atlas | La source de vérité du contrat (fichiers contract/*.example.yaml). |
| AT-0033 | Contrat d’interface (vue atlas) | Miroir applicatif de CL-0043 : ce que l’application attend et fournit. |
| AT-0077 | Topologie deux dépôts, frontière outillée | La 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éfixe | Décision | Rôle dans la frontière |
|---|---|---|
| AT-0029 | Architecture du pipeline de collaborations | Pose le contrat de données (Parquet + manifest sur S3) consommé via le cluster. |
| AT-0043 | Publication des images sur GHCR | Comment atlas livre ses images au registry du socle. |
| AT-0069 | Scan, signature et provenance des images | Durcit la chaîne d’approvisionnement des images livrées. |
| AT-0075 | Déploiement prod par digest | atlas expose des placeholders, cluster injecte le digest immuable. |
| CL-0093 | Cache de flux sur CNPG | Le socle fournit la base cache ; l’adaptateur vit côté atlas (AT-0085). |
Garde-fou
Section intitulée « Garde-fou »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.