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
320
docs/reference/SCRIPTS_DISPONIBLES.md
Normal file
320
docs/reference/SCRIPTS_DISPONIBLES.md
Normal file
@@ -0,0 +1,320 @@
|
||||
# 🛠️ Scripts Disponibles - RPA Vision V2
|
||||
|
||||
## 🚀 Scripts de Lancement
|
||||
|
||||
### LANCER_APPLICATION.sh ⭐ (Recommandé)
|
||||
**Emplacement** : Racine du projet
|
||||
**Usage** : `./LANCER_APPLICATION.sh`
|
||||
|
||||
Script principal pour lancer l'application depuis n'importe où dans le projet.
|
||||
|
||||
**Fonctionnalités** :
|
||||
- ✅ Vérification de l'existence des répertoires
|
||||
- ✅ Vérification de l'existence de run.sh
|
||||
- ✅ Ajout automatique des permissions d'exécution
|
||||
- ✅ Messages d'erreur clairs
|
||||
- ✅ Lancement de l'application
|
||||
|
||||
**Quand l'utiliser** : Toujours ! C'est la méthode recommandée.
|
||||
|
||||
---
|
||||
|
||||
### geniusia2/run.sh
|
||||
**Emplacement** : `geniusia2/`
|
||||
**Usage** : `cd geniusia2 && ./run.sh`
|
||||
|
||||
Script de lancement depuis le dossier geniusia2.
|
||||
|
||||
**Fonctionnalités** :
|
||||
- ✅ Activation de l'environnement virtuel
|
||||
- ✅ Lancement de main.py
|
||||
- ✅ Gestion des erreurs
|
||||
|
||||
**Quand l'utiliser** : Si vous êtes déjà dans le dossier geniusia2.
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Scripts d'Installation
|
||||
|
||||
### geniusia2/setup.sh ⭐
|
||||
**Emplacement** : `geniusia2/`
|
||||
**Usage** : `cd geniusia2 && ./setup.sh`
|
||||
|
||||
Script d'installation automatique complet.
|
||||
|
||||
**Fonctionnalités** :
|
||||
- ✅ Création de l'environnement virtuel
|
||||
- ✅ Installation de toutes les dépendances Python (~3.5 GB)
|
||||
- ✅ Installation d'Ollama (si nécessaire)
|
||||
- ✅ Téléchargement du modèle Qwen 2.5-VL
|
||||
- ✅ Création des répertoires de données
|
||||
- ✅ Génération des clés de chiffrement
|
||||
- ✅ Configuration complète
|
||||
|
||||
**Durée** : ~10-15 minutes (selon la connexion internet)
|
||||
|
||||
**Quand l'utiliser** :
|
||||
- Première installation
|
||||
- Après suppression de venv/
|
||||
- Pour réinstaller complètement
|
||||
|
||||
---
|
||||
|
||||
## 🔍 Scripts de Vérification
|
||||
|
||||
### VERIFIER_INSTALLATION.sh ⭐
|
||||
**Emplacement** : Racine du projet
|
||||
**Usage** : `./VERIFIER_INSTALLATION.sh`
|
||||
|
||||
Script de vérification complète de l'installation.
|
||||
|
||||
**Vérifications effectuées** :
|
||||
1. ✅ Structure des répertoires
|
||||
2. ✅ Scripts de lancement
|
||||
3. ✅ Documentation
|
||||
4. ✅ Environnement virtuel
|
||||
5. ✅ Dépendances Python (PyTorch, PyQt5, Transformers, FAISS)
|
||||
6. ✅ Ollama et modèle Qwen 2.5-VL
|
||||
7. ✅ Fichiers de configuration
|
||||
8. ✅ Répertoires de données
|
||||
|
||||
**Résultat** :
|
||||
- Affiche un résumé avec compteurs (✅/❌/⚠️)
|
||||
- Code de sortie 0 si tout est OK
|
||||
- Code de sortie 1 si problèmes détectés
|
||||
|
||||
**Quand l'utiliser** :
|
||||
- Après l'installation
|
||||
- Avant de lancer l'application
|
||||
- Pour diagnostiquer des problèmes
|
||||
|
||||
---
|
||||
|
||||
## 🧪 Scripts de Test
|
||||
|
||||
### test_learning_manager_simple.py
|
||||
**Usage** : `python3 test_learning_manager_simple.py`
|
||||
|
||||
Test du gestionnaire d'apprentissage sans dépendances lourdes.
|
||||
|
||||
**Tests** :
|
||||
- Initialisation
|
||||
- Observation d'actions
|
||||
- Transitions de mode
|
||||
- Calcul de confiance
|
||||
- Confirmations et corrections
|
||||
- Sauvegarde/chargement
|
||||
|
||||
---
|
||||
|
||||
### test_orchestrator_simple.py
|
||||
**Usage** : `python3 test_orchestrator_simple.py`
|
||||
|
||||
Test de l'orchestrateur (boucle cognitive).
|
||||
|
||||
**Tests** :
|
||||
- Initialisation
|
||||
- Capture de contexte
|
||||
- Liste blanche
|
||||
- Métriques
|
||||
- Statut
|
||||
|
||||
---
|
||||
|
||||
### test_whitelist_simple.py
|
||||
**Usage** : `python3 test_whitelist_simple.py`
|
||||
|
||||
Test du gestionnaire de liste blanche.
|
||||
|
||||
**Tests** :
|
||||
- Ajout/suppression d'applications
|
||||
- Vérification d'autorisation
|
||||
- Patterns avec wildcards
|
||||
- Sauvegarde/chargement
|
||||
|
||||
---
|
||||
|
||||
### test_whitelist_integration.py
|
||||
**Usage** : `python3 test_whitelist_integration.py`
|
||||
|
||||
Test d'intégration de la liste blanche avec l'orchestrateur.
|
||||
|
||||
---
|
||||
|
||||
### test_input_utils_simple.py
|
||||
**Usage** : `python3 test_input_utils_simple.py`
|
||||
|
||||
Test des utilitaires d'entrée (actions UI).
|
||||
|
||||
**Tests** :
|
||||
- Exécution d'actions (click, type, scroll)
|
||||
- Historique d'actions
|
||||
- Actions inverses
|
||||
- Rollback
|
||||
|
||||
---
|
||||
|
||||
### test_input_utils_integration.py
|
||||
**Usage** : `python3 test_input_utils_integration.py`
|
||||
|
||||
Test d'intégration des utilitaires d'entrée.
|
||||
|
||||
---
|
||||
|
||||
### test_ui_change_detector_simple.py
|
||||
**Usage** : `python3 test_ui_change_detector_simple.py`
|
||||
|
||||
Test du détecteur de changements UI.
|
||||
|
||||
---
|
||||
|
||||
### test_summary_dashboard.py
|
||||
**Usage** : `python3 test_summary_dashboard.py`
|
||||
|
||||
Test du tableau de bord des métriques.
|
||||
|
||||
---
|
||||
|
||||
## 📊 Tableau Récapitulatif
|
||||
|
||||
| Script | Type | Emplacement | Durée | Priorité |
|
||||
|--------|------|-------------|-------|----------|
|
||||
| **LANCER_APPLICATION.sh** | Lancement | Racine | <1s | ⭐⭐⭐ |
|
||||
| **run.sh** | Lancement | geniusia2/ | <1s | ⭐⭐ |
|
||||
| **setup.sh** | Installation | geniusia2/ | ~10min | ⭐⭐⭐ |
|
||||
| **VERIFIER_INSTALLATION.sh** | Vérification | Racine | ~5s | ⭐⭐⭐ |
|
||||
| **test_*.py** | Tests | Racine | ~1-5s | ⭐ |
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Workflow Recommandé
|
||||
|
||||
### Première Installation
|
||||
|
||||
```bash
|
||||
# 1. Vérifier l'état initial
|
||||
./VERIFIER_INSTALLATION.sh
|
||||
|
||||
# 2. Installer
|
||||
cd geniusia2
|
||||
./setup.sh
|
||||
|
||||
# 3. Vérifier l'installation
|
||||
cd ..
|
||||
./VERIFIER_INSTALLATION.sh
|
||||
|
||||
# 4. Lancer l'application
|
||||
./LANCER_APPLICATION.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Utilisation Quotidienne
|
||||
|
||||
```bash
|
||||
# Lancer l'application
|
||||
./LANCER_APPLICATION.sh
|
||||
```
|
||||
|
||||
C'est tout ! 🎉
|
||||
|
||||
---
|
||||
|
||||
### Après Mise à Jour du Code
|
||||
|
||||
```bash
|
||||
# 1. Vérifier l'installation
|
||||
./VERIFIER_INSTALLATION.sh
|
||||
|
||||
# 2. Réinstaller si nécessaire
|
||||
cd geniusia2
|
||||
rm -rf venv
|
||||
./setup.sh
|
||||
|
||||
# 3. Tester
|
||||
cd ..
|
||||
python3 test_learning_manager_simple.py
|
||||
python3 test_orchestrator_simple.py
|
||||
|
||||
# 4. Lancer
|
||||
./LANCER_APPLICATION.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Diagnostic de Problèmes
|
||||
|
||||
```bash
|
||||
# 1. Vérifier l'installation
|
||||
./VERIFIER_INSTALLATION.sh
|
||||
|
||||
# 2. Tester les composants
|
||||
python3 test_learning_manager_simple.py
|
||||
python3 test_orchestrator_simple.py
|
||||
python3 test_whitelist_simple.py
|
||||
|
||||
# 3. Consulter les logs
|
||||
cat geniusia2/data/logs/logs_$(date +%Y-%m-%d).enc
|
||||
|
||||
# 4. Réinstaller si nécessaire
|
||||
cd geniusia2
|
||||
rm -rf venv
|
||||
./setup.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 💡 Conseils
|
||||
|
||||
### Rendre un Script Exécutable
|
||||
|
||||
```bash
|
||||
chmod +x nom_du_script.sh
|
||||
```
|
||||
|
||||
### Exécuter un Script Python avec le venv
|
||||
|
||||
```bash
|
||||
geniusia2/venv/bin/python3 script.py
|
||||
```
|
||||
|
||||
### Vérifier la Version de Python
|
||||
|
||||
```bash
|
||||
geniusia2/venv/bin/python3 --version
|
||||
```
|
||||
|
||||
### Lister les Packages Installés
|
||||
|
||||
```bash
|
||||
geniusia2/venv/bin/pip list
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🆘 En Cas de Problème
|
||||
|
||||
1. **Script ne se lance pas** :
|
||||
```bash
|
||||
chmod +x nom_du_script.sh
|
||||
```
|
||||
|
||||
2. **Erreur "command not found"** :
|
||||
```bash
|
||||
./nom_du_script.sh # Avec ./
|
||||
```
|
||||
|
||||
3. **Erreur "Permission denied"** :
|
||||
```bash
|
||||
chmod +x nom_du_script.sh
|
||||
```
|
||||
|
||||
4. **Script Python ne trouve pas les modules** :
|
||||
```bash
|
||||
# Utiliser le Python du venv
|
||||
geniusia2/venv/bin/python3 script.py
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**Tous les scripts sont prêts à l'emploi ! 🚀**
|
||||
Reference in New Issue
Block a user