C4 Charts - Diagrammes complémentaires

Rappel

Les C4 Charts (ou plus exactement diagrammes C4) sont une méthode de documentation d'architecture logicielle créée par Simon Brown. Le but est de décrire un système en utilisant plusieurs niveaux de zoom, un peu comme Google Maps : on commence par la vue globale puis on entre progressivement dans les détails.

Voir C4 Model pour l'explication des 4 niveaux.

Diagrammes complémentaires

Le modèle C4 ajoute également :

System Landscape

Vue de l'écosystème global :

Shopify
OneStock
Salesforce
Databricks
Cegid Y2
PIM
WMS

Très utile pour une cartographie SI.

Dynamic Diagram

Montre un scénario :

Client
  |
  v
Shopify
  |
  v
Logic Apps
  |
  v
OneStock
  |
  v
Databricks

En précisant l'ordre des appels.

Deployment Diagram

Montre où sont déployés les composants :

Azure Subscription

 ├─ App Service
 ├─ Logic Apps
 ├─ Databricks
 ├─ Azure SQL
 └─ Key Vault

Exemple de structure documentaire idéale

Pour chaque projet :

01-Context.md
02-Container.md
03-Components.md
04-Dynamic-Flows.md
05-Deployment.md

Avec des diagrammes générés via :

Pour l'approche Docs-as-Code / Markdown, on préfère Structurizr DSL ou C4-PlantUML, qui s'intègrent très bien dans Azure DevOps, Git et Confluence.