Vue du graphe compréhensible d'un coup d'œil, même sur un gros dépôt #50

Activity

1. alexwrite

   added

   enhancementNew feature or requestNew feature or request

   p3Finition, dette, confortFinition, dette, confort

   on Oct 11, 2026
2. github-actions commented on Oct 11, 2026

   

   github-actionsBot

   on Oct 11, 2026 – with GitHub Actions

   More actions

   Thanks for opening this issue, @alexwrite. A maintainer will take a look soon.

   If you would like to discuss it in real time, come say hi on our Discord server. For longer-form questions and ideas there is also GitHub Discussions.

   To help us triage, please make sure the report includes what you expected, what actually happened, and the steps (and a small sample) to reproduce it.
3. alexwrite commented on Oct 11, 2026

   

   alexwrite

   on Oct 11, 2026

   OwnerAuthor

   More actions

   Conception validée le 2026-10-11 : vue en trois niveaux de zoom (domaines, puis un domaine en colonnes par couche, puis une classe), variables visuelles porteuses de sens, tests et framework masqués par défaut. Mise en œuvre lancée.
4. alexwrite commented on Oct 11, 2026

   

   alexwrite

   on Oct 11, 2026

   OwnerAuthor

   More actions

   Prise en charge (branche feat/zoom-view).

   Périmètre de fichiers visé :

   • graphify/zoom_html.py (nouveau : calcul des trois niveaux + rendu HTML autonome)
   • graphify/cli.py, graphify/__main__.py (sous-commande graphify export zoom-html, aide CLI)
   • README.md, ARCHITECTURE.md
   • tests/test_zoom_html.py (nouveau)

   Approche envisagée : callflow-html et tree évalués comme base, mais tous deux chargent leur bibliothèque depuis un CDN sans version figée ni SRI, et callflow-html regroupe par communautés (le défaut constaté ici). Je reprends le principe d'agrégation par section et le chargement fidèle au sens des arcs (paths.restore_arc_direction), et j'écris une vue sans dépendance : données des trois niveaux calculées en Python (testables), rendu SVG/HTML natif, hors ligne.
5. alexwrite commented on Oct 11, 2026

   

   alexwrite

   on Oct 11, 2026

   Last edited by alexwrite

   OwnerAuthor

   More actions

   Fait

   • graphify export zoom-html écrit une page HTML autonome, hors ligne, en trois niveaux de zoom : PR feat(export): add zoom-html, a three-level architecture view #57.
   • Niveau 1 : les domaines du dépôt, longueur de barre = nombre de classes, appelants au-dessus des appelés, 15 boîtes au plus (les plus petites regroupées), les 15 liens les plus forts avec leur nombre d'appels. Les domaines qui rappellent un domaine situé au-dessus (cycle) portent un badge rouge « ! ».
   • Niveau 2 : un domaine, ses classes en colonnes par couche (Route, Controller, Service, Repository, Entity / Model, View, Other), arcs agrégés entre couches ; une classe qui appelle une couche à sa gauche est entourée de rouge avec un triangle.
   • Niveau 3 : une classe, ses méthodes triées par nombre d'appelants, appelants et appelés avec fichier:ligne de chaque appel.
   • Tests, framework / vendor et code hors racine masqués par défaut, chaque filtre affiche son nombre de classes.

   Comment

   • graphify/zoom_html.py : build_zoom_data calcule tout ce que la page affiche (domaine, couche, agrégats, sens interdit, ordre des domaines), write_zoom_html écrit la page ; rendu SVG et HTML natif sans bibliothèque.
   • graphify/cli.py, graphify/__main__.py : sous-commande export zoom-html, aide CLI.
   • tests/test_zoom_html.py : 22 tests sur un graphe neutre (Item, Shared) : couches et domaines Symfony par type, par domaine, Laravel ; tests, vendor, hors racine ; sens interdit ; cycle entre domaines ; sens des arcs _src/_tgt ; gabarits ; échappement des libellés ; CLI.
   • README.md, ARCHITECTURE.md : commande et module documentés.

   Pourquoi ce choix

   • Rendu écrit plutôt que callflow-html ou tree : les deux chargent leur bibliothèque depuis un CDN sans version figée ni SRI (callflow-html et tree chargent leur bibliothèque depuis un CDN sans version figée ni SRI #52), ne marchent pas hors ligne, et callflow-html regroupe par communautés, le défaut constaté ici. Repris : l'agrégation des arêtes par section et le contrat de sens des arcs (paths.restore_arc_direction).
   • Domaine sous un dossier de couche (src/Controller/Account/ donne Account) plutôt que le premier dossier sous src/ au sens strict : sur un projet Symfony rangé par type, la lecture stricte aurait affiché les couches à la place des domaines.
   • Seuls les appels EXTRACTED peuvent être signalés à contre-sens : un appel INFERRED (résolu par le nom) est compté et tracé en pointillé, jamais accusé. Alternative écartée : tout compter, qui aurait signalé des dépendances non prouvées.
   • Au niveau 1, les liens de cycle sont révélés au survol ou au focus, le badge reste visible : la première version les traçait tous et produisait une pelote rouge sur ClientXCMS (20 liens à contre-sens sur 15 boîtes).
   • Données calculées en Python plutôt qu'en JavaScript : les règles qui portent un jugement sont testées par pytest.

   Apprentissages

   • Charger graph.json dans un nx.Graph fusionne les arêtes parallèles (un appel et une référence entre les mêmes nœuds) : la vue lit donc la liste brute des liens pour ne perdre aucun appel.
   • graphify export <format> --help n'atteint jamais l'aide détaillée : la garde d'aide universelle répond avant (L'aide détaillée de graphify export <format> --help est inaccessible #53).
   • Le marqueur _callable_class (posé par le moteur d'extraction, toutes langues) identifie les classes de façon fiable ; les méthodes sont les cibles des arêtes method.
   • Sur le projet A (rangé par type), 290 classes (entités, dépôts à plat) n'ont pas de domaine connu : c'est l'architecture réelle, pas un défaut de la vue.

   Faiblesses restantes

   • Colonne Route vide tant que les routes ne sont pas extraites (Framework : ajouter routes, injection et événements depuis l'export du framework #47).
   • Liens longs tracés derrière les boîtes intermédiaires du niveau 1, libellés parfois superposés (Vue zoom-html : les liens longs passent derrière les boîtes du niveau 1 #54).
   • Arborescence plate (paquet Python) entièrement dans « (no domain) » (Vue zoom-html : une arborescence plate tombe entièrement dans « (no domain) » #55).
   • Textes en anglais seulement (Vue zoom-html : textes en anglais seulement #56).
   • Les bibliothèques des autres exports HTML restent chargées depuis un CDN sans SRI (callflow-html et tree chargent leur bibliothèque depuis un CDN sans version figée ni SRI #52, p1).
   • Contraste du texte en SVG vérifié par calcul des paires de couleurs, axe-core ne le mesure pas sur le SVG.
   • Suite complète lancée avant les deux derniers ajustements de placement des libellés (script de la page) ; tests ciblés relancés après.

   Quality

   • Tests : tests/test_zoom_html.py 22/22 ; suite complète 7641 passed, 14 skipped, 0 failed ; tests ciblés après les derniers ajustements 117 passed.
   • Contrôle de mutation : retirer la règle EXTRACTED, lire source/target au lieu de _src/_tgt, ou désactiver le marquage des cycles fait échouer un test à chaque fois.
   • Ruff : 0. Pyright : 0 erreur sur les fichiers nouveaux ; aucune nouvelle erreur sur cli.py et __main__.py (2 erreurs préexistantes sur main).
   • Accessibilité : axe-core 4.10.3 (WCAG 2.0/2.1 A et AA), 0 violation sur 3 niveaux x 2 thèmes x 3 projets réels ; parcours clavier aller-retour vérifié ; aucun défilement horizontal à 320 px ; aucun texte sous 12 px.
6. alexwrite

   closed this as completedin #57on Oct 11, 2026
7. alexwrite

   added a commit that references this issue on Oct 11, 2026

   Merge: three-level zoom view, export zoom-html (#50)

   ...

   98b28ad