qa360 2.1.7 → 2.2.0

package/docs/archive/obsolete-proposals/qa360-quick-start-guide.md

@@ -0,0 +1,298 @@
+# QA360 - Guide de Démarrage Rapide
+
+**Version** : 2.1.1
+**Durée totale** : 15-30 minutes
+**Niveau requis** : Aucun
+
+---
+
+## 🎯 Ce guide est pour vous si...
+
+- Vous découvrez QA360
+- Vous n'êtes pas développeur
+- Vous voulez tester rapidement
+- Vous êtes chef de projet, tester, ou analyste
+
+---
+
+## ⚡ Installation (2 minutes)
+
+### Étape 1 : Installer Node.js
+
+Ouvrez un terminal et tapez :
+
+```bash
+node --version
+```
+
+**Si vous voyez un numéro (ex: `v20.x.x`)** → C'est installé, passez à l'étape 2
+
+**Si vous voyez une erreur** → Téléchargez Node.js sur [nodejs.org](https://nodejs.org)
+
+### Étape 2 : Installer QA360
+
+```bash
+npm install -g qa360@latest
+```
+
+### Étape 3 : Vérifier l'installation
+
+```bash
+qa360 --version
+```
+
+Vous devriez voir : `2.1.1` (ou supérieur)
+
+✅ **Installation terminée !**
+
+---
+
+## 🚀 Vos 3 premiers tests (10 minutes)
+
+### Test 1 : Scanner un site web (2 minutes)
+
+Comprendre ce qui est testable sur un site.
+
+**Copiez-collez cette commande :**
+
+```bash
+qa360 scan https://example.com
+```
+
+**Résultat attendu :**
+
+```
+✅ Buttons found: X
+✅ Links found: XX
+✅ Images found: XX
+✅ Headings found: XX
+📦 Total elements: XX
+✨ Scan completed
+```
+
+### Test 2 : Lancer un test automatique (3 minutes)
+
+QA360 génère automatiquement un test à partir du scan.
+
+**Copiez-collez :**
+
+```bash
+qa360 scan https://example.com --auto-generate-test
+```
+
+Puis exécutez le test :
+
+```bash
+qa360 run .qa360/discovery/elements.yml
+```
+
+**Résultat attendu :**
+
+```
+✅ All quality gates passed!
+🎯 Trust Score: 100%
+```
+
+### Test 3 : Voir l'historique (1 minute)
+
+```bash
+qa360 history list
+```
+
+Vous verrez tous les tests que vous avez lancés.
+
+✅ **Vos 3 premiers tests sont terminés !**
+
+---
+
+## 📋 Checklist de test (pour votre projet)
+
+Remplacez `https://votre-site.com` par votre URL.
+
+### Scanner votre site
+
+```bash
+qa360 scan https://votre-site.com --auto-generate-test
+```
+
+- [ ] Scan terminé sans erreur
+- [ ] Fichier `.qa360/discovery/elements.yml` créé
+
+### Lancer le test généré
+
+```bash
+qa360 run
+```
+
+- [ ] Test exécuté
+- [ ] Trust Score affiché
+- [ ] Rapport généré
+
+### Vérifier le résultat
+
+```bash
+qa360 history list
+qa360 history show [RUN_ID]
+```
+
+- [ ] Historique visible
+- [ ] Détails du test consultables
+
+---
+
+## 🎨 Les 3 commandes essentielles
+
+| Commande | À quoi ça sert | À utiliser |
+|----------|----------------|------------|
+| `qa360 scan <URL>` | Découvrir les éléments d'un site | Avant de créer des tests |
+| `qa360 run` | Exécuter les tests | Pour valider votre site |
+| `qa360 history list` | Voir les résultats passés | Pour suivre l'évolution |
+
+---
+
+## 📊 Comprendre les résultats
+
+### Trust Score (Score de Confiance)
+
+| Score | Signification |
+|-------|---------------|
+| 100% | Tout est parfait |
+| 75-99% | Quelques problèmes mineurs |
+| 50-74% | Problèmes modérés |
+| < 50% | Problèmes critiques |
+
+### Gates (Portes de validation)
+
+Chaque "gate" est une catégorie de test :
+
+- **ui-smoke** : Test rapide de l'interface
+- **api-smoke** : Test rapide de l'API
+- **security** : Tests de sécurité
+- **a11y** : Accessibilité
+
+---
+
+## 🆘 Problèmes courants
+
+### "Command not found: qa360"
+
+**Solution** : Redémarrez votre terminal après l'installation
+
+### "Cannot find module"
+
+**Solution** : Réinstallez avec `npm install -g qa360@latest`
+
+### Le scan est lent
+
+**Normal** : Premier scan télécharge les navigateurs (30-60 sec)
+
+---
+
+## 🎓 Suite : Les commandes utiles
+
+### Créer un test rapidement
+
+```bash
+qa360 init --template ui-basic
+```
+
+Répondez aux questions, puis :
+
+```bash
+qa360 run
+```
+
+### Générer un rapport PDF
+
+```bash
+qa360 report --format pdf
+```
+
+### Aide sur une commande
+
+```bash
+qa360 <commande> --help
+# Exemple : qa360 scan --help
+```
+
+---
+
+## 📞 Besoin d'aide ?
+
+- **Documentation complète** : [qa360.dev](https://qa360.dev) (si disponible)
+- **Liste des commandes** : `qa360 --help`
+- **Diagnostic** : `qa360 doctor`
+
+---
+
+## ✅ Félicitations !
+
+Vous savez maintenant :
+- [x] Installer QA360
+- [x] Scanner un site web
+- [x] Lancer un test
+- [x] Consulter les résultats
+
+**Prochaine étape** : Intégrez QA360 dans votre workflow de test continu !
+
+---
+
+**Temps total** : 15-30 minutes
+**Prérequis** : Aucun
+**Profil** : Tous
+
+---
+
+## Annexes : Guide par profil
+
+### 👔 Chef de Projet
+
+**Ce dont vous avez besoin :**
+- Scanner les sites de votre projet
+- Voir les Trust Scores
+- Générer des rapports PDF
+
+**Commandes clés :**
+```bash
+qa360 scan https://mon-site.com
+qa360 run
+qa360 report --format pdf
+```
+
+### 🧪 Tester Manuel
+
+**Ce dont vous avez besoin :**
+- Créer des tests UI
+- Exécuter les tests
+- Remonter les anomalies
+
+**Commandes clés :**
+```bash
+qa360 init --template ui-basic
+qa360 run
+qa360 history list
+```
+
+### 📊 Business Analyst
+
+**Ce dont vous avez besoin :**
+- Vérifier la disponibilité
+- Suivre les performances
+- Rapporter
+
+**Commandes clés :**
+```bash
+qa360 run
+qa360 history stats
+qa360 report
+```
+
+### 💻 Développeur
+
+**Tout est disponible dans le guide complet :**
+- Voir `qa360-comprehensive-test-plan.md`
+
+---
+
+**Version du document** : 1.0
+**Date** : 2026-01-10