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>
This commit is contained in:
Dom
214
docs/guides/GUIDE_DEMARRAGE_RAPIDE.md
Normal file
214
docs/guides/GUIDE_DEMARRAGE_RAPIDE.md
Normal file
@@ -0,0 +1,214 @@
|
||||
# 🚀 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 !**
|
||||
Reference in New Issue
Block a user