Documentation d'architecture
Modèle C4
Approche hiérarchique des diagrammes d'architecture avec quatre niveaux de détail :
Zoomer avec le modèle C4
Client[Personne]
Contoso Ordering[Système logiciel]
ERP[Système externe]
E-mail[Système externe]
Système en contexte avec utilisateurs et dépendances externes. Montre ce que fait le système et qui l'utilise. Les parties prenantes non techniques peuvent comprendre cette vue.
Architecture decision records (ADRs)
Documenter les décisions architecturales significatives avec contexte, décision et conséquences :
# ADR 001 : utiliser Azure Cosmos DB pour le catalogue produits **Statut :** Accepté **Date :** 2024-01-15 **Décideurs :** Équipe d'architecture ## Contexte Le catalogue produits nécessite un stockage de données distribué mondialement et à faible latence. Le volume de lectures sera élevé ; la cohérence à terme est acceptable. ## Décision Utiliser Azure Cosmos DB avec des écritures multirégions. ## Conséquences + Distribution mondiale avec des lectures en quelques millisecondes + Mise à l'échelle automatique pour absorber les pics de trafic + Plusieurs niveaux de cohérence au choix - Coût plus élevé qu'Azure SQL Database - L'équipe doit apprendre les modèles de requête de Cosmos DB
Gouvernance d'architecture
Comité de revue d'architecture
Établir une gouvernance pour les décisions d'architecture :
- Revues régulières : Revues d'architecture trimestrielles pour les initiatives majeures
- Revue par les pairs : Conceptions d'architecture revues par des ingénieurs seniors
- Application des standards : Vérifications automatisées pour la sécurité, conformité, conventions de nommage
- Technology radar : Suivre les technologies approuvées, en essai et dépréciées
- Mises en œuvre de référence : Projets exemples démontrant les modèles
Gestion de la dette technique
- Registre de dette : Cataloguer la dette technique connue avec priorité et estimations d'effort
- Allocation : Dédier 20% de la capacité du sprint à la réduction de dette
- Métriques : Suivre la couverture de code, complexité cyclomatique, santé des dépendances
- Refactoring : Améliorations incrémentales continues vs. grosses réécritures