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>

visual_workflow_builder/docs/TROUBLESHOOTING.md

@@ -0,0 +1,97 @@
+# Guide de Dépannage - Visual Workflow Builder
+
+## 🚨 Problèmes Courants
+
+### Capture d'Écran
+
+**"Permission denied"**
+```bash
+# Linux - Permissions X11
+xhost +local:
+export DISPLAY=:0
+```
+
+**"Timeout during capture"**
+```typescript
+// Augmenter timeout et réduire qualité
+const result = await screenCaptureService.captureScreen({
+  timeout: 15000,
+  quality: 0.6
+});
+```
+
+### Détection d'Éléments
+
+**"Element not found"**
+```typescript
+// Recapturer avec seuil ajusté
+const validation = await visualTargetService.validateTarget(signature, {
+  confidenceThreshold: 0.6
+});
+```
+
+**"Multiple elements detected"**
+```typescript
+// Utiliser plus de contexte
+const target = await visualTargetService.captureAndSelectElement(
+  position,
+  { includeContext: true, contextRadius: 100 }
+);
+```
+
+### Multi-Moniteurs
+
+**"Coordinates out of bounds"**
+```typescript
+// Vérifier et rafraîchir les moniteurs
+const monitors = await monitorService.detectMonitors();
+await monitorService.refresh();
+```
+
+### Performance
+
+**"Slow rendering"**
+```typescript
+// Nettoyer cache et optimiser
+imageCache.clear();
+const { optimizedImageLoad } = usePerformanceOptimization({
+  maxConcurrentOperations: 2,
+  debounceMs: 500
+});
+```
+
+## 🔧 Diagnostic
+
+### Vérification Système
+```bash
+# Test capture d'écran
+import -window root /tmp/test.png
+
+# Vérifier ports
+netstat -tlnp | grep :5002  # Backend
+netstat -tlnp | grep :3000  # Frontend
+```
+
+### Tests Connectivité
+```typescript
+// Test santé backend
+const health = await fetch('/api/visual/health');
+console.log(await health.json());
+```
+
+## 📊 Monitoring
+
+```typescript
+// Métriques critiques à surveiller
+const stats = imageCache.getStats();
+if (stats.hitRate < 0.8) console.warn('Cache hit rate low');
+if (stats.totalSize > 100MB) imageCache.clear();
+```
+
+## 🆘 Support
+
+Collectez avant signalement :
+- Logs d'erreur complets
+- Configuration système
+- Étapes de reproduction
+- Captures d'écran du problème