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é)
```bash
# 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
```bash
cd visual_workflow_builder
./start_full.sh
```

**Services démarrés :**
- 🔧 Backend VWB (port 5002)
- 🎨 Frontend React (port 3000)

### Option 3 : Lancement Orchestré Complet
```bash
# 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
```bash
# Vérifie que tout est prêt
python3 test_systeme_complet_final.py
```

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

### Tests Spécifiques
```bash
# Tests des corrections BBOX (Fiche #2)
./run.sh --test-bbox

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

## 🔧 Commandes Utiles

### Gestion des Services
```bash
# 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
```bash
# 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
```bash
# 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

```bash
# 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 :
```bash
# Nettoyer les processus existants
./launch_all.sh  # Inclut un nettoyage automatique
```

### Problèmes de Dépendances
```bash
# 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
```bash
# 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 !**