# 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.