v1.0 - Version stable: multi-PC, détection UI-DETR-1, 3 modes exécution

- Frontend v4 accessible sur réseau local (192.168.1.40) - Ports ouverts: 3002 (frontend), 5001 (backend), 5004 (dashboard) - Ollama GPU fonctionnel - Self-healing interactif - Dashboard confiance Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 11:23:51 +01:00
parent 21bfa3b337
commit a27b74cf22
1595 changed files with 412691 additions and 400 deletions
--- a/docs/guides/GUIDE_LANCEMENT_UNIFIE.md
+++ b/docs/guides/GUIDE_LANCEMENT_UNIFIE.md
@@ -0,0 +1,140 @@
+# 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
+```bash
+./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
+```bash
+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
+```bash
+./logs/monitor_logs.sh     # Script de monitoring
+```
+
+### Commandes utiles
+```bash
+# 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 :
+```bash
+pkill -f "python.*server"
+pkill -f "npm.*start"
+```
+
+### Dépendances manquantes
+Le script installe automatiquement les dépendances, mais vous pouvez forcer :
+```bash
+cd visual_workflow_builder/frontend
+npm install
+```
+
+### Problèmes de permissions
+Assurez-vous que le script est exécutable :
+```bash
+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.