Des boîtes et des flèches sans légende : le défaut visé
Un schéma d’architecture tracé librement, fait de boîtes et de flèches, peut laisser son lecteur sans réponse. Que représente chaque boîte ? Que signifie chaque trait ? À quel niveau de détail se situe-t-on ? Le C4 model répond par un petit nombre de conventions. Son site officiel, c4model.com, rédigé par son créateur Simon Brown, part de ces défauts : notation non expliquée, relations sans libellé, niveaux d’abstraction mélangés.
Il compare les schémas obtenus à des cartes du code, à parcourir en changeant de niveau de zoom.
Définition du C4 model
Le C4 model, que l’on traduit par modèle C4, est présenté par ce site comme une approche de la représentation de l’architecture logicielle, facile à apprendre et pensée pour les développeurs. Il réunit des abstractions hiérarchisées, des diagrammes de même hiérarchie et des diagrammes complémentaires. Son nom vient des quatre diagrammes de structure, dont l’intitulé anglais commence par la lettre C.
D’après la foire aux questions du site, les racines du modèle remontent aux alentours de 2006 à 2009, sans date exacte, et le nom « C4 » apparaît au début de 2011. Les pages citées dans cette fiche ont été consultées le 12 novembre 2026.
Les quatre niveaux et les diagrammes complémentaires
Les termes d’origine sont conservés ; les traductions et les gloses sont des propositions de cette fiche.
| Niveau (terme d’origine) | Traduction proposée | Ce que montre le diagramme, selon le site |
|---|---|---|
| System context | Contexte du système | Le système étudié, ses utilisateurs et les systèmes auxquels il est relié |
| Container | Conteneur | Les applications et les magasins de données du système, leurs technologies et leurs échanges |
| Component | Composant | Les composants d’un conteneur, chacun regroupant des fonctions derrière une interface |
| Code | Code | La réalisation d’un composant : classes, interfaces, fonctions |
Le site ne demande pas de tracer les quatre niveaux : il recommande les deux premiers à toutes les équipes de développement et tient le diagramme de code pour facultatif.
Trois diagrammes complètent l’ensemble : system landscape (paysage des systèmes d’une organisation), dynamic (collaboration des éléments à l’exécution) et deployment (déploiement dans un environnement donné).
C4 model, conteneur Docker, UML, architecture d’entreprise : ne pas confondre
Le conteneur du modèle n’est pas un conteneur Docker, et le site y insiste. Le mot désigne une application ou un magasin de données : ce qui doit s’exécuter pour que le système fonctionne.
Le C4 model n’est pas non plus une notation : le site le dit indépendant de toute notation, s’en tient à des recommandations (un titre, une légende, un type et une description pour chaque élément, des relations libellées) et admet que les diagrammes soient tracés en UML.
Il ne couvre pas le champ de l’architecture d’entreprise, de l’urbanisation du SI ou d’un cadre comme TOGAF. Son objet, selon le site, est la structure statique d’un système logiciel : les processus métier, les modèles de données ou les machines à états se décrivent par d’autres diagrammes. Le diagramme de paysage y est présenté comme une passerelle vers l’architecture d’entreprise.
Un cas d’usage : la prise de rendez-vous de centres de santé
Imaginons un réseau de centres de santé dont l’application de prise de rendez-vous doit être décrite à une nouvelle équipe. Le diagramme de contexte place le système au centre, entouré des patients, des secrétariats, du service d’envoi de messages et du logiciel de dossier patient. Le diagramme de conteneurs ouvre la boîte : une application mobile, une application web, une interface de programmation et une base de données, avec la technologie de chacune et le protocole de leurs échanges. Un diagramme de composants n’est tracé que pour l’interface de programmation, qui porte les règles de réservation.
Le site reconnaît des limites au modèle : conçu pour des logiciels développés sur mesure, il convient moins aux systèmes embarqués et aux solutions qui reposent sur un paramétrage lourd plutôt que sur du développement spécifique.
Ces schémas trouvent leur place dans le dossier d’architecture d’un projet, aux côtés des cartographies qui décrivent le système d’information entier : notre page architecture SI présente les deux.