# Guide d'utilisation — AI QA Workflow

## 1. Prérequis

- **IDE avec agent IA** : VS Code (Copilot), Cursor, Codex, OpenCode, Claude Code...
- **Node.js 18+**
- Navigateur Chromium

---

## 2. Créer un dossier de test

```bash
mkdir mon-projet-qa
cd mon-projet-qa
```

---

## 3. Installer le template

```bash
npx @ai-qa/workflow init --yes
```

---

## 4. Installer les dépendances

Consultez le fichier `README.md` → section **Dépendances requises** puis installez :

```bash
npm install -D @playwright/test @types/node allure-playwright allure-commandline
npx playwright install chromium
```

---

## 5. Rédiger une User Story

Créez un fichier dans le dossier `user-story/` :

```markdown
# US-ALIM-01 : Alimentation de Solde

**Rôle** : Agent SB
**Étapes** :
- Se connecter
- Naviguer vers "Demande alimentation et CASH"
- Saisir Montant=100, Mode=Virement
- Joindre un fichier, cliquer Suivant
```

---

## 6. Lancer le pipeline IA

Ouvrez le projet dans votre IDE avec agent IA, puis envoyez ce prompt :

```text
"Read router.md and follow the QA workflow for user-story/US-ALIM-01.md"
```

### C'est quoi `router.md` ?

Le fichier `router.md` est le **plan de mission** de l'agent IA. Il définit :
- Les phases du workflow (Environment Check → Plan → Generate → Execute → Heal → Report)
- Les fichiers agents à utiliser (`playwright-test-planner.agent.md`, etc.)
- Les règles de validation humaine à chaque étape

En bref : **router.md dit à l'IA comment faire son travail.**

---

## 7. Résultat attendu

L'IA va :
1. Explorer l'application via le navigateur
2. Générer un plan de test dans `specs/`
3. **STOP** → vous validez

---

## 8. Superviser chaque étape

### Phase Plan
- Vérifiez le fichier `specs/US-ALIM-01-test-plan.md`
- Approuvez ou demandez des modifications

### Phase Generate
- Vérifiez le fichier `tests/US-ALIM-01.spec.ts`
- Vérifiez les sélecteurs, les assertions
- Approuvez avant exécution

---

## 9. Exécuter les tests

```bash
npx playwright test tests/US-ALIM-01.spec.ts
```

Ou via le pipeline :

```bash
npm run qa:execute US-ALIM-01
```

---

## 10. Visualiser les résultats

### Option A : Rapport Allure

```bash
npm run qa:report:allure
allure open allure-report
```

### Option B : Dashboard local

```bash
npm run dashboard
# → http://localhost:4000
```

---

## Résumé du workflow

```text
1. Prérequis (IDE + Node.js)
2. Dossier de test
3. npx init
4. npm install dépendances
5. User story → user-story/
6. Prompt : "Read router.md..."
7. L'IA explore + plan → specs/  ← vous validez
8. L'IA génère tests → tests/    ← vous validez
9. npx playwright test
10. allure open ou npm run dashboard
```
