La plateforme est organisée en couches, chacune avec une responsabilité distincte, connectées plutôt qu'isolées.
Comment la plateforme est structurée
Chaque couche — gouvernance, standards, architecture, etc. — est une discipline distincte, mais chacune est conçue pour fonctionner avec les autres, pas isolément.
Les couches et leurs responsabilités
La gouvernance définit les droits de décision et les règles opérationnelles ; l'architecture consigne les décisions de conception significatives ; la livraison rend les mises en production prévisibles et reproductibles.
Comment les décisions d'architecture sont consignées
Les décisions de conception significatives sont documentées sous forme d'Architecture Decision Records, avec leur contexte et leurs arbitrages, pas seulement leur résultat.
Exemples
Un exemple de configuration, un tableau récapitulatif des composants et un bref aperçu à onglets de la manière dont cette architecture est généralement présentée à une nouvelle équipe.
Une configuration d'environnement minimale pour une instance ETES locale :
ETES_API_URL=https://api.etes.local
ETES_ENV=development
ETES_LOG_LEVEL=info| Composant | Type | Description |
|---|---|---|
| API Gateway | Service | Achemine et authentifie les requêtes entrantes de la plateforme. |
| Standards Engine | Service | Évalue le contenu et la configuration par rapport aux normes actives. |
| Documentation Store | Données | Conserve le contenu des articles versionné et leurs métadonnées. |
La plateforme est organisée en un petit ensemble de services coopérants plutôt qu'en un seul bloc monolithique, afin que chaque domaine puisse évoluer indépendamment.
Chaque service lit sa configuration à partir des variables d'environnement au démarrage, sans magasin de configuration mutable partagé entre eux.
Les services exposent une API HTTP versionnée ; les appels internes entre services utilisent les mêmes contrats que les intégrations externes.