Initial commit
This commit is contained in:
Dom
265
GUIDE_MIGRATION_V3.md
Normal file
265
GUIDE_MIGRATION_V3.md
Normal file
@@ -0,0 +1,265 @@
|
||||
# 🚀 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` ! 🚀
|
||||
Reference in New Issue
Block a user