a7de6a488b
Validé sur PC Windows (DESKTOP-58D5CAC, 2560x1600) : - 8 clics résolus visuellement (1 anchor_template, 1 som_text_match, 6 som_vlm) - Score moyen 0.75, temps moyen 1.6s - Texte tapé correctement (bonjour, test word, date, email) - 0 retries, 2 actions non vérifiées (OK) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
177 lines
6.3 KiB
Markdown
177 lines
6.3 KiB
Markdown
# Système d'Exécution VWB - Spécifications
|
|
|
|
**Auteur :** Dom, Alice, Kiro - 10 janvier 2026
|
|
**Phase :** 3.1 - Intégration et Exécution VWB
|
|
**Priorité :** Critique
|
|
**Dépendances :** Phase 2 complète (Propriétés d'étapes VWB ✅)
|
|
|
|
## Vue d'Ensemble
|
|
|
|
Implémenter le système d'exécution des actions VisionOnly dans le Visual Workflow Builder, permettant l'exécution fluide des workflows avec feedback visuel en temps réel et gestion des états d'exécution.
|
|
|
|
## User Stories
|
|
|
|
### US-3.1.1 : Exécution d'Actions VWB
|
|
**En tant qu'** utilisateur du VWB
|
|
**Je veux** pouvoir exécuter des workflows contenant des actions VisionOnly
|
|
**Afin de** automatiser des tâches avec reconnaissance visuelle
|
|
|
|
**Critères d'acceptation :**
|
|
- [ ] Les actions VWB s'exécutent depuis l'interface VWB
|
|
- [ ] Les paramètres configurés sont transmis correctement
|
|
- [ ] Les Evidence sont générées et affichées
|
|
- [ ] Les erreurs sont gérées avec messages clairs
|
|
|
|
### US-3.1.2 : États Visuels d'Exécution
|
|
**En tant qu'** utilisateur du VWB
|
|
**Je veux** voir l'état d'exécution de chaque étape en temps réel
|
|
**Afin de** suivre le progrès et identifier les problèmes
|
|
|
|
**Critères d'acceptation :**
|
|
- [ ] États visuels clairs sur le canvas (en cours, succès, erreur)
|
|
- [ ] Indicateurs de progression pour les étapes longues
|
|
- [ ] Mise en évidence de l'étape en cours d'exécution
|
|
- [ ] Historique des exécutions accessible
|
|
|
|
### US-3.1.3 : Feedback Visuel en Temps Réel
|
|
**En tant qu'** utilisateur du VWB
|
|
**Je veux** voir les Evidence générées pendant l'exécution
|
|
**Afin de** comprendre ce que fait l'automatisation
|
|
|
|
**Critères d'acceptation :**
|
|
- [ ] Affichage automatique des Evidence après chaque action
|
|
- [ ] Screenshots avec annotations des zones cliquées
|
|
- [ ] Logs d'exécution détaillés
|
|
- [ ] Possibilité de pause/reprise de l'exécution
|
|
|
|
### US-3.1.4 : Gestion des Erreurs d'Exécution
|
|
**En tant qu'** utilisateur du VWB
|
|
**Je veux** être informé clairement des erreurs d'exécution
|
|
**Afin de** pouvoir corriger les problèmes rapidement
|
|
|
|
**Critères d'acceptation :**
|
|
- [ ] Messages d'erreur clairs en français
|
|
- [ ] Possibilité de retry automatique ou manuel
|
|
- [ ] Sauvegarde de l'état avant erreur
|
|
- [ ] Suggestions de correction
|
|
|
|
## Exigences Fonctionnelles
|
|
|
|
### EF-3.1.1 : Intégration avec l'Executor Existant
|
|
- Étendre le composant `Executor/index.tsx` pour supporter les actions VWB
|
|
- Maintenir la compatibilité avec les actions existantes
|
|
- Utiliser l'API catalogue pour l'exécution des actions VisionOnly
|
|
|
|
### EF-3.1.2 : États d'Exécution sur le Canvas
|
|
- Implémenter les états visuels sur les nœuds du canvas
|
|
- États : IDLE, RUNNING, SUCCESS, ERROR, PAUSED
|
|
- Animations fluides pour les transitions d'état
|
|
- Indicateurs de progression pour les actions longues
|
|
|
|
### EF-3.1.3 : Affichage des Evidence
|
|
- Intégration avec le composant EvidenceViewer existant
|
|
- Affichage automatique des Evidence après chaque action
|
|
- Panneau dédié pour l'historique des exécutions
|
|
- Zoom et navigation dans les screenshots
|
|
|
|
### EF-3.1.4 : Contrôles d'Exécution
|
|
- Boutons Play/Pause/Stop pour contrôler l'exécution
|
|
- Exécution pas-à-pas pour le débogage
|
|
- Possibilité de reprendre depuis une étape spécifique
|
|
- Sauvegarde automatique de l'état d'exécution
|
|
|
|
## Exigences Non-Fonctionnelles
|
|
|
|
### ENF-3.1.1 : Performance
|
|
- Temps de réponse < 2s pour le démarrage d'exécution
|
|
- Interface fluide même pendant l'exécution
|
|
- Gestion mémoire optimisée pour les Evidence
|
|
- Pas de blocage de l'interface utilisateur
|
|
|
|
### ENF-3.1.2 : Robustesse
|
|
- Gestion des timeouts et erreurs réseau
|
|
- Récupération automatique après erreurs temporaires
|
|
- Validation des paramètres avant exécution
|
|
- Logs détaillés pour le débogage
|
|
|
|
### ENF-3.1.3 : Utilisabilité
|
|
- Interface intuitive avec contrôles clairs
|
|
- Messages d'état compréhensibles
|
|
- Raccourcis clavier pour les actions courantes
|
|
- Aide contextuelle intégrée
|
|
|
|
### ENF-3.1.4 : Compatibilité
|
|
- Fonctionne avec tous les navigateurs modernes
|
|
- Compatible avec les workflows existants
|
|
- Intégration transparente avec l'interface VWB
|
|
- Support des environnements Citrix/VDI
|
|
|
|
## Contraintes Techniques
|
|
|
|
### CT-3.1.1 : Architecture
|
|
- Utiliser React + TypeScript + Material-UI
|
|
- Respecter les patterns de hooks existants
|
|
- Intégration avec Redux pour la gestion d'état
|
|
- Communication via l'API REST du backend
|
|
|
|
### CT-3.1.2 : Sécurité
|
|
- Validation des paramètres côté client et serveur
|
|
- Gestion sécurisée des secrets et mots de passe
|
|
- Logs sans informations sensibles
|
|
- Authentification pour les actions critiques
|
|
|
|
### CT-3.1.3 : Monitoring
|
|
- Métriques de performance d'exécution
|
|
- Logs structurés pour l'analyse
|
|
- Alertes en cas d'erreurs critiques
|
|
- Tableau de bord de monitoring intégré
|
|
|
|
## Critères d'Acceptation Globaux
|
|
|
|
### Critères Fonctionnels
|
|
- [ ] Toutes les actions VWB s'exécutent correctement
|
|
- [ ] États visuels clairs et informatifs sur le canvas
|
|
- [ ] Evidence affichées automatiquement après exécution
|
|
- [ ] Contrôles d'exécution fonctionnels (play/pause/stop)
|
|
- [ ] Gestion d'erreurs avec messages clairs
|
|
- [ ] Tests end-to-end réussis
|
|
|
|
### Critères de Performance
|
|
- [ ] Démarrage d'exécution < 2s
|
|
- [ ] Interface fluide pendant l'exécution
|
|
- [ ] Gestion mémoire optimisée
|
|
- [ ] Pas de fuite mémoire lors d'exécutions longues
|
|
|
|
### Critères de Qualité
|
|
- [ ] Code commenté en français
|
|
- [ ] Tests unitaires et d'intégration
|
|
- [ ] Documentation utilisateur
|
|
- [ ] Respect des conventions du projet
|
|
|
|
## Risques et Mitigation
|
|
|
|
### Risque 1 : Performance dégradée
|
|
**Impact :** Moyen
|
|
**Probabilité :** Faible
|
|
**Mitigation :** Tests de performance réguliers, optimisation des rendus
|
|
|
|
### Risque 2 : Complexité d'intégration
|
|
**Impact :** Élevé
|
|
**Probabilité :** Moyen
|
|
**Mitigation :** Développement incrémental, tests d'intégration continus
|
|
|
|
### Risque 3 : Gestion des erreurs complexe
|
|
**Impact :** Moyen
|
|
**Probabilité :** Moyen
|
|
**Mitigation :** Framework d'erreurs standardisé, tests d'erreurs exhaustifs
|
|
|
|
## Définition de "Terminé"
|
|
|
|
Une tâche est considérée comme terminée quand :
|
|
- [ ] Tous les critères d'acceptation sont validés
|
|
- [ ] Tests automatisés passent (couverture > 80%)
|
|
- [ ] Code reviewé et approuvé
|
|
- [ ] Documentation mise à jour
|
|
- [ ] Démo fonctionnelle réalisée
|
|
- [ ] Performance validée
|
|
- [ ] Intégration avec l'existant confirmée |