zoom-html : domaines métier d'un projet rangé par type #58

Activity

1. alexwrite

   added

   bugSomething isn't workingSomething isn't working

   p2Défaut visible par l'utilisateurDéfaut visible par l'utilisateur

   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

   Prise en charge (branche fix/zoom-domains-by-type).

   Périmètre de fichiers visé :

   • graphify/zoom_html.py (détection de l'organisation, règle de domaine, libellés)
   • tests/test_zoom_html.py (fixture neutre rangée par type)
   • README.md si la ligne de commande change de sens

   Approche envisagée : liste fermée des dossiers « de type » (noms générés par les commandes make:* de Symfony et Laravel, plus les dossiers de couche) ; organisation par type si la majorité des classes vit sous un tel dossier ; domaine = premier dossier non technique sous les dossiers de type ; sinon domaine commun explicite. Captures avant/après du projet A, niveaux 1 et 2, clair et sombre.
4. alexwrite commented on Oct 11, 2026

   

   alexwrite

   on Oct 11, 2026

   OwnerAuthor

   More actions

   Fait

   • Le niveau 1 de zoom-html montre les domaines métier d'un projet rangé par type : PR fix(zoom-html): show business domains in projects organised by type #61.
   • L'organisation est détectée (by-type ou by-domain) et annoncée en tête du niveau 1.
   • Les dossiers de type (Controller, Command, Form, Enum, DataFixtures, EventSubscriber...) ne sont jamais présentés comme domaines ; les classes sans dossier de domaine vont dans le groupe explicite « Common », expliqué dans la légende.
   • Ordre des colonnes du niveau 2 confirmé : Route (masquée tant qu'elle est vide), Controller, Service, Repository, Entity / Model, View, Other.

   Comment

   • graphify/zoom_html.py : liste fermée _TYPE_DIRS, detect_layout, classify_domain(path, root, layout), groupe « Common », phrase d'organisation et entrée de légende ; docstring du module mis à jour.
   • tests/test_zoom_html.py : 16 cas de chemins (Symfony par type, par domaine, Laravel), détection de l'organisation, fixture neutre rangée par type (Item, Order, Sitemap) qui vérifie qu'aucun dossier technique ne devient domaine.

   Pourquoi ce choix

   • Liste fermée des noms que les générateurs de Symfony (maker) et Laravel (make:*) donnent aux dossiers, plutôt qu'une heuristique sur la taille ou le contenu des dossiers : prévisible, documentable, et fidèle à la règle « refuser plutôt que deviner ».
   • Organisation décidée à l'échelle du projet (majorité des classes sous un dossier de type) et non fichier par fichier : dans un projet rangé par domaine, un domaine qui porterait un nom de type au deuxième niveau (src/Account/Security/) reste dans son domaine.
   • Groupe « Common » explicite plutôt que de rattacher une entité au domaine qui lui ressemble par le nom : un rattachement deviné serait faux sans le dire. Le rattachement par l'usage, prouvé par les appels, est proposé dans zoom-html : rattacher par l'usage les classes du groupe Common à leur domaine unique #60.

   Apprentissages

   • Sur le projet A, le découpage métier existe bien un niveau plus bas : 94 domaines (ProbeNetwork, Admin, Retention, Osint, Host, Account, Economy...), mais un tiers des classes (1 068 sur 3 362) n'a aucun dossier de domaine : entités, dépôts, énumérations et messages sont posés à plat.
   • ClientXCMS (Laravel 12) est aussi rangé par type : 24 domaines (Admin, Billing, Core, Store, Provisioning, Helpdesk...) au lieu de Http, DTO, Console, Events, Contracts, Providers.
   • Le projet B, rangé par domaine, ne change pas.

   Faiblesses restantes

   • « Common » domine le niveau 1 du projet A (zoom-html : rattacher par l'usage les classes du groupe Common à leur domaine unique #60, p3).
   • Les modules d'infrastructure qui ne sont pas des dossiers de type (Logging, Sentry, Mailer...) apparaissent comme domaines ; domaines déclarés à la main : Contrôles d'architecture déclaratifs avec score et SARIF, sur le modèle de Plumber #51.
   • Libellés de liens parfois superposés au niveau 1 (Vue zoom-html : les liens longs passent derrière les boîtes du niveau 1 #54).
   • Captures avant/après faites sur le projet A (niveaux 1 et 2, clair et sombre), non publiées ici car le projet est privé.

   Quality

   • Tests : tests/test_zoom_html.py 29/29 ; sans le correctif, erreur d'import sur main, et 2 échecs si la détection est forcée à by-domain.
   • Suite complète après le dernier changement : 7648 passed, 14 skipped, 0 failed.
   • Ruff : 0. Pyright sur les fichiers touchés : 0 erreur.
   • 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 et 320 px vérifiés ; aucun texte sous 12 px (glyphe de l'icône passé de 11 à 12 px).
5. alexwrite

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

   Merge: zoom-html shows business domains of type-organized projects (#58)

   ...

   ddc3b00
6. alexwrite

   closed this as completedin #61on Oct 11, 2026