# 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 ! 🚀
