# 📚 Index des Fichiers - RPA Vision V2 MVP

## 🚀 Démarrage Rapide

| Fichier | Description | Priorité |
|---------|-------------|----------|
| **`README_MVP.md`** | README principal du MVP | ⭐⭐⭐ |
| **`DEMARRAGE_RAPIDE_MVP.md`** | Guide de démarrage complet | ⭐⭐⭐ |
| **`RECAP_COMPLET_SESSION.md`** | Récapitulatif de tout ce qui a été fait | ⭐⭐⭐ |

## 📖 Documentation Principale

### État du Projet
| Fichier | Description |
|---------|-------------|
| `état_avancement_18_11.md` | État actuel du projet (60% complet) |
| `état_avancement_17_11.md` | État précédent (35% complet) |
| `CHANGELOG_MVP.md` | Historique des versions |

### Modifications Récentes
| Fichier | Description |
|---------|-------------|
| `MODIFICATIONS_MVP.md` | Détails des modifications MVP |
| `SESSION_REJEU_RESUME.md` | Résumé de la session de rejeu |

### Système de Rejeu
| Fichier | Description |
|---------|-------------|
| `MVP_COMPLET_REJEU.md` | Documentation complète du système de rejeu |
| `SYSTEME_REJEU_IMPLEMENTATION.md` | Détails d'implémentation |
| `geniusia2/core/TASK_REPLAY_README.md` | API technique du rejeu |

### Données et Diagnostic
| Fichier | Description |
|---------|-------------|
| `ETAT_DONNEES_ET_SOLUTIONS.md` | Diagnostic et solutions |

## 🛠️ Scripts Utilitaires

### Scripts Principaux
| Script | Description | Usage |
|--------|-------------|-------|
| **`test_task_replay.py`** | Test de rejeu interactif | `python3 test_task_replay.py` |
| **`example_complete_workflow.py`** | Workflow complet | `python3 example_complete_workflow.py` |
| **`read_pkl.py`** | Lecture des fichiers .pkl | `python3 read_pkl.py --list` |
| **`rebuild_faiss_simple.py`** | Reconstruction index FAISS | `python3 rebuild_faiss_simple.py` |
| **`diagnostic_data.py`** | Diagnostic du système | `python3 diagnostic_data.py` |

### Scripts d'Installation
| Script | Description | Usage |
|--------|-------------|-------|
| `geniusia2/setup.sh` | Installation complète | `cd geniusia2 && ./setup.sh` |
| `geniusia2/install_faiss.sh` | Installation FAISS | `cd geniusia2 && ./install_faiss.sh` |
| `geniusia2/run.sh` | Lancement de l'app | `cd geniusia2 && ./run.sh` |

## 📁 Code Source

### Core (Logique Principale)
| Fichier | Description |
|---------|-------------|
| `geniusia2/core/task_replay.py` | ✨ Moteur de rejeu intelligent (450 lignes) |
| `geniusia2/core/event_capture.py` | Capture d'événements |
| `geniusia2/core/learning_manager.py` | Apprentissage de tâches |
| `geniusia2/core/embeddings_manager.py` | Gestion FAISS |
| `geniusia2/core/logger.py` | Logs (JSON simple) |
| `geniusia2/core/orchestrator.py` | Orchestration |
| `geniusia2/core/llm_manager.py` | Gestion LLM (Gemma3) |

### Utils
| Fichier | Description |
|---------|-------------|
| `geniusia2/core/utils/vision_utils.py` | Analyse visuelle (CLIP, OWL-v2, etc.) |
| `geniusia2/core/utils/input_utils.py` | Contrôle souris/clavier |
| `geniusia2/core/utils/image_utils.py` | Manipulation d'images |

### GUI
| Fichier | Description |
|---------|-------------|
| `geniusia2/gui/minimal_gui.py` | Interface principale |
| `geniusia2/gui/suggestion_overlay.py` | Superposition de suggestions |
| `geniusia2/gui/dialogs/` | Dialogues divers |

### Configuration
| Fichier | Description |
|---------|-------------|
| `geniusia2/core/config.py` | Configuration globale |
| `geniusia2/requirements.txt` | Dépendances Python |

## 📊 Données

### Structure
```
geniusia2/data/
├── user_profiles/          # 105 tâches apprises
│   └── task_XXXXX/
│       ├── metadata.json   # Infos de la tâche
│       └── signatures.pkl  # Actions + embeddings
├── faiss_index/            # Index de recherche
│   ├── embeddings.index    # Index FAISS
│   └── metadata.pkl        # Métadonnées
└── logs/                   # Logs JSON
    └── logs_YYYY-MM-DD.json
```

## 📚 Documentation Ancienne (Référence)

### Guides Utilisateur
| Fichier | Description | État |
|---------|-------------|------|
| `README.md` | README original | Remplacé par `README_MVP.md` |
| `DEMARRAGE_RAPIDE.md` | Guide original | Remplacé par `DEMARRAGE_RAPIDE_MVP.md` |
| `PREMIERE_UTILISATION.md` | Guide première utilisation | Toujours valide |
| `GUIDE_RAPIDE_INTERFACE.md` | Guide interface | Toujours valide |

### Documentation Technique
| Fichier | Description |
|---------|-------------|
| `MVP_FONCTIONNEL_IMPLEMENTATION.md` | Implémentation MVP initiale |
| `IMPLEMENTATION_CAPTURE_EVENEMENTS.md` | Détails capture |
| `INPUT_UTILS_IMPLEMENTATION_SUMMARY.md` | Résumé input_utils |
| `WHITELIST_IMPLEMENTATION_SUMMARY.md` | Résumé whitelist |

### Guides Spécifiques
| Fichier | Description |
|---------|-------------|
| `FONCTIONNEMENT_MODE_SHADOW.md` | Mode Shadow |
| `MODES_SECURITE.md` | Sécurité |
| `QWEN3_VL_CONFIGURATION.md` | Configuration Qwen3-VL |
| `DEBUG_GUIDE.md` | Guide de debug |

### Documentation Modules
| Fichier | Description |
|---------|-------------|
| `geniusia2/QWEN3_VL_USAGE.md` | Usage Qwen3-VL |
| `geniusia2/QWEN3_VL_ACTIVATION.md` | Activation Qwen3-VL |
| `geniusia2/VISION_MODELS_IMPLEMENTATION.md` | Modèles de vision |
| `geniusia2/INSTALLATION_FIXES.md` | Corrections d'installation |
| `geniusia2/PROGRESS.md` | Progression |

## 🎯 Fichiers par Cas d'Usage

### Je veux démarrer rapidement
1. `README_MVP.md`
2. `DEMARRAGE_RAPIDE_MVP.md`
3. `cd geniusia2 && ./setup.sh`
4. `./install_faiss.sh`

### Je veux comprendre ce qui a été fait
1. `RECAP_COMPLET_SESSION.md`
2. `état_avancement_18_11.md`
3. `CHANGELOG_MVP.md`

### Je veux tester le rejeu
1. `test_task_replay.py`
2. `example_complete_workflow.py`
3. `MVP_COMPLET_REJEU.md`

### Je veux diagnostiquer un problème
1. `diagnostic_data.py`
2. `ETAT_DONNEES_ET_SOLUTIONS.md`
3. `DEBUG_GUIDE.md`

### Je veux lire les données
1. `read_pkl.py --list`
2. `read_pkl.py task_XXXXX`
3. `cat geniusia2/data/logs/logs_$(date +%Y-%m-%d).json`

### Je veux reconstruire l'index FAISS
1. `rebuild_faiss_simple.py`
2. `ETAT_DONNEES_ET_SOLUTIONS.md`

## 📝 Checklist de Lecture

### Démarrage (Ordre recommandé)
1. [ ] `README_MVP.md` - Vue d'ensemble
2. [ ] `DEMARRAGE_RAPIDE_MVP.md` - Installation
3. [ ] `RECAP_COMPLET_SESSION.md` - Ce qui a été fait

### Compréhension du Système
4. [ ] `état_avancement_18_11.md` - État actuel
5. [ ] `MVP_COMPLET_REJEU.md` - Système de rejeu
6. [ ] `MODIFICATIONS_MVP.md` - Changements récents

### Utilisation
7. [ ] Lancer `python3 diagnostic_data.py`
8. [ ] Lancer `python3 read_pkl.py --list`
9. [ ] Lancer `python3 test_task_replay.py`

## 🗂️ Organisation des Fichiers

### Racine du Projet
```
Geniusia_v2/
├── README_MVP.md                    ⭐ Lire en premier
├── DEMARRAGE_RAPIDE_MVP.md          ⭐ Guide d'installation
├── RECAP_COMPLET_SESSION.md         ⭐ Récapitulatif complet
├── état_avancement_18_11.md         État du projet
├── CHANGELOG_MVP.md                 Historique
├── MODIFICATIONS_MVP.md             Changements récents
├── MVP_COMPLET_REJEU.md             Doc rejeu
├── ETAT_DONNEES_ET_SOLUTIONS.md     Diagnostic
├── test_task_replay.py              Script de test
├── example_complete_workflow.py     Workflow complet
├── read_pkl.py                      Lecture .pkl
├── rebuild_faiss_simple.py          Reconstruction index
├── diagnostic_data.py               Diagnostic
└── geniusia2/                       Code source
    ├── setup.sh                     Installation
    ├── install_faiss.sh             Installation FAISS
    ├── run.sh                       Lancement
    ├── requirements.txt             Dépendances
    ├── main.py                      Point d'entrée
    ├── core/                        Logique
    ├── gui/                         Interface
    └── data/                        Données
```

## 🎯 Résumé

**Fichiers essentiels** : 3
- `README_MVP.md`
- `DEMARRAGE_RAPIDE_MVP.md`
- `RECAP_COMPLET_SESSION.md`

**Scripts utilitaires** : 5
- `test_task_replay.py`
- `example_complete_workflow.py`
- `read_pkl.py`
- `rebuild_faiss_simple.py`
- `diagnostic_data.py`

**Documentation** : 10+ fichiers

**Code source** : ~20 fichiers principaux

**Total** : ~100 fichiers dans le projet

---

**Tout est organisé et documenté ! 📚**