266 lines
5.2 KiB
Markdown
266 lines
5.2 KiB
Markdown
# 🚀 Guide de Migration - RPA Vision V3 Répertoire Unique
|
|
|
|
**Date** : 24 novembre 2024
|
|
**Objectif** : Migrer de `~/ai/Geniusia_v2/rpa_vision_v3/` vers `~/ai/rpa_vision_v3/`
|
|
|
|
---
|
|
|
|
## 📋 Vue d'Ensemble
|
|
|
|
Cette migration va :
|
|
1. ✅ Créer une **sauvegarde complète** de l'ancien répertoire
|
|
2. ✅ Déplacer **rpa_vision_v3** vers un répertoire dédié
|
|
3. ✅ Conserver l'ancien répertoire pour référence
|
|
4. ✅ Créer des fichiers de documentation
|
|
|
|
**Durée estimée** : 2-3 minutes
|
|
|
|
---
|
|
|
|
## ⚠️ Avant de Commencer
|
|
|
|
### Vérifications
|
|
|
|
```bash
|
|
# 1. Vérifier que tu es dans le bon répertoire
|
|
pwd
|
|
# Devrait afficher: /home/dom/ai/Geniusia_v2
|
|
|
|
# 2. Vérifier que rpa_vision_v3 existe
|
|
ls -la rpa_vision_v3/
|
|
# Devrait lister les fichiers du projet
|
|
|
|
# 3. Vérifier l'espace disque disponible (besoin ~2GB)
|
|
df -h ~/ai/
|
|
```
|
|
|
|
### Sauvegardes Recommandées
|
|
|
|
Si tu as des données importantes dans `rpa_vision_v3/data/` :
|
|
|
|
```bash
|
|
# Sauvegarder les données utilisateur
|
|
tar -czf ~/backup_v3_data_$(date +%Y%m%d).tar.gz rpa_vision_v3/data/
|
|
```
|
|
|
|
---
|
|
|
|
## 🚀 Étapes de Migration
|
|
|
|
### Étape 1 : Rendre les Scripts Exécutables
|
|
|
|
```bash
|
|
cd ~/ai/Geniusia_v2
|
|
chmod +x migrate_to_v3_only.sh
|
|
chmod +x verify_migration.sh
|
|
```
|
|
|
|
### Étape 2 : Lancer la Migration
|
|
|
|
```bash
|
|
./migrate_to_v3_only.sh
|
|
```
|
|
|
|
Le script va :
|
|
1. Vérifier que tout est en place
|
|
2. Te demander confirmation
|
|
3. Créer une sauvegarde complète
|
|
4. Déplacer rpa_vision_v3
|
|
5. Créer des fichiers de documentation
|
|
|
|
**Répondre "oui" quand demandé**
|
|
|
|
### Étape 3 : Vérifier la Migration
|
|
|
|
```bash
|
|
./verify_migration.sh
|
|
```
|
|
|
|
Ce script vérifie que tous les fichiers critiques sont présents.
|
|
|
|
### Étape 4 : Tester le Nouveau Répertoire
|
|
|
|
```bash
|
|
cd ~/ai/rpa_vision_v3
|
|
|
|
# Vérifier la structure
|
|
ls -la
|
|
|
|
# Lire les infos de migration
|
|
cat MIGRATION_INFO.md
|
|
|
|
# Tester le lancement (optionnel)
|
|
./run.sh --help
|
|
```
|
|
|
|
---
|
|
|
|
## 📂 Structure Avant/Après
|
|
|
|
### AVANT
|
|
|
|
```
|
|
~/ai/Geniusia_v2/
|
|
├── geniusia2/ ← V2 (ancien)
|
|
├── rpa_vision_v3/ ← V3 (actif)
|
|
├── .kiro/
|
|
├── docs/
|
|
├── test_*.py
|
|
└── ...
|
|
```
|
|
|
|
### APRÈS
|
|
|
|
```
|
|
~/ai/
|
|
├── rpa_vision_v3/ ← V3 (répertoire unique) ✅
|
|
│ ├── core/
|
|
│ ├── docs/
|
|
│ ├── tests/
|
|
│ ├── README.md
|
|
│ └── MIGRATION_INFO.md
|
|
│
|
|
├── Geniusia_v2/ ← Ancien répertoire (conservé)
|
|
│ ├── geniusia2/
|
|
│ ├── README_MIGRATION.md
|
|
│ └── ...
|
|
│
|
|
└── backup_geniusia_v2_*/ ← Sauvegarde complète
|
|
```
|
|
|
|
---
|
|
|
|
## 🔧 Configuration IDE
|
|
|
|
### VS Code
|
|
|
|
1. Fermer le workspace actuel
|
|
2. Ouvrir le nouveau répertoire :
|
|
```bash
|
|
code ~/ai/rpa_vision_v3
|
|
```
|
|
|
|
3. Configurer Python :
|
|
- Ouvrir Command Palette (Ctrl+Shift+P)
|
|
- "Python: Select Interpreter"
|
|
- Choisir `~/ai/rpa_vision_v3/venv/bin/python`
|
|
|
|
### PyCharm
|
|
|
|
1. File → Open
|
|
2. Sélectionner `~/ai/rpa_vision_v3`
|
|
3. Configurer l'interpréteur Python :
|
|
- Settings → Project → Python Interpreter
|
|
- Ajouter `~/ai/rpa_vision_v3/venv/bin/python`
|
|
|
|
---
|
|
|
|
## ✅ Vérifications Post-Migration
|
|
|
|
### Checklist
|
|
|
|
- [ ] Le répertoire `~/ai/rpa_vision_v3` existe
|
|
- [ ] Tous les fichiers sont présents (verify_migration.sh = 0 erreurs)
|
|
- [ ] L'IDE est configuré sur le nouveau répertoire
|
|
- [ ] Les imports Python fonctionnent
|
|
- [ ] Le script `run.sh` fonctionne
|
|
- [ ] La documentation est accessible
|
|
|
|
### Tests Rapides
|
|
|
|
```bash
|
|
cd ~/ai/rpa_vision_v3
|
|
|
|
# Test 1 : Vérifier les imports
|
|
python3 -c "from core.models import workflow_graph; print('✓ Imports OK')"
|
|
|
|
# Test 2 : Vérifier la structure
|
|
python3 verify_imports.py
|
|
|
|
# Test 3 : Lancer les tests unitaires (optionnel)
|
|
pytest tests/unit/ -v
|
|
```
|
|
|
|
---
|
|
|
|
## 🗑️ Nettoyage (Après Vérification)
|
|
|
|
**⚠️ Attendre au moins 1 semaine avant de nettoyer !**
|
|
|
|
### Supprimer l'Ancien Répertoire
|
|
|
|
```bash
|
|
# Après avoir vérifié que tout fonctionne
|
|
rm -rf ~/ai/Geniusia_v2
|
|
```
|
|
|
|
### Supprimer la Sauvegarde (Optionnel)
|
|
|
|
```bash
|
|
# Après plusieurs semaines, si tout est stable
|
|
rm -rf ~/ai/backup_geniusia_v2_*
|
|
```
|
|
|
|
---
|
|
|
|
## 🆘 Dépannage
|
|
|
|
### Problème : Migration échoue
|
|
|
|
**Solution** : Vérifier l'espace disque
|
|
```bash
|
|
df -h ~/ai/
|
|
# Besoin d'au moins 2GB libres
|
|
```
|
|
|
|
### Problème : Fichiers manquants après migration
|
|
|
|
**Solution** : Restaurer depuis la sauvegarde
|
|
```bash
|
|
BACKUP_DIR=$(ls -td ~/ai/backup_geniusia_v2_* | head -1)
|
|
cp -r "$BACKUP_DIR/Geniusia_v2/rpa_vision_v3" ~/ai/
|
|
```
|
|
|
|
### Problème : Imports Python ne fonctionnent pas
|
|
|
|
**Solution** : Réactiver l'environnement virtuel
|
|
```bash
|
|
cd ~/ai/rpa_vision_v3
|
|
source venv/bin/activate
|
|
python3 -c "from core.models import workflow_graph"
|
|
```
|
|
|
|
### Problème : Permissions refusées
|
|
|
|
**Solution** : Corriger les permissions
|
|
```bash
|
|
chmod -R u+rwX ~/ai/rpa_vision_v3
|
|
```
|
|
|
|
---
|
|
|
|
## 📞 Support
|
|
|
|
Si tu rencontres un problème :
|
|
|
|
1. Vérifier les logs de migration
|
|
2. Consulter `MIGRATION_INFO.md` dans le nouveau répertoire
|
|
3. Restaurer depuis la sauvegarde si nécessaire
|
|
4. Me demander de l'aide avec les détails de l'erreur
|
|
|
|
---
|
|
|
|
## ✅ Confirmation Finale
|
|
|
|
Une fois la migration terminée et vérifiée :
|
|
|
|
```bash
|
|
cd ~/ai/rpa_vision_v3
|
|
echo "✅ Migration réussie - RPA Vision V3 opérationnel" > MIGRATION_SUCCESS.txt
|
|
date >> MIGRATION_SUCCESS.txt
|
|
```
|
|
|
|
---
|
|
|
|
**Prêt à migrer ?** Lance `./migrate_to_v3_only.sh` ! 🚀
|