rpa_vision_v3/visual_workflow_builder/GUIDE_TESTS_UTILISATEUR.md

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

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 :

   ./launch.sh logs
   

2. Redémarrez l'application :

   ./launch.sh restart
   

3. Testez les connexions API :

   python test_api_connections_complete.py
   

4. Vérifiez le statut :

   ./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 ! 🚀