Geniusia_v2/GUIDE_MIGRATION_V3.md

🚀 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

# 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/ :

# 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

cd ~/ai/Geniusia_v2
chmod +x migrate_to_v3_only.sh
chmod +x verify_migration.sh

Étape 2 : Lancer la Migration

./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

./verify_migration.sh

Ce script vérifie que tous les fichiers critiques sont présents.

Étape 4 : Tester le Nouveau Répertoire

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 :

   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

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

# Après avoir vérifié que tout fonctionne
rm -rf ~/ai/Geniusia_v2

Supprimer la Sauvegarde (Optionnel)

# 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

df -h ~/ai/
# Besoin d'au moins 2GB libres

Problème : Fichiers manquants après migration

Solution : Restaurer depuis la sauvegarde

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

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

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 :

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 ! 🚀