Initial commit

docs/guides/DEBUG_GUIDE.md

@@ -0,0 +1,218 @@
+# 🐛 Guide de Debug
+
+## Problème : Rien ne se passe
+
+### Vérifications à Faire
+
+#### 1. L'application est-elle lancée ?
+
+```bash
+ps aux | grep python | grep geniusia2
+```
+
+Si rien → L'app n'est pas lancée
+
+#### 2. La capture d'événements démarre-t-elle ?
+
+**Dans le terminal, tu devrais voir** :
+```
+✅ Capture d'événements démarrée
+```
+
+Si tu ne vois pas ce message → La capture ne démarre pas
+
+#### 3. Les événements sont-ils capturés ?
+
+**Teste avec le script simple** :
+```bash
+./geniusia2/venv/bin/python test_capture_simple.py
+```
+
+Puis clique 3 fois rapidement au même endroit.
+
+**Tu devrais voir** :
+```
+Événements capturés: 3
+[DEBUG] Événements simplifiés: 3
+[DEBUG] Derniers: [...]
+[DEBUG] seq_len=1, repetitions=3, threshold=3
+[DEBUG] ✅ Pattern trouvé !
+🎯 PATTERN DÉTECTÉ !
+```
+
+#### 4. Le callback est-il appelé ?
+
+**Dans l'app principale, tu devrais voir** :
+```
+🎯 Pattern détecté dans event_capture !
+   Répétitions: 3
+   Longueur: 1
+
+============================================================
+🎯 PATTERN DÉTECTÉ DANS ORCHESTRATOR !
+============================================================
+```
+
+---
+
+## Messages de Debug Ajoutés
+
+### Dans event_capture.py
+
+```
+[DEBUG] Événements simplifiés: X
+[DEBUG] Derniers: [...]
+[DEBUG] seq_len=1, repetitions=3, threshold=3
+[DEBUG] ✅ Pattern trouvé !
+🎯 Pattern détecté dans event_capture !
+```
+
+### Dans orchestrator.py
+
+```
+============================================================
+🎯 PATTERN DÉTECTÉ DANS ORCHESTRATOR !
+============================================================
+📸 Analyse de 3 actions...
+✅ Tâche créée : task_abc123
+```
+
+---
+
+## Si Rien ne S'affiche
+
+### Problème 1 : pynput ne fonctionne pas
+
+**Test** :
+```bash
+./geniusia2/venv/bin/python -c "from pynput import mouse; print('OK')"
+```
+
+Si erreur → Réinstaller pynput
+
+### Problème 2 : Les clics sont trop espacés
+
+**Solution** : Clique plus rapidement (< 2 secondes entre chaque clic)
+
+### Problème 3 : Les clics sont trop éloignés
+
+**Solution** : Clique au même endroit (tolérance 100px)
+
+### Problème 4 : Le seuil est trop élevé
+
+**Modifier** `event_capture.py` ligne 42 :
+```python
+pattern_threshold=2  # Au lieu de 3
+```
+
+---
+
+## Test Minimal
+
+### Script de Test
+
+```bash
+./geniusia2/venv/bin/python test_capture_simple.py
+```
+
+### Ce que tu dois faire
+
+1. Lance le script
+2. Attends "Capture démarrée"
+3. Clique 3 fois RAPIDEMENT au MÊME endroit
+4. Observe les messages
+
+### Résultat Attendu
+
+```
+✅ Capture démarrée
+
+Effectuez 3 clics rapides au même endroit...
+
+Événements capturés: 1  
+Événements capturés: 2  
+Événements capturés: 3  
+[DEBUG] Événements simplifiés: 3
+[DEBUG] Derniers: [{'type': 'click', 'x_zone': 10, 'y_zone': 5, 'window': 'Firefox'}]
+[DEBUG] seq_len=1, repetitions=3, threshold=3
+[DEBUG] ✅ Pattern trouvé !
+
+🎯 PATTERN DÉTECTÉ !
+   Répétitions: 3
+   Fenêtre: Firefox
+
+✅ Pattern détecté avec succès !
+```
+
+---
+
+## Si le Test Fonctionne mais pas l'App
+
+### Vérifier que l'orchestrateur démarre la capture
+
+**Dans** `orchestrator.py`, méthode `run()` :
+```python
+# Démarrer la capture d'événements
+self.event_capture.start()
+```
+
+### Vérifier que le callback est enregistré
+
+**Dans** `orchestrator.py`, `__init__()` :
+```python
+self.event_capture.register_pattern_callback(self._on_pattern_detected)
+```
+
+---
+
+## Logs à Vérifier
+
+```bash
+# Voir les derniers logs
+ls -lah geniusia2/data/logs/
+
+# Décrypter les logs (si nécessaire)
+# Les logs sont chiffrés, donc difficiles à lire
+```
+
+---
+
+## Solution Rapide
+
+Si rien ne fonctionne, **réduis le seuil** :
+
+```python
+# Dans event_capture.py, ligne 42
+pattern_threshold=2  # Au lieu de 3
+```
+
+Et **augmente la tolérance** :
+
+```python
+# Dans event_capture.py, ligne 260
+"x_zone": e["x"] // 200,  # Au lieu de 100
+"y_zone": e["y"] // 200,
+```
+
+---
+
+## Commandes Utiles
+
+```bash
+# Tester la capture seule
+./geniusia2/venv/bin/python test_capture_simple.py
+
+# Lancer l'app avec debug
+cd geniusia2
+./run.sh 2>&1 | tee debug.log
+
+# Voir les processus
+ps aux | grep python
+
+# Tuer l'app
+pkill -f geniusia2
+```
+
+---
+
+**Lance d'abord `test_capture_simple.py` et dis-moi ce que tu vois !**