feat: Version 3.5.2 - Configuration Stripe et gestion des immeubles

- Configuration complète Stripe pour les 3 environnements (DEV/REC/PROD)
  * DEV: Clés TEST Pierre (mode test)
  * REC: Clés TEST Client (mode test)
  * PROD: Clés LIVE Client (mode live)
- Ajout de la gestion des bases de données immeubles/bâtiments
  * Configuration buildings_database pour DEV/REC/PROD
  * Service BuildingService pour enrichissement des adresses
- Optimisations pages et améliorations ergonomie
- Mises à jour des dépendances Composer
- Nettoyage des fichiers obsolètes

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

api/scripts/php/create_missing_stripe_locations.php

@@ -0,0 +1,240 @@
+#!/usr/bin/env php
+<?php
+/**
+ * Script : Créer les Stripe Terminal Locations manquantes
+ *
+ * Raison : Certains comptes Stripe Connect ont été créés avant l'implémentation
+ *          de la création automatique de Location. Ce script crée les Locations
+ *          manquantes pour tous les comptes existants.
+ *
+ * Date : 2025-11-03
+ * Auteur : Migration automatique
+ */
+
+// Simuler l'environnement web pour AppConfig en CLI
+if (php_sapi_name() === 'cli') {
+    $hostname = gethostname();
+    if (strpos($hostname, 'pra') !== false) {
+        $_SERVER['SERVER_NAME'] = 'app3.geosector.fr';
+    } elseif (strpos($hostname, 'rca') !== false) {
+        $_SERVER['SERVER_NAME'] = 'rapp.geosector.fr';
+    } else {
+        $_SERVER['SERVER_NAME'] = 'dapp.geosector.fr';
+    }
+
+    $_SERVER['HTTP_HOST'] = $_SERVER['HTTP_HOST'] ?? $_SERVER['SERVER_NAME'];
+    $_SERVER['REMOTE_ADDR'] = $_SERVER['REMOTE_ADDR'] ?? '127.0.0.1';
+
+    if (!function_exists('getallheaders')) {
+        function getallheaders() {
+            return [];
+        }
+    }
+}
+
+// Charger l'autoloader Composer (pour Stripe SDK)
+require_once dirname(dirname(__DIR__)) . '/vendor/autoload.php';
+
+// Charger les classes nécessaires explicitement
+require_once dirname(dirname(__DIR__)) . '/src/Config/AppConfig.php';
+require_once dirname(dirname(__DIR__)) . '/src/Core/Database.php';
+require_once dirname(dirname(__DIR__)) . '/src/Services/ApiService.php';
+require_once dirname(dirname(__DIR__)) . '/src/Services/LogService.php';
+require_once dirname(dirname(__DIR__)) . '/src/Services/StripeService.php';
+
+use App\Services\StripeService;
+
+// Initialiser la configuration
+$config = AppConfig::getInstance();
+$env = $config->getEnvironment();
+$dbConfig = $config->getDatabaseConfig();
+
+echo "\n";
+echo "=============================================================================\n";
+echo "  Création des Stripe Terminal Locations manquantes\n";
+echo "=============================================================================\n";
+echo "Environnement : " . strtoupper($env) . "\n";
+echo "Base de données : " . $dbConfig['name'] . "\n";
+echo "\n";
+
+try {
+    // Initialiser la base de données avec la configuration
+    Database::init($dbConfig);
+    $db = Database::getInstance();
+
+    // StripeService est un singleton
+    $stripeService = StripeService::getInstance();
+
+    // 1. Identifier les comptes sans Location
+    echo "📋 Recherche des comptes Stripe sans Location...\n\n";
+
+    $stmt = $db->query("
+        SELECT
+            sa.id,
+            sa.fk_entite,
+            sa.stripe_account_id,
+            sa.stripe_location_id,
+            e.encrypted_name,
+            e.adresse1,
+            e.adresse2,
+            e.code_postal,
+            e.ville
+        FROM stripe_accounts sa
+        INNER JOIN entites e ON sa.fk_entite = e.id
+        WHERE sa.stripe_account_id IS NOT NULL
+        AND (sa.stripe_location_id IS NULL OR sa.stripe_location_id = '')
+        AND e.chk_active = 1
+    ");
+
+    $accountsWithoutLocation = $stmt->fetchAll(PDO::FETCH_ASSOC);
+    $total = count($accountsWithoutLocation);
+
+    if ($total === 0) {
+        echo "✅ Aucun compte sans Location trouvé. Tous les comptes sont à jour !\n\n";
+        exit(0);
+    }
+
+    echo "ℹ️  Trouvé $total compte(s) sans Location :\n\n";
+
+    foreach ($accountsWithoutLocation as $account) {
+        $name = !empty($account['encrypted_name'])
+            ? ApiService::decryptData($account['encrypted_name'])
+            : 'Amicale #' . $account['fk_entite'];
+
+        echo "   - Entité #{$account['fk_entite']} : $name\n";
+        echo "     Stripe Account : {$account['stripe_account_id']}\n";
+        echo "     Adresse : {$account['adresse1']}, {$account['code_postal']} {$account['ville']}\n\n";
+    }
+
+    // Demander confirmation
+    echo "⚠️  Voulez-vous créer les Locations manquantes ? (yes/no) : ";
+    $handle = fopen("php://stdin", "r");
+    $line = trim(fgets($handle));
+    fclose($handle);
+
+    if ($line !== 'yes') {
+        echo "❌ Opération annulée.\n\n";
+        exit(0);
+    }
+
+    echo "\n🚀 Création des Locations...\n\n";
+
+    // Initialiser Stripe avec la bonne clé selon le mode
+    $stripeConfig = $config->getStripeConfig();
+    $stripeMode = $stripeConfig['mode'] ?? 'test';
+    $stripeSecretKey = ($stripeMode === 'live')
+        ? $stripeConfig['secret_key_live']
+        : $stripeConfig['secret_key_test'];
+
+    \Stripe\Stripe::setApiKey($stripeSecretKey);
+    echo "ℹ️  Mode Stripe : " . strtoupper($stripeMode) . "\n\n";
+
+    $success = 0;
+    $errors = 0;
+
+    // 2. Créer les Locations manquantes
+    foreach ($accountsWithoutLocation as $account) {
+        $entiteId = $account['fk_entite'];
+        $stripeAccountId = $account['stripe_account_id'];
+
+        $name = !empty($account['encrypted_name'])
+            ? ApiService::decryptData($account['encrypted_name'])
+            : 'Amicale #' . $entiteId;
+
+        echo "🔧 Entité #{$entiteId} : $name\n";
+
+        try {
+            // Construire l'adresse
+            $adresse1 = !empty($account['adresse1']) ? $account['adresse1'] : 'Adresse non renseignée';
+            $ville = !empty($account['ville']) ? $account['ville'] : 'Ville';
+            $codePostal = !empty($account['code_postal']) ? $account['code_postal'] : '00000';
+
+            // Construire l'adresse pour Stripe (ne pas envoyer line2 si vide)
+            $addressData = [
+                'line1' => $adresse1,
+                'city' => $ville,
+                'postal_code' => $codePostal,
+                'country' => 'FR',
+            ];
+
+            // Ajouter line2 seulement s'il n'est pas vide
+            if (!empty($account['adresse2'])) {
+                $addressData['line2'] = $account['adresse2'];
+            }
+
+            // Créer la Location via Stripe API
+            $location = \Stripe\Terminal\Location::create([
+                'display_name' => $name,
+                'address' => $addressData,
+                'metadata' => [
+                    'entite_id' => $entiteId,
+                    'type' => 'tap_to_pay',
+                    'created_by' => 'migration_script'
+                ]
+            ], [
+                'stripe_account' => $stripeAccountId
+            ]);
+
+            $locationId = $location->id;
+
+            // Mettre à jour la base de données
+            $updateStmt = $db->prepare("
+                UPDATE stripe_accounts
+                SET stripe_location_id = :location_id,
+                    updated_at = NOW()
+                WHERE id = :id
+            ");
+
+            $updateStmt->execute([
+                'location_id' => $locationId,
+                'id' => $account['id']
+            ]);
+
+            echo "   ✅ Location créée : $locationId\n\n";
+            $success++;
+
+        } catch (\Stripe\Exception\ApiErrorException $e) {
+            echo "   ❌ Erreur Stripe : " . $e->getMessage() . "\n\n";
+            $errors++;
+        } catch (Exception $e) {
+            echo "   ❌ Erreur : " . $e->getMessage() . "\n\n";
+            $errors++;
+        }
+    }
+
+    // 3. Résumé
+    echo "\n";
+    echo "=============================================================================\n";
+    echo "  Résumé de l'opération\n";
+    echo "=============================================================================\n";
+    echo "✅ Locations créées avec succès : $success\n";
+    echo "❌ Erreurs : $errors\n";
+    echo "📊 Total traité : $total\n";
+    echo "\n";
+
+    // 4. Vérification finale
+    echo "🔍 Vérification finale...\n";
+    $stmt = $db->query("
+        SELECT COUNT(*) as remaining
+        FROM stripe_accounts sa
+        WHERE sa.stripe_account_id IS NOT NULL
+        AND (sa.stripe_location_id IS NULL OR sa.stripe_location_id = '')
+    ");
+    $remaining = $stmt->fetch(PDO::FETCH_ASSOC);
+
+    echo "   ℹ️  Comptes restants sans Location : " . $remaining['remaining'] . "\n\n";
+
+    if ($remaining['remaining'] == 0) {
+        echo "🎉 Tous les comptes Stripe ont maintenant une Location !\n\n";
+    }
+
+} catch (Exception $e) {
+    echo "\n";
+    echo "=============================================================================\n";
+    echo "  ❌ ERREUR\n";
+    echo "=============================================================================\n";
+    echo "Message : " . $e->getMessage() . "\n";
+    echo "Fichier : " . $e->getFile() . ":" . $e->getLine() . "\n";
+    echo "\n";
+    exit(1);
+}

api/scripts/php/migrate_from_backup_verbose.php

@@ -0,0 +1,543 @@
+#!/usr/bin/env php
+<?php
+
+/**
+ * Script de migration VERBOSE avec détails table par table
+ *
+ * Usage:
+ *   php migrate_from_backup_verbose.php \
+ *     --source-db=geosector_20251008 \
+ *     --target-db=pra_geo \
+ *     --entity-id=1178 \
+ *     --limit-operations=3
+ */
+
+// Inclusion des dépendances de l'API
+require_once dirname(dirname(__DIR__)) . '/bootstrap.php';
+
+use GeoSector\Services\ApiService;
+
+// Configuration
+const DB_HOST = '13.23.33.4';
+const DB_PORT = 3306;
+const DB_USER = 'pra_geo_user';
+const DB_PASS = 'd2jAAGGWi8fxFrWgXjOA';
+const DB_USER_ROOT = 'root';
+const DB_PASS_ROOT = 'MyAlpLocal,90b';
+
+// Couleurs pour terminal
+const C_RESET = "\033[0m";
+const C_RED = "\033[0;31m";
+const C_GREEN = "\033[0;32m";
+const C_YELLOW = "\033[1;33m";
+const C_BLUE = "\033[0;34m";
+const C_CYAN = "\033[0;36m";
+const C_BOLD = "\033[1m";
+
+// Variables globales
+$sourceDb = null;
+$targetDb = null;
+$sourceDbName = null;
+$targetDbName = null;
+$entityId = null;
+$limitOperations = 3;
+$stats = [
+    'entites' => ['source' => 0, 'migrated' => 0],
+    'users' => ['source' => 0, 'migrated' => 0],
+    'operations' => ['source' => 0, 'migrated' => 0],
+    'ope_sectors' => ['source' => 0, 'migrated' => 0],
+    'sectors_adresses' => ['source' => 0, 'migrated' => 0],
+    'ope_users' => ['source' => 0, 'migrated' => 0],
+    'ope_users_sectors' => ['source' => 0, 'migrated' => 0],
+    'ope_pass' => ['source' => 0, 'migrated' => 0],
+    'ope_pass_histo' => ['source' => 0, 'migrated' => 0],
+    'medias' => ['source' => 0, 'migrated' => 0],
+];
+
+// Fonctions utilitaires
+function println($message, $color = C_RESET) {
+    echo $color . $message . C_RESET . "\n";
+}
+
+function printBox($title, $color = C_BLUE) {
+    $width = 70;
+    $titleLen = strlen($title);
+    $padding = ($width - $titleLen - 2) / 2;
+
+    println(str_repeat("═", $width), $color);
+    println(str_repeat(" ", floor($padding)) . $title . str_repeat(" ", ceil($padding)), $color);
+    println(str_repeat("═", $width), $color);
+}
+
+function printStep($step, $substep = null) {
+    if ($substep) {
+        println("  ├─ " . $substep, C_CYAN);
+    } else {
+        println("\n" . C_BOLD . "▶ " . $step . C_RESET);
+    }
+}
+
+function printStat($label, $source, $migrated, $indent = "  ") {
+    $status = ($source === $migrated) ? C_GREEN . "✓" : C_YELLOW . "⚠";
+    println($indent . "📊 {$label}: {$source} source → {$migrated} migré(s) {$status}" . C_RESET);
+}
+
+function connectDatabases($sourceDbName, $targetDbName) {
+    global $sourceDb, $targetDb;
+
+    printStep("Connexion aux bases de données");
+
+    try {
+        // Base source
+        $dsn = sprintf('mysql:host=%s;port=%d;dbname=%s;charset=utf8mb4',
+            DB_HOST, DB_PORT, $sourceDbName);
+        $sourceDb = new PDO($dsn, DB_USER_ROOT, DB_PASS_ROOT, [
+            PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
+            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
+        ]);
+        printStep("Source connectée: {$sourceDbName}", true);
+
+        // Base cible
+        $dsn = sprintf('mysql:host=%s;port=%d;dbname=%s;charset=utf8mb4',
+            DB_HOST, DB_PORT, $targetDbName);
+        $targetDb = new PDO($dsn, DB_USER, DB_PASS, [
+            PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
+            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
+        ]);
+        printStep("Cible connectée: {$targetDbName}", true);
+
+        return true;
+    } catch (PDOException $e) {
+        println("✗ Erreur connexion: " . $e->getMessage(), C_RED);
+        return false;
+    }
+}
+
+function getEntityInfo($entityId) {
+    global $sourceDb;
+
+    $stmt = $sourceDb->prepare("
+        SELECT rowid, libelle, cp, ville
+        FROM users_entites
+        WHERE rowid = ?
+    ");
+    $stmt->execute([$entityId]);
+    return $stmt->fetch();
+}
+
+function migrateReferenceTable($tableName) {
+    global $sourceDb, $targetDb;
+
+    printStep("Migration table: {$tableName}");
+
+    // Compter source
+    $count = $sourceDb->query("SELECT COUNT(*) FROM {$tableName}")->fetchColumn();
+    printStep("Source: {$count} enregistrements", true);
+
+    if ($count === 0) {
+        printStep("Aucune donnée à migrer", true);
+        return 0;
+    }
+
+    // Récupérer les données
+    $rows = $sourceDb->query("SELECT * FROM {$tableName}")->fetchAll();
+
+    // Préparer l'insertion
+    $columns = array_keys($rows[0]);
+    $placeholders = array_map(fn($col) => ":{$col}", $columns);
+
+    $sql = sprintf(
+        "INSERT INTO %s (%s) VALUES (%s) ON DUPLICATE KEY UPDATE %s",
+        $tableName,
+        implode(', ', $columns),
+        implode(', ', $placeholders),
+        implode(', ', array_map(fn($col) => "{$col} = VALUES({$col})", $columns))
+    );
+
+    $stmt = $targetDb->prepare($sql);
+
+    $success = 0;
+    foreach ($rows as $row) {
+        try {
+            $stmt->execute($row);
+            $success++;
+        } catch (PDOException $e) {
+            // Ignorer erreurs
+        }
+    }
+
+    printStep("Migré: {$success}/{$count}", true);
+    return $success;
+}
+
+function migrateEntite($entityId) {
+    global $sourceDb, $targetDb, $stats;
+
+    printStep("ÉTAPE 1: Migration de l'entité #{$entityId}");
+
+    // Récupérer l'entité source
+    $stmt = $sourceDb->prepare("
+        SELECT * FROM users_entites WHERE rowid = ?
+    ");
+    $stmt->execute([$entityId]);
+    $entity = $stmt->fetch();
+
+    if (!$entity) {
+        println("  ✗ Entité introuvable", C_RED);
+        return false;
+    }
+
+    $stats['entites']['source'] = 1;
+
+    println("  📋 Entité: " . $entity['libelle']);
+    println("  📍 Code postal: " . ($entity['cp'] ?? 'N/A'));
+    println("  🏙️  Ville: " . ($entity['ville'] ?? 'N/A'));
+
+    // Chiffrer les données
+    $encryptedName = ApiService::encryptSearchableData($entity['libelle']);
+    $encryptedEmail = !empty($entity['email']) ? ApiService::encryptSearchableData($entity['email']) : '';
+    $encryptedPhone = !empty($entity['phone']) ? ApiService::encryptData($entity['phone']) : '';
+    $encryptedMobile = !empty($entity['mobile']) ? ApiService::encryptData($entity['mobile']) : '';
+
+    // Insérer dans la cible
+    $sql = "INSERT INTO entites (
+        id, encrypted_name, code_postal, ville, encrypted_email, encrypted_phone, encrypted_mobile,
+        fk_region, fk_type, chk_active, created_at, updated_at
+    ) VALUES (
+        :id, :name, :cp, :ville, :email, :phone, :mobile,
+        :region, :type, :active, :created, :updated
+    ) ON DUPLICATE KEY UPDATE
+        encrypted_name = VALUES(encrypted_name),
+        code_postal = VALUES(code_postal),
+        ville = VALUES(ville)";
+
+    $stmt = $targetDb->prepare($sql);
+    $stmt->execute([
+        'id' => $entity['rowid'],
+        'name' => $encryptedName,
+        'cp' => $entity['cp'] ?? '',
+        'ville' => $entity['ville'] ?? '',
+        'email' => $encryptedEmail,
+        'phone' => $encryptedPhone,
+        'mobile' => $encryptedMobile,
+        'region' => $entity['fk_region'] ?? 1,
+        'type' => $entity['fk_type'] ?? 1,
+        'active' => $entity['active'] ?? 1,
+        'created' => $entity['date_creat'],
+        'updated' => $entity['date_modif']
+    ]);
+
+    $stats['entites']['migrated'] = 1;
+
+    printStat("Entité", 1, 1);
+
+    return true;
+}
+
+function migrateUsers($entityId) {
+    global $sourceDb, $targetDb, $stats;
+
+    printStep("ÉTAPE 2: Migration des utilisateurs");
+
+    // Compter source
+    $count = $sourceDb->prepare("SELECT COUNT(*) FROM users WHERE fk_entite = ? AND active = 1");
+    $count->execute([$entityId]);
+    $sourceCount = $count->fetchColumn();
+
+    $stats['users']['source'] = $sourceCount;
+    println("  📊 Source: {$sourceCount} utilisateurs actifs");
+
+    if ($sourceCount === 0) {
+        println("  ⚠️  Aucun utilisateur à migrer", C_YELLOW);
+        return 0;
+    }
+
+    // Récupérer les users
+    $stmt = $sourceDb->prepare("
+        SELECT * FROM users WHERE fk_entite = ? AND active = 1
+    ");
+    $stmt->execute([$entityId]);
+    $users = $stmt->fetchAll();
+
+    $success = 0;
+    foreach ($users as $user) {
+        try {
+            $encryptedName = ApiService::encryptSearchableData($user['nom']);
+            $encryptedUsername = !empty($user['username']) ? ApiService::encryptSearchableData($user['username']) : '';
+            $encryptedEmail = !empty($user['email']) ? ApiService::encryptSearchableData($user['email']) : '';
+            $encryptedPhone = !empty($user['telephone']) ? ApiService::encryptData($user['telephone']) : '';
+            $encryptedMobile = !empty($user['mobile']) ? ApiService::encryptData($user['mobile']) : '';
+
+            $sql = "INSERT INTO users (
+                id, fk_entite, fk_role, encrypted_name, first_name,
+                encrypted_user_name, user_pass_hash, encrypted_email,
+                encrypted_phone, encrypted_mobile, chk_active, created_at, updated_at
+            ) VALUES (
+                :id, :entity, :role, :name, :firstname,
+                :username, :pass, :email,
+                :phone, :mobile, :active, :created, :updated
+            ) ON DUPLICATE KEY UPDATE
+                encrypted_name = VALUES(encrypted_name),
+                encrypted_email = VALUES(encrypted_email)";
+
+            $stmt = $targetDb->prepare($sql);
+            $stmt->execute([
+                'id' => $user['rowid'],
+                'entity' => $entityId,
+                'role' => $user['fk_role'] ?? 1,
+                'name' => $encryptedName,
+                'firstname' => $user['prenom'] ?? '',
+                'username' => $encryptedUsername,
+                'pass' => $user['password'] ?? '',
+                'email' => $encryptedEmail,
+                'phone' => $encryptedPhone,
+                'mobile' => $encryptedMobile,
+                'active' => 1,
+                'created' => $user['date_creat'],
+                'updated' => $user['date_modif']
+            ]);
+
+            $success++;
+        } catch (PDOException $e) {
+            // Ignorer
+        }
+    }
+
+    $stats['users']['migrated'] = $success;
+    printStat("Utilisateurs", $sourceCount, $success);
+
+    return $success;
+}
+
+function migrateOperations($entityId, $limit = 3) {
+    global $sourceDb, $targetDb, $stats;
+
+    printStep("ÉTAPE 3: Migration des opérations (limite: {$limit})");
+
+    // Compter toutes les opérations
+    $count = $sourceDb->prepare("SELECT COUNT(*) FROM operations WHERE fk_entite = ? AND active = 1");
+    $count->execute([$entityId]);
+    $totalCount = $count->fetchColumn();
+
+    println("  📊 Total disponible: {$totalCount} opérations");
+    println("  🎯 Limitation: {$limit} dernières opérations");
+
+    $stats['operations']['source'] = min($limit, $totalCount);
+
+    // Récupérer les N dernières opérations
+    $stmt = $sourceDb->prepare("
+        SELECT * FROM operations
+        WHERE fk_entite = ? AND active = 1
+        ORDER BY date_creat DESC
+        LIMIT ?
+    ");
+    $stmt->execute([$entityId, $limit]);
+    $operations = $stmt->fetchAll();
+
+    if (empty($operations)) {
+        println("  ⚠️  Aucune opération à migrer", C_YELLOW);
+        return [];
+    }
+
+    $migratedOps = [];
+    foreach ($operations as $op) {
+        try {
+            $sql = "INSERT INTO operations (
+                id, fk_entite, libelle, date_deb, date_fin,
+                chk_distinct_sectors, chk_active, created_at, updated_at
+            ) VALUES (
+                :id, :entity, :libelle, :datedeb, :datefin,
+                :distinct, :active, :created, :updated
+            ) ON DUPLICATE KEY UPDATE
+                libelle = VALUES(libelle)";
+
+            $stmt = $targetDb->prepare($sql);
+            $stmt->execute([
+                'id' => $op['rowid'],
+                'entity' => $entityId,
+                'libelle' => $op['libelle'],
+                'datedeb' => $op['date_deb'],
+                'datefin' => $op['date_fin'],
+                'distinct' => $op['chk_distinct_sectors'] ?? 0,
+                'active' => 1,
+                'created' => $op['date_creat'],
+                'updated' => $op['date_modif']
+            ]);
+
+            $migratedOps[] = $op['rowid'];
+            $stats['operations']['migrated']++;
+
+            println("  ├─ Opération #{$op['rowid']}: " . $op['libelle'], C_GREEN);
+        } catch (PDOException $e) {
+            println("  ├─ ✗ Erreur opération #{$op['rowid']}: " . $e->getMessage(), C_RED);
+        }
+    }
+
+    printStat("Opérations", count($operations), count($migratedOps));
+
+    return $migratedOps;
+}
+
+function migrateOperationDetails($operationId, $entityId) {
+    global $sourceDb, $targetDb, $stats;
+
+    println("\n  " . C_BOLD . "┌─ Détails opération #{$operationId}" . C_RESET);
+
+    // 1. Compter les passages
+    $passCount = $sourceDb->prepare("SELECT COUNT(*) FROM ope_pass WHERE fk_operation = ?");
+    $passCount->execute([$operationId]);
+    $nbPassages = $passCount->fetchColumn();
+
+    println("  │  📊 Passages disponibles: {$nbPassages}");
+
+    // 2. Compter les ope_users
+    $opeUsersCount = $sourceDb->prepare("SELECT COUNT(*) FROM ope_users WHERE fk_operation = ?");
+    $opeUsersCount->execute([$operationId]);
+    $nbOpeUsers = $opeUsersCount->fetchColumn();
+
+    $stats['ope_users']['source'] += $nbOpeUsers;
+    println("  │  👥 Associations users: {$nbOpeUsers}");
+
+    // 3. Compter les secteurs (via ope_users_sectors)
+    $sectorsCount = $sourceDb->prepare("
+        SELECT COUNT(DISTINCT ous.fk_sector)
+        FROM ope_users_sectors ous
+        WHERE ous.fk_operation = ?
+    ");
+    $sectorsCount->execute([$operationId]);
+    $nbSectors = $sectorsCount->fetchColumn();
+
+    println("  │  🗺️  Secteurs distincts: {$nbSectors}");
+
+    println("  └─ " . C_CYAN . "Migration des données associées..." . C_RESET);
+
+    // Migration ope_users (simplifié pour l'exemple)
+    // ... (code de migration réel ici)
+
+    $stats['ope_pass']['source'] += $nbPassages;
+}
+
+// === MAIN ===
+
+function parseArguments($argv) {
+    $args = [
+        'source-db' => null,
+        'target-db' => 'pra_geo',
+        'entity-id' => null,
+        'limit-operations' => 3,
+        'help' => false
+    ];
+
+    foreach ($argv as $arg) {
+        if (strpos($arg, '--') === 0) {
+            $parts = explode('=', substr($arg, 2), 2);
+            $key = $parts[0];
+            $value = $parts[1] ?? true;
+
+            if (array_key_exists($key, $args)) {
+                $args[$key] = $value;
+            }
+        }
+    }
+
+    return $args;
+}
+
+// Vérifier CLI
+if (php_sapi_name() !== 'cli') {
+    die("Ce script doit être exécuté en ligne de commande.\n");
+}
+
+$args = parseArguments($argv);
+
+if ($args['help'] || !$args['source-db'] || !$args['entity-id']) {
+    echo <<<HELP
+
+Usage: php migrate_from_backup_verbose.php [OPTIONS]
+
+Options:
+  --source-db=NAME         Base source (ex: geosector_20251008) [REQUIS]
+  --target-db=NAME         Base cible (défaut: pra_geo)
+  --entity-id=ID           ID de l'entité à migrer [REQUIS]
+  --limit-operations=N     Nombre d'opérations à migrer (défaut: 3)
+  --help                   Affiche cette aide
+
+Exemple:
+  php migrate_from_backup_verbose.php \\
+    --source-db=geosector_20251008 \\
+    --target-db=pra_geo \\
+    --entity-id=1178 \\
+    --limit-operations=3
+
+HELP;
+    exit($args['help'] ? 0 : 1);
+}
+
+$sourceDbName = $args['source-db'];
+$targetDbName = $args['target-db'];
+$entityId = (int)$args['entity-id'];
+$limitOperations = (int)$args['limit-operations'];
+
+// Bannière
+printBox("MIGRATION VERBOSE - DÉTAILS TABLE PAR TABLE", C_BLUE);
+println("📅 Date: " . date('Y-m-d H:i:s'));
+println("📁 Source: {$sourceDbName}");
+println("📁 Cible: {$targetDbName}");
+println("🎯 Entité: #{$entityId}");
+println("📊 Limite opérations: {$limitOperations}");
+println("");
+
+// Connexion
+if (!connectDatabases($sourceDbName, $targetDbName)) {
+    exit(1);
+}
+
+// Récupérer infos entité
+$entityInfo = getEntityInfo($entityId);
+if (!$entityInfo) {
+    println("✗ Entité #{$entityId} introuvable", C_RED);
+    exit(1);
+}
+
+println("\n📋 Entité trouvée: " . $entityInfo['libelle']);
+println("📍 CP: " . ($entityInfo['cp'] ?? 'N/A') . " - Ville: " . ($entityInfo['ville'] ?? 'N/A'));
+println("");
+
+// Migration des tables de référence (x_*)
+printBox("TABLES DE RÉFÉRENCE", C_CYAN);
+$referenceTables = ['x_devises', 'x_entites_types', 'x_types_passages',
+                    'x_types_reglements', 'x_users_roles'];
+foreach ($referenceTables as $table) {
+    migrateReferenceTable($table);
+}
+
+// Migration entité
+printBox("MIGRATION ENTITÉ", C_CYAN);
+if (!migrateEntite($entityId)) {
+    println("✗ Échec migration entité", C_RED);
+    exit(1);
+}
+
+// Migration users
+printBox("MIGRATION UTILISATEURS", C_CYAN);
+migrateUsers($entityId);
+
+// Migration opérations
+printBox("MIGRATION OPÉRATIONS", C_CYAN);
+$migratedOps = migrateOperations($entityId, $limitOperations);
+
+// Détails par opération
+foreach ($migratedOps as $opId) {
+    migrateOperationDetails($opId, $entityId);
+}
+
+// Résumé final
+printBox("RÉSUMÉ DE LA MIGRATION", C_GREEN);
+foreach ($stats as $table => $data) {
+    if ($data['source'] > 0 || $data['migrated'] > 0) {
+        printStat(ucfirst($table), $data['source'], $data['migrated'], "  ");
+    }
+}
+
+println("\n✅ Migration terminée avec succès!", C_GREEN);
+exit(0);

api/scripts/php/verify_migration_structure.php

@@ -0,0 +1,282 @@
+<?php
+/**
+ * Script de vérification de la cohérence des structures
+ * avant migration entre geosector (source) et geo_app (cible)
+ *
+ * Ce script compare les colonnes de chaque table migrée
+ * et identifie les incohérences potentielles
+ *
+ * Usage: php scripts/php/verify_migration_structure.php
+ */
+
+require_once dirname(__DIR__) . '/config.php';
+
+// Couleurs pour le terminal
+define('COLOR_GREEN', "\033[0;32m");
+define('COLOR_RED', "\033[0;31m");
+define('COLOR_YELLOW', "\033[1;33m");
+define('COLOR_BLUE', "\033[0;34m");
+define('COLOR_RESET', "\033[0m");
+
+// Fonction pour afficher des messages colorés
+function printColor($message, $color = COLOR_RESET) {
+    echo $color . $message . COLOR_RESET . PHP_EOL;
+}
+
+// Fonction pour obtenir les colonnes d'une table
+function getTableColumns($pdo, $tableName) {
+    try {
+        $stmt = $pdo->query("DESCRIBE `$tableName`");
+        $columns = [];
+        while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
+            $columns[$row['Field']] = [
+                'type' => $row['Type'],
+                'null' => $row['Null'],
+                'key' => $row['Key'],
+                'default' => $row['Default'],
+                'extra' => $row['Extra']
+            ];
+        }
+        return $columns;
+    } catch (PDOException $e) {
+        return null;
+    }
+}
+
+// Mappings de colonnes connus
+$columnMappings = [
+    // Mappings globaux
+    'global' => [
+        'rowid' => 'id',
+        'active' => 'chk_active',
+        'date_creat' => 'created_at',
+        'date_modif' => 'updated_at',
+    ],
+    // Mappings spécifiques par table
+    'users_entites' => [
+        'table_target' => 'entites',
+        'mappings' => [
+            'libelle' => 'encrypted_name',
+            'tel1' => 'encrypted_phone',
+            'tel2' => 'encrypted_mobile',
+            'email' => 'encrypted_email',
+            'iban' => 'encrypted_iban',
+            'bic' => 'encrypted_bic',
+            'cp' => 'code_postal',
+        ]
+    ],
+    'users' => [
+        'mappings' => [
+            'libelle' => 'encrypted_name',
+            'username' => 'encrypted_user_name',
+            'userpswd' => 'user_pass_hash',
+            'userpass' => 'user_pass_hash',
+            'prenom' => 'first_name',
+            'nom_tournee' => 'sect_name',
+            'telephone' => 'encrypted_phone',
+            'mobile' => 'encrypted_mobile',
+            'email' => 'encrypted_email',
+            'alert_email' => 'chk_alert_email',
+        ]
+    ],
+    'ope_pass' => [
+        'mappings' => [
+            'date_eve' => 'passed_at',
+            'libelle' => 'encrypted_name',
+            'email' => 'encrypted_email',
+            'phone' => 'encrypted_phone',
+            'recu' => 'nom_recu',
+        ]
+    ],
+    'medias' => [
+        'mappings' => [
+            'support_rowid' => 'support_id',
+        ]
+    ],
+    'x_villes' => [
+        'mappings' => [
+            'cp' => 'code_postal',
+        ]
+    ],
+];
+
+// Tables à vérifier (source => cible)
+$tablesToVerify = [
+    'x_devises' => 'x_devises',
+    'x_entites_types' => 'x_entites_types',
+    'x_types_passages' => 'x_types_passages',
+    'x_types_reglements' => 'x_types_reglements',
+    'x_users_roles' => 'x_users_roles',
+    'x_pays' => 'x_pays',
+    'x_regions' => 'x_regions',
+    'x_departements' => 'x_departements',
+    'x_villes' => 'x_villes',
+    'users_entites' => 'entites',
+    'users' => 'users',
+    'operations' => 'operations',
+    'ope_users' => 'ope_users',
+    'ope_users_sectors' => 'ope_users_sectors',
+    'ope_pass' => 'ope_pass',
+    'ope_pass_histo' => 'ope_pass_histo',
+    'medias' => 'medias',
+    'sectors_adresses' => 'sectors_adresses',
+];
+
+try {
+    printColor("\n╔══════════════════════════════════════════════════════════════╗", COLOR_BLUE);
+    printColor("║  VÉRIFICATION DES STRUCTURES DE MIGRATION                   ║", COLOR_BLUE);
+    printColor("╚══════════════════════════════════════════════════════════════╝", COLOR_BLUE);
+
+    // Connexion aux bases de données
+    printColor("\n[INFO] Connexion aux bases de données...", COLOR_BLUE);
+    $sourceDb = getSourceConnection();
+    $targetDb = getTargetConnection();
+    printColor("[OK] Connexions établies", COLOR_GREEN);
+
+    $totalIssues = 0;
+    $totalWarnings = 0;
+    $totalTables = count($tablesToVerify);
+
+    foreach ($tablesToVerify as $sourceTable => $targetTable) {
+        printColor("\n" . str_repeat("─", 70), COLOR_BLUE);
+        printColor("📊 Table: $sourceTable → $targetTable", COLOR_BLUE);
+        printColor(str_repeat("─", 70), COLOR_BLUE);
+
+        // Récupérer les colonnes
+        $sourceCols = getTableColumns($sourceDb, $sourceTable);
+        $targetCols = getTableColumns($targetDb, $targetTable);
+
+        if ($sourceCols === null) {
+            printColor("❌ ERREUR: Table source '$sourceTable' introuvable", COLOR_RED);
+            $totalIssues++;
+            continue;
+        }
+
+        if ($targetCols === null) {
+            printColor("❌ ERREUR: Table cible '$targetTable' introuvable", COLOR_RED);
+            $totalIssues++;
+            continue;
+        }
+
+        // Récupérer les mappings pour cette table
+        $tableMappings = $columnMappings['global'];
+        if (isset($columnMappings[$sourceTable]['mappings'])) {
+            $tableMappings = array_merge($tableMappings, $columnMappings[$sourceTable]['mappings']);
+        }
+
+        // Vérifier chaque colonne source
+        $unmappedSourceCols = [];
+        $mappedCols = 0;
+
+        foreach ($sourceCols as $sourceCol => $sourceInfo) {
+            // Chercher la colonne cible
+            $targetCol = $tableMappings[$sourceCol] ?? $sourceCol;
+
+            if (isset($targetCols[$targetCol])) {
+                $mappedCols++;
+                // Colonne existe et mappée correctement
+            } else {
+                // Vérifier si c'est une colonne qui doit être ignorée
+                $ignoredCols = ['dir0', 'dir1', 'dir2', 'type_fichier', 'position', 'hauteur', 'largeur',
+                                'niveaugris', 'lieudit', 'chk_habitat_vide', 'lot_nb_passages', 'departement',
+                                'fk_user', 'chk_api_adresse', 'num_adherent', 'libelle_naissance', 'josh',
+                                'email_secondaire', 'infos', 'ltt', 'lng', 'sector', 'dept_naissance',
+                                'commune_naissance', 'anciennete', 'fk_categorie', 'fk_sous_categorie',
+                                'adresse_1', 'adresse_2', 'cp', 'ville', 'matricule', 'fk_grade',
+                                'chk_adherent_ud', 'chk_adherent_ur', 'chk_adherent_fns', 'chk_archive',
+                                'chk_double_affectation', 'date_creat', 'appname', 'http_host', 'tva_intra',
+                                'rcs', 'siret', 'ape', 'couleur', 'prefecture', 'fk_titre_gerant',
+                                'gerant_prenom', 'gerant_nom', 'site_url', 'gerant_signature',
+                                'tampon_signature', 'banque_libelle', 'banque_adresse', 'banque_cp',
+                                'banque_ville', 'genbase', 'groupebase', 'userbase', 'passbase', 'demo',
+                                'lib_vert', 'lib_verts', 'lib_orange', 'lib_oranges', 'lib_rouge', 'lib_rouges',
+                                'lib_bleu', 'lib_bleus', 'icon_siege', 'icon_siege_color', 'btn_width',
+                                'nbmembres', 'nbconnex'];
+
+                if (in_array($sourceCol, $ignoredCols)) {
+                    // Colonne volontairement non migrée
+                    continue;
+                }
+
+                $unmappedSourceCols[] = $sourceCol;
+            }
+        }
+
+        // Vérifier les nouvelles colonnes dans la cible
+        $newTargetCols = [];
+        foreach ($targetCols as $targetCol => $targetInfo) {
+            // Vérifier si cette colonne existe dans la source
+            $sourceCol = array_search($targetCol, $tableMappings);
+            if ($sourceCol === false) {
+                $sourceCol = $targetCol; // Même nom
+            }
+
+            if (!isset($sourceCols[$sourceCol])) {
+                // Vérifier si c'est une colonne attendue (timestamp auto, etc.)
+                $autoColumns = ['created_at', 'updated_at', 'id'];
+                if (!in_array($targetCol, $autoColumns)) {
+                    $newTargetCols[] = $targetCol;
+                }
+            }
+        }
+
+        // Affichage des résultats
+        printColor("✓ Colonnes source mappées: $mappedCols/" . count($sourceCols), COLOR_GREEN);
+
+        if (!empty($unmappedSourceCols)) {
+            printColor("⚠ Colonnes source NON mappées:", COLOR_YELLOW);
+            foreach ($unmappedSourceCols as $col) {
+                printColor("  - $col ({$sourceCols[$col]['type']})", COLOR_YELLOW);
+            }
+            $totalWarnings += count($unmappedSourceCols);
+        }
+
+        if (!empty($newTargetCols)) {
+            printColor("ℹ Nouvelles colonnes dans cible (seront NULL/défaut):", COLOR_YELLOW);
+            foreach ($newTargetCols as $col) {
+                $defaultValue = $targetCols[$col]['default'] ?? 'NULL';
+                $nullable = $targetCols[$col]['null'] === 'YES' ? '(nullable)' : '(NOT NULL)';
+                printColor("  - $col ({$targetCols[$col]['type']}) = $defaultValue $nullable", COLOR_YELLOW);
+            }
+            $totalWarnings += count($newTargetCols);
+        }
+
+        if (empty($unmappedSourceCols) && empty($newTargetCols)) {
+            printColor("✓ Aucun problème détecté", COLOR_GREEN);
+        }
+    }
+
+    // Résumé final
+    printColor("\n" . str_repeat("═", 70), COLOR_BLUE);
+    printColor("📈 RÉSUMÉ DE LA VÉRIFICATION", COLOR_BLUE);
+    printColor(str_repeat("═", 70), COLOR_BLUE);
+    printColor("Tables vérifiées: $totalTables", COLOR_BLUE);
+
+    if ($totalIssues > 0) {
+        printColor("❌ Erreurs critiques: $totalIssues", COLOR_RED);
+    } else {
+        printColor("✓ Aucune erreur critique", COLOR_GREEN);
+    }
+
+    if ($totalWarnings > 0) {
+        printColor("⚠ Avertissements: $totalWarnings", COLOR_YELLOW);
+        printColor("  (colonnes non mappées ou nouvelles colonnes)", COLOR_YELLOW);
+    } else {
+        printColor("✓ Aucun avertissement", COLOR_GREEN);
+    }
+
+    printColor("\n💡 Recommandations:", COLOR_BLUE);
+    printColor("  - Vérifiez que les colonnes non mappées sont intentionnelles", COLOR_RESET);
+    printColor("  - Les nouvelles colonnes cible utiliseront leurs valeurs par défaut", COLOR_RESET);
+    printColor("  - Consultez README-migration.md pour plus de détails", COLOR_RESET);
+
+    // Fermer le tunnel SSH
+    closeSshTunnel();
+
+    printColor("\n✓ Vérification terminée\n", COLOR_GREEN);
+
+} catch (Exception $e) {
+    printColor("\n❌ ERREUR CRITIQUE: " . $e->getMessage(), COLOR_RED);
+    closeSshTunnel();
+    exit(1);
+}