Navigateur de Trace de Fonctionnalité (Action Utilisateur → Graphe d'Appels → Parcours de Code)
Suivez une fonctionnalité unique depuis l'entrée UI ou API à travers les contrôleurs, services et couches de données pour générer un graphe d'appels et un parcours annoté.
Aperçu du prompt
Conseils pour vous
- Fournissez des journaux ou noms de tests pour identifier les chemins d'exécution réels. - Incluez le code de gestion des erreurs pour capturer les flux alternatifs. - Ajoutez un exemple court de payload utilisé en production.
De l’équipe opérationsNexusAi TechnologyProblème résolu
Trouver le chemin complet d'une fonctionnalité à travers les couches est sujet à erreurs. Cet outil produit un graphe d'appels fiable et met en évidence les points à explorer ensuite.
Clarté du chemin de bout en bout
Montre précisément comment les données circulent à travers les couches.
Annotations exploitables
Chaque étape inclut le but, les entrées/sorties et les effets secondaires.
Détecteur de lacunes de tests
Met en lumière les tests manquants ou faibles le long du chemin.
Guidage du fichier suivant
Indique ce qu'il faut lire ensuite et pourquoi.
Instructions du prompt IA
Agissez en tant qu'ingénieur full-stack senior et cartographe de code.
Pourquoi cette tâche est importante :
Les traces de bout en bout révèlent comment les données circulent, où se produisent les effets secondaires, et quels composants sont essentiels pour la maintenance et les tests.
Limites importantes :
- Travaillez uniquement à partir des extraits de routes, contrôleurs, services et modèles fournis.
- Si plusieurs variantes existent, privilégiez le chemin de production.
Entrées utilisateur :
- Description de la fonctionnalité (ex. « Créer une tâche » via POST /tasks).
- Fichiers pertinents : gestionnaires de routes, contrôleurs, services, modèles, middleware.
- Tout journal ou nom de test couvrant ce chemin.
Objectifs :
1) Produire un graphe d'appels clair de l'entrée à la persistance.
2) Annoter les fonctions clés avec leur but, entrées/sorties et effets secondaires.
3) Identifier les risques, tests manquants et lacunes d'observabilité.
4) Recommander l'ordre des fichiers à lire ensuite.
Flux d'analyse :
1) Commencez par la route ; localisez les appels aux contrôleurs et services.
2) Suivez les transformations et validations des données.
3) Notez les appels externes (BD, file d'attente, HTTP) et la gestion des erreurs.
4) Recoupez avec les tests existants.
5) Résumez les préoccupations de performance, fiabilité et lisibilité.
Format de sortie requis :
- Graphe d'appels textuel (liste indentée) pour copier/coller.
- Annotations par étape : but, paramètres, sortie, effets secondaires.
- Tests manquants et cas de test suggérés.
- 5 fichiers suivants à examiner.
Contrôles qualité :
- Inclure les noms exacts des fonctions et chemins de fichiers.
- Distinguer affirmations et suppositions ; marquer clairement les suppositions.
Liste de vérification :
- Toutes les couches représentées (route → contrôleur → service → modèle).
- Intégrations externes identifiées.
Instruction finale :
Fournissez une trace qu'un nouvel ingénieur peut suivre pour corriger un bug en toute confiance.
Résultat attendu
Graphe d'appels : POST /tasks → routes/tasks.js:createTask → controllers/taskController.js:create → services/taskService.js:createTask → models/task.js:Task.create Annotations : - createTask (route) : Valide le schéma du corps ; transmet au contrôleur - controller.create : Mappe le DTO, gère try/catch - service.createTask : Applique les règles métier, élimine les doublons de titre - Task.create : Persiste, retourne l'id Tests manquants : Rejet de titre en double ; payload invalide 400. Fichiers suivants : middleware/validateBody.js, services/notifications.js
Parcours de mise en œuvre
Construisez la trace avec Codex
Ouvrez Codex. Collez les extraits de route, contrôleur, service et modèle pour la fonctionnalité choisie. Demandez un graphe d'appels et un parcours annoté en utilisant cette invite. Attendez-vous à une trace en couches avec noms de fonctions et chemins.
12 minValidez les appels dans VS Code
Accédez à chaque fonction dans VS Code et confirmez les paramètres, retours et effets secondaires. Ajoutez ou corrigez les étapes manquantes (files d'attente, cache, appels HTTP).
10 minConvertissez en checklist de tests
Transformez la liste des tests manquants en noms de tests dans votre framework et créez des placeholders. Partagez la trace et la checklist dans la documentation de votre repo pour guider la prochaine PR.
8 min