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