Dom/rpa_vision_v3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
a7de6a488b8269927a6eb78adea3c9632acc3f33
rpa_vision_v3/.kiro/specs/systeme-execution-vwb/requirements.md
Dom a7de6a488b feat: replay E2E fonctionnel — 25/25 actions, 0 retries, SomEngine via serveur 
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>
2026-03-31 14:04:41 +02:00

6.3 KiB
Raw Blame History

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
Reference in New Issue View Git Blame Copy Permalink