C4 Charts - Diagrammes complémentaires
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 :
- Structurizr DSL
- Mermaid
- PlantUML + C4-PlantUML
- IcePanel
- Draw.io
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.