117 lines
3.2 KiB
Markdown
117 lines
3.2 KiB
Markdown
# 📖 Guide des Specs - RPA Vision V2
|
|
|
|
## 🗂️ Structure des Specs
|
|
|
|
Toutes les specs sont dans `.kiro/specs/` avec cette structure :
|
|
|
|
```
|
|
.kiro/specs/
|
|
├── faiss-learning-fix/ ✅ TERMINÉ (22 nov 2024)
|
|
│ ├── requirements.md
|
|
│ ├── design.md
|
|
│ └── tasks.md
|
|
├── workflow-detection-fix/
|
|
│ ├── requirements.md
|
|
│ ├── design.md
|
|
│ └── tasks.md
|
|
├── assisted-mode-suggestions/
|
|
│ ├── requirements.md
|
|
│ ├── design.md
|
|
│ └── tasks.md
|
|
├── ui-element-detection/
|
|
│ ├── requirements.md
|
|
│ ├── design.md
|
|
│ └── tasks.md
|
|
├── embedding-improvement/
|
|
│ ├── requirements.md
|
|
│ ├── design.md
|
|
│ └── tasks.md
|
|
└── gui-logs-improvement/
|
|
├── requirements.md
|
|
├── design.md
|
|
└── tasks.md
|
|
```
|
|
|
|
## 🎯 Spec Actuelle : faiss-learning-fix
|
|
|
|
### Problème Résolu
|
|
Après 3 jours de tests, aucune suggestion n'apparaissait car :
|
|
- Index FAISS vide malgré 40 tâches sauvegardées
|
|
- Processus zombies consommant 3GB+ RAM
|
|
- Arrêt impossible sans kill manuel
|
|
|
|
### Fichiers de la Spec
|
|
|
|
#### 📋 [requirements.md](.kiro/specs/faiss-learning-fix/requirements.md)
|
|
8 exigences principales :
|
|
1. Construction automatique de l'index FAISS
|
|
2. Arrêt propre sans processus zombies
|
|
3. Génération de suggestions après actions répétitives
|
|
4. Limitation mémoire à 2GB
|
|
5. Diagnostic complet du système
|
|
6. Reconstruction de l'index
|
|
7. Validation des embeddings
|
|
8. Protection contre boucles infinies
|
|
|
|
#### 🏗️ [design.md](.kiro/specs/faiss-learning-fix/design.md)
|
|
- 4 nouveaux composants
|
|
- 39 correctness properties
|
|
- Stratégie de test avec Hypothesis
|
|
|
|
#### ✅ [tasks.md](.kiro/specs/faiss-learning-fix/tasks.md)
|
|
14 tâches (4 terminées) :
|
|
- ✅ Tâche 1 : FAISSIndexBuilder
|
|
- ✅ Tâche 2 : Chargement automatique
|
|
- ✅ Tâche 3 : Arrêt propre
|
|
- ✅ Tâche 4 : Checkpoint
|
|
- ⏭️ Tâches 5-14 : Améliorations optionnelles
|
|
|
|
### Résultats
|
|
|
|
**Résumé complet** : [FAISS_LEARNING_FIX_COMPLETE.md](FAISS_LEARNING_FIX_COMPLETE.md)
|
|
|
|
- ✅ 40 tâches chargées
|
|
- ✅ 122 embeddings indexés
|
|
- ✅ 672 workflows appris
|
|
- ✅ Application stable
|
|
|
|
## 🔍 Comment Retrouver une Spec ?
|
|
|
|
### Méthode 1 : Par Nom
|
|
```bash
|
|
ls .kiro/specs/
|
|
```
|
|
|
|
### Méthode 2 : Par Problème
|
|
Consultez ce guide ou `INDEX.md`
|
|
|
|
### Méthode 3 : Par Date
|
|
```bash
|
|
ls -lt .kiro/specs/*/requirements.md
|
|
```
|
|
|
|
## 📝 Créer une Nouvelle Spec
|
|
|
|
1. Demander à Kiro : "Je veux créer une spec pour [problème]"
|
|
2. Kiro créera automatiquement :
|
|
- `.kiro/specs/[nom-feature]/requirements.md`
|
|
- `.kiro/specs/[nom-feature]/design.md`
|
|
- `.kiro/specs/[nom-feature]/tasks.md`
|
|
|
|
## 🗄️ Archives
|
|
|
|
Les anciens documents sont dans `docs/archive/` :
|
|
- `sessions/` : Résumés de sessions (SESSION_*.md, RESUME_*.md, etc.)
|
|
- `old-summaries/` : Anciens résumés (*COMPLETE*.md, *FIX*.md, etc.)
|
|
|
|
## 📚 Documentation Complémentaire
|
|
|
|
- **README.md** : Documentation principale
|
|
- **ROADMAP_RPA_100_VISION.md** : Vision du projet
|
|
- **CHANGELOG.md** : Historique des changements
|
|
- **INDEX.md** : Index général de la documentation
|
|
|
|
---
|
|
|
|
**Astuce** : Utilisez `INDEX.md` comme point d'entrée pour naviguer dans la documentation !
|