Genz ©Created by JThemes.com
Dans le monde rapide du développement logiciel, une bonne architecture peut faire toute la différence entre le succès ou l’échec d’une initiative logicielle. Alors que les organisations doivent faire face à des exigences changeantes, à une variété de parties prenantes et à des technologies de pointe, maîtriser une série de techniques devient crucial pour les architectes logiciels.
Voici une synthèse des approches et outils essentiels à connaître pour concevoir des systèmes modernes, aligner la technique sur la stratégie d’entreprise, prendre de bonnes décisions et collaborer efficacement.
Planification stratégique & prise de décision
- Impact Mapping : Une technique collaborative qui aligne visuellement les efforts d’une organisation avec des objectifs mesurables.
- Wardley Mapping : Outil visuel pour cartographier la chaîne de valeur d’un produit/service et identifier les opportunités d’investissement ou de rationalisation.
Alignement des équipes & structuration du domaine
- Domain Storytelling : Représentation narrative et visuelle des processus métiers pour assurer une compréhension partagée.
- Event Storming : Modélisation collaborative des événements, commandes et règles dans un domaine métier.
- Langage ubiquitaire : Vocabulaire commun entre tous les intervenants du projet, technique ou non.
- Architecture Inception Canvas : Cadre pour poser les bases d’une architecture logicielle (contexte, objectifs, contraintes).
- Modèle de qualité arc42 (Q42) : Méthode pragmatique pour identifier et prioriser les exigences non fonctionnelles.
- Event Modeling : Représentation visuelle du système à travers les événements et leurs effets sur les données.
- Context Mapping : Cartographie des interactions entre différents contextes délimités dans un système.
- Bounded Context Canvas : Outil pour définir les limites fonctionnelles et techniques d’un sous-système.
- Prototypage de domaine : Création rapide d’un prototype pour tester et valider des concepts avant le développement.
Prise de décision architecturale
- Principes d’architecture : Ensemble de règles et valeurs qui guident les choix techniques et facilitent l’alignement avec les objectifs.
- Architecture Decision Records (ADR) : Fiches courtes qui documentent les décisions prises, leur contexte et leur justification.
Gestion technologique
- Tech Stack Canvas : Visualisation de l’ensemble des technologies utilisées dans le produit.
- Technology Radar : Cartographie des technologies selon leur maturité (Adopt, Trial, Assess, Hold), pour orienter les choix stratégiques.
Gestion des risques
- Risk Storming : Atelier collaboratif pour identifier les risques techniques et métiers autour d’un système.
- Technical Debt Records : Documentation des dettes techniques pour assurer leur suivi et leur résolution future.
- Threat Modeling : Modélisation des menaces pour identifier les failles de sécurité potentielles dans un système.
Visualisation & documentation
- Architecture Communication Canvas : Structure pour présenter clairement les choix et composants d’une architecture.
- C4 Model : Méthode visuelle pour représenter l’architecture selon 4 niveaux (Contexte, Conteneurs, Composants, Code).
- Template arc42 : Modèle de documentation structurée de l’architecture, organisé en 12 sections.
- Documentation as Code : Traitement de la documentation comme du code : versionnée, en texte brut, gérée avec Git.
Évaluation, mesure et amélioration
- DORA Metrics : Indicateurs de performance DevOps : fréquence de déploiement, temps de réparation, taux d’échec, etc.
- LASR : Revue d’architecture légère et rapide, orientée objectifs, alternative à ATAM.
- aim42 : Méthode pour améliorer les architectures existantes de manière structurée.
- Théorie de la résidualité : Cadre pour comprendre la stabilité et l’évolutivité différentes parties d’un système.
À noter : la liste n’est pas exhaustive ! Si des techniques importantes manquent, n’hésitez pas à le signaler.
Planification stratégique & prise de décision
💡 Impact Mapping
Impact Mapping est un outil de stratégie collaboratif qui aligne visuellement les efforts d’une organisation sur des objectifs mesurables afin d’avoir un impact réel et de réussir efficacement.
Il s’agit d’une technique de planification stratégique qui aide les organisations à identifier et à prioriser les actions selon leur impact potentiel sur un objectif donné.
Tous les acteurs concernés collaborent pour définir les objectifs, les parties prenantes pouvant influencer les résultats, les impacts qui contribuent aux objectifs, et les livrables pouvant produire ces impacts.
Cette feuille de route visuelle permet d’aligner les équipes et les ressources sur des résultats concrets, en s’assurant que l’effort est concentré sur ce qui génère de la valeur.
💡 Wardley Mapping
Wardley Mapping est un outil stratégique visuel développé par Simon Wardley qui aide à visualiser la chaîne de valeur d’un produit ou d’un service.
Il représente les composants comme une chaîne de besoins et les positionne selon leur niveau de maturité (de produit sur-mesure à commodité standardisée).
Cette approche aide les entreprises à repérer les inefficacités, à anticiper les tendances du secteur et à mieux orienter leurs investissements pour innover et prendre de meilleures décisions.
https://blog.stackademic.com/the-art-of-strategy-811c00a96fad
Concept initial, alignement des équipes & structuration
💡 Domain Storytelling
Domain Storytelling est une technique narrative utilisée pour capturer et communiquer les processus métiers de manière claire pour toutes les parties prenantes.
Les utilisateurs et experts métier racontent des histoires sur leur travail, et ces histoires sont représentées visuellement à l’aide d’un langage simple et de pictogrammes.
Cette approche favorise une compréhension partagée du domaine et aligne les équipes techniques et non techniques sur les besoins métiers.
💡 Event Storming
Event Storming est une technique de modélisation visuelle collaborative utilisée pour explorer des domaines métier complexes.
Elle consiste à identifier et discuter des événements (actions métier significatives), des commandes (actions déclenchées) et des règles (politiques métier), à l’aide de post-its de couleurs différentes.
Event Storming permet de clarifier les processus, de repérer les zones d’ombre, et de co-concevoir un modèle métier efficace.
💡 Langage ubiquitaire (Ubiquitous Language)
Le langage ubiquitaire est un vocabulaire partagé entre les développeurs, les experts métier et les autres parties prenantes, utilisé dans toute la documentation, le code et les discussions.
Il assure une communication claire et évite les malentendus, en alignant les concepts métiers avec leur implémentation technique.
💡 Architecture Inception Canvas
Le Architecture Inception Canvas est un outil visuel pour cadrer le périmètre initial d’une architecture.
Il capture les moteurs métiers, les contraintes, les objectifs, les parties prenantes, les choix technologiques envisagés, les risques, etc.
Il permet de poser une base claire et partagée pour les premières décisions architecturales.
https://canvas.arc42.org/architecture-inception-canvas
💡 Carte d’Architecture Frontend
La Carte d’Architecture Frontend est une approche centrée sur l’utilisateur, axée sur l’alignement du développement frontend avec les besoins réels des utilisateurs plutôt qu’avec les tendances actuelles.
Cette approche se concentre sur la compréhension approfondie des interactions des utilisateurs afin de concevoir une architecture capable de soutenir efficacement ces parcours. La carte aide les équipes à identifier les technologies et les pratiques les plus appropriées tout en évitant les choix dictés par la mode. L’objectif est de créer une architecture frontend mieux adaptée, centrée avant tout sur les besoins réels des utilisateurs.
https://miro.com/miroverse/frontend-architecture-map
https://github.com/bitsmuggler/frontend-architecture-map?ref=workingsoftware.dev
💡 Modèle de qualité arc42
arc42 Quality Model est un cadre simple et pratique pour évaluer et documenter la qualité d’un système ou d’un produit logiciel.
Il couvre des critères comme la performance, la sécurité, la maintenabilité, la robustesse, etc., et permet d’identifier les priorités qualité dès le départ.
💡 Quality Storming
Le Quality Storming est un atelier visant à identifier les exigences de qualité à partir d’un modèle de référence tel que la norme ISO 25010.
Cette méthode repose sur des techniques et des idées issues de la modélisation collaborative (« Collaborative Modeling »), une approche largement répandue dans la communauté du Domain-Driven Design. Un aspect essentiel du Quality Storming est la collaboration active entre les différentes parties prenantes et les départements concernés.
💡 Event Modeling
Event Modeling est une technique visuelle pour concevoir et comprendre les architectures système à travers des événements et des états.
Elle met en avant la chronologie des événements, les interactions utilisateur et les changements de données, ce qui aide à concevoir des systèmes alignés sur le comportement métier.
https://eventmodeling.org/posts/what-is-event-modeling
💡 Context Mapping
Context Mapping est une technique utilisée pour identifier et décrire les interactions entre les bounded contexts (contextes délimités) et les équipes.
Elle met en lumière les relations (coopération, dépendance, antécédents historiques) entre les différentes parties d’un système, et aide à structurer les responsabilités.
💡 Bounded Context Canvas
Le Bounded Context Canvas est un outil qui aide les architectes à définir les limites dans lesquelles un modèle de domaine spécifique s’applique.
Il inclut les rôles, les termes clés, les objectifs, les interactions avec d’autres contextes, et la façon dont la solution y est intégrée.
https://github.com/ddd-crew/bounded-context-canvas
💡 Prototypage de Domaine (Domain Prototyping)
Le prototypage de domaine est une technique qui consiste à créer une version préliminaire d’un système ou d’un module logiciel afin d’explorer et valider des concepts spécifiques à un domaine donné.
Cette approche aide les développeurs et les parties prenantes à mieux comprendre les exigences, les fonctionnalités et les problèmes potentiels du système, en leur offrant une vision concrète avant le début du développement complet.
Elle est particulièrement utile dans les systèmes complexes où la connaissance du domaine est très élaborée, car elle permet un retour d’information itératif et des ajustements progressifs qui garantissent que le produit final répond mieux aux besoins et aux attentes des utilisateurs.
Prise de décision
💡 Principes d’architecture
Les principes d’architecture sont un ensemble de règles ou de lignes directrices que les architectes définissent pour guider les décisions techniques.
Ils permettent d’assurer une cohérence dans les choix d’architecture, d’aligner les décisions sur les objectifs métiers, et de faciliter la communication avec les parties prenantes.
Ces principes peuvent inclure : “favoriser l’évolutivité”, “minimiser le couplage”, ou encore “prioriser la simplicité”.
💡 Architecture Decision Records (ADR)
Les Architecture Decision Records (ADR) sont de courts documents qui capturent les décisions architecturales importantes, avec leur contexte, les options envisagées, et la justification de la décision finale.
Ils rendent les décisions traçables, transparentes, et faciles à remettre en question ou à réviser dans le futur.
https://github.com/npryce/adr-tools
💡 Markdown Architecture Decision Records (MADR)
MADR est un format léger en Markdown pour écrire des ADRs de manière simple et standardisée.
Il facilite la documentation des décisions directement dans les dépôts de code, en versionnant les choix au même rythme que le développement logiciel.
Gestion de la technologie
💡 Tech Stack Canvas
Le Tech Stack Canvas est un outil visuel qui permet de documenter et de planifier l’ensemble des technologies utilisées dans un projet.
Il aide à structurer les couches techniques (frontend, backend, base de données, CI/CD, monitoring, etc.), à identifier les dépendances et à discuter des choix technologiques avec les équipes.
C’est aussi un bon support pour onboarder de nouveaux développeurs ou faire des revues techniques.
💡 Technology Radar
Le Technology Radar est une méthode utilisée pour cartographier et suivre les technologies internes (ou envisagées) d’une organisation.
Les technos sont classées par niveau de maturité : Adopt, Trial, Assess, Hold.
Cela aide à guider les choix technologiques, éviter la dispersion, partager les retours d’expérience, et détecter les tendances émergentes.
Gestion des risques
💡 Risk Storming
Risk Storming est une technique collaborative qui permet d’identifier, de discuter et de documenter les risques potentiels dans un système logiciel.
Elle implique l’équipe entière (architectes, développeurs, PO, sécurité…) et s’appuie souvent sur le modèle C4 pour visualiser les composants.
Les risques sont classés par gravité, fréquence, ou impact, puis des stratégies d’atténuation sont définies.
💡 Technical Debt Records
Les Technical Debt Records (TDR) sont des documents qui suivent les dettes techniques identifiées dans un projet.
Chaque TDR précise la dette, son origine, son impact, la priorité de résolution, et les conditions de remboursement.
Cela permet de ne pas perdre de vue les compromis techniques faits dans l’urgence, et d’y revenir de manière structurée.
https://github.com/ms1963/TechnicalDebtRecords
💡 Threat Modeling
Le Threat Modeling (modélisation des menaces) est un processus permettant d’identifier les vulnérabilités de sécurité dans un système.
Il repose sur la compréhension de ce que fait le système, de qui peut l’attaquer, de ce qui pourrait être visé, et des conséquences d’une exploitation.
Des méthodes comme STRIDE ou PASTA peuvent être utilisées pour structurer l’analyse.
Visualisation & documentation
💡 Architecture Communication Canvas
Le Architecture Communication Canvas est un outil qui aide les architectes à structurer les informations clés à communiquer autour d’une architecture.
Il inclut : objectifs business, parties prenantes, décisions clés, contraintes, risques, vues d’architecture, etc.
C’est un support utile pour faciliter les échanges clairs avec les différentes audiences : développeurs, décideurs, ou non-techniques.
💡 Modèle C4
Le modèle C4 est une méthode pour visualiser l’architecture logicielle à différents niveaux de détail :
- Contexte : vue globale du système dans son environnement.
- Conteneurs : composants majeurs du système (ex : backend, mobile, base de données…).
- Composants : sous-systèmes ou services internes.
- Code : structure détaillée des classes ou modules.
C’est un langage visuel standardisé, simple à lire, qui aide à partager une compréhension commune de l’architecture.
💡 Template arc42
Le template arc42 est un modèle de documentation architecturale complet, structuré en plusieurs sections : motivation, qualité, décisions, contexte, composants, déploiement, etc.
Il permet de documenter l’architecture d’un système de manière systématique, tout en restant adaptable selon les besoins.
💡 Documentation as Code
Documentation as Code consiste à traiter la documentation technique comme du code source : dans un dépôt Git, en texte brut (Markdown, AsciiDoc), versionnée, revue par pull request, etc.
Cette approche rend la doc vivante, à jour, proche du code, et intégrée au cycle de développement.
Évaluation, amélioration et adaptation
💡 DORA Metrics
Les DORA Metrics (de Google’s DevOps Research and Assessment) mesurent la performance des équipes de développement sur quatre indicateurs clés :
- Fréquence de déploiement
- Délai de livraison des changements
- Temps moyen de restauration (MTTR)
- Taux d’échec des changements
Ces métriques permettent de suivre l’efficacité des processus de livraison, d’identifier les points de friction, et d’améliorer la vélocité sans sacrifier la qualité.
💡 Revue d’architecture légère
Cette méthode consiste à organiser des revues d’architecture simples et efficaces, sans lourdeur administrative.
Elle implique un petit groupe de pairs, une discussion structurée, et des feedbacks concrets autour de décisions, de risques et de solutions possibles.
Le but : améliorer la qualité architecturale sans freiner la livraison.
https://www.embarc.de/architektur-spicker/12-leichtgewichtige-reviews/
💡 aim42 – Méthode d’amélioration de l’architecture
aim42 est une méthode structurée pour améliorer des architectures logicielles existantes.
Elle propose une approche en 3 étapes :
- Analyse : comprendre les points forts, faiblesses, risques.
- Évaluation : prioriser les problèmes à résoudre.
- Amélioration : mettre en œuvre des solutions adaptées.
aim42 est particulièrement utile pour les systèmes legacy ou complexes.
💡 Théorie de la résidualité
La théorie de la résidualité (Residuality Theory) est un cadre de réflexion pour comprendre pourquoi certaines parties d’un système sont plus résistantes au changement.
Elle propose de penser les systèmes comme des couches empilées, certaines étant plus stables ou critiques que d’autres.
Cela aide les architectes à mieux gérer la dette technique, à planifier les évolutions, et à choisir où expérimenter sans casser le reste.
