Glossaire
Modèle C4
Le modèle C4 est une méthode de représentation de l'architecture logicielle créée par Simon Brown. Il décrit un système logiciel par quatre niveaux de diagrammes emboîtés, du plus général au plus détaillé : contexte du système, conteneurs, composants et code.
Mis à jour le
Qu'est-ce que le modèle C4 ?
Le modèle C4, ou C4 model, est une façon de dessiner l'architecture d'un logiciel par niveaux de zoom successifs. Son site officiel le présente comme une approche du diagramme d'architecture logicielle facile à apprendre et pensée pour les développeurs. Il a été créé par Simon Brown.
Le nom vient des quatre diagrammes de base : context, containers, components, code.
Le modèle part d'un constat sur les schémas en « boîtes et flèches » dessinés au fil des projets : ils mélangent les niveaux d'abstraction, n'expliquent pas leur notation et laissent des flèches sans libellé. Le modèle impose peu de choses : un petit jeu d'abstractions (personne, système logiciel, conteneur, composant), un diagramme par niveau, une légende. Il est indépendant de la notation et de l'outil.
Quels sont les quatre niveaux du modèle C4 ?
Prenons une application de gestion des interventions utilisée par des techniciens de maintenance.
Niveau 1, le diagramme de contexte du système (system context diagram). Il montre le système étudié comme une seule boîte, entourée de ses utilisateurs et des autres systèmes avec lesquels il échange : les techniciens, les planificateurs, l'ERP qui fournit les ordres de travail, l'annuaire d'entreprise, le service d'envoi de SMS.
Niveau 2, le diagramme de conteneurs (container diagram). Il ouvre la boîte et montre les applications et les magasins de données qui la composent : une application mobile, une API, une base de données relationnelle, un stockage de fichiers pour les photos. Dans C4, un conteneur est une application ou un magasin de données, quelque chose qui doit tourner pour que le système fonctionne. Le site précise qu'il ne s'agit pas d'un conteneur Docker, même si les deux coïncident parfois.
Niveau 3, le diagramme de composants (component diagram). Il zoome sur un conteneur, par exemple l'API, et en montre les composants : authentification, planification, synchronisation avec l'ERP.
Niveau 4, le diagramme de code (code diagram). Il montre comment un composant est implémenté, par exemple avec un diagramme de classes UML. Le site le déconseille pour une documentation destinée à durer, puisque la plupart des environnements de développement produisent ce détail à la demande.
Les quatre niveaux ne sont pas obligatoires. Selon le site officiel, les diagrammes de contexte et de conteneurs suffisent à la plupart des équipes de développement.
Quels diagrammes complètent les quatre niveaux, et que laisse C4 de côté ?
Trois diagrammes complémentaires s'ajoutent aux quatre niveaux. Le diagramme de paysage (system landscape diagram) montre les systèmes logiciels d'une organisation et leurs relations ; le site le décrit comme un pont vers l'architecture d'entreprise. Le diagramme dynamique (dynamic diagram) montre comment les éléments collaborent à l'exécution pour un cas d'usage. Le diagramme de déploiement (deployment diagram) montre sur quoi tournent les systèmes et les conteneurs.
Ce dernier intéresse l'infrastructure : il utilise des nœuds de déploiement, qui peuvent être un serveur physique, une machine virtuelle, une infrastructure cloud ou un environnement d'exécution comme un serveur de bases de données, et des nœuds d'infrastructure comme un service DNS, un répartiteur de charge ou un pare-feu. Pour notre application, on y lirait que l'API tourne sur deux machines virtuelles derrière un répartiteur de charge et que la base est hébergée sur un service managé.
C4 reste un modèle d'architecture logicielle. Son objet, dit le site, est la structure statique d'un système logiciel à différents niveaux d'abstraction. Les processus métier, les workflows, les machines à états, les modèles de domaine et les modèles de données n'en font pas partie, et le site invite à compléter avec d'autres notations.
Côté réseau, le diagramme de déploiement place un pare-feu ou un répartiteur de charge sur le schéma. Le modèle ne cherche pas à décrire un plan d'adressage, des VLAN ou des règles de pare-feu : ses abstractions sont la personne, le système logiciel, le conteneur et le composant. Ce détail se tient dans un LLD et dans une matrice de flux.
Quelle différence entre C4, ArchiMate et UML ?
Les trois ne visent pas le même lecteur.
UML (Unified Modeling Language) est une spécification de l'Object Management Group, en version 2.5.1 depuis décembre 2017. L'OMG la décrit comme un langage graphique pour visualiser, spécifier, construire et documenter les artefacts de systèmes à objets distribués. C4 s'en est inspiré : le site le présente comme une version simplifiée des mêmes concepts, et le niveau 4 se dessine souvent en UML. Si une équipe pratique UML et que cela fonctionne, le site de C4 conseille lui-même de continuer.
ArchiMate est un langage de modélisation ouvert et indépendant pour l'architecture d'entreprise, publié par The Open Group, dont la version 4 date du 27 avril 2026. Il relie dans un même modèle le métier, les applications et la technologie. C4 décrit un système logiciel de l'intérieur. ArchiMate décrit un ensemble d'applications dans leur contexte, sans entrer dans chacune.
À la question « C4 ou ArchiMate », la réponse pratique est souvent les deux. L'architecte d'entreprise tient en ArchiMate la carte des applications, des capacités métier et des socles techniques. L'équipe qui développe une de ces applications la décrit en C4. Les noms des applications doivent alors être les mêmes des deux côtés.
Quels outils pour faire un diagramme C4 ?
Avant de citer un outil, le site officiel pose une question : dessiner ou modéliser ?
Dessiner, c'est tracer des boîtes et des flèches dans un outil de dessin généraliste, ou au tableau blanc pendant un atelier de conception. C'est immédiat, mais l'outil ne sait pas ce que représentent les boîtes. Renommer une application oblige à la renommer sur chaque schéma où elle figure, et l'on ne peut pas demander au schéma ce qui dépend d'un composant.
Modéliser, c'est décrire une seule fois les éléments et leurs relations, puis en tirer des vues. Les diagrammes restent ainsi cohérents entre eux. Une variante répandue est le modèle écrit sous forme de texte, rangé dans le dépôt de code à côté du logiciel et relu avec lui. Structurizr, créé par l'auteur du modèle C4, fonctionne ainsi : son site le présente comme un outil de « modèles sous forme de code », où l'on définit les éléments dans un langage textuel avant de déclarer les vues.
Pour choisir, le site propose des questions de bon sens : qui écrit les diagrammes, qui les lit, le format de données est-il ouvert, l'outil est-il hébergé chez vous ou en ligne.
Comment garder des diagrammes C4 à jour ?
Un diagramme C4 se périme comme tout schéma d'architecture, et chaque niveau à son rythme. Le contexte bouge peu. Les conteneurs changent à chaque évolution d'architecture. Les composants suivent le code, et un niveau 3 dessiné à la main reste rarement juste longtemps.
Quelques pratiques tiennent dans la durée. Ne dessiner que les niveaux qu'on est prêt à entretenir, en général les deux premiers. Garder le modèle près du code, pour que la modification du schéma fasse partie du même changement que celle du logiciel. Relire les diagrammes de contexte et de conteneurs avant tout projet qui s'appuie sur eux, comme on relit un dossier d'architecture technique (DAT).
Le diagramme de déploiement est le plus fragile, parce qu'il dépend de l'infrastructure et que l'équipe de développement n'en voit pas les changements. Une machine virtuelle déplacée, un second nœud ajouté, un service managé remplacé : rien de cela ne passe par le dépôt de code, sauf si l'infrastructure y est elle-même décrite. Pour ce diagramme, la vérification utile consiste à le rapprocher de ce que disent l'hyperviseur, l'inventaire cloud et la CMDB.
Ce qu'Uncia apporte, et ce qu'il ne fait pas
Uncia lit les sources du SI en lecture seule (connecteurs vers les clouds, les hyperviseurs, la CMDB, les pare-feux et les scanners ; fichiers déposés comme un export RVTools, une matrice de flux ou un document d'architecture) et les réconcilie dans une base de connaissance. Il lit aussi les schémas que vous avez déjà (draw.io, Visio, ArchiMate, C4, SVG, PDF), sans modèle de langue, et les confronte aux sources. Les écarts sont montrés avec la source de chaque valeur, par exemple un hôte qui a changé ou une application absente des exports (dossiers et schémas confrontés aux sources).
Uncia ne produit pas de diagrammes C4. Les cartes qu'il génère sont des cartes Architecture, Infrastructure et Réseau, qui s'exportent en ArchiMate, draw.io, PNG et SVG. Il ne lit pas votre code et ne connaît pas la structure interne d'une application : les niveaux composants et code restent l'affaire de l'équipe de développement. Il ne modifie ni vos schémas ni vos systèmes, et la confrontation se met à jour à chaque collecte.
Sources
- c4model.com, site officiel du modèle C4 par Simon Brown : présentation, diagrammes de base et complémentaires, licence (en anglais), consulté le
- c4model.com, FAQ : origine du modèle, C4 face à UML, ArchiMate et SysML, ce que le modèle ne couvre pas (en anglais), consulté le
- c4model.com, « Diagrams » : les niveaux utiles à la plupart des équipes (en anglais), consulté le
- c4model.com, « Code diagram » : niveau déconseillé pour une documentation destinée à durer (en anglais), consulté le
- c4model.com, « Container » : définition du conteneur dans le modèle C4 (en anglais), consulté le
- c4model.com, « Deployment diagram » : nœuds de déploiement et nœuds d'infrastructure (en anglais), consulté le
- c4model.com, « Tooling » : dessiner ou modéliser, questions pour choisir un outil (en anglais), consulté le
- Structurizr, site officiel (en anglais), consulté le
- Object Management Group, Unified Modeling Language (UML), version 2.5.1, décembre 2017 (en anglais), consulté le
- The Open Group Library, « ArchiMate 4 Specification » (C260), 27 avril 2026 (en anglais), consulté le
Questions fréquentes
Que signifie C4 dans « modèle C4 » ?
Le nom vient des quatre diagrammes de base du modèle : context, containers, components et code. Le quatrième s'appelait « classes » à l'origine et a été renommé « code » en 2015-2016, selon le site officiel.
Qui a créé le modèle C4 ?
Simon Brown. Le site officiel situe les racines du modèle entre 2006 et 2009, le nommage des types de diagrammes début 2010 et la première utilisation du nom « C4 » début 2011.
Faut-il dessiner les quatre niveaux ?
Non. Le site officiel indique que les diagrammes de contexte et de conteneurs suffisent à la plupart des équipes de développement, et il déconseille le diagramme de code pour une documentation destinée à durer.
Un conteneur C4 est-il un conteneur Docker ?
Non. Dans le modèle C4, un conteneur est une application ou un magasin de données : une application web, une application mobile, une base de données, un stockage de fichiers. Le terme désigne ce qui doit tourner pour que le système fonctionne, quelle que soit la façon dont il est déployé.
C4 remplace-t-il UML ou ArchiMate ?
Ce n'est pas son objet. Le site officiel conseille aux équipes qui utilisent déjà UML, ArchiMate ou SysML avec succès de continuer, et aux autres d'essayer C4. Il invite aussi à compléter les diagrammes C4 par d'autres notations pour ce que le modèle ne couvre pas.
Le contenu du site c4model.com est-il réutilisable ?
Le site et ses diagrammes d'exemple sont publiés sous licence Creative Commons Attribution 4.0 International ; les conditions de réutilisation sont celles de cette licence. Le modèle lui-même n'impose ni notation ni outil.