feat: 切换 schema dump 基线并增强返点结算与管理校验

app/Services/AgentSettlement/AgentSettlementBadDebtService.php

@@ -2,6 +2,8 @@
 
 namespace App\Services\AgentSettlement;
 
+use App\Models\Player;
+use App\Services\Player\PlayerCreditService;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Validation\ValidationException;
 
@@ -10,6 +12,7 @@ final class AgentSettlementBadDebtService
 {
     public function __construct(
         private readonly AgentSettlementPeriodCompletionService $periodCompletion,
+        private readonly PlayerCreditService $playerCreditService,
     ) {}
 
     public function writeOff(int $originalBillId, ?string $reason, int $adminUserId): int
@@ -99,6 +102,13 @@ final class AgentSettlementBadDebtService
                 'updated_at' => $now,
             ]);
 
+            if ((string) $original->owner_type === 'player' && (int) $original->owner_id > 0 && (int) $original->net_amount > 0) {
+                $player = Player::query()->find((int) $original->owner_id);
+                if ($player !== null) {
+                    $this->playerCreditService->releaseFromSettlement($player, $unpaid, $originalBillId);
+                }
+            }
+
             $this->periodCompletion->syncIfReady($periodId);
 
             return $archiveBillId;