Migration V1 → V2 (technique)

Lien isolé Accueil docs Formation
Technique & dev

Migration technique complète de la Version 1 vers Version 2.

🔄 Guide de Migration des Boutiques : Version 1 → Version 2

Ce guide explique comment migrer les données d'une boutique de la Version 1 vers la Version 2, en tenant compte du préfixe des tables.

⚠️ Comprendre le Préfixe

Structure des Tables

Version 1 (sans préfixe) :

  • users
  • products
  • sales
  • shops
  • categories
  • etc.

Version 2 (avec préfixe v2_) :

  • v2_users
  • v2_products
  • v2_sales
  • v2_shops
  • v2_categories
  • etc.

Impact sur la Migration

✅ Avantage : Les deux versions peuvent coexister sans conflit
⚠️ Défi : La migration doit lire depuis les tables v1 et écrire dans les tables v2

🎯 Stratégie de Migration

Option 1 : Migration Automatique (RECOMMANDÉ)

Créer un service de migration qui :

  1. Se connecte aux deux bases de données (ou utilise deux connexions)
  2. Lit les données depuis les tables v1 (sans préfixe)
  3. Transforme/adapter les données si nécessaire
  4. Insère les données dans les tables v2 (avec préfixe v2_)

Option 2 : Migration Manuelle via SQL

Utiliser des requêtes SQL directes pour copier les données.

🔧 Solution : Service de Migration Adapté

Connexions de Base de Données

Dans config/database.php, ajoutez une connexion pour la v1 :

'connections' => [
    'mysql' => [
        // Connexion par défaut (Version 2 avec préfixe v2_)
        'prefix' => env('DB_PREFIX', ''),
        // ...
    ],
    'mysql_v1' => [
        // Connexion pour lire depuis la Version 1 (sans préfixe)
        'driver' => 'mysql',
        'host' => env('DB_HOST', '127.0.0.1'),
        'port' => env('DB_PORT', '3306'),
        'database' => env('DB_DATABASE'), // Même base
        'username' => env('DB_USERNAME'),
        'password' => env('DB_PASSWORD'),
        'prefix' => '', // Pas de préfixe pour v1
        'charset' => 'utf8mb4',
        'collation' => 'utf8mb4_unicode_ci',
    ],
],

Service de Migration Adapté

Le service de migration doit :

  1. Lire depuis la connexion v1 (sans préfixe)
  2. Écrire dans la connexion v2 (avec préfixe v2_)

Exemple de structure :

// Lire depuis v1
$v1Shop = DB::connection('mysql_v1')->table('shops')->find($shopId);

// Écrire dans v2
DB::connection('mysql')->table('v2_shops')->insert([
    'name' => $v1Shop->name,
    // ... autres champs
]);

📋 Processus de Migration d'une Boutique

Étape 1 : Préparer la Migration

  1. Vérifier que la boutique existe dans la v1
  2. Vérifier que la boutique n'existe pas déjà dans la v2
  3. Créer une sauvegarde de sécurité

Étape 2 : Migrer les Données Principales

Ordre recommandé (respecter les dépendances) :

  1. Shop (boutique elle-même)
  2. Users (utilisateurs de la boutique)
  3. Categories (catégories)
  4. Products (produits - dépend de categories)
  5. Suppliers (fournisseurs)
  6. Purchases (achats - dépend de suppliers, products)
  7. Sales (ventes - dépend de products, users)
  8. Stock Movements (mouvements de stock)
  9. Cash Sessions (sessions de caisse)
  10. Settings (paramètres)

Étape 3 : Vérifier l'Intégrité

  • Vérifier que toutes les données sont migrées
  • Vérifier les relations (foreign keys)
  • Vérifier les totaux (stock, ventes, etc.)

🛠️ Implémentation Pratique

Exemple : Migration d'une Boutique

public function migrateShopFromV1ToV2($v1ShopId)
{
    DB::beginTransaction();
    
    try {
        // 1. Lire la boutique depuis v1
        $v1Shop = DB::connection('mysql_v1')
            ->table('shops')
            ->where('id', $v1ShopId)
            ->first();
        
        if (!$v1Shop) {
            throw new \Exception("Boutique non trouvée dans la v1");
        }
        
        // 2. Vérifier qu'elle n'existe pas déjà dans v2
        $existingV2Shop = DB::connection('mysql')
            ->table('v2_shops')
            ->where('name', $v1Shop->name)
            ->first();
        
        if ($existingV2Shop) {
            throw new \Exception("Boutique déjà migrée dans la v2");
        }
        
        // 3. Créer la boutique dans v2
        $v2ShopId = DB::connection('mysql')
            ->table('v2_shops')
            ->insertGetId([
                'name' => $v1Shop->name,
                'description' => $v1Shop->description,
                'logo' => $v1Shop->logo,
                // ... autres champs
                'app_version' => '2.0',
                'migrated_at' => now(),
                'migration_notes' => "Migré depuis v1 (ID: {$v1ShopId})",
            ]);
        
        // 4. Migrer les utilisateurs de cette boutique
        $v1Users = DB::connection('mysql_v1')
            ->table('users')
            ->where('shop_id', $v1ShopId)
            ->get();
        
        foreach ($v1Users as $v1User) {
            DB::connection('mysql')
                ->table('v2_users')
                ->insert([
                    'name' => $v1User->name,
                    'email' => $v1User->email,
                    'password' => $v1User->password, // Garder le même hash
                    'shop_id' => $v2ShopId,
                    // ... autres champs
                ]);
        }
        
        // 5. Migrer les catégories
        // ... (même principe)
        
        // 6. Migrer les produits
        // ... (même principe)
        
        // 7. Migrer les ventes, achats, etc.
        // ... (même principe)
        
        DB::commit();
        
        return [
            'success' => true,
            'v1_shop_id' => $v1ShopId,
            'v2_shop_id' => $v2ShopId,
            'migrated_data' => [
                'users' => count($v1Users),
                // ... autres compteurs
            ],
        ];
        
    } catch (\Exception $e) {
        DB::rollBack();
        throw $e;
    }
}

⚠️ Points d'Attention

1. Gestion des IDs

Les IDs peuvent être différents entre v1 et v2. Il faut :

  • Soit conserver les IDs originaux (si possible)
  • Soit mapper les IDs (créer une table de correspondance)

2. Relations (Foreign Keys)

Les relations doivent être adaptées :

  • product.category_id dans v1 → v2_product.v2_category_id dans v2
  • Utiliser un mapping des IDs si nécessaire

3. Données Uniques

Vérifier les contraintes d'unicité :

  • Emails d'utilisateurs
  • Codes de produits
  • Références de ventes/achats

4. Données Calculées

Certaines données peuvent être recalculées :

  • Totaux de stock
  • Statistiques
  • Soldes de caisse

✅ Vérifications Post-Migration

Checklist

  • Boutique créée dans v2 avec toutes les informations
  • Tous les utilisateurs migrés
  • Toutes les catégories migrées
  • Tous les produits migrés avec leurs relations
  • Toutes les ventes migrées
  • Tous les achats migrés
  • Stock synchronisé
  • Relations (foreign keys) correctes
  • Données uniques respectées
  • Totaux et statistiques cohérents

Requêtes de Vérification

-- Vérifier le nombre d'éléments migrés
SELECT 
    (SELECT COUNT(*) FROM shops WHERE id = ?) as v1_count,
    (SELECT COUNT(*) FROM v2_shops WHERE id = ?) as v2_count;

-- Vérifier les relations
SELECT COUNT(*) 
FROM v2_products p
LEFT JOIN v2_categories c ON p.category_id = c.id
WHERE c.id IS NULL; -- Devrait être 0

🚀 Commandes Artisan

Créer une Commande de Migration

php artisan make:command MigrateShopFromV1ToV2

Usage :

php artisan shop:migrate-from-v1 {v1_shop_id} {--dry-run}

📝 Notes Importantes

  1. Les deux versions coexistent : La migration ne supprime pas les données de la v1
  2. Migration réversible : Gardez toujours une sauvegarde avant migration
  3. Migration progressive : Migrez boutique par boutique, pas tout d'un coup
  4. Tests : Testez d'abord sur une boutique de test

🔒 Sécurité

  • ✅ Toujours créer une sauvegarde avant migration
  • ✅ Utiliser des transactions pour garantir l'intégrité
  • ✅ Vérifier les données après migration
  • ✅ Ne pas supprimer les données v1 immédiatement

Conclusion : Le préfixe des tables ne pose PAS de problème pour la migration. Au contraire, il permet de migrer progressivement tout en gardant les deux versions fonctionnelles.