# 🎼 RPA Vision V3 - Chef d'Orchestre Guide

**Auteur**: Dom, Alice Kiro  
**Date**: 15 décembre 2024  
**Objectif**: Guide complet du nouveau `run.sh` - Chef d'Orchestre

## 🚀 **Nouveau run.sh - Fonctionnalités**

Le `run.sh` a été transformé en véritable **Chef d'Orchestre** qui lance et gère tout l'écosystème RPA Vision V3 !

---

## 🎯 **Mode COMPLET (Recommandé)**

### **Lancement de l'écosystème complet**
```bash
./run.sh --full
```

**Ce qui est lancé :**
- 🌐 API Server (port 8000)
- 📊 Dashboard Web (port 5001) 
- 📈 Interface de Monitoring (port 5003)
- 🔧 Visual Workflow Builder (port 3000)
- 🖥️ GUI PyQt5 (interface principale)

**URLs d'accès :**
- API Server: http://localhost:8000
- Dashboard: http://localhost:5001
- Monitoring: http://localhost:5003
- Workflow Builder: http://localhost:3000

---

## 🖥️ **Modes Individuels**

### **Interface GUI seule (défaut)**
```bash
./run.sh
# ou
./run.sh --gui
```

### **API Server seul**
```bash
./run.sh --server
```

### **Dashboard Web seul**
```bash
./run.sh --dashboard
```

### **Interface de Monitoring**
```bash
./run.sh --monitoring
```
- Monitoring système en temps réel
- Status des services
- Métriques CPU/RAM/Disk
- Status des corrections Fiche #1 & #2

### **Visual Workflow Builder**
```bash
./run.sh --workflow
```

### **Agent V0 (Capture)**
```bash
./run.sh --agent
```

### **Interface Commande**
```bash
./run.sh --command
```

---

## 🧪 **Tests & Validation**

### **Tests complets**
```bash
./run.sh --test
```

### **Tests rapides**
```bash
./run.sh --test-quick
```

### **Tests corrections BBOX (Fiche #2)**
```bash
./run.sh --test-bbox
```
Teste spécifiquement les corrections de précision géométrique.

### **Démos d'intégration**
```bash
./run.sh --demo
```
Choix entre :
1. Full Integration Demo
2. Automation Demo  
3. Self-Healing Demo

---

## 🔧 **Maintenance & Monitoring**

### **Vérification environnement**
```bash
./run.sh --check
```

### **Status des services**
```bash
./run.sh --status
```
Vérifie quels services tournent sur quels ports.

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

### **Réinstallation forcée**
```bash
./run.sh --reinstall
```

---

## 📊 **Interface de Monitoring**

Le nouveau monitoring (port 5003) affiche :

### **Métriques Système**
- CPU usage en temps réel
- Memory usage
- Disk usage  
- System uptime

### **Status Services**
- API Server (8000) - Status
- Dashboard (5001) - Status
- Monitoring (5003) - Status
- Command Interface (5002) - Status
- Workflow Builder (3000) - Status

### **Status RPA Vision V3**
- ✅ Fiche #1 & #2 Corrections Applied
- 🎯 BBOX Precision: ~95% (improved from ~60%)
- 🔧 All contrats de données unified

---

## 🎯 **Exemples d'Usage**

### **Pour tester les corrections BBOX**
```bash
# 1. Lancer l'écosystème complet
./run.sh --full

# 2. Tester spécifiquement les corrections
./run.sh --test-bbox

# 3. Voir le monitoring
# Ouvrir http://localhost:5003
```

### **Pour développement**
```bash
# API + Dashboard pour développement
./run.sh --server --dashboard

# Ou écosystème complet
./run.sh --full
```

### **Pour tests rapides**
```bash
# Tests rapides du système
./run.sh --test-quick

# Démos d'intégration
./run.sh --demo
```

---

## 🌐 **Ports Utilisés**

| Service | Port | URL |
|---------|------|-----|
| API Server | 8000 | http://localhost:8000 |
| Dashboard | 5001 | http://localhost:5001 |
| Command Interface | 5002 | http://localhost:5002 |
| **Monitoring** | **5003** | **http://localhost:5003** |
| Workflow Builder | 3000 | http://localhost:3000 |

---

## 📝 **Logs**

Tous les logs sont dans le dossier `logs/` :
```bash
# Voir les logs en temps réel
tail -f logs/api.log
tail -f logs/dashboard.log
tail -f logs/monitoring.log
tail -f logs/workflow.log
```

---

## 🎉 **Nouveautés**

### **Chef d'Orchestre**
- Gestion centralisée de tous les services
- Démarrage/arrêt coordonné
- Monitoring intégré

### **Interface de Monitoring**
- Dashboard temps réel sur port 5003
- Métriques système
- Status des corrections Fiche #1 & #2

### **Tests Spécialisés**
- Tests BBOX dédiés
- Tests rapides
- Démos interactives

### **Gestion des Services**
- Status en temps réel
- Arrêt propre de tous les services
- Détection automatique des ports

---

## 🚀 **Recommandation**

**Pour tester les corrections Fiche #1 & #2 :**
```bash
./run.sh --full
```

Puis ouvrir http://localhost:5003 pour voir le monitoring et tester la précision améliorée du robot ! 🎯

---

**Le run.sh est maintenant un véritable Chef d'Orchestre ! 🎼**