Analyse complète des bugs du dépôt et flux de travail de correction

{ "tâche": "analyse_complète_du_dépôt", "objectif": "Effectuer une analyse exhaustive de l'ensemble du codebase pour identifier, prioriser, corriger et documenter TOUS les bugs vérifiables, les vulnérabilités de sécurité et les problèmes critiques sur toute la pile technologique", "phases_d_analyse": [ { "phase": 1, "nom": "Découverte et cartographie du dépôt", "étapes": [ { "étape": "1.1", "titre": "Analyse de l'architecture et de la structure", "actions": [ "Cartographier la structure complète des répertoires (src/, lib/, tests/, docs/, config/, scripts/, build/, deploy/)", "Identifier toutes les piles technologiques et les frameworks utilisés", "Analyser les manifestes de dépendances (package.json, requirements.txt, go.mod, pom.xml, Gemfile, Cargo.toml, composer.json)", "Documenter les points d'entrée, les chemins d'exécution principaux et les limites des modules", "Analyser les systèmes de build (Webpack, Gradle, Maven, Make, CMake)", "Examiner les configurations CI/CD (GitHub Actions, GitLab CI, Jenkins, CircleCI)", "Examiner la documentation existante (README, CONTRIBUTING, spécifications API, diagrammes d'architecture)" ] }, { "étape": "1.2", "titre": "Inventaire de l'environnement de développement", "actions": [ "Identifier les frameworks de test (Jest, Mocha, pytest, PHPUnit, Go test, JUnit, RSpec, xUnit)", "Examiner les configurations de linter/formateur (ESLint, Prettier, Black, Flake8, RuboCop, golangci-lint, Checkstyle)", "Rechercher les marqueurs de problèmes en ligne (TODO, FIXME, HACK, XXX, BUG, NOTE)", "Analyser l'historique Git pour les modèles problématiques et les correctifs récents", "Extraire les rapports et métriques de couverture de test existants", "Identifier les outils d'analyse de code déjà utilisés (SonarQube, CodeClimate, etc.)" ] } ] }, { "phase": 2, "nom": "Découverte systématique des bugs", "catégories_de_bugs": [ { "catégorie": "CRITIQUE", "gravité": "P0", "types": [ "Vulnérabilités d'injection SQL", "Failles de script intersite (XSS)", "Vulnérabilités de falsification de requête intersite (CSRF)", "Contournement d'authentification/autorisation", "Risques d'exécution de code à distance (RCE)", "Corruption de données ou perte de données permanente", "Plantages système, interblocages ou boucles infinies", "Fuites de mémoire et épuisement des ressources", "Implémentations cryptographiques non sécurisées", "Secrets ou identifiants codés en dur" ] }, { "catégorie": "FONCTIONNEL", "gravité": "P1-P2", "types": [ "Erreurs de logique (conditions incorrectes, calculs erronés, erreurs de décalage d'un)", "Problèmes de gestion d'état (conditions de course, état obsolète, mutations inappropriées)", "Contrats API incorrects ou mappages requête/réponse", "Validation d'entrée manquante ou insuffisante", "Logique métier cassée ou violations de flux de travail", "Transformations ou sérialisations de données incorrectes", "Inadéquations de type ou coercitions de type non sécurisées", "Gestion des exceptions ou propagation d'erreurs incorrecte" ] }, { "catégorie": "INTÉGRATION", "gravité": "P2", "types": [ "Utilisation incorrecte de l'API externe ou points de terminaison obsolètes", "Erreurs de requête de base de données, problèmes de syntaxe SQL ou problèmes N+1", "Échecs de gestion des files de messages (RabbitMQ, Kafka, SQS)", "Erreurs d'opérations sur le système de fichiers (permissions, traversée de chemin)", "Problèmes de communication réseau (délais d'attente, nouvelles tentatives, regroupement de connexions)", "Problèmes d'incohérence ou d'invalidation du cache", "Mauvaise utilisation de bibliothèques tierces ou incompatibilités de versions" ] }, { "catégorie": "CAS_LIMITES", "gravité": "P2-P3", "types": [ "Déréférencements de pointeurs null/undefined/nil/None", "Gestion de tableaux/listes/collections vides", "Cas limites de valeurs nulles ou négatives", "Conditions aux limites (entiers max/min, limites de longueur de chaîne)", "Gestion d'erreurs manquante ou exceptions avalées", "Échecs de logique de délai d'attente et de nouvelle tentative", "Problèmes d'accès concurrent sans verrouillage approprié", "Dépassement/sous-dépassement dans les opérations numériques" ] }, { "catégorie": "QUALITÉ_DU_CODE", "gravité": "P3-P4", "types": [ "Utilisation d'API obsolètes", "Code mort ou chemins de code inaccessibles", "Dépendances circulaires", "Goulots d'étranglement de performance (algorithmes inefficaces, opérations redondantes)", "Annotations de type manquantes ou incorrectes", "Modèles de gestion d'erreurs incohérents", "Fuites de ressources (descripteurs de fichiers, connexions de base de données, sockets réseau)", "Journalisation inappropriée (exposition de données sensibles, contexte insuffisant)" ] } ], "méthodes_de_découverte": [ "Analyse statique de code à l'aide d'outils spécifiques au langage", "Correspondance de modèles pour les anti-modèles courants et les odeurs de code", "Analyse de vulnérabilités des dépendances (npm audit, pip-audit, bundle-audit, cargo audit)", "Analyse du flux de contrôle et du flux de données", "Détection de code mort", "Validation de la configuration par rapport aux meilleures pratiques", "Vérification croisée documentation-implémentation", "Revue de code axée sur la sécurité" ] }, { "phase": 3, "nom": "Documentation et priorisation des bugs", "schéma_de_rapport_de_bug": { "id_du_bug": "Identifiant séquentiel (BUG-001, BUG-002, etc.)", "gravité": { "type": "énumération", "valeurs": [ "CRITIQUE", "HAUTE", "MOYENNE", "BASSE" ], "description": "Niveau de gravité du bug" }, "catégorie": { "type": "énumération", "valeurs": [ "SÉCURITÉ", "FONCTIONNEL", "PERFORMANCE", "INTÉGRATION", "QUALITÉ_DU_CODE" ], "description": "Classification du bug" }, "emplacement": { "fichiers": [ "Tableau des chemins de fichiers affectés avec numéros de ligne" ], "composant": "Nom du module/service/fonctionnalité", "fonction": "Nom de la fonction ou de la méthode spécifique" }, "description": { "comportement_actuel": "Ce qui est cassé ou incorrect", "comportement_attendu": "Ce qui devrait se produire à la place", "cause_racine": "Explication technique de pourquoi c'est cassé" }, "évaluation_de_l_impact": { "impact_utilisateur": "Effet sur les utilisateurs finaux (perte de données, exposition à la sécurité, dégradation de l'UX)", "impact_système": "Effet sur le système (performance, stabilité, évolutivité)", "impact_métier": "Effet sur l'entreprise (conformité, revenus, réputation, juridique)" }, "reproduction": { "étapes": [ "Instructions étape par étape pour reproduire" ], "données_de_test": "Données d'exemple ou conditions nécessaires", "résultat_actuel": "Ce qui se produit lors de la reproduction", "résultat_attendu": "Ce qui devrait se produire" }, "vérification": { "extrait_de_code": "Code de démonstration montrant le bug", "cas_de_test": "Test qui échouerait à cause de ce bug", "journaux_ou_métriques": "Preuves provenant des journaux ou de la surveillance" }, "dépendances": { "bugs_liés": [ "Tableau des ID de bugs liés" ], "problèmes_bloquants": [ "Tableau des bugs qui doivent être corrigés en premier" ], "bloqué_par": [ "Facteurs externes empêchant la correction" ] }, "métadonnées": { "date_de_découverte": "Horodatage ISO 8601", "découvert_par": "Outil ou méthode utilisée", "id_cve": "Si applicable, identifiant CVE", "id_cwe": "Si applicable, identifiant CWE" } }, "matrice_de_priorisation": { "critères": [ { "facteur": "gravité", "poids": 0.4, "échelle": "CRITIQUE=100, HAUTE=70, MOYENNE=40, BASSE=10" }, { "facteur": "impact_utilisateur", "poids": 0.3, "échelle": "Tous les utilisateurs=100, Beaucoup=70, Certains=40, Peu=10" }, { "facteur": "complexité_de_correction", "poids": 0.15, "échelle": "Simple=100, Moyen=60, Complexe=20" }, { "facteur": "risque_de_régression", "poids": 0.15, "échelle": "Faible=100, Moyen=60, Élevé=20" } ], "formule": "score_de_priorité = Σ(valeur_du_facteur × poids)" } }, { "phase": 4, "nom": "Implémentation des corrections", "flux_de_travail_de_correction": [ { "étape": 1, "action": "Créer une branche de correction isolée", "nommage": "fix/BUG-{id}-{description-courte}" }, { "étape": 2, "action": "Écrire le test échouant D'ABORD", "justification": "Le développement piloté par les tests garantit que la correction est vérifiable" }, { "étape": 3, "action": "Implémenter une correction minimale et ciblée", "principe": "Le plus petit changement qui résout correctement le problème" }, { "étape": 4, "action": "Vérifier que le test passe maintenant", "validation": "Exécuter le test spécifique et la suite de tests associée" }, { "étape": 5, "action": "Exécuter la suite complète de tests de régression", "validation": "S'assurer qu'aucune fonctionnalité existante ne casse" }, { "étape": 6, "action": "Mettre à jour la documentation", "portée": "Documentation API, commentaires en ligne, journal des modifications" } ], "principes_de_correction": [ "CHANGEMENT_MINIMAL : Faire le plus petit changement qui corrige correctement le problème", "PAS_D_ÉLARGISSEMENT_DE_PORTÉE : Éviter le refactoring ou les ajouts de fonctionnalités non liés", "COMPATIBILITÉ_ASCENDANTE : Préserver les contrats API existants sauf si le bug lui-même est cassant", "SUIVRE_LES_CONVENTIONS : Adhérer au style de code et aux modèles existants du projet", "PROGRAMMATION_DÉFENSIVE : Ajouter des gardes pour prévenir des bugs similaires à l'avenir", "EXPLICITE_PLUTÔT_QU_IMPLICITE : Rendre l'intention claire à travers la structure du code et les commentaires", "ÉCHEC_RAPIDE : Valider les entrées tôt et échouer avec des messages d'erreur clairs" ], "liste_de_vérification_de_revue_de_code": [ "La correction traite la cause racine, pas seulement les symptômes", "Tous les cas limites sont correctement gérés", "Les messages d'erreur sont clairs, exploitables et n'exposent pas d'informations sensibles", "L'impact sur les performances est acceptable (pas de O(n²) quand O(n) suffit)", "Les implications de sécurité sont minutieusement examinées", "Aucun nouvel avertissement du compilateur ou erreur de lint", "Les changements sont couverts par des tests", "La documentation est mise à jour et précise", "Les changements cassants sont clairement marqués et justifiés", "Les dépendances sont à jour et sécurisées" ] }, { "phase": 5, "nom": "Tests et validation", "exigences_de_test": { "tests_obligatoires_par_correction": [ { "type": "test_unitaire", "description": "Test isolé pour la correction spécifique du bug", "couverture": "Doit couvrir le chemin de code exact qui était cassé" }, { "type": "test_d_intégration", "description": "Test si le bug implique plusieurs composants", "couverture": "Flux de bout en bout à travers les systèmes affectés" }, { "type": "test_de_régression", "description": "S'assurer que la correction ne casse pas les fonctionnalités existantes", "couverture": "Toutes les fonctionnalités et chemins de code liés" }, { "type": "tests_de_cas_limites", "description": "Couvrir les conditions aux limites et les cas particuliers", "couverture": "Valeurs nulles, entrées vides, limites, conditions d'erreur" } ] }, "modèle_de_structure_de_test": { "description": "Structure de test indépendante du langage", "modèle": [ "describe('BUG-{ID}: {description}', () => {", " test('reproduit le bug original', () => {", " // Ce test démontre que le bug existait", " // Devrait échouer avant la correction, passer après", " });", "", " test('vérifie que la correction résout le problème', () => {", " // Ce test prouve le comportement correct après la correction", " });", "", " test('gère le cas limite : {cas}', () => {", " // Couverture supplémentaire pour les scénarios liés", " });", "});" ] }, "étapes_de_validation": [ { "étape": "Exécuter la suite complète de tests", "commandes": { "javascript": "npm test", "python": "pytest", "go": "go test ./...", "java": "mvn test", "ruby": "bundle exec rspec", "rust": "cargo test", "php": "phpunit" } }, { "étape": "Mesurer la couverture de code", "outils": [ "Istanbul/NYC", "Coverage.py", "JaCoCo", "SimpleCov", "Tarpaulin" ] }, { "étape": "Exécuter l'analyse statique", "outils": [ "ESLint", "Pylint", "golangci-lint", "SpotBugs", "Clippy" ] }, { "étape": "Analyse comparative des performances", "condition": "Si la correction affecte les chemins chauds ou les opérations critiques" }, { "étape": "Analyse de sécurité", "outils": [ "Snyk", "OWASP Dependency-Check", "Trivy", "Bandit" ] } ] }, { "phase": 6, "nom": "Documentation et rapports", "exigences_de_documentation_de_correction": [ "Mettre à jour les commentaires de code en ligne expliquant la correction et pourquoi elle était nécessaire", "Réviser la documentation API si le comportement a changé", "Mettre à jour CHANGELOG.md avec l'entrée de correction de bug", "Créer ou mettre à jour les guides de dépannage", "Documenter les solutions de contournement pour les problèmes différés/non corrigés", "Ajouter des notes de migration si la correction nécessite une action de l'utilisateur" ], "modèle_de_résumé_exécutif": { "titre": "Rapport de correction de bugs - {nom_du_dépôt}", "métadonnées": { "date": "Date ISO 8601", "analyseur": "Nom de l'outil/personne", "dépôt": "Chemin complet du dépôt", "hash_de_commit": "SHA du commit Git", "durée": "Durée de l'analyse en heures" }, "aperçu": { "total_de_bugs_trouvés": "entier", "total_de_bugs_corrigés": "entier", "bugs_différés": "entier", "couverture_de_test_avant": "pourcentage", "couverture_de_test_après": "pourcentage", "fichiers_analysés": "entier", "lignes_de_code": "entier" }, "constatations_critiques": [ "Les 3 à 5 bugs les plus critiques trouvés et leurs corrections" ], "résumé_des_corrections_par_catégorie": { "sécurité": "nombre", "fonctionnel": "nombre", "performance": "nombre", "intégration": "nombre", "qualité_du_code": "nombre" }, "tableau_détaillé_des_corrections": { "colonnes": [ "BUG-ID", "Fichier", "Ligne", "Catégorie", "Gravité", "Description", "Statut", "Test ajouté" ], "format": "Tableau Markdown ou CSV" }, "évaluation_des_risques": { "haute_priorité_restante": [ "Liste des problèmes critiques non corrigés" ], "prochaines_étapes_recommandées": [ "Éléments d'action priorisés" ], "dette_technique": [ "Résumé de la dette technique identifiée" ], "changements_cassants": [ "Toute correction incompatible avec les versions précédentes" ] }, "résultats_des_tests": { "commande_de_test": "Commande exacte utilisée pour exécuter les tests", "tests_réussis": "X sur Y", "tests_échoués": "nombre avec raisons", "tests_ajoutés": "nombre", "delta_de_couverture": "+X% ou -X%" } }, "liste_de_vérification_des_livrables": [ "Tous les bugs documentés dans un format standardisé", "Corrections implémentées avec une portée minimale", "Suite de tests mise à jour et réussie", "Documentation mise à jour (code, API, guides utilisateur)", "Revue de code terminée et approuvée", "Impact sur les performances évalué et acceptable", "Revue de sécurité effectuée pour les corrections liées à la sécurité", "Notes de déploiement et plan de restauration préparés", "Journal des modifications mis à jour avec les changements visibles par l'utilisateur", "Parties prenantes informées des corrections critiques" ] }, { "phase": 7, "nom": "Amélioration continue", "analyse_de_modèles": { "objectifs": [ "Identifier les modèles de bugs récurrents dans le codebase", "Détecter les problèmes architecturaux permettant les bugs", "Trouver les lacunes dans la stratégie de test", "Mettre en évidence les zones avec de la dette technique" ], "sorties": [ "Rapport sur les modèles de bugs courants", "Recommandations de mesures préventives", "Suggestions d'amélioration des outils", "Propositions de refactoring architectural" ] }, "recommandations_de_surveillance": { "métriques_à_suivre": [ "Taux de découverte de bugs au fil du temps", "Délai de résolution par gravité", "Taux de régression (bugs réintroduits)", "Pourcentage de couverture de test", "Churn de code dans les zones sujettes aux bugs", "Nombre de vulnérabilités de dépendances" ], "règles_d_alerte": [ "Vulnérabilités de sécurité critiques dans les dépendances", "Échecs de la suite de tests", "Baisse de la couverture de code sous le seuil", "Dégradation des performances dans les opérations clés" ], "améliorations_de_journalisation": [ "Ajouter une journalisation structurée là où elle manque", "Inclure des ID de corrélation pour le traçage des requêtes", "Journaliser les événements liés à la sécurité", "S'assurer que les journaux d'erreurs incluent les traces de pile et le contexte" ] } } ], "contraintes_et_meilleures_pratiques": [ "NE JAMAIS compromettre la sécurité pour la simplicité ou la commodité", "MAINTENIR une piste d'audit complète de tous les changements", "SUIVRE le versionnage sémantique si les corrections changent l'API publique", "RESPECTER les limites de débit lors des tests des services externes", "UTILISER des indicateurs de fonctionnalité pour les corrections à haut risque ou à déploiement progressif", "DOCUMENTER toutes les hypothèses faites pendant l'analyse", "CONSIDÉRER une stratégie de restauration pour chaque correction", "PRÉFÉRER les corrections rétrocompatibles lorsque c'est possible", "ÉVITER d'introduire de nouvelles dépendances sans justification", "TESTER dans plusieurs environnements lorsque c'est applicable" ], "formats_de_sortie": [ { "format": "markdown", "but": "Documentation et rapports lisibles par l'humain", "modèle_de_nom_de_fichier": "bug_report_{date}.md" }, { "format": "json", "but": "Lisible par machine pour le traitement automatisé", "modèle_de_nom_de_fichier": "bug_data_{date}.json", "schéma": "Suivre le schéma de rapport de bug défini dans la phase 3" }, { "format": "csv", "but": "Importation dans les systèmes de suivi de bugs (Jira, GitHub Issues)", "modèle_de_nom_de_fichier": "bugs_{date}.csv", "colonnes": [ "BUG-ID", "Gravité", "Catégorie", "Fichier", "Ligne", "Description", "Statut" ] }, { "format": "yaml", "but": "Format adapté à la configuration pour l'intégration CI/CD", "modèle_de_nom_de_fichier": "bug_config_{date}.yaml" } ], "considérations_spéciales": { "monorepos": "Analyser chaque package/espace de travail séparément avec suivi des dépendances entre packages", "microservices": "Considérer les contrats inter-services, la compatibilité API et le traçage distribué", "code_legacy": "Équilibrer le risque de correction par rapport au bénéfice ; prioriser les corrections à fort impact et à faible risque", "dépendances_tierces": "Signaler les vulnérabilités en amont ; considérer des alternatives si non maintenues", "systèmes_à_fort_trafic": "Considérer les stratégies de déploiement (blue-green, canary) pour les corrections", "industries_réglementées": "S'assurer que les exigences de conformité sont respectées (HIPAA, PCI-DSS, SOC2, GDPR)", "projets_open_source": "Suivre les directives de contribution ; s'engager avec les mainteneurs avant les changements importants" }, "critères_de_succès": { "quantitatifs": [ "Tous les bugs de gravité CRITIQUE et HAUTE traités", "Couverture de test augmentée d'au moins X%", "Zéro vulnérabilité de sécurité dans les dépendances", "Tous les tests réussissent", "Métriques de qualité de code améliorées (complexité cyclomatique, indice de maintenabilité)" ], "qualitatifs": [ "Le codebase est plus maintenable", "La documentation est claire et complète", "L'équipe peut déployer les corrections en toute confiance", "Des mécanismes de prévention de bugs futurs sont en place", "La vélocité de développement est améliorée" ] } }

Analyse complète des bugs du dépôt et flux de travail de correction

Contenu du PromptEnregistrer

Utilisation

Références

Discussion