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 :

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

Voir la documentation technique associée : .claude/technical-docs/ai/backlog-ai-generation.md.