Inspection de l'architecture

L'index de code enregistre les fichiers, les symboles et leurs relations. Les vues d'architecture organisent ces éléments de preuve pour vous permettre d'inspecter la structure d'un dépôt. Systèmes enregistre également la structure étendue des dépôts et des ressources.

Consultez l'architecture d'un dépôt

Ouvrez un système adossé à un dépôt dans Systèmes. Sous Architecture, choisissez Composants de code, Classes ou Flux d'appels. Le Système L'onglet affiche la structure du système. Données et Dépendances externes offrent d'autres lectures du dépôt.

Choisissez une présentation pour les lectures contenant un graphe :

• Diagramme: explorez les nœuds et relations enregistrés.
• UML: notation de classe, disponible pour les lectures de classes et de relations entre entités.
• Flux ciblé: sélectionnez un nœud et suivez ses relations entrantes et sortantes. Sélectionnez un voisin pour poursuivre l'exploration.
• Matrice de dépendances: les lignes pointent vers les colonnes. Un nombre compte les relations enregistrées ; sélectionnez-le pour lire leurs types. Filtrez par nom de nœud pour affiner la matrice.

Les flèches indiquent la direction indexée, et non le trafic d'exécution ni l'ordre d'exécution. Le dessin de flux affiche jusqu'à dix voisins de chaque côté ; la matrice affiche jusqu'à 24 nœuds correspondants. Une cellule vide signifie qu'aucune relation n'existe dans cette lecture. Si l'index ne peut pas prendre en charge une lecture, la page en explique la raison.

Inspectez les composants locaux

Après avoir configuré l'agent local et indexé un dépôt, utilisez son identifiant depuis sourceant repos:

sourceant architecture acme/billing
sourceant architecture acme/billing --depth 2
sourceant architecture acme/billing --depth 2 --tests

Les composants suivent les frontières des répertoires. La profondeur va de 1 à 4 et vaut 1 par défaut. Les tests sont exclus sauf si vous passez --tests. La commande lit l'index actuel sans effectuer d'appels de modèle ni démarrer une nouvelle exécution d'indexation.

Comparer à une référence

Exportez l'architecture actuelle avant de modifier le code :

sourceant architecture acme/billing --depth 2 --json > architecture.json

Une fois le dépôt réindexé, comparez-le à l'instantané enregistré :

sourceant architecture acme/billing --baseline architecture.json

Le résultat indique les composants et relations ajoutés, supprimés et modifiés. Les comparaisons utilisent le dépôt, la profondeur et la sélection de tests de la référence ; ne passez donc pas --depth ou --tests avec --baseline.

Cette comparaison porte sur des instantanés indexés, et non sur des commits Git. Les instantanés incomplets sont refusés, car des preuves manquantes ne permettent pas d'établir qu'un composant ou une relation a été supprimé. Mettez à jour l'index via la planification de l'agent ou la page Repositories avant de comparer.