Démarrer avec Needl

Ce que fait Needl, comment y accéder et comment lire l'application avant de produire votre premier dossier.

Parcours utilisateurs

Les six workflows métier de Needl : ce qui les déclenche, ce qu'ils produisent, et l'enchaînement exact des tâches. Commencez ici si vous savez ce que vous devez livrer.

Cadrer un besoin

La phase d'entrée : décrire le besoin, répondre au cadrage et valider la reformulation qui servira de base au dossier.

Le PRD

Le cahier des charges structuré en 8 sections. C'est le socle dont découlent les quatre autres artefacts.

Les User Stories

Le découpage du PRD en fonctionnalités vues du côté utilisateur, avec leurs critères d'acceptation.

Exigences et cas de test

La traduction des critères d'acceptation en règles testables, puis en scénarios de recette exécutables.

Traçabilité et couverture

La preuve que rien n'est oublié : chaque story reliée à ses exigences, chaque exigence à ses cas de test.

Rapports et exports

Les sept sorties de Needl, en PDF et en Markdown. Le téléchargement est le seul point de sortie de l'outil.

Gestion des projets

Votre bibliothèque de dossiers : retrouver, renommer, archiver, partager et versionner.

Référence et dépannage

Les pages à consulter ponctuellement : checklists, glossaire, identifiants, symptômes courants, limites du produit.

Introduction à Needl

Needl est un outil de spécification assisté par IA. Vous décrivez un besoin en langage naturel, Needl produit un dossier complet en cinq artefacts reliés entre eux. Cet article décrit ce que l'outil produit, pour qui, et ce qu'il ne fait pas.

Le problème que Needl résout

Les cinq artefacts produits

À qui s'adresse chaque livrable

Needl n'a qu'un seul profil utilisateur : tout le monde voit les mêmes écrans. Ce qui change, c'est le rapport que chacun reçoit à la sortie.

Se connecter à Needl

Needl s'ouvre dans un navigateur, sans installation. Cet article décrit comment ouvrir une session, créer un compte, et ce qu'implique le profil unique de l'application.

Ouvrir une session

1. Ouvrez l'adresse needl.qalilab.com/login dans votre navigateur.
2. Saisissez votre e-mail et votre mot de passe.
3. Validez. La page d'Accueil s'affiche avec le champ de saisie du besoin et vos Projets récents.

Créer un compte

Le lien S'inscrire se trouve sur le même écran que la connexion. Aucune approbation par un administrateur n'est nécessaire : Needl ne gère pas de rôles.

Un seul profil, mêmes droits

Démarrage rapide

Votre premier dossier, du besoin brut au fichier exportable. Cinq étapes, sans détour.

Les 5 étapes

Étape 1Démarrer depuis l'Accueil

Page d'accueil. Écrivez le besoin dans le grand champ, vérifiez le modèle IA affiché, cliquez Générer le dossier complet.

→ Needl crée le projet et ouvre le cadrage.

L'ordre est imposé

Un onglet cliqué en avance affiche : « Génère d'abord les User Stories pour déverrouiller cette étape ».

Et après

Découvrir la page d'accueil

L'Accueil est le point de départ de tout projet : c'est là que vous décrivez un besoin et que vous retrouvez vos derniers dossiers. Cet article décrit chaque zone de l'écran.

Les zones de l'écran

ÉcranLa page d'accueil de Needl

Page d'accueil. Barre du haut : logo, onglets Accueil et Mes projets, recherche de projet, icône de déconnexion. Au centre, le champ de saisie du besoin. Sous le champ : Joindre fichier à gauche, le modèle IA au centre, Générer le dossier complet à droite. En bas, le bloc Projets récents.

Comprendre la chaîne de production

Chaque artefact de Needl est généré depuis le précédent, dans un ordre imposé. Cet article décrit cet enchaînement et explique pourquoi un onglet peut rester verrouillé.

La chaîne des artefacts

L'ordre est imposé

Un artefact ne peut pas exister sans celui qui le précède : pas d'exigence sans user story, pas de cas de test sans exigence. Un onglet cliqué en avance affiche : « Génère d'abord les User Stories pour déverrouiller cette étape ».

Lire les compteurs des onglets

Le chiffre affiché à côté de chaque onglet de la fiche projet indique le nombre d'éléments générés : PRD 1, User Stories 15, Exigences 46, Cas de test 12. Un onglet sans chiffre correspond à un maillon qui n'existe pas encore.

Rechercher un projet

La barre de recherche est présente dans la barre du haut, sur toutes les pages. Vous n'avez pas besoin d'ouvrir Mes projets pour chercher.

Lancer une recherche

1. Cliquez la barre Rechercher un projet…, en haut à droite.
2. Tapez un mot du nom du projet.
3. Lisez les cartes de résultat : compteurs PRD · US · EXG · CT, statut et date.
4. Cliquez la carte pour ouvrir le projet, ou le menu … pour agir dessus.

ÉcranRésultats de recherche depuis l'Accueil

Recherche depuis l'Accueil. Le bloc Projets récents laisse place à Résultats de recherche avec leur nombre. Chaque carte affiche les compteurs d'artefacts, le statut et la date.

Pour revenir à l'affichage normal, videz le champ avec la croix.

Si ça bloque

Carte des workflows

Un workflow est une suite d'actions qui produit un résultat métier, pas un écran. Cette page indique lequel suivre selon ce que vous devez livrer, et lesquels concernent votre rôle dans le projet.

Les six workflows

Comment ils s'enchaînent

W5 n'est pas dans la file : il se déclenche quand une décision tombe en cours de route et vous ramène en amont. C'est le workflow le plus coûteux si on l'exécute mal.

Par lecteur

Needl n'a qu'un profil applicatif, mais quatre lecteurs. Chacun n'a pas besoin de tout le guide.

Parcours complet : un projet de bout en bout

Ce parcours suit le projet Gestion des achats et livraisons, celui qui illustre toutes les captures de ce guide. Il va du besoin brut jusqu'au constat de couverture — y compris son trou, qui est réel.

1 — Le besoin de départ

Un cycle d'approvisionnement à dématérialiser : bons de commande, achat au marché, tri, répartition, livraison avec preuve. Le besoin est saisi sur l'Accueil, puis affiné par 4 questions de cadrage et une reformulation validée.

→ Workflow W1 · Cadrer un besoin avant de chiffrer

2 — Ce que le PRD a produit

État réelLe PRD du projet, en version v2

Lecture de l'écran. Le Besoin métier a produit 5 items BM-01 à BM-05 : créer les bons de commande et d'achat via une application web, effectuer le tri et la vérification du stock, réaliser l'achat au marché et répartir les articles, affecter un livreur et un chauffeur, livrer et valider le bon de livraison avec preuve. Le Périmètre compte 8 inclus · 3 exclus, les Règles métier 5 règle(s), les Décisions 6 décision(s). Ambiguïtés et Hypothèses sont à zéro : elles ont été levées, et le bandeau Origine le confirme — « Section enrichie suite aux décisions H2, AMB-01, AMB-02, AMB-03 ».

→ Le cadrage est propre : c'est ce qu'on attend avant de passer au backlog.

3 — Le backlog

Le PRD a produit 15 user stories, regroupées par thème : Gestion des commandes, Opérations de terrain, Logistique. Chacune porte son format « En tant que… », ses critères d'acceptation, sa criticité et son estimation.

→ Workflow W2 · Produire un backlog estimable

4 — Les exigences et les tests

Les 15 stories ont produit 46 exigences. Les cas de test, eux, sont 12. Ce rapport de presque 4 pour 1 est le premier signal : la recette ne peut pas couvrir 46 règles avec 12 scénarios.

→ Workflow W3 · Construire un cahier de recette

5 — Le constat de couverture

État réelLa matrice ISTQB du projet

Lecture de l'écran. Le compteur d'alerte affiche ⚠ 31 EXG non couvertes, à rapprocher des 46 EXG et 12 CT. Les lignes vides portent le badge ⚠ Lacune et un 0 dans la colonne CT. En vue Détail, les stories US-03, US-06 et US-08 ont trois exigences chacune et aucun cas de test.

→ Deux tiers des exigences ne sont vérifiées par aucun test.

6 — Ce qu'il faut en faire

Ce dossier n'est pas prêt pour l'audit en l'état. Trois actions, dans cet ordre :

1. Onglet Cas de test → Régénérer les CT. C'est le geste qui résout la majorité des lacunes.
2. Pour les badges qui persistent, ouvrir l'exigence : elle est trop vague pour être testable. La reformuler, puis régénérer.
3. Pour ce qui reste, assumer par écrit : périmètre reporté, décision en attente, exigence non testable.

→ Workflow W4 · Préparer un dossier d'audit

W1 · Cadrer un besoin avant de chiffrer

Le workflow d'entrée : transformer une demande orale ou un document flou en cadrage écrit, validé par le sponsor, avant d'engager le moindre chiffrage.

Le déroulé

Point de contrôle avant de sortir du workflow

• Le Périmètre affiche autant d'exclusions que d'inclusions attendues — un périmètre sans out- est un périmètre non discuté.
• Ambiguïtés affiche 0 à lever, ou chaque item restant est assumé par écrit.
• Hypothèses a été relue par quelqu'un du métier, pas seulement par vous.
• L'indicateur État : à jour est affiché en bas à gauche du panneau PRD.

W2 · Produire un backlog estimable

Transformer un PRD validé en user stories qu'une équipe de développement peut estimer sans revenir vers vous.

Le déroulé

Point de contrôle

• Aucune story ne porte encore Mérite affinage sans arbitrage écrit.
• Chaque story a au moins deux critères d'acceptation formulés comme des faits vérifiables.
• Le compteur Toutes est bien égal à la somme des deux sous-onglets.
• Les stories ajoutées à la main (US-A…) sont visibles après la dernière régénération.

W3 · Construire un cahier de recette

Passer des user stories à des cas de test qu'un testeur peut exécuter sans poser de question. C'est le workflow de la QA.

Le déroulé

Point de contrôle

• Chaque exigence a au moins un cas Nominal et un cas Erreur.
• Les types Limite existent sur les champs à contrainte (longueur, date, quantité).
• Aucun cas AMB ne part en exécution sans arbitrage.
• Le fichier a été exporté avant la dernière régénération.

W4 · Préparer un dossier d'audit

Produire la preuve que rien n'a été oublié — ou que ce qui manque est explicitement signalé. C'est le seul workflow dont le résultat est un document opposable.

Le déroulé

Point de contrôle

• Le compteur d'exigences non couvertes est connu et communiqué, pas découvert par l'auditeur.
• Chaque lacune restante a une raison écrite : exigence non testable, périmètre reporté, décision en attente.
• La matrice ISTQB figure bien en fin du PDF exporté.
• Les cas multi-EXG ont été comptés une fois par exigence, pas une seule fois au total.

W5 · Intégrer un changement de périmètre

Le client tranche une ambiguïté, retire une fonctionnalité ou en ajoute une, alors que le dossier est déjà produit. C'est le workflow où l'on casse le plus de choses en voulant aller vite.

La règle unique

Régénérez toujours de haut en bas, sans sauter de maillon. Un maillon sauté laisse des références orphelines et une traçabilité fausse — qui a l'air correcte à l'écran.

Le déroulé

Point de contrôle

• Les cas de test corrigés à la main ont été exportés avant la cascade.
• Les quatre régénérations ont été faites, dans l'ordre.
• Les user stories ajoutées manuellement sont toujours présentes dans leur sous-onglet.
• La traçabilité ne montre aucune exigence rattachée à une story inexistante.

W6 · Livrer et partager le dossier

Sortir le dossier de Needl et le mettre entre les mains des bonnes personnes, avec le bon niveau de droit.

Le déroulé

Point de contrôle

• Le rapport a été ouvert et relu après téléchargement, pas seulement généré.
• La permission de partage correspond à l'usage : lecture seule si le cadrage ne doit pas circuler.
• Le projet porte un nom explicite, pas Nouveau projet · JJ/MM/AAAA.

Créer un projet

Un projet Needl part d'un besoin décrit en langage naturel, pas d'un formulaire. Cet article décrit comment saisir ce besoin, ce qu'il faut y mettre, et ce qui se passe une fois la génération lancée.

Saisir le besoin

1. Sur la page d'Accueil, écrivez votre besoin dans le grand champ.
2. Dites qui utilise : « les acheteurs B2B ».
3. Dites ce qu'il fait : « visualiser leurs commandes, télécharger leurs factures ».
4. Dites ce qui est exclu, si vous le savez déjà.
5. Cliquez Générer le dossier complet. Le bouton s'active dès que le champ n'est plus vide.

Étape 1Le besoin saisi sur l'Accueil

Champ de saisie renseigné. Sous le champ : Joindre fichier, le modèle IA et le bouton Générer le dossier complet.

→ Needl crée le projet et ouvre le cadrage.

Ce qu'il faut écrire

Laisser Needl créer le projet

1. Attendez la fin de la barre de progression (« Finalisation… »).
2. Ne rechargez pas la page.

Étape 2Création du projet en cours

Modale « Génération en cours ». Le projet apparaît dans Mes projets avant même que le PRD soit généré.

→ Vous arrivez sur la fiche projet, onglet PRD, cadrage ouvert.

Si ça bloque

Joindre un fichier au besoin

Quand le contexte existe déjà dans un document — compte rendu d'atelier, cahier des charges partiel, export d'un outil — joignez-le plutôt que de le retaper. Needl s'en sert pour enrichir le cadrage.

Attacher un document

1. Cliquez Joindre fichier, à gauche sous le champ de saisie.
2. Choisissez votre document. Il apparaît en pastille au-dessus du texte, avec son nom et son poids (ici spécification.pdf · 46 Ko).
3. Écrivez quand même une phrase dans le champ : « Je viens de te partager les spécifications de mon projet ». Le fichier complète le besoin, il ne le remplace pas.
4. Cliquez Générer le dossier complet.

ÉcranUn fichier attaché au besoin

Fichier joint. La pastille du document s'affiche au-dessus du texte ; le compteur sur Joindre fichier passe à 1. Pour retirer un fichier, cliquez la croix sur sa pastille.

→ Le contenu du fichier entre dans le contexte du cadrage.

Choisir le modèle IA

Le modèle qui génère le dossier se choisit avant la génération et se change à tout moment. C'est le seul réglage de Needl.

Les modèles disponibles

Changer de modèle

1. Cliquez sur le nom du modèle affiché, sous le champ de saisie de l'Accueil.
2. Choisissez dans la liste Modèle IA.

ÉcranLe sélecteur de modèle IA

Liste « Modèle IA ». Chaque ligne porte son étiquette : Qualité, Auto, Équilibré, Économique.

→ Le nouveau modèle s'applique aux générations suivantes.

Changer en cours de projet

Le modèle est aussi affiché dans l'en-tête de la fiche projet, à droite du nom. Cliquez dessus pour en changer.

Répondre aux questions de cadrage

Needl pose 4 questions maximum avant de rédiger le dossier. C'est l'étape qui détermine la qualité de tout ce qui suit : ce que vous ne dites pas ici ne se trouvera dans aucun des cinq artefacts.

Répondre aux questions

1. Lisez la question, à gauche.
2. Répondez en une phrase dans le champ Votre réponse…, en bas.
3. Envoyez avec la flèche. Le compteur passe à 1/4 et la question suivante arrive.
4. Enchaînez jusqu'à la dernière question.

Étape 1Première question du cadrage

Question 1 sur 4. La question est à gauche, le compteur d'avancement en haut, le champ Votre réponse… en bas avec la flèche d'envoi.

Étape 2Question suivante

Question 2 sur 4. Les réponses déjà données restent visibles au-dessus.

→ Après la dernière question, l'écran de reformulation s'ouvre.

Bien répondre

Valider la reformulation

La reformulation est le dernier contrôle avant génération. Ce texte est la seule base du dossier : dix secondes de relecture évitent une régénération complète.

Relire, corriger, valider

1. Relisez le texte, en particulier ce qui est exclu.
2. Corrigez directement dans le cadre, ou écrivez votre demande dans Affiner la reformulation….
3. Cliquez Valider et générer le PRD.

ÉcranLa reformulation du besoin

Écran de reformulation. Le texte est éditable directement dans le cadre. En bas, le champ Affiner la reformulation… et le bouton Valider et générer le PRD.

→ La génération du PRD démarre en 3 phases.

Deux façons de corriger

Suivre la génération du PRD

La génération se déroule en trois phases, avec barre de progression. Les sections se déverrouillent automatiquement : vous n'avez rien à faire, mais vous ne devez pas recharger la page.

Les 3 phases

1. Laissez l'écran ouvert : les sections se déverrouillent au fur et à mesure.
2. Suivez la phase en cours et le pourcentage.
3. Pour interrompre, cliquez Arrêter, en haut à droite.

ÉcranGénération du PRD, phase 1 sur 3

Génération en cours. La barre affiche le pourcentage et la phase courante. Le bouton Arrêter est en haut à droite.

→ À 100 %, les 8 sections du PRD s'affichent.

Si ça bloque

Lire le PRD

Le PRD transforme votre besoin en cahier des charges structuré en 8 sections. C'est le socle : les quatre autres artefacts en découlent. Cet article décrit comment lire l'écran et dans quel ordre.

Lire l'écran

1. Lisez d'abord Ambiguïtés : c'est ce que le dossier ne sait pas encore.
2. Cliquez une carte pour ouvrir son détail dans le panneau de droite.
3. Vérifiez l'indicateur État : à jour, en bas à gauche.

ÉcranLe PRD terminé, vue Affinage

Vue Affinage du PRD. Les 8 cartes de section entourent le bloc central Affinage, chacune avec son indicateur (Validé, 8 inclus · 3 exclus, 5 règle(s)…). À droite, le détail de la section sélectionnée avec ses items BM-01, BM-02… et son bandeau Origine. En haut, les onglets de version v1 / v2. En bas à droite, Régénérer le PRD.

→ Les 8 cartes passent en ✓ Validé quand la section est complète.

Les 8 sections

Si ça bloque

Affiner une section du PRD

L'affinage retravaille un item isolé — une inclusion de périmètre, une règle métier — sans toucher au reste du PRD. Cet article décrit la manipulation et ce qu'il faut faire ensuite pour que l'affinage compte.

Affiner un item

1. Cliquez une carte de section, ou son nom dans le bloc Affinage central.
2. Repérez les deux blocs : Dans le périmètre et Hors périmètre.
3. Cliquez Affiner à droite de l'item à retravailler.
4. Fermez la modale une fois vos affinages terminés.

ÉcranModale Périmètre : inclus et exclus

Affinage du Périmètre. Les items in-01 (dans le périmètre) et out-01 (hors périmètre) sont séparés en deux blocs. Le bouton Affiner est à droite de chaque item.

→ L'item est retravaillé seul, sans toucher au reste du PRD.

Si ça bloque

Régénérer le PRD

La régénération intègre vos affinages et crée une nouvelle version du PRD. Les versions précédentes restent consultables. Cet article décrit l'opération et l'enchaînement obligatoire qui la suit.

Régénérer

1. Revenez sur la vue Affinage.
2. Cliquez Régénérer le PRD, en bas à droite.
3. Attendez les 3 phases, comme à la première génération.
4. Vérifiez la nouvelle version dans les onglets v1 / v2.

ÉcranLe bouton Régénérer le PRD

Bas du panneau d'affinage. À gauche l'état du PRD, à droite le bouton Régénérer le PRD.

→ Une version v2 est créée. La v1 reste consultable.

Enchaîner la régénération

Après Régénérer le PRD, régénérez aussi les user stories, les exigences et les cas de test. Sinon ils restent basés sur la version précédente et pointent vers des stories qui n'existent plus.

Consulter le prompt initial

Le prompt initial est votre reformulation validée, mot pour mot. C'est le premier écran à ouvrir quand un dossier généré paraît à côté du besoin réel.

Ouvrir le prompt initial

1. Cliquez Prompt initial dans l'en-tête de la fiche projet.
2. Lisez le contexte qui a servi à générer le PRD.

ÉcranModale Prompt initial

Prompt initial. Le texte affiché est la reformulation que vous avez validée avant la génération.

Lire et filtrer les user stories

Les user stories découpent le PRD en fonctionnalités vues du côté utilisateur, chacune avec ses critères d'acceptation. C'est ce que vous donnez à l'équipe de développement pour estimer et planifier.

Lire et filtrer

1. Filtrez avec Toutes / Générées (PRD) / Ajoutées manuellement.
2. Dépliez une story pour voir ses critères d'acceptation.
3. Corrigez avec le crayon, supprimez avec la corbeille.
4. Traitez en priorité les stories marquées ⚠ Mérite affinage : elles reposent sur une zone incertaine, avec sa source (Issue de : AMB-04).

ÉcranL'onglet User Stories

Liste des user stories. Sous-onglets de filtrage en haut, stories dépliables avec identifiant, criticité, estimation et critères d'acceptation. Le bouton Régénérer les US est en haut à droite.

→ Les critères d'acceptation deviennent les exigences à l'étape suivante.

Anatomie d'une story

Si ça bloque

Ajouter des user stories manuellement

Quand une fonctionnalité évidente manque, vous l'ajoutez sans tout régénérer. Vous ne remplissez pas un formulaire : vous décrivez le besoin, Needl rédige la story avec son format, ses critères d'acceptation, sa criticité et son estimation.

Quand ajouter à la main

Décrire la story

1. Ouvrez l'onglet User Stories, sous-onglet Ajoutées manuellement.
2. Cliquez + Ajouter des User Stories, en bas de la liste.
3. Décrivez le besoin en langage naturel, en une phrase dense.
4. Cliquez Générer, ou faites Ctrl + Entrée.

Étape 1Zone de saisie « Ajouter des User Stories »

Saisie libre d'une nouvelle story. Exemple de description exploitable : « Notification du propriétaire après modération de son annonce : validation, refus avec motif obligatoire, demande de correction, et ressoumission de l'annonce corrigée sans repartir de zéro. »

→ Needl peut produire plusieurs stories à partir d'une seule description.

Bien écrire la description

Les critères d'acceptation générés ne seront jamais plus précis que votre description.

Vérifier le résultat

1. Les nouvelles stories portent un identifiant en US-A07 : le A les distingue des stories générées depuis le PRD.
2. Contrôlez les compteurs : Toutes = Générées (PRD) + Ajoutées manuellement.
3. Relisez les critères d'acceptation et corrigez au crayon si besoin.
4. Les renvois RG-01, RG-02… sous la story sont cliquables et mènent aux règles associées.

Étape 2Le sous-onglet « Ajoutées manuellement »

Stories ajoutées à la main. Identifiants en US-A…, compteurs par sous-onglet, renvois RG-… cliquables sous chaque story.

Intégrer la story à la chaîne

Une story ajoutée n'a encore ni exigence ni cas de test. Sans cette étape, elle n'apparaîtra nulle part dans la traçabilité.

1. Onglet Exigences → Régénérer les EXG.
2. Onglet Cas de test → Régénérer les CT.
3. Ouvrez la Traçabilité et vérifiez que votre story apparaît avec sa chaîne complète.

Régénérer les user stories

La régénération recrée les stories issues du PRD et crée une nouvelle version. Cet article décrit l'opération et les vérifications à faire juste après.

Régénérer

1. Cliquez Régénérer les US, en haut à droite de l'onglet User Stories.
2. Contrôlez les compteurs : vos ajouts doivent toujours figurer dans Ajoutées manuellement.
3. Une nouvelle version apparaît ; les précédentes restent consultables.
4. Si le bandeau User Stories modifié — le PRD impacté s'affiche en bas, cliquez Mettre à jour le PRD pour réaligner le cadrage.

ÉcranLes User Stories après régénération

Nouvelle version des US. Le bandeau « 4 User Stories ajoutées » propose Générer les exigences — le maillon suivant de la chaîne.

Si ça bloque

Lire et modifier les exigences

Une exigence traduit un critère d'acceptation en règle métier précise et testable. C'est le contrat technique entre le métier et les développeurs. Cet article décrit comment lire une exigence, vérifier sa filiation et la modifier.

Lire une exigence et sa filiation

1. Commencez par les onglets Sécurité et RGPD/Légal : ce sont les plus souvent oubliés.
2. Dépliez une exigence pour voir ses règles métier.
3. Vérifiez la ligne Dérivée de US-01 · Critère 1 ; cliquez le badge pour remonter à la story.
4. Regardez le bloc Cas de test liés, en bas.

ÉcranL'onglet Exigences

Liste des exigences. Trois filtres cumulables : type, criticité, user story. Chaque exigence porte son identifiant EXG-001, son type, sa criticité, sa filiation Dérivée de US-01 et son bloc Cas de test liés. « Tout replier » ramène la liste aux titres.

→ Une exigence sans cas de test lié apparaîtra « Non couvert » en Traçabilité.

Les 5 types d'exigences

Modifier une exigence

1. Cliquez l'icône crayon, à droite du titre de l'exigence.
2. Reformulez l'énoncé ou corrigez une règle métier.
3. Enregistrez.

Si ça bloque

Vérifier la couverture des cas de test

Chaque exigence doit recevoir au moins un cas de test. La vue groupée par exigence est le contrôle le plus rapide pour repérer ce qui n'est couvert par rien.

Contrôler exigence par exigence

1. Gardez la vue Groupé par EXG.
2. Lisez le décompte à droite de chaque bloc : 2 Nominal 1 Erreur.
3. Une exigence sans bloc n'a aucun test : régénérez les CT.

ÉcranCas de test groupés par exigence

Vue « Groupé par EXG ». Chaque bloc porte son exigence, son décompte par type de cas et la liste des cas rattachés.

→ Cliquez un cas pour ouvrir son détail.

Les 4 types de cas

Les marqueurs d'origine

Si ça bloque

Modifier un cas de test

Un cas de test se corrige directement dans Needl : préconditions, étapes, résultat attendu, jeu de données. Cet article décrit la manipulation et la précaution à prendre avant toute régénération.

Corriger un cas

1. Dépliez le cas pour afficher son détail complet.
2. Cliquez l'icône crayon, en haut à droite du cas.
3. Corrigez les préconditions (l'état de départ), les étapes (les actions et leurs valeurs), le résultat attendu et le jeu de données.
4. Enregistrez.

ÉcranLe détail d'un cas de test

Détail d'un cas de test. Préconditions, étapes numérotées avec leurs valeurs, résultat attendu et jeu de données. L'icône crayon est en haut à droite du cas.

→ Un cas modifié à la main reste modifié, jusqu'à la prochaine régénération.

Si ça bloque

Explorer la traçabilité

La traçabilité relie chaque user story à ses exigences et chaque exigence à ses cas de test. Elle répond à une seule question : est-ce que tout est couvert ? Cet article décrit les trois vues disponibles.

Vue Colonnes par défaut

1. Balayez la colonne du milieu et repérez les ⚠ Non couvert.
2. Cliquez une user story à gauche pour filtrer sa chaîne.
3. Vérifiez à droite ce que chaque test couvre : Vérifie : EXG-001.

Vue 1Traçabilité en 3 colonnes

Vue Colonnes. User stories à gauche, exigences au centre, cas de test à droite. Sélectionner une story filtre toute sa chaîne.

→ Zéro « Non couvert » = dossier complet.

Vue Détail

Une user story à la fois, avec toute sa chaîne dépliée sur trois panneaux. C'est la vue qui sert à comprendre pourquoi un test existe.

1. Cliquez Détail dans la barre de vues, en haut à droite.
2. Choisissez une story dans la colonne de gauche : chacune affiche ses compteurs 3 EXG 4 CT.
3. Basculez sur le filtre ⚠ Lacunes pour n'afficher que les stories incomplètes.
4. Au centre, lisez la story et ses critères d'acceptation, puis le bloc Exigences liées.
5. Cliquez une exigence : le panneau de droite affiche ses règles métier et ses cas de test complets.
6. Cliquez Voir tout pour revenir à la liste entière.

Vue 2Vue Détail, une story sélectionnée

Vue Détail. L'en-tête résume la sélection (« US-04 — 3 exigences · 4 cas de test »). Une story incomplète porte le badge ⚠ Lacune et affiche 0 CT. Un cas marqué Vérifie plusieurs exigences compte pour chacune.

Vue Matrice ISTQB

Les exigences en lignes, les cas de test en colonnes, une coche à chaque croisement couvert. C'est le format attendu en audit.

1. Cliquez Matrice dans la barre de vues.
2. Lisez le compteur d'alerte en haut à droite : ⚠ 31 EXG non couvertes, à rapprocher des 46 EXG et 12 CT.
3. Repérez les lignes vides : elles portent le badge ⚠ Lacune et un 0 dans la colonne CT de droite.
4. Filtrez avec Toutes les US et Tous les types pour isoler un périmètre.
5. Lisez la couleur des coches : elle donne le type du cas de test.

Vue 3Matrice de traçabilité ISTQB

Vue Matrice. Chaque colonne porte son identifiant CT-001 et la story d'origine US-01. La légende rappelle les 4 types de cas : Nominal, Erreur, Limite, Performance.

Si ça bloque

Corriger une lacune de couverture

Une lacune est une exigence qu'aucun cas de test ne vérifie. Cet article décrit comment la faire disparaître, et quoi faire quand elle persiste.

Faire disparaître une lacune

1. Notez l'identifiant de l'exigence, par exemple EXG-002.
2. Allez sur l'onglet Cas de test → Régénérer les CT.
3. Revenez en Traçabilité : le badge doit avoir disparu.

Si la lacune persiste

C'est que l'exigence est trop vague pour être testable. Deux voies :

1. Affinez l'exigence dans l'onglet Exigences, puis régénérez les CT.
2. Ou levez l'ambiguïté correspondante dans le PRD, régénérez le PRD, puis toute la chaîne.

Vue d'ensemble des rapports

Needl produit sept sorties, toutes en PDF et en Markdown. Cet article indique quel rapport correspond à quel bouton et à quel destinataire.

Les sept rapports

Choisir le format

Tous les onglets proposent PDF et Markdown. Seule la traçabilité ajoute une troisième sortie, le lot ciblé sur une story.

Exporter un artefact

Chaque onglet de la fiche projet possède son propre bouton d'export : PRD, User Stories, Exigences, Cas de test. Le fichier ne contient que l'artefact concerné. Cet article décrit les quatre exports et ce que contient chaque rapport.

Exporter le PRD

1. Restez sur l'onglet PRD.
2. Cliquez le bouton PRD (icône téléchargement), en haut à droite.
3. Choisissez Télécharger en PDF ou Télécharger en Markdown.

ÉcranMenu d'export du PRD

Menu d'export de l'onglet PRD. Le fichier ne contient que le PRD, sans les autres artefacts.

RésultatLe rapport PRD ouvert

Rapport PRD exporté. En-tête Product Requirements Document et titre du système. Les 8 sections se suivent, chacune avec ses badges Enrichi par (H2, AMB-01…) : la provenance de l'information reste lisible.

→ Document à transmettre au sponsor pour validation du cadrage.

Exporter les User Stories

1. Cliquez le bouton User Stories (icône téléchargement), à gauche de Régénérer les US.
2. Choisissez PDF ou Markdown.

ÉcranMenu d'export des User Stories

Menu d'export de l'onglet US. Le Markdown est pratique pour alimenter un backlog.

RésultatLe rapport User Stories ouvert

Rapport User Stories exporté. En-tête User Stories avec le compteur total. Les stories sont regroupées par thème (Gestion des commandes, Opérations de terrain, Logistique…), chacune avec identifiant, criticité, estimation, format « En tant que… », critères d'acceptation et tags. Les badges Mérite affinage et leur source Issue de : AMB-02 signalent les stories à trancher avant développement.

→ Backlog prêt pour l'estimation en équipe.

Exporter les Exigences

1. Cliquez le bouton Exigences (icône téléchargement), à gauche de Régénérer les EXG.
2. Choisissez PDF ou Markdown.

ÉcranMenu d'export des Exigences

Menu d'export de l'onglet EXG. Chaque exigence part avec ses règles métier et ses cas de test liés.

RésultatLe rapport Exigences ouvert

Rapport Exigences exporté. Pour chaque exigence : identifiant EXG-001, type, criticité, énoncé et règles métier. La filiation Dérivée de US-01 et Source US-01 · Critère 1 montre l'origine de chaque règle. Le bloc Cas de test liés détaille préconditions, étapes, résultat attendu et jeu de données.

→ Contrat technique complet : exigence, règle, test et données dans un seul document.

Exporter les Cas de test

1. Cliquez le bouton Cas de test (icône téléchargement), à gauche de Régénérer les CT.
2. Choisissez PDF ou Markdown.

ÉcranMenu d'export des Cas de test

Menu d'export de l'onglet CT. Exportez avant de régénérer : la régénération écrase vos corrections manuelles.

RésultatLe rapport Cas de test ouvert

Rapport Cas de test exporté. Les cas restent groupés par exigence : badges EXG-001 · US-01 et décompte par type. Chaque cas est exécutable tel quel. Les scénarios E2E traversent plusieurs rôles et valident la chaîne complète.

→ Cahier de recette à donner au testeur, sans information à chercher ailleurs.

Exporter le rapport complet

Le rapport complet réunit les cinq artefacts dans un seul fichier, dans l'ordre de la chaîne. C'est le livrable client : il ne dépend plus de Needl.

Exporter

1. Cliquez Rapport complet, en haut à droite de la fiche projet.
2. Choisissez PDF pour envoyer au client.
3. Choisissez Markdown pour reprendre le contenu ailleurs (Notion, Confluence, Git).

ÉcranMenu d'export du rapport complet

Menu Rapport complet. Deux sorties : PDF et Markdown. Le fichier contient les 5 artefacts.

Vérifier le fichier

1. Ouvrez le fichier téléchargé.
2. Vérifiez que le document enchaîne les 5 artefacts dans l'ordre : PRD → User Stories → Exigences → Cas de test → Traçabilité.
3. Contrôlez que les sections du PRD gardent leurs badges Enrichi par : la provenance de l'information doit rester lisible.
4. Vérifiez que la matrice ISTQB ferme le document.

RésultatLe rapport complet ouvert

Rapport complet exporté. Les 5 artefacts se suivent dans l'ordre de la chaîne. La matrice ISTQB, en fin de document, est la partie qu'un auditeur ouvre en premier.

→ Livrable client : un seul fichier, aucune dépendance à Needl.

Exporter la traçabilité

L'export de traçabilité ne fonctionne pas comme les autres : il propose trois sorties, dont un lot ciblé sur une seule user story. Cet article décrit les deux cas d'usage.

Exporter le rapport de traçabilité complet

1. Cliquez Exporter la traçabilité, en haut à droite (bouton vert).
2. Rapport complet — PDF : toutes les US, EXG et CT, plus la matrice ISTQB.
3. Rapport complet — Markdown : chaînes et matrice au format .md.

ÉcranMenu Exporter la traçabilité

Menu d'export de la traçabilité. Trois options. Le rapport complet PDF est le document d'audit : c'est lui qui contient la matrice ISTQB.

RésultatLe rapport de traçabilité ouvert

Rapport de traçabilité exporté. En-tête Chaînes de traçabilité et nombre de user stories analysées. Chaque story ouvre un bloc avec ses compteurs 3 EXG 4 CT, puis l'arborescence US → EXG → CT. Les lignes rouges « Non couvert par aucun cas de test » sont les trous de recette. La matrice ISTQB suit dans le même PDF.

→ Dossier prêt pour l'audit : chaque exigence est couverte, ou explicitement signalée comme trou.

Exporter le lot d'une seule user story

Le rapport complet fait des dizaines de pages. Le lot n'en fait qu'une : la chaîne d'une story et sa mini-matrice. C'est la pièce jointe idéale d'un ticket.

1. Restez en vue Colonnes et cliquez la story voulue à gauche : l'en-tête affiche « US-01 — 3 exigences · 4 cas de test ».
2. Cliquez Exporter la traçabilité. Le menu compte maintenant 4 options au lieu de 3.
3. Choisissez Lot US-01 — PDF ou Lot US-01 — Markdown.

ÉcranMenu d'export avec une story sélectionnée

Menu à 4 options. Le nom de l'option porte l'identifiant réel de la story : aucun risque d'exporter la mauvaise.

RésultatLe rapport de lot ouvert

Rapport « Lot d'une User Story ». Il tient sur une page. À gauche, l'arborescence US-01 → EXG-001…003 → CT-001…012. Les trous restent visibles. À droite, la matrice ISTQB réduite au périmètre, avec la légende N Nominal, E Erreur, L Limite.

→ Une page auto-portante par story.

Retrouver un projet

Mes projets est votre bibliothèque de dossiers, avec recherche, filtres par statut et actions sur chaque projet. Cet article décrit comment lire la liste.

Lire et filtrer la liste

1. Filtrez par statut : Tous / Actif / Partagé / Archivé.
2. Lisez la colonne Artefacts : les mentions PRD · US · EXG · CT indiquent l'avancement.
3. Basculez entre vue liste et vue grille avec les icônes à droite.
4. Cliquez un projet pour l'ouvrir.

ÉcranLa page Mes projets, vue liste

Mes projets. Filtres de statut en haut, colonne Artefacts pour l'avancement, bascule liste/grille à droite.

→ Un projet sans badge US n'a pas dépassé le PRD.

Les trois statuts

Si ça bloque

Renommer, archiver ou supprimer un projet

Toutes les actions sur un projet passent par le menu contextuel … de sa ligne. Cet article décrit chaque action et sa portée.

Ouvrir le menu contextuel

1. Cliquez le menu … à droite de la ligne du projet.
2. Renommer : le nom automatique est rarement le bon.
3. Partager ou Archiver : bascule le statut du projet.
4. Supprimer : action définitive, affichée en rouge.

ÉcranLe menu contextuel d'un projet

Menu … d'un projet. Renommer, Partager, Archiver, Supprimer. Le statut se change aussi depuis l'en-tête de la fiche projet.

Partager un projet

Le partage se fait par lien, avec deux niveaux de permission. La duplication ne se déclenche pas depuis votre compte : elle s'autorise, et c'est le destinataire qui crée sa propre copie.

Ouvrir le partage et choisir la permission

1. Ouvrez le projet, puis cliquez Partager (menu … de la liste, ou badge de statut dans l'en-tête).
2. Choisissez la permission dans la modale Partager le projet.
3. Cliquez Copier à droite du lien de partage.
4. Envoyez le lien à la personne concernée.

ÉcranModale Partager le projet

Modale « Partager le projet ». Les deux permissions, le lien de partage et son bouton Copier. Le statut du projet passe à Partagé.

Les deux permissions

Côté destinataire

1. Il ouvre le lien needl.qalilab.com/shared/… dans son navigateur, connecté à son compte.
2. Il crée sa copie depuis la vue partagée.
3. La copie apparaît dans ses projets, avec le suffixe (copie).

Couper le partage

Dans la même modale, Désactiver le partage → bouton Révoquer. Le lien cesse de fonctionner.

Si ça bloque

Gérer les versions et régénérer

Needl conserve chaque génération sous forme de version : rien n'est jamais écrasé. Cet article décrit comment comparer deux versions et dans quel ordre régénérer.

Comparer deux versions

1. Cliquez v1, v2… en haut du panneau.
2. Lisez le bandeau Origine : il indique ce qui a déclenché l'enrichissement (par exemple les décisions AMB-01 à AMB-03).

ÉcranLe PRD en version v2

Onglets de version. Les onglets v1 / v2 existent sur le PRD et les User Stories. Le bandeau Origine explique l'enrichissement.

Quand régénérer, et quoi

Checklists de contrôle

Trois moments où une vérification de deux minutes évite une reprise complète. À utiliser tels quels, avant de passer à la suite.

Avant de valider la reformulation

C'est le point de non-retour du cadrage : ce texte est la seule base du dossier.

• Le rôle qui utilise est nommé précisément, pas « l'utilisateur ».
• Ce qui est exclu est écrit noir sur blanc, pas seulement sous-entendu.
• Aucun choix technique ni élément de planning ne s'est glissé dans le texte.
• Les cas de figure sont listés un par un, pas résumés par un verbe générique.

→ Valider la reformulation

Avant de lancer la recette

Un cahier de recette exécutable ne se reconnaît pas au nombre de cas, mais à leur couverture.

• Les onglets Sécurité et RGPD/Légal ont été lus, pas seulement les exigences fonctionnelles.
• Chaque exigence a au moins un cas Nominal et un cas Erreur.
• Aucun cas marqué AMB ou HYP ne part en exécution sans arbitrage écrit.
• Les cas corrigés à la main ont été exportés — la régénération les écrase.
• Le nombre d'exigences non couvertes est connu et communiqué.

→ Vérifier la couverture des cas de test

Avant d'envoyer au client

Le fichier quitte Needl : plus personne ne pourra le corriger sans renvoyer une nouvelle version.

• Le rapport a été ouvert et relu après téléchargement, pas seulement généré.
• La matrice ISTQB ferme bien le document, si c'est le rapport complet ou la traçabilité.
• Chaque lacune restante a une raison écrite ailleurs que dans votre tête.
• Le projet porte un nom explicite, pas Nouveau projet · JJ/MM/AAAA.
• Si vous partagez un lien : la permission est Lecture seule, sauf raison de dupliquer.

→ Exporter le rapport complet

Glossaire

Les termes de l'interface et du métier, définis simplement. À lire une fois, à revenir consulter au besoin.

Les artefacts

Le cadrage

Le vocabulaire de test

Le pilotage du dossier

Les lecteurs du dossier

Identifiants et badges

Page de référence à consulter ponctuellement : la signification de chaque identifiant et de chaque badge de l'interface.

Identifiants

Badges

Statuts d'un projet

Navigation

Dépannage

Repérez votre symptôme, lisez la cause, appliquez la solution.

Limites connues

Ce que Needl ne fait pas — pour ne pas le chercher.

Fonctions absentes du produit

Comportements à connaître

Captures encore à fournir

Périmètre de ce guide

Ce guide décrit Needl tel qu'observé dans l'application needl.qalilab.com et illustré par les 42 captures de ce document. Il ne couvre ni l'architecture technique, ni le modèle de données, ni les API. Il doit être mis à jour à chaque évolution de l'interface.