--- title: "Génération de backlog par IA — Documentation Fonctionnelle" module: ai type: functional status: active updated: 2026-07-08 --- # Génération de backlog par IA — Documentation Fonctionnelle > Génère automatiquement une liste d'éléments de backlog à partir d'un cahier des charges (CDC) au format PDF, via l'IA (Anthropic Claude). --- ## Vue d'ensemble Sur l'onglet **Backlog** d'un projet, un utilisateur autorisé peut uploader un cahier des charges PDF (jusqu'à 100 pages, 20 Mo). L'IA analyse le document et propose une liste d'éléments de backlog (titre, description, importance, référence au besoin fonctionnel source). L'utilisateur choisit ensuite un sprint et des catégories par défaut (avec possibilité d'override par élément), édite ou supprime les suggestions si besoin, puis crée les éléments un par un ou en masse. --- ## Qui peut utiliser cette fonctionnalité ? Le bouton **"Générer via l'IA"**, situé à côté de "Créer un backlog" sur l'onglet Backlog d'un projet, n'est visible que pour les utilisateurs ayant le droit de modification sur le projet (même condition que "Créer un backlog"). --- ## Déroulement ### Étape 1 — Upload Une modale s'ouvre avec un formulaire de dépôt de fichier PDF unique. Le fichier est validé : - format PDF (type réel du fichier, pas seulement l'extension) - taille maximum 20 Mo - 100 pages maximum Un message d'erreur clair s'affiche si le fichier ne respecte pas ces limites, ou si une génération est déjà en cours sur ce projet. ### Étape 2 — Traitement Le PDF est envoyé à l'IA de façon asynchrone (file d'attente `ai-fills`). L'étape affiche l'état du traitement (en attente / en cours / terminé / erreur) et se met à jour automatiquement toutes les 3 secondes. En cas d'échec, le message d'erreur est affiché et l'utilisateur peut relancer une génération. ### Étape 3 — Prévisualisation et validation Une fois le traitement terminé, la liste des éléments de backlog proposés s'affiche dans une nouvelle modale : - Un **sélecteur de sprint** et un **champ de sélection de catégories** en tête de liste s'appliquent par défaut à tous les éléments. - Chaque élément affiche son titre, sa description, son importance (étoiles) et ses références aux besoins fonctionnels (`BF-xx`) du CDC. - Chaque élément peut être **édité** (titre/description), **supprimé** (non créé), ou recevoir un **override individuel** de sprint/catégories. - La création peut se faire **élément par élément** ("Créer") ou **en une fois** ("Tout créer"). Les éléments créés apparaissent immédiatement dans le tableau/kanban du backlog du projet. --- ## Mapping de l'importance La moulinette IA classe chaque besoin selon la méthode MoSCoW du CDC, puis restitue une importance simplifiée : | Importance restituée par l'IA | Note backlog (étoiles) | |-------------------------------|-------------------------| | Haute | 5 | | Moyenne | 3 | | Basse | 1 | Les besoins marqués "Won't have" dans le CDC ne génèrent aucun élément. --- ## Limites connues - Une seule génération peut être en cours à la fois par projet. - Le PDF source n'est pas conservé après traitement (suppression automatique, qu'il y ait succès ou échec). - Les catégories proposées dans le sélecteur sont celles déjà existantes pour le projet — aucune création de catégorie à la volée depuis cette modale. - Si l'IA ne trouve aucun besoin exploitable dans le CDC, la liste de prévisualisation est vide (ce n'est pas considéré comme une erreur). --- ## Fichiers concernés | Composant | Fichier | |-----------|---------| | Bouton d'accès | `resources/views/project/project/backlog.blade.php` | | Wizard upload/traitement | `app/Livewire/Project/Backlog/Ai/BacklogAiGenerateLauncher.php` | | Revue/validation | `app/Livewire/Project/Backlog/Ai/BacklogAiGenerateReview.php` | | Service métier | `app/Services/Project/BacklogAiGenerationService.php` | | Job asynchrone | `app/Jobs/Project/GenerateBacklogFromCdcJob.php` | Voir la documentation technique associée : `.claude/technical-docs/ai/backlog-ai-generation.md`.