Initial commit

2026-03-05 00:20:25 +01:00
commit dcd4de9945
1954 changed files with 669380 additions and 0 deletions
--- a/docs/reference/ARCHITECTURE_INDEX.md
+++ b/docs/reference/ARCHITECTURE_INDEX.md
@@ -0,0 +1,173 @@
+# Index - Documentation Architecture RPA Vision V2
+
+**Date** : 22 novembre 2024  
+**Version** : 1.0
+
+---
+
+## 📚 Documents Disponibles
+
+### 🏗️ Architecture Complète
+
+**[ARCHITECTURE_VISION_COMPLETE.md](./ARCHITECTURE_VISION_COMPLETE.md)**
+
+Document de référence complet décrivant l'architecture en 5 couches du système RPA Vision V2.
+
+**Contenu** :
+- Vue d'ensemble de l'architecture
+- Couche 0 : RawSession (capture brute)
+- Couche 1 : ScreenState (analyse multi-modale)
+- Couche 2 : UIElement Detection (détection sémantique)
+- Couche 3 : State Embedding (fusion multi-modale)
+- Couche 4 : Workflow Graph (modélisation en graphe)
+- Pipeline de traitement complet
+- Exemple concret : "Validation Facture T2A"
+- Plan de migration progressif
+- Métriques de succès
+
+**Taille** : ~1500 lignes  
+**Format** : Markdown avec exemples JSON
+
+---
+
+### 🔧 Enrichissements Avancés
+
+**[ARCHITECTURE_ENRICHISSEMENTS.md](./ARCHITECTURE_ENRICHISSEMENTS.md)** ⭐ NOUVEAU
+
+Document d'enrichissements qui transforme l'architecture en contrat stable production-ready.
+
+**Contenu** :
+- Grammaire du temps (épisodes de workflow)
+- Identités stables (tracking d'éléments)
+- Versioning d'espaces d'embedding
+- Variables métier (slots)
+- Nœuds d'erreur explicites
+- Matrice Mode × Maturité
+- Layout vs Contenu
+- Scores d'actionnabilité
+
+**Taille** : ~800 lignes  
+**Format** : Markdown avec exemples JSON avancés
+
+**[ENRICHISSEMENTS_RESUME.md](./ENRICHISSEMENTS_RESUME.md)**
+
+Résumé des 8 enrichissements majeurs avec impact et modifications JSON.
+
+**Taille** : ~200 lignes  
+**Format** : Tableaux et listes
+
+---
+
+## 🎯 Navigation Rapide
+
+### Par Couche
+
+| Couche | Description | Section |
+|--------|-------------|---------|
+| **0 - RawSession** | Capture brute des événements | § Couche 0 |
+| **1 - ScreenState** | Analyse multi-modale (4 niveaux) | § Couche 1 |
+| **2 - UIElement** | Détection sémantique d'éléments | § Couche 2 |
+| **3 - State Embedding** | Fusion multi-modale | § Couche 3 |
+| **4 - Workflow Graph** | Modélisation en graphe | § Couche 4 |
+
+### Par Cas d'Usage
+
+| Cas d'Usage | Section |
+|-------------|---------|
+| **Comprendre les formats JSON** | Structures JSON de chaque couche |
+| **Implémenter la détection UI** | § Couche 2 - Pipeline |
+| **Calculer les embeddings** | § Couche 3 - Méthodes de fusion |
+| **Créer un workflow** | § Couche 4 - Structure Workflow |
+| **Migrer le code existant** | § Mapping avec Code Existant |
+| **Planifier l'implémentation** | § Plan de Migration |
+
+### Par Concept
+
+| Concept | Description | Section |
+|---------|-------------|---------|
+| **Learning States** | OBSERVATION → COACHING → AUTO | § États d'Apprentissage |
+| **Node Matching** | Reconnaissance d'état d'écran | § WorkflowNode |
+| **Edge Actions** | Transitions entre états | § WorkflowEdge |
+| **Safety Rules** | Règles de sécurité | § Workflow - safety_rules |
+| **Embeddings** | Représentations vectorielles | § State Embedding |
+
+---
+
+## 💡 Propositions d'Amélioration
+
+Le document inclut des propositions d'amélioration pour chaque couche :
+
+- ✅ **Couche 0** : Métadonnées de performance, support multi-écrans
+- ✅ **Couche 1** : Zones d'intérêt, historique de changements
+- ✅ **Couche 2** : Hiérarchie d'éléments, états, relations
+- ✅ **Couche 3** : Embeddings adaptatifs, contexte temporel
+- ✅ **Couche 4** : Graphes avec boucles, sous-workflows
+
+---
+
+## 🚀 Prochaines Étapes
+
+### Pour Démarrer
+
+1. **Lire** : [ARCHITECTURE_VISION_COMPLETE.md](./ARCHITECTURE_VISION_COMPLETE.md)
+2. **Comprendre** : Les 5 couches et leurs interactions
+3. **Explorer** : L'exemple "Validation Facture T2A"
+4. **Planifier** : Utiliser le plan de migration (Phase 1-6)
+
+### Pour Implémenter
+
+1. **Phase 1** : Créer les structures de données (Semaines 1-2)
+2. **Phase 2** : Implémenter UIElement Detection (Semaines 3-4)
+3. **Phase 3** : Développer State Embedding (Semaines 5-6)
+4. **Phase 4** : Construire Workflow Graph (Semaines 7-9)
+5. **Phase 5** : Intégrer Learning States (Semaines 10-12)
+6. **Phase 6** : Déployer en production (Semaines 13-14)
+
+### Pour Contribuer
+
+- 📝 Proposer des améliorations aux structures JSON
+- 🔧 Implémenter des composants spécifiques
+- 🧪 Créer des tests et benchmarks
+- 📚 Enrichir la documentation
+
+---
+
+## 📊 Statistiques du Document
+
+| Métrique | Valeur |
+|----------|--------|
+| **Lignes totales** | ~1500 |
+| **Structures JSON** | 15+ |
+| **Exemples de code** | 20+ |
+| **Propositions d'amélioration** | 15+ |
+| **Tableaux de référence** | 10+ |
+| **Diagrammes** | 5+ |
+
+---
+
+## 🔗 Liens Utiles
+
+### Documentation Existante
+
+- [README.md](../../README.md) - Documentation principale
+- [CHANGELOG.md](../../CHANGELOG.md) - Historique des versions
+- [INDEX.md](../../INDEX.md) - Index général
+
+### Spécifications
+
+- [.kiro/specs/rpa-vision-v2/](../../.kiro/specs/rpa-vision-v2/) - Spec RPA Vision V2
+- [.kiro/specs/ui-element-detection/](../../.kiro/specs/ui-element-detection/) - Spec UI Detection
+- [.kiro/specs/workflow-detection-fix/](../../.kiro/specs/workflow-detection-fix/) - Spec Workflow
+
+### Code Source
+
+- [geniusia2/core/](../../geniusia2/core/) - Code principal
+- [geniusia2/core/embedders/](../../geniusia2/core/embedders/) - Système d'embeddings
+- [geniusia2/gui/](../../geniusia2/gui/) - Interface graphique
+
+---
+
+**Dernière mise à jour** : 22 novembre 2024  
+**Maintenu par** : Équipe RPA Vision V2  
+**Statut** : ✅ À jour
+