Initial commit

geniusia2/QUICKSTART.md

@@ -0,0 +1,184 @@
+# Guide de Démarrage Rapide - RPA Vision V2
+
+Ce guide vous permet de démarrer avec RPA Vision V2 en quelques minutes.
+
+## Installation Express (5 minutes)
+
+```bash
+# 1. Cloner ou naviguer vers le projet
+cd geniusia2
+
+# 2. Lancer l'installation automatique
+./setup.sh
+
+# 3. C'est tout ! Le script configure tout automatiquement
+```
+
+## Premier Lancement (2 minutes)
+
+```bash
+# Activer l'environnement virtuel
+source venv/bin/activate
+
+# Lancer l'application
+python3 main.py
+```
+
+L'interface graphique s'ouvre automatiquement.
+
+## Première Utilisation (10 minutes)
+
+### Étape 1: Configuration de la Liste Blanche
+
+Avant de commencer, ajoutez les applications que vous souhaitez automatiser:
+
+1. Cliquez sur **"Gérer Liste Blanche"**
+2. Ajoutez une application de test (ex: "Firefox", "gedit")
+3. Confirmez l'ajout
+
+⚠️ **Important**: Ne jamais ajouter d'applications sensibles (banque, admin système)
+
+### Étape 2: Mode Shadow (Apprentissage)
+
+1. Cliquez sur **"Start"**
+2. Le mode 👀 **Shadow** est activé par défaut
+3. Effectuez une tâche répétitive dans l'application autorisée
+4. Le système observe et apprend silencieusement
+5. Répétez la tâche au moins 20 fois
+
+**Exemple de tâche simple**:
+- Ouvrir Firefox
+- Cliquer sur la barre d'adresse
+- Taper "example.com"
+- Appuyer sur Entrée
+
+### Étape 3: Transition vers Mode Assisté
+
+Après ≥20 observations avec ≥95% de concordance:
+
+1. Une notification propose le passage en mode 🤝 **Assisté**
+2. Acceptez la transition
+3. Le système suggère maintenant les actions
+4. Validez avec **Entrée** ou rejetez avec **Échap**
+
+### Étape 4: Mode Autopilot (Automatisation)
+
+Après ≥20 validations avec ≥95% de concordance:
+
+1. Une notification propose le passage en mode 🤖 **Autopilot**
+2. Acceptez la transition
+3. Le système exécute automatiquement la tâche
+4. Surveillez les notifications de succès/échec
+
+## Raccourcis Essentiels
+
+| Raccourci | Action |
+|-----------|--------|
+| **Ctrl+Pause** | 🛑 Arrêt d'urgence |
+| **Entrée** | ✅ Valider suggestion |
+| **Échap** | ❌ Rejeter suggestion |
+| **Alt+C** | 🔧 Corriger action |
+
+## Tableau de Bord
+
+Appuyez sur **Ctrl+D** pour ouvrir le tableau de bord:
+
+- Vue d'ensemble des tâches apprises
+- Métriques de performance (confiance, concordance)
+- Historique des corrections
+- Alertes et recommandations
+
+## Cas d'Usage Simples
+
+### 1. Automatiser une Recherche Web
+
+**Tâche**: Rechercher "météo Paris" sur Google
+
+1. Mode Shadow: Effectuez la recherche 20 fois
+2. Mode Assisté: Validez les suggestions 20 fois
+3. Mode Autopilot: Laissez le système faire
+
+**Temps d'apprentissage**: ~10 minutes
+
+### 2. Remplir un Formulaire
+
+**Tâche**: Remplir un formulaire avec des données fixes
+
+1. Mode Shadow: Remplissez le formulaire 20 fois
+2. Mode Assisté: Validez les suggestions
+3. Mode Autopilot: Automatisation complète
+
+**Temps d'apprentissage**: ~15 minutes
+
+### 3. Copier-Coller entre Applications
+
+**Tâche**: Copier du texte de Firefox vers LibreOffice
+
+1. Ajoutez Firefox et LibreOffice à la liste blanche
+2. Mode Shadow: Effectuez l'opération 20 fois
+3. Mode Assisté: Validez les suggestions
+4. Mode Autopilot: Automatisation
+
+**Temps d'apprentissage**: ~15 minutes
+
+## Résolution de Problèmes Rapide
+
+### Le système ne détecte pas mes actions
+
+- Vérifiez que l'application est dans la liste blanche
+- Assurez-vous que le mode Shadow est actif
+- Vérifiez les logs dans le tableau de bord
+
+### Les suggestions sont imprécises
+
+- Fournissez plus d'exemples en mode Shadow (>20)
+- Vérifiez que l'UI n'a pas changé
+- Ajustez les seuils dans `core/config.py`
+
+### Latence élevée
+
+- Vérifiez que le GPU est utilisé
+- Utilisez un modèle plus léger (qwen2.5-vl:3b)
+- Réduisez la résolution de capture
+
+### Erreur "Application not whitelisted"
+
+- Ajoutez l'application à la liste blanche
+- Vérifiez le titre exact de la fenêtre
+- Redémarrez l'application
+
+## Prochaines Étapes
+
+1. **Explorez le tableau de bord**: Ctrl+D pour voir les métriques
+2. **Testez le rollback**: Ctrl+Z pour annuler les 3 dernières actions
+3. **Personnalisez la config**: Éditez `core/config.py`
+4. **Lisez la doc complète**: `README.md`
+
+## Conseils de Sécurité
+
+✅ **À FAIRE**:
+- Tester en mode Shadow avant Autopilot
+- Surveiller le tableau de bord régulièrement
+- Sauvegarder `data/` périodiquement
+- Utiliser l'arrêt d'urgence (Ctrl+Pause) si nécessaire
+
+❌ **À NE PAS FAIRE**:
+- Ajouter des applications sensibles à la liste blanche
+- Laisser tourner en Autopilot sans surveillance
+- Modifier les fichiers dans `data/` manuellement
+- Désactiver les mécanismes de sécurité
+
+## Support
+
+- **Documentation**: `README.md`
+- **Architecture**: `.kiro/specs/rpa-vision-v2/design.md`
+- **Logs**: `data/logs/` (chiffrés)
+- **Métriques**: Tableau de bord (Ctrl+D)
+
+---
+
+**Temps total pour être opérationnel**: ~20 minutes
+
+**Temps pour première automatisation**: ~30 minutes
+
+Bon apprentissage ! 🚀