Docs

Architecture

À quoi sert cet écran

Architecture Explorer dessine votre catalogue sous forme de graphe : systèmes, composants, APIs et ressources, avec les relations qui les lient. C’est la réponse à « qu’est-ce qui parle à quoi, et qu’est-ce qui casse si ceci disparaît » — une question dont la liste du Catalogue détient les données mais qu’elle ne sait pas montrer.

La page se présente comme un dossier d’architecture technique, et c’est la bonne façon de s’en servir : quelque chose que l’on lit avant de modifier un composant partagé, et que l’on exporte dans une revue de conception.

Avant de commencer

Pour faire ceci Il vous faut
Ouvrir la page l’accès en lecture au catalogue

Le graphe est construit à partir du catalogue : il ne montre donc que ce qui y est enregistré. Enregistrez d’abord vos systèmes et composants dans Settings › Development › Projects — un composant non enregistré est invisible ici, ce qui se lit comme « rien n’en dépend ».

Ouvrir l’écran

  1. Explore › Architecture dans la barre latérale.

URL directe : /architecture

L’interface

📸 Capture d’écran : Architecture Explorer affichant un système avec ses composants et ses APIs. Repères : (1) le champ de recherche, (2) les filtres de types avec leurs compteurs, (3) les filtres de relations, (4) les sélecteurs Owner et System, (5) la légende, (6) l’export, (7) le rafraîchissement.

# Élément Ce qu’il fait Quand l’utiliser
1 Recherche Filtre le graphe par nom Retrouver un nœud dans un grand parc
2 Filtres de types Active systèmes, composants, APIs, ressources — chacun avec un compteur Réduire le graphe à ce qui vous intéresse
3 Filtres de relations Affiche ou masque des types de relations Tracer un type de dépendance à la fois
4 Owner / System Restreint à une équipe ou un système Examiner la surface d’une seule équipe
5 Légende Ce que signifient formes et couleurs La première fois, et chaque fois que vous l’oubliez
6 Export Enregistre la vue courante en image Revues de conception, comptes rendus d’incident
7 Rafraîchir Relit le catalogue Après avoir enregistré quelque chose

Les compteurs des filtres de types méritent d’être lus pour eux-mêmes. Un système à quarante composants et deux APIs n’a pas la même forme qu’un système à quatre composants et trente APIs, et cela se voit avant même de dessiner quoi que ce soit.

Procédures

Trouver ce qui dépend d’un composant

  1. Explore › Architecture.
  2. Recherchez le composant.
  3. Désactivez les types qui ne vous intéressent pas, pour que le graphe cesse de se disputer votre attention.
  4. Utilisez les filtres de relations pour n’afficher qu’un type à la fois. Tout afficher donne une pelote ; une relation à la fois donne un schéma.

Examiner la surface d’une équipe

Réglez le filtre Owner sur son groupe. Vous obtenez tout ce dont cette équipe est responsable — utile lors d’une passation, et inconfortable dans le bon sens quand une équipe découvre ce qu’elle possède réellement.

Exporter une vue

Filtrez jusqu’à ce que vous vouliez dire, puis Export. Exporter le graphe non filtré produit quelque chose que personne ne lit.

Scénario

Décider si une bibliothèque partagée peut être modifiée.

Quelqu’un propose un changement cassant sur un composant utilisé par plusieurs équipes. La question n’est pas « le changement est-il bon » mais « qui l’apprendra à ses dépens ».

  1. Explore › Architecture, recherchez le composant.
  2. Désactivez d’abord ressources et APIs, en gardant systèmes et composants. Vous voulez la forme avant le détail.
  3. Regardez quels systèmes l’atteignent. Notez l’Owner de chacun : ce sont les personnes à prévenir, et elles ne sont souvent pas dans la conversation.
  4. Activez les filtres de relations un à un. Une dépendance directe et une dépendance transitive n’appellent pas la même discussion.
  5. Recoupez avec Deploy : un système dépendant qui n’a pas déployé depuis des mois représente un risque différent d’un système qui livre quotidiennement.
  6. Exportez la vue filtrée et joignez-la à la proposition. Une discussion sur le périmètre d’impact avance beaucoup plus vite avec une image.

La réserve à énoncer à voix haute à l’étape 3 : ce graphe montre ce qui est enregistré. Un consommateur que personne n’a ajouté au catalogue n’y figure pas, et son équipe sera cassée quand même. Considérez le graphe comme un plancher du périmètre d’impact, pas comme un plafond.

En cas de problème

Symptôme Cause Comment vérifier Solution
Un composant attendu est absent Il n’est pas enregistré dans le catalogue Projets Enregistrez-le, puis Rafraîchir
Le graphe est une pelote illisible Trop de types et de relations affichés à la fois Les filtres Filtrez sur un type de relation ; masquez les types inutiles
Rien n’a de propriétaire Les systèmes n’ont pas de groupe propriétaire Projets Renseignez les propriétaires sur les systèmes
Une dépendance connue n’est pas dessinée La relation n’est pas consignée dans le catalogue L’entrée de catalogue du composant Ajoutez la relation à son entité
Le graphe semble périmé Il reflète le catalogue au moment du chargement — Rafraîchir
L’export est vide ou énorme Il exporte la vue courante Les filtres Filtrez d’abord, exportez ensuite

Pour aller plus loin