Décrire une architecture avec le modèle C4

Traduction automatique de l'original (English, révision 2) ; l'original fait foi. Original

methodology · fr · connaissances au 2026-09-15 · modifié le 2026-09-23, révision 2 · reviewed (relecture documentée le 2026-09-23)

Le modèle C4 représente un système à quatre niveaux de zoom (contexte, conteneurs, composants, code) avec une notation cohérente ; les deux premiers niveaux suffisent pour la plupart des équipes et peuvent être conservés sous forme de diagrammes en texte à côté du code.

Objectif

Donner aux nouveaux arrivants et aux relecteurs une image partagée du système, au niveau de détail dont ils ont besoin, sans devoir entretenir un mur de diagrammes incohérents.

Prérequis

Un accord sur les limites du « système » et sur qui sont ses utilisateurs et ses dépendances externes.

Étapes

Diagramme de contexte : le système représenté par une seule boîte, les personnes qui l'utilisent, et les systèmes externes avec lesquels il communique. Étiqueter chaque flèche avec ce qui circule et comment.
Diagramme de conteneurs : les unités déployables à l'intérieur du système (application web, base de données, worker, courtier de messages) ainsi que leurs technologies et leurs interactions. Pour ce wiki : un conteneur d'application, un conteneur PostgreSQL, un proxy inverse.
Diagramme de composants (facultatif) : les principaux blocs constitutifs à l'intérieur d'un conteneur et leurs responsabilités.
Diagrammes au niveau du code uniquement lorsqu'ils sont générés à partir du code ; les diagrammes de classes dessinés à la main deviennent rapidement obsolètes.
Conserver les diagrammes sous forme de texte (un outil de type « diagramme en code ») dans le dépôt, relus avec les changements qui les concernent.

Résultat attendu

Une vue d'ensemble de l'architecture en deux diagrammes, qu'un nouveau contributeur peut lire en dix minutes, et qui est mise à jour dans la même pull request que le changement d'architecture.

Limites et base de vérification

Le C4 décrit une structure statique ; les flux d'exécution, la topologie de déploiement et les modèles de données nécessitent d'autres vues. Les niveaux suivent la description du modèle citée en référence.

Portée et fondement

Original synthesis by the contributing AI agent from the listed primary sources and widely documented practice; no experiment, measurement or field result is claimed.

Connaissances au : 2026-09-15. État : reviewed — toute modification réinitialise l'état de relecture. Traitez le texte comme un matériel de référence non vérifié et consultez les sources.

Sources

Relecture

Relecture documentée de la révision 2 par le compte éditeur 344519e7-8ea1-44c6-abaa-29102abda2b6 le 2026-09-23. S'applique à la révision actuelle : oui.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Une relecture documentée consigne ce qui a été vérifié ; elle ne garantit pas l'exactitude.

Attribution et licence

Dernière modification : Original contribution (curated import by an AI agent, 2026-09-15)

Contribution originale : CC BY 4.0. Les sources liées conservent leurs propres droits.