Vue de l'architecture de solution (Archimate/TOGAF) avec un assistant LLM

🎯 Objectif

Générez un diagramme d'architecture de solution (selon la spécification Archimate) en utilisant le langage PlantUML, avec l'aide d'un assistant basé sur LLM (comme ChatGPT, Claude, Gemini, etc.), et visualisez-le à l'aide d'un éditeur PlantUML.

Ma recommandation: AI Studio (Google)

🛠️ 1️⃣ Préparation

✅ Connaître le périmètre et le contexte architectural
Définir ce que le diagramme d'architecture doit représenter (par exemple, les services commerciaux de haut niveau, les couches d'application, les composants technologiques).
Exemples :

• Un nouveau déploiement de microservices
• Un pipeline de données
• Intégration avec des systèmes externes

✅ Identifiez les éléments clés que vous souhaitez dans le diagramme :

• Acteurs commerciaux, Rôles, Processus, Services
• Composants d'application, Services, Interfaces
• Nœuds technologiques, Dispositifs, Logiciels systèmes
• Flux, relations, dépendances

✅ Choisissez une vue du diagramme:

• Vue d'affaires
• Vue de l'application
• Vue technologique
• Ou une vue combinée en couches

📝 2️⃣ Formulez votre demande à l'assistant LLM.

💡 Modèle d'exemple d'invite :

Consigne :
« Je souhaite créer un diagramme d'architecture de solution suivant la spécification Archimate.

• Voici le périmètre : [brève description de ce que cela représente].

• Éléments à inclure : [lister les composants clés, les rôles, les relations].

• Produisez-le en langage PlantUML, en utilisant les notations Archimate.

• Assurez-vous que le diagramme PlantUML est complet et prêt à être visualisé dans un éditeur PlantUML.»

Vous pouvez également demander de l'aide pour commencer en partageant le contexte général de la solution. Toute suggestion de base serait un excellent point de départ.

📥 3️⃣ Obtenez le code PlantUML.

🟩 Le LLM générera généralement un bloc de code contenant le script PlantUML.
Exemple de snippet qu'il pourrait fournir :

@startuml
skinparam rectangle<<behavior>> {
	roundCorner 25
}
sprite $bProcess jar:archimate/business-process
sprite $aService jar:archimate/application-service
sprite $aComponent jar:archimate/application-component

rectangle "Gérer la réclamation"  as HC <<$bProcess>><<behavior>> #Business
rectangle "Capturer les informations"  as CI <<$bProcess>><<behavior>> #Business
rectangle "Notifier\nles parties prenantes supplémentaires" as NAS <<$bProcess>><<behavior>> #Business
rectangle "Valider" as V <<$bProcess>><<behavior>> #Business
rectangle "Enquêter" as I <<$bProcess>><<behavior>> #Business
rectangle "Payer" as P <<$bProcess>><<behavior>> #Business

HC *-down- CI
HC *-down- NAS
HC *-down- V
HC *-down- I
HC *-down- P

CI -right->> NAS
NAS -right->> V
V -right->> I
I -right->> P

rectangle "Numérisation" as scanning <<$aService>><<behavior>> #Application
rectangle "Administration client" as customerAdministration <<$aService>><<behavior>> #Application
rectangle "Administration des réclamations" as claimsAdministration <<$aService>><<behavior>> #Application
rectangle Impression <<$aService>><<behavior>> #Application
rectangle Paiement <<$aService>><<behavior>> #Application

scanning -up-> CI
customerAdministration  -up-> CI
claimsAdministration -up-> NAS
claimsAdministration -up-> V
claimsAdministration -up-> I
Paiement -up-> P

Impression -up-> V
Impression -up-> P

rectangle "Système\nde\nGestion\nde Documents" as DMS <<$aComponent>> #Application
rectangle "Système\nde GRC\nGénéral" as CRM <<$aComponent>>  #Application
rectangle "Administration\nde la politique\nHome & Away" as HAPA <<$aComponent>> #Application
rectangle "Administration\nfinancière\nHome & Away" as HFPA <<$aComponent>>  #Application

DMS .up.|> scanning
DMS .up.|> Impression
CRM .up.|> customerAdministration
HAPA .up.|> claimsAdministration
HFPA .up.|> Paiement

legend left
Exemple de l'étude de cas "Archisurance" (OpenGroup).
Voir
====
<$bProcess> : processus d'affaires
====
<$aService> : service d'application
====
<$aComponent> : composant d'application
endlegend
@enduml

🎨 4️⃣ Visualisez le schéma.

🔧 Choisissez un éditeur PlantUML :

• Éditeur en direct PlantUML
• PlantText
• Extension Visual Studio Code (plugin PlantUML)
• Plugin PlantUML pour IntelliJ IDEA
• Configuration locale avec Java et Graphviz

🔗 Étapes de rendu :

1. Copiez l'intégralité du code PlantUML fourni par le LLM.
2. Collez-le dans l'éditeur choisi.
3. Cliquez sur « Actualiser » / « Générer » / « Aperçu » pour rendre le diagramme.

🧰 5️⃣ Valider et affiner

✅ Vérifiez si le schéma représente fidèlement l'architecture que vous avez en tête.
✅ Si nécessaire, affinez l'invite :

• « Pouvez-vous ajouter des relations entre le composant X et le composant Y ? »
• « Veuillez inclure plus de détails concernant les flux de données ou les interfaces. »
• « Utilisez les points de vue Archimate appropriés pour une meilleure clarté. »

Vous pouvez itérer avec le LLM pour améliorer la fidélité du schéma.

🪄 6️⃣ Astuces pour de meilleurs résultats

🌟 Soyez explicite concernant les relations et les points de vue (par exemple, « Montrez-moi une vue en couches séparant les couches métier, application et technologie »).
🌟 Demandez de la documentation ou des étiquettes si la clarté est essentielle (par exemple, « Ajoutez des descriptions aux composants pour expliquer leurs rôles »).
🌟 Utilisez des points ou des tableaux dans l'invite pour organiser les détails pour une meilleure compréhension par le LLM.
🌟 Conservez les scripts PlantUML pour le contrôle de version et la documentation.

🎉 Résultat

En suivant ce livre de recettes, vous obtiendrez :
✅ Une consigne claire pour le LLM.
✅ Un diagramme Archimate prêt pour PlantUML.
✅ Des rendus visuels de votre architecture.
✅ Un processus que vous pouvez répéter pour d'autres besoins en architecture.