Guide outil

Graphify: comprendre un projet en le visualisant

Graphify sert a transformer un projet en carte lisible. Au lieu de parcourir les fichiers un par un, tu obtiens une vue d'ensemble des pages, fonctions, fichiers importants et relations entre eux.

A quoi sert Graphify ?

L'outil aide surtout quand un projet commence a grossir ou quand tu arrives sur un code que tu ne connais pas encore. Il repere les elements du projet, les relie entre eux et genere une documentation visuelle pour comprendre plus vite ce qui depend de quoi.

Comment lire les resultats ?

Graphify genere souvent un dossier de sortie avec une page HTML interactive, des fichiers de synthese et parfois des fiches par fonction ou par module. La page HTML sert a explorer le graphe; les documents texte servent a lire rapidement les zones importantes.

Commence par les noeuds les plus gros ou les plus connectes: ce sont souvent les fichiers centraux. Ensuite, suis les liens vers les routes, composants ou fonctions qui dependent d'eux.

Comment l'utiliser ?

La bonne methode est simple: lance Graphify sur le dossier du projet, ouvre le rapport genere, puis utilise le graphe comme une carte avant de modifier le code.

  1. Place-toi dans le dossier racine du projet.
  2. Lance l'analyse Graphify avec la commande prevue dans ton installation.
  3. Ouvre le fichier HTML genere dans le dossier de sortie.
  4. Lis les syntheses pour identifier les zones principales.
  5. Reviens au code avec une meilleure idee des fichiers a toucher.

Comment le mettre en place ?

Sur un projet web, garde Graphify comme outil de diagnostic. Tu peux le placer dans un dossier d'outils ou l'installer comme dependance si ton workflow le permet. Le plus important est de choisir un dossier de sortie clair, par exemple graphify-out, pour ne pas melanger les rapports avec le code de l'application.

Une mise en place propre ressemble a ca:

Quand le relancer ?

Relance Graphify apres une refonte, l'ajout de plusieurs pages, une grosse modification d'API ou avant de confier le projet a quelqu'un d'autre. C'est aussi utile avant une session de debug, parce que la carte montre rapidement les chemins possibles.

Tu peux revenir a la liste des guides.