feat: 增强代理结算和账单管理功能

- 在多个控制器中引入 SettlementPartyEnrichment 服务，以优化代理结算和账单的处理逻辑。
- 更新 AgentSettlementBillIndexController 和 AgentSettlementBillShowController，支持根据账单 ID 和关键字进行查询。
- 在 AgentSettlementPeriodCloseController 中添加对站点管理权限的验证，确保只有具备相应权限的管理员能够关闭账期。
- 在 AgentSettlementPeriodIndexController 中更新账期数据的返回格式，提升数据的完整性和可用性。
- 引入对相对占成比例的支持，增强代理资料的管理能力，确保数据一致性。

app/Services/Player/PlayerCreditService.php

@@ -133,6 +133,30 @@ final class PlayerCreditService
         ]);
     }
 
+    public function applySettledWin(Player $player, int $amountMinor, int $ticketItemId): void
+    {
+        if ($amountMinor <= 0) {
+            return;
+        }
+
+        if (! PlayerFundingMode::usesCredit($player)) {
+            return;
+        }
+
+        $this->decreaseUsedCredit($player, $amountMinor);
+
+        DB::table('credit_ledger')->insert([
+            'owner_type' => 'player',
+            'owner_id' => $player->id,
+            'amount' => $amountMinor,
+            'reason' => 'game_settlement_win',
+            'ref_type' => 'ticket_item',
+            'ref_id' => $ticketItemId,
+            'created_at' => now(),
+            'updated_at' => now(),
+        ]);
+    }
+
     public function assertMayPlaceBet(Player $player, int $amountMinor): void
     {
         if (! PlayerFundingMode::usesCredit($player)) {
@@ -155,6 +179,7 @@ final class PlayerCreditService
         $agentNodeId = (int) ($player->agent_node_id ?? 0);
         if ($agentNodeId > 0) {
             AgentOverdueGuard::assertAgentMayGrantCredit($agentNodeId);
+            AgentOverdueGuard::assertAgentLineMayPlaceBet($agentNodeId);
         }
 
         $this->holdForBet($player, $amountMinor);
@@ -200,6 +225,28 @@ final class PlayerCreditService
         ]);
     }
 
+    public function applySettlementPayout(Player $player, int $amountMinor, int $billId): void
+    {
+        if ($amountMinor <= 0) {
+            return;
+        }
+
+        if (! PlayerFundingMode::usesCredit($player)) {
+            return;
+        }
+
+        DB::table('credit_ledger')->insert([
+            'owner_type' => 'player',
+            'owner_id' => $player->id,
+            'amount' => $amountMinor,
+            'reason' => 'settlement_payout',
+            'ref_type' => 'settlement_bill',
+            'ref_id' => $billId,
+            'created_at' => now(),
+            'updated_at' => now(),
+        ]);
+    }
+
     private function decreaseUsedCredit(Player $player, int $amountMinor): void
     {
         if ($amountMinor <= 0) {

app/Services/Player/PlayerNativeAuthService.php

@@ -18,13 +18,17 @@ final class PlayerNativeAuthService
     {
         $username = trim($username);
         $siteCode = trim($siteCode);
-        if ($siteCode === '' || $username === '' || $password === '') {
+        if ($username === '' || $password === '') {
             throw new PlayerAuthenticationException(
                 '账号或密码错误',
                 ErrorCode::PlayerCredentialsInvalid->value,
             );
         }
 
+        if ($siteCode === '') {
+            $siteCode = trim((string) config('lottery.integration.default_site_code', ''));
+        }
+
         $player = Player::query()
             ->where('site_code', $siteCode)
             ->where('username', $username)