rpa_vision_v3/docs/guides/GUIDE_DEMARRAGE_RAPIDE.md

🚀 Guide de Démarrage Rapide - RPA Vision V3

Auteur : Dom, Alice, Kiro - 8 janvier 2026
Version : 3.0 - Système unifié et testé

📋 Prérequis Vérifiés

✅ Environnement complet testé et fonctionnel

• Python 3.8+ (testé avec 3.12.3)
• Node.js 14+ (testé avec 18.19.1)
• npm (testé avec 9.2.0)
• Environnement virtuel venv_v3 configuré

🎯 Lancement Rapide (Recommandé)

Option 1 : Système Complet (Recommandé)

# Lance tous les services en une commande
./run.sh --full

Services démarrés :

• 🌐 API REST (port 8000)
• 📊 Dashboard Web (port 5001)
• 📈 Interface de monitoring (port 5003)
• 🔧 Visual Workflow Builder (port 3000)
• 🖥️ Interface GUI PyQt5

Option 2 : Visual Workflow Builder Seul

cd visual_workflow_builder
./start_full.sh

Services démarrés :

• 🔧 Backend VWB (port 5002)
• 🎨 Frontend React (port 3000)

Option 3 : Lancement Orchestré Complet

# Lance tout avec monitoring avancé
./launch_all.sh

🌐 URLs d'Accès

Une fois lancé, accédez aux interfaces :

Service	URL	Description
Visual Workflow Builder	http://localhost:3000	Interface principale de création de workflows
API REST	http://localhost:8000	API pour intégrations externes
Dashboard Web	http://localhost:5001	Monitoring et administration
Monitoring	http://localhost:5003	Métriques système en temps réel
VWB Backend	http://localhost:5002	API backend du constructeur

🧪 Tests et Validation

Test Système Complet

# Vérifie que tout est prêt
python3 test_systeme_complet_final.py

Tests Rapides

# Tests fonctionnels rapides
./run.sh --test-quick

Tests Spécifiques

# Tests des corrections BBOX (Fiche #2)
./run.sh --test-bbox

# Tests complets
./run.sh --test

🔧 Commandes Utiles

Gestion des Services

# Vérifier le statut des services
./run.sh --status

# Arrêter tous les services
./run.sh --stop

# Réinstaller les dépendances
./run.sh --reinstall

Monitoring et Logs

# Voir les logs en temps réel
tail -f logs/*.log

# Logs spécifiques
tail -f logs/api.log          # API REST
tail -f logs/dashboard.log    # Dashboard
tail -f logs/workflow.log     # Visual Workflow Builder

Composants Individuels

# Lancer seulement l'API
./run.sh --server

# Lancer seulement le dashboard
./run.sh --dashboard

# Lancer l'agent de capture
./run.sh --agent

# Lancer l'interface GUI
./run.sh --gui  # ou simplement ./run.sh

🎮 Démonstrations

# Démonstrations interactives
./run.sh --demo

# Choisir parmi :
# 1. Démo d'intégration complète
# 2. Démo d'automatisation
# 3. Démo de self-healing

🛠️ Dépannage

Problèmes de Ports

Si des ports sont occupés :

# Nettoyer les processus existants
./launch_all.sh  # Inclut un nettoyage automatique

Problèmes de Dépendances

# Réinstaller toutes les dépendances
./run.sh --reinstall

# Pour le frontend VWB spécifiquement
cd visual_workflow_builder/frontend
npm install

Vérification de l'Environnement

# Test complet de l'environnement
./run.sh --check

📊 Architecture des Services

RPA Vision V3 - Architecture Complète
├── 🌐 API REST (port 8000)
│   ├── Endpoints de téléchargement
│   ├── Gestion des sessions
│   └── Queue de traitement
├── 📊 Dashboard Web (port 5001)
│   ├── Monitoring en temps réel
│   ├── Gestion des workflows
│   └── Analytics
├── 🔧 Visual Workflow Builder (port 3000)
│   ├── Interface React/TypeScript
│   ├── Backend Flask (port 5002)
│   └── Éditeur visuel de workflows
├── 📈 Monitoring (port 5003)
│   ├── Métriques système
│   ├── Statut des services
│   └── Logs centralisés
└── 🖥️ Interface GUI PyQt5
    ├── Contrôle local
    ├── Capture d'écran
    └── Orchestration

🎯 Fonctionnalités Clés Testées

✅ Corrections Appliquées :

• Fiche #1 & #2 : Corrections BBOX et précision améliorée (~95%)
• Unification des contrats de données
• Architecture 5 couches stabilisée
• Tests de propriétés implémentés

✅ Composants Fonctionnels :

• Capture d'écran en temps réel
• Détection hybride (OpenCV + CLIP + VLM)
• Apprentissage progressif
• Self-healing automatique
• Analytics et monitoring

🚨 Points d'Attention

1. Premier Lancement : Le premier démarrage peut prendre 2-3 minutes (installation des dépendances)
2. Ressources : Le mode --full utilise plus de ressources (recommandé 8GB RAM)
3. GPU : Optionnel mais recommandé pour les performances
4. Ollama : Optionnel pour les modèles VLM avancés

📞 Support

En cas de problème :

1. Exécuter python3 test_systeme_complet_final.py pour diagnostiquer
2. Vérifier les logs dans le répertoire logs/
3. Utiliser ./run.sh --check pour valider l'environnement

---

🎉 Le système RPA Vision V3 est maintenant prêt pour vos tests et démonstrations !