docs: ajouter les guides BDD pour experts métier et développeurs #11

Merged

f.piccinali merged 1 commit from docs/bdd-guides into main

2026-01-25 09:44:46 +01:00

bruno.d2b commented

2026-01-23 10:12:39 +01:00

Member

A challenger pour voir si les orientations poussées sont les nôtres.
Supprimer ou completer la checklist PR incluse selon ce qu'on veux.

BDD_Guide_Expert_Metier.md : comment rédiger des scénarios Gherkin en français
BDD_Guide_Developpeur.md : comment implémenter les steps en Python avec pytest-bdd

Guide Expert Métier

Structure des fichiers .feature
Mots-clés Gherkin en français (Fonctionnalité, Scénario, Quand, Alors...)
Fonctionnalités avancées : Plan du Scénario, tableaux de données, tags
Bonnes pratiques : style déclaratif, scénarios courts, valeurs concrètes
Anti-patterns à éviter
4 exemples réels du projet gradués par complexité

Guide Développeur

Architecture des tests (pac-bdd, pac0)
Implémentation des steps avec parsers.parse et parsers.re
Fixtures : WorldContext, contextes locaux Pydantic
Hooks pytest
Patterns courants : appels API, vérifications JSON, async
Debugging et checklist PR

J'ai parcouru le repo en m'appuyant sur l'IA pour mieux comprendre la démarche de test BDD. Du coup j'ai vu que deux guides étaient attendus. J'en fait avec l'aide de l'IA et une skill adaptée une rédaction des deux guides (https://mcpmarket.com/tools/skills/cucumber-gherkin-bdd). A challenger pour voir si les orientations poussées sont les nôtres. Supprimer ou completer la checklist PR incluse selon ce qu'on veux. - BDD_Guide_Expert_Metier.md : comment rédiger des scénarios Gherkin en français - BDD_Guide_Developpeur.md : comment implémenter les steps en Python avec pytest-bdd **Guide Expert Métier** - Structure des fichiers .feature - Mots-clés Gherkin en français (Fonctionnalité, Scénario, Quand, Alors...) - Fonctionnalités avancées : Plan du Scénario, tableaux de données, tags - Bonnes pratiques : style déclaratif, scénarios courts, valeurs concrètes - Anti-patterns à éviter - 4 exemples réels du projet gradués par complexité **Guide Développeur** - Architecture des tests (pac-bdd, pac0) - Implémentation des steps avec parsers.parse et parsers.re - Fixtures : WorldContext, contextes locaux Pydantic - Hooks pytest - Patterns courants : appels API, vérifications JSON, async - Debugging et checklist PR

bruno.d2b added 1 commit

2026-01-23 10:12:39 +01:00

docs: ajouter les guides BDD pour experts métier et développeurs 252028e99f

Deux guides complémentaires pour la rédaction et l'implémentation des tests BDD :

- BDD_Guide_Expert_Metier.md : comment rédiger des scénarios Gherkin en français
- BDD_Guide_Developpeur.md : comment implémenter les steps en Python avec pytest-bdd