# Guide de Tests Utilisateur - Visual Workflow Builder

Ce guide vous permet de tester toutes les fonctionnalités du Visual Workflow Builder pour vous assurer que tout fonctionne correctement.

## 🚀 Démarrage Rapide

### 1. Lancement de l'Application

```bash
cd visual_workflow_builder
./launch.sh start --dev02
```

Attendez que les messages suivants apparaissent :
- ✅ Backend démarré avec succès sur le port 5002
- ✅ Frontend démarré avec succès sur le port 3000

### 2. Accès à l'Interface

Ouvrez votre navigateur et allez sur : **http://localhost:3000**

## 📋 Tests de Fonctionnalités

### Test 1 : Interface Utilisateur de Base

**Objectif :** Vérifier que l'interface se charge correctement

**Étapes :**
1. ✅ L'interface se charge sans erreur
2. ✅ La palette de gauche est visible avec les catégories d'outils
3. ✅ Le canvas central est vide et prêt à recevoir des éléments
4. ✅ Le panneau de propriétés de droite est visible
5. ✅ La barre d'outils supérieure contient tous les boutons

**Résultat attendu :** Interface complète et fonctionnelle

---

### Test 2 : Création d'un Workflow Simple

**Objectif :** Créer un workflow basique avec 3 étapes

**Étapes :**
1. **Ajouter une étape "Naviguer" :**
   - Cliquez sur "Actions Web" dans la palette
   - Glissez "Naviguer" sur le canvas
   - ✅ L'étape apparaît sur le canvas

2. **Configurer l'étape "Naviguer" :**
   - Cliquez sur l'étape pour la sélectionner
   - Dans le panneau de propriétés, saisissez l'URL : `https://example.com`
   - ✅ Le paramètre est sauvegardé

3. **Ajouter une étape "Cliquer" :**
   - Glissez "Cliquer" depuis la palette
   - Connectez "Naviguer" à "Cliquer" en tirant une flèche
   - ✅ La connexion est créée

4. **Configurer l'étape "Cliquer" :**
   - Sélectionnez l'étape "Cliquer"
   - Dans "Élément cible", cliquez sur le bouton de sélection
   - ✅ Le sélecteur d'élément s'ouvre

5. **Ajouter une étape "Attendre" :**
   - Glissez "Attendre" depuis la palette
   - Connectez "Cliquer" à "Attendre"
   - Configurez la durée : 2000ms
   - ✅ Workflow complet avec 3 étapes connectées

**Résultat attendu :** Workflow fonctionnel avec 3 étapes connectées

---

### Test 3 : Sélection Interactive d'Éléments

**Objectif :** Tester le sélecteur d'éléments interactif

**Étapes :**
1. **Ouvrir le sélecteur :**
   - Sélectionnez une étape "Cliquer"
   - Cliquez sur le bouton de sélection d'élément cible
   - ✅ Une capture d'écran apparaît

2. **Sélectionner un élément :**
   - Cliquez sur un élément dans la capture d'écran
   - ✅ L'élément est surligné
   - ✅ Les propriétés de l'élément sont affichées

3. **Valider la sélection :**
   - Cliquez sur "Utiliser cet élément"
   - ✅ Le sélecteur se ferme
   - ✅ L'élément cible est configuré dans les propriétés

**Résultat attendu :** Sélection d'élément fonctionnelle avec retour visuel

---

### Test 4 : Gestion des Variables

**Objectif :** Créer et utiliser des variables

**Étapes :**
1. **Créer une variable :**
   - Glissez "Variable" depuis la catégorie "Données"
   - Configurez : Nom = "mon_texte", Valeur = "Hello World"
   - ✅ Variable créée

2. **Utiliser la variable :**
   - Ajoutez une étape "Saisir du texte"
   - Dans le champ texte, saisissez : `${mon_texte}`
   - ✅ La référence de variable est acceptée

3. **Extraire une variable :**
   - Ajoutez une étape "Extraire"
   - Configurez la variable de destination : "resultat"
   - ✅ Configuration d'extraction réussie

**Résultat attendu :** Variables créées et utilisées correctement

---

### Test 5 : Logique Conditionnelle

**Objectif :** Tester les conditions et boucles

**Étapes :**
1. **Ajouter une condition :**
   - Glissez "Condition" depuis "Logique"
   - Configurez l'expression : `${resultat} == "OK"`
   - ✅ Condition créée avec 2 ports de sortie

2. **Connecter les branches :**
   - Connectez le port "true" à une étape
   - Connectez le port "false" à une autre étape
   - ✅ Branchement conditionnel configuré

3. **Ajouter une boucle :**
   - Glissez "Boucle" depuis "Logique"
   - Configurez : Type = "repeat", Nombre = 3
   - ✅ Boucle configurée

**Résultat attendu :** Logique conditionnelle et boucles fonctionnelles

---

### Test 6 : Sauvegarde et Chargement

**Objectif :** Tester la persistance des workflows

**Étapes :**
1. **Sauvegarder le workflow :**
   - Cliquez sur "Sauvegarder" dans la barre d'outils
   - ✅ Message de confirmation affiché
   - ✅ Bouton devient "Sauvegardé" avec icône verte

2. **Créer un nouveau workflow :**
   - Cliquez sur "Nouveau"
   - ✅ Canvas vidé
   - ✅ Nouveau workflow créé

3. **Tester l'export :**
   - Créez quelques étapes
   - Sauvegardez
   - ✅ Export possible (fonctionnalité future)

**Résultat attendu :** Sauvegarde et gestion des workflows fonctionnelle

---

### Test 7 : Exécution de Workflow

**Objectif :** Tester l'exécution d'un workflow simple

**Étapes :**
1. **Préparer un workflow simple :**
   - Créez : Attendre (1000ms) → Attendre (1000ms)
   - Sauvegardez le workflow
   - ✅ Workflow prêt pour l'exécution

2. **Lancer l'exécution :**
   - Cliquez sur "Exécuter"
   - ✅ Message "Exécution du workflow démarrée !"
   - ✅ Bouton devient "Exécution..." avec spinner

3. **Observer l'exécution :**
   - ✅ Les étapes s'illuminent pendant l'exécution
   - ✅ Progression visible sur les étapes
   - ✅ Message de fin d'exécution

**Résultat attendu :** Exécution visible avec feedback en temps réel

---

### Test 8 : Templates et Réutilisabilité

**Objectif :** Tester les templates prédéfinis

**Étapes :**
1. **Ouvrir les templates :**
   - Cliquez sur "Templates" dans la barre d'outils
   - ✅ Sélecteur de templates s'ouvre

2. **Sélectionner un template :**
   - Choisissez un template disponible
   - Configurez les paramètres demandés
   - ✅ Workflow créé à partir du template

3. **Sauver comme template :**
   - Créez un workflow personnalisé
   - Cliquez sur "Sauver Template"
   - Configurez le nom et les paramètres
   - ✅ Template personnalisé créé

**Résultat attendu :** Templates fonctionnels et personnalisables

---

### Test 9 : Analytics et Monitoring

**Objectif :** Vérifier les métriques et analytics

**Étapes :**
1. **Ouvrir le dashboard Analytics :**
   - Cliquez sur "Analytics" dans la barre d'outils
   - ✅ Dashboard Analytics s'ouvre

2. **Vérifier les métriques :**
   - ✅ Métriques d'exécution affichées
   - ✅ Graphiques de performance visibles
   - ✅ Historique des exécutions disponible

3. **Analyser les données :**
   - ✅ Taux de succès calculé
   - ✅ Durées moyennes affichées
   - ✅ Tendances visibles

**Résultat attendu :** Analytics complètes et informatives

---

### Test 10 : Raccourcis Clavier et UX

**Objectif :** Tester l'expérience utilisateur avancée

**Étapes :**
1. **Tester les raccourcis :**
   - `Ctrl+Z` : Annuler ✅
   - `Ctrl+Y` : Refaire ✅
   - `Ctrl+S` : Sauvegarder ✅
   - `Suppr` : Supprimer l'élément sélectionné ✅
   - `Ctrl+C/V` : Copier/Coller ✅

2. **Tester l'aide contextuelle :**
   - Cliquez sur l'icône clavier dans la barre d'outils
   - ✅ Aide des raccourcis s'affiche
   - Appuyez sur `F1` sur un élément sélectionné
   - ✅ Documentation contextuelle s'ouvre

3. **Tester la navigation :**
   - Zoom avec la molette de souris ✅
   - Panoramique en glissant ✅
   - Fit-to-screen avec double-clic ✅

**Résultat attendu :** Interface fluide et intuitive

---

## 🔧 Tests Techniques

### Test de Performance

**Objectif :** Vérifier les performances avec un workflow complexe

**Étapes :**
1. Créez un workflow avec 20+ étapes
2. Connectez toutes les étapes en séquence
3. Ajoutez des conditions et boucles
4. ✅ Interface reste fluide
5. ✅ Sauvegarde rapide (< 2 secondes)
6. ✅ Exécution sans blocage

### Test de Robustesse

**Objectif :** Tester la gestion d'erreurs

**Étapes :**
1. **Paramètres manquants :**
   - Créez une étape sans configurer les paramètres requis
   - ✅ Avertissements visuels affichés
   - ✅ Exécution bloquée avec message explicite

2. **Connexions invalides :**
   - Tentez de créer des cycles dans le workflow
   - ✅ Validation empêche les cycles
   - ✅ Message d'erreur explicite

3. **Récupération d'erreurs :**
   - Fermez et rouvrez l'application
   - ✅ État précédent restauré
   - ✅ Pas de perte de données

---

## 📊 Critères de Validation

### ✅ Fonctionnalités Essentielles
- [ ] Interface utilisateur complète et responsive
- [ ] Création de workflows par glisser-déposer
- [ ] Configuration des paramètres avec validation
- [ ] Sélection interactive d'éléments UI
- [ ] Gestion des variables et expressions
- [ ] Logique conditionnelle et boucles
- [ ] Sauvegarde et chargement des workflows
- [ ] Exécution avec feedback temps réel
- [ ] Templates et réutilisabilité
- [ ] Analytics et monitoring

### ✅ Qualité Utilisateur
- [ ] Interface intuitive et claire
- [ ] Messages d'erreur explicites
- [ ] Raccourcis clavier fonctionnels
- [ ] Performance fluide (< 2s pour les opérations)
- [ ] Aide contextuelle disponible
- [ ] Récupération d'erreurs gracieuse

### ✅ Intégration Technique
- [ ] Connexion avec le système RPA Vision V3
- [ ] APIs de capture d'écran fonctionnelles
- [ ] Détection d'éléments UI opérationnelle
- [ ] Conversion vers WorkflowGraph correcte
- [ ] Exécution via ExecutionLoop
- [ ] Analytics intégrées

---

## 🚨 Problèmes Connus et Solutions

### Problème : Capture d'écran ne fonctionne pas
**Solution :** Vérifiez que le backend a accès aux permissions d'écran

### Problème : Exécution bloquée
**Solution :** Vérifiez que tous les paramètres requis sont configurés

### Problème : Interface lente
**Solution :** Réduisez le nombre d'éléments sur le canvas ou redémarrez l'application

---

## 📞 Support

Si vous rencontrez des problèmes :

1. **Vérifiez les logs :**
   ```bash
   ./launch.sh logs
   ```

2. **Redémarrez l'application :**
   ```bash
   ./launch.sh restart
   ```

3. **Testez les connexions API :**
   ```bash
   python test_api_connections_complete.py
   ```

4. **Vérifiez le statut :**
   ```bash
   ./launch.sh status
   ```

---

## ✅ Validation Finale

Une fois tous les tests passés, le Visual Workflow Builder est prêt pour :
- ✅ Utilisation en production
- ✅ Formation des utilisateurs
- ✅ Déploiement étendu
- ✅ Intégration dans le système RPA Vision V3

**Bon test ! 🚀**