rpa_vision_v3/docs/guides/GUIDE_LANCEMENT_UNIFIE.md

Guide de Lancement Unifié RPA Vision V3

Auteur : Dom, Alice Kiro
Date : 22 décembre 2024

Vue d'ensemble

Le script launch_all.sh permet de lancer tous les services RPA Vision V3 en une seule commande :

• Backend principal (API + Dashboard)
• Visual Workflow Builder (Frontend + Backend)
• Système de monitoring des logs
• Gestion automatique des processus

Utilisation

Lancement rapide

./launch_all.sh

Services démarrés automatiquement

Service	URL	Port	Description
API REST	http://localhost:8000	8000	API principale du système
Dashboard Web	http://localhost:5001	5001	Interface de monitoring
Visual Workflow Builder	http://localhost:3000	3000	Éditeur de workflows
VWB Backend	http://localhost:5002	5002	API du Visual Workflow Builder

Fonctionnalités

✅ Vérifications automatiques

• Prérequis système (Python, Node.js, npm)
• Environnement virtuel
• Répertoires de travail

🚀 Démarrage intelligent

• Démarrage séquentiel des services
• Attente de disponibilité des services
• Installation automatique des dépendances frontend si nécessaire

📊 Monitoring intégré

• Logs centralisés dans logs/
• Script de monitoring interactif
• Affichage en temps réel des statuts

🛑 Arrêt propre

• Capture de Ctrl+C
• Arrêt de tous les processus
• Nettoyage automatique

Logs et Monitoring

Fichiers de logs

logs/main_backend.log      # Backend principal
logs/vwb_backend.log       # Backend VWB
logs/vwb_frontend.log      # Frontend VWB
logs/npm_install.log       # Installation dépendances

Monitoring interactif

./logs/monitor_logs.sh     # Script de monitoring

Commandes utiles

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

# Tester l'API principale
curl http://localhost:8000/health

# Vérifier les services
netstat -tlnp | grep :500

Résolution de problèmes

Port déjà utilisé

Si un port est occupé, arrêtez les services existants :

pkill -f "python.*server"
pkill -f "npm.*start"

Dépendances manquantes

Le script installe automatiquement les dépendances, mais vous pouvez forcer :

cd visual_workflow_builder/frontend
npm install

Problèmes de permissions

Assurez-vous que le script est exécutable :

chmod +x launch_all.sh

Architecture des services

┌─────────────────┐    ┌─────────────────┐
│   Frontend VWB  │    │   Dashboard     │
│   Port 3000     │    │   Port 5001     │
└─────────┬───────┘    └─────────┬───────┘
          │                      │
          │ Proxy API            │ Direct
          │                      │
┌─────────▼───────┐    ┌─────────▼───────┐
│  Backend VWB    │    │  API Principale │
│  Port 5002      │    │  Port 8000      │
└─────────────────┘    └─────────────────┘

Intégration avec le système

Variables d'environnement

Le script respecte les variables d'environnement définies dans .env :

• PORT : Port personnalisé pour les services
• FLASK_ENV : Mode de développement/production
• CORS_ORIGINS : Origines autorisées pour CORS

Compatibilité

• ✅ Linux (testé)
• ✅ macOS (compatible)
• ⚠️ Windows (nécessite WSL ou adaptation)

Prochaines améliorations

• Support Docker Compose
• Configuration SSL/HTTPS
• Mode production avec Gunicorn
• Monitoring avancé avec Prometheus
• Auto-restart en cas de crash

---

Note : Ce guide fait partie du système RPA Vision V3 et suit les conventions du projet pour la documentation centralisée.