fix(core): harden settlement and wallet integration

database/migrations/2026_07_21_150000_remove_cross_site_agent_role_assignments.php

@@ -1,7 +1,7 @@
 <?php
 
-use App\Support\InvalidPlatformAgentRoleCleanup;
 use Illuminate\Database\Migrations\Migration;
+use App\Support\InvalidPlatformAgentRoleCleanup;
 
 return new class extends Migration
 {

database/migrations/2026_07_22_010000_version_credit_settlement_idempotency.php

@@ -0,0 +1,85 @@
+<?php
+
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
+
+return new class extends Migration
+{
+    private const INDEX = 'uk_credit_ledger_ref_reason';
+
+    public function up(): void
+    {
+        if (! Schema::hasTable('credit_ledger')) {
+            return;
+        }
+
+        if (! Schema::hasColumn('credit_ledger', 'settlement_version')) {
+            Schema::table('credit_ledger', function (Blueprint $table): void {
+                $table->unsignedInteger('settlement_version')->default(0)->after('ref_id');
+            });
+        }
+
+        $this->dropIndex();
+        $this->createIndex(includeSettlementVersion: true);
+    }
+
+    public function down(): void
+    {
+        if (! Schema::hasTable('credit_ledger')) {
+            return;
+        }
+
+        $this->dropIndex();
+        $this->createIndex(includeSettlementVersion: false);
+
+        if (Schema::hasColumn('credit_ledger', 'settlement_version')) {
+            Schema::table('credit_ledger', function (Blueprint $table): void {
+                $table->dropColumn('settlement_version');
+            });
+        }
+    }
+
+    private function dropIndex(): void
+    {
+        if (! Schema::hasIndex('credit_ledger', self::INDEX)) {
+            return;
+        }
+
+        $driver = Schema::getConnection()->getDriverName();
+        if (in_array($driver, ['pgsql', 'sqlite'], true)) {
+            DB::statement('DROP INDEX IF EXISTS '.self::INDEX);
+
+            return;
+        }
+
+        Schema::table('credit_ledger', function (Blueprint $table): void {
+            $table->dropUnique(self::INDEX);
+        });
+    }
+
+    private function createIndex(bool $includeSettlementVersion): void
+    {
+        $columns = $includeSettlementVersion
+            ? 'ref_type, ref_id, reason, settlement_version'
+            : 'ref_type, ref_id, reason';
+        $driver = Schema::getConnection()->getDriverName();
+
+        if (in_array($driver, ['pgsql', 'sqlite'], true)) {
+            DB::statement(
+                'CREATE UNIQUE INDEX '.self::INDEX.' ON credit_ledger ('.$columns.') WHERE ref_id IS NOT NULL',
+            );
+
+            return;
+        }
+
+        Schema::table('credit_ledger', function (Blueprint $table) use ($includeSettlementVersion): void {
+            $columns = ['ref_type', 'ref_id', 'reason'];
+            if ($includeSettlementVersion) {
+                $columns[] = 'settlement_version';
+            }
+            $table->unique($columns, self::INDEX);
+        });
+    }
+};

database/migrations/2026_07_22_020000_add_auto_payout_attempts_to_settlement_batches.php

@@ -0,0 +1,32 @@
+<?php
+
+use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        if (! Schema::hasTable('settlement_batches')
+            || Schema::hasColumn('settlement_batches', 'auto_payout_attempts')) {
+            return;
+        }
+
+        Schema::table('settlement_batches', function (Blueprint $table): void {
+            $table->unsignedInteger('auto_payout_attempts')->default(0)->after('paid_at');
+        });
+    }
+
+    public function down(): void
+    {
+        if (! Schema::hasTable('settlement_batches')
+            || ! Schema::hasColumn('settlement_batches', 'auto_payout_attempts')) {
+            return;
+        }
+
+        Schema::table('settlement_batches', function (Blueprint $table): void {
+            $table->dropColumn('auto_payout_attempts');
+        });
+    }
+};