Analyses d'Architecture

L'analyse propulsée par l'IA d'Archyl détecte les problèmes d'architecture potentiels et fournit des recommandations pour améliorer la conception de votre système.

Quelles Analyses Archyl Détecte-t-il ?

Problèmes Critiques

Haute Priorité

Priorité Moyenne

Basse Priorité

Lancer l'Analyse d'Architecture

Analyse d'un Seul Projet

1. Allez dans la section Analyses depuis la barre latérale
2. Sélectionnez votre projet
3. Cliquez sur Analyser
4. Attendez que l'analyse se termine
5. Révisez les résultats par sévérité

Analyse à l'Échelle de l'Organisation

Pour analyser tous les projets en une fois :

1. Allez dans Analyses depuis la navigation principale
2. Cliquez sur Analyser Tous les Projets
3. Révisez les résultats agrégés à travers votre organisation

Comprendre les Analyses

Chaque analyse inclut :

Niveau de Sévérité

• Critique : Nécessite une attention immédiate
• Haute : Devrait être traité rapidement
• Moyenne : Envisager de traiter quand possible
• Basse : Améliorations souhaitables

Éléments Affectés

L'analyse liste tous les éléments impliqués, avec des liens directs pour les voir dans le diagramme.

Recommandations

Étapes actionnables pour résoudre le problème :

Recommandation : Ajoutez une couche de cache entre l'API Gateway
et la Base de Données pour réduire les connexions directes à la
base de données et améliorer la résilience.

Documentation Liée

Liens vers les bonnes pratiques et patterns architecturaux pertinents.

Gérer les Analyses

Masquer les Analyses

Si une analyse est intentionnelle ou un faux positif :

1. Cliquez sur l'analyse pour l'étendre
2. Cliquez sur Masquer cette analyse
3. Optionnellement ajoutez une raison
4. L'analyse sera cachée de la vue principale

Voir les Analyses Masquées

Pour réviser les analyses masquées :

1. Allez dans la section Analyses
2. Activez Afficher masquées
3. Révisez et optionnellement réactivez des éléments

Actions en Masse

Sélectionnez plusieurs analyses pour :

• Masquer toutes les sélectionnées
• Assigner à un membre de l'équipe
• Exporter en rapport

Bonnes Pratiques

Analyse Régulière

• Lancez l'analyse après des changements majeurs d'architecture
• Incluez la révision des analyses dans la planification de sprint
• Suivez les tendances des analyses au fil du temps

Priorisez par Impact

Toutes les analyses ne nécessitent pas une action immédiate :

1. Concentrez-vous d'abord sur la sévérité Critique et Haute
2. Considérez l'impact business lors de la priorisation
3. Documentez les déviations intentionnelles

Partagez avec l'Équipe

• Exportez les rapports d'analyses pour les revues d'architecture
• Assignez les analyses aux membres de l'équipe
• Suivez la résolution dans votre outil de gestion de projet

Analyses Courantes et Solutions

Point Unique de Défaillance

Problème : Un seul service gère toute l'authentification.

Solution :

• Ajoutez un service d'auth redondant
• Implémentez le pattern circuit breaker
• Utilisez un stockage de session distribué

Fort Couplage

Problème : Le frontend appelle directement 10+ services backend.

Solution :

• Introduisez une API Gateway
• Implémentez le pattern Backend for Frontend (BFF)
• Utilisez la communication événementielle

Dépendances Circulaires

Problème : Le Service A dépend de B, B dépend de C, C dépend de A.

Solution :

• Extrayez la logique partagée vers un nouveau service
• Utilisez l'architecture événementielle
• Refactorisez pour casser le cycle

Éléments Orphelins

Problème : Base de données sans connexions montrées.

Solution :

• Ajoutez des relations vers les services qui l'utilisent
• Supprimez si plus utilisé
• Liez à de la documentation expliquant l'usage

Personnaliser les Règles d'Analyse

Chaque organisation a des standards d'architecture différents. Archyl vous permet de personnaliser les règles qui génèrent les analyses pour correspondre aux exigences de votre équipe.

Accéder aux Paramètres des Règles

1. Allez dans la section Analyses
2. Cliquez sur l'onglet Règles
3. Ajustez les paramètres pour chaque règle
4. Cliquez sur Enregistrer pour appliquer les changements

Lorsque vous enregistrez les changements, Archyl ré-analyse automatiquement votre architecture avec la nouvelle configuration.

Règles Disponibles

Point Unique de Défaillance (SPOF)

Détecte les éléments avec trop de dépendances entrantes qui pourraient causer des défaillances système s'ils tombent en panne.

Augmentez le seuil si votre architecture centralise intentionnellement certaines préoccupations. Les infrastructures critiques comme les bases de données reçoivent une attention supplémentaire quel que soit votre paramètre de seuil.

Fort Couplage

Identifie les composants avec des connexions excessives dans les deux directions.

Le seuil entrant capture les éléments dont dépendent beaucoup d'autres composants. Le seuil sortant capture les éléments qui dépendent de trop d'autres composants.

Éléments Sur-connectés

Signale les éléments avec trop de connexions totales (entrantes + sortantes combinées).

Cela capture un problème différent du fort couplage : les composants difficiles à comprendre parce qu'ils touchent trop de parties du système.

Dépendances Circulaires

Détecte les cycles de dépendances où A dépend de B, B dépend de C, et C dépend de A.

Les dépendances circulaires compliquent les tests, créent des problèmes d'initialisation et signalent des frontières peu claires. La plupart des équipes laissent cette option activée.

Éléments Orphelins

Trouve les éléments d'architecture sans connexion avec d'autres composants.

Les éléments orphelins peuvent indiquer des lacunes de documentation ou des services obsolètes qui devraient être supprimés.

Problèmes de Sécurité

Détecte les patterns préoccupants comme les systèmes externes avec accès direct à la base de données.

Ces résultats sont de sévérité critique et la plupart des équipes veulent en être informées immédiatement.

Documentation Manquante

Signale les éléments sans description.

Pour éviter des rapports trop volumineux sur les grandes bases de code, les vérifications de documentation pour les composants ne s'exécutent que si votre nombre total de composants est inférieur à ce seuil.

Paramètres à l'Échelle de l'Organisation

Les règles d'analyse s'appliquent à toute votre organisation, pas par projet. Cela assure des standards de gouvernance cohérents à travers toutes les équipes et projets.

Réinitialiser aux Valeurs par Défaut

Cliquez sur Réinitialiser aux valeurs par défaut dans l'onglet Règles pour restaurer toutes les règles à leur configuration originale.

Prochaines Étapes

• Découverte Propulsée par l'IA - Garder l'architecture à jour
• Documentation - Documenter les décisions architecturales
• Export - Exporter les rapports d'analyses