Correction d'Issue GitHub

Instructions à Exécuter

IMPORTANT : Exécute ce workflow étape par étape :

Purpose

Corriger une issue GitHub de manière structurée et efficace, en se concentrant sur l'essentiel.

Variables

ISSUE_NUMBER: $1 (obligatoire)

Instructions

• Utilise les outils Bash pour les opérations Git et GitHub CLI
• Focus sur la résolution rapide et efficace du problème
• Applique les standards du projet NEO

Relevant Files

• Issues GitHub du repository
• Code source pertinent selon l'issue
• Documentation technique si nécessaire

Workflow

Initialisation

Créer les tâches du workflow :

Utiliser TaskCreate pour chaque phase :

TaskCreate #1: Analyse de l'issue
TaskCreate #2: Préparation de l'environnement (branche)
TaskCreate #3: Investigation du code
TaskCreate #4: Implémentation de la solution
TaskCreate #5: Validation et tests
TaskCreate #6: Finalisation (informer utilisateur)

Important :

• Utiliser activeForm (ex: "Analysant l'issue", "Implémentant la solution")
• Chaque tâche doit être marquée in_progress puis completed

Pattern d'exécution pour chaque phase :

1. TaskUpdate → tâche en in_progress
2. Exécuter la phase
3. TaskUpdate → tâche en completed

Phases

1. Analyse de l'issue

• Récupérer les détails de l'issue via gh issue view $ISSUE_NUMBER
• Analyser le problème : type (bug, feature, enhancement), priorité, description
• Identifier les fichiers/modules concernés
• Vérifier les éventuels liens Sentry pour plus de contexte

2. Préparation de l'environnement

• Vérifier le statut git actuel
• S'assurer d'être sur la bonne branche de base (develop/main)
• Créer une branche de travail : issue/$ISSUE_NUMBER-{description-courte}
• Exemple : issue/966-stockage-epuration-historique

3. Investigation du code

• Localiser les fichiers concernés par l'issue
• Comprendre le code existant et identifier la cause du problème
• Analyser l'impact de la modification sur les autres parties du système
• Identifier les dépendances et side-effects potentiels

4. Implémentation de la solution

• Implémenter la correction en respectant :

- Standards PHP 8.2+ avec typage strict - Conditions Yoda (null === $value) - Documentation des exceptions avec @throws - Conventions de nommage françaises

• Éviter les changements inutiles ou trop larges
• Maintenir la cohérence avec l'architecture existante

5. Validation et tests

• Exécuter les tests existants : make run-unit-php
• Ajouter des tests si nécessaire pour couvrir le nouveau code
• Vérifier avec PHPStan : ZÉRO erreur acceptée
• Tester la solution manuellement si applicable

6. Finalisation

• Informer l'utilisateur
• Ne pas faire de commit

Task Management

Progression du workflow :

• 6 tâches créées à l'initialisation
• Chaque phase suit le pattern : in_progress → exécution → completed
• Utiliser TaskList pour voir la progression
• Les tâches permettent à l'utilisateur de suivre la résolution de l'issue

Report

• Issue analysée avec titre et type
• Branche créée avec nom approprié
• Fichiers modifiés avec résumé des changements
• Tests exécutés avec résultats

Validation

• ✅ ISSUE_NUMBER doit être fourni et exister sur GitHub
• ✅ Branche de travail créée avec convention de nommage
• ✅ Solution implémentée respectant les standards
• ✅ PHPStan passe sans erreur (CRITIQUE)
• ✅ Tests unitaires passent

Expertise

Standards de qualité NEO :

• PHP 8.2+ avec typage strict obligatoire
• Conditions Yoda pour toutes les comparaisons
• Exceptions documentées avec @throws
• Nommage en français pour les concepts métier
• PHPStan niveau 9 sans erreur
• Tests unitaires pour nouveau code

Examples

# Correction d'un bug
/github:fix 966

# Résultat attendu :
# 1. Analyse issue #966 "STOCKAGE - Épuration historique"
# 2. Création branche : issue/966-stockage-epuration-historique
# 3. Investigation du code de gestion des devis/alertes
# 4. Implémentation de l'épuration automatique
# 5. Tests et validation PHPStan