feat: 增强管理员功能与数据处理

- 在多个控制器中引入 agent_node_id，以支持基于代理节点的权限和数据过滤。
- 更新 AdminRole 和 AdminUser 模型，新增角色范围和代理节点相关功能，提升角色管理的灵活性。
- 在请求验证中添加 agent_node_id 字段，确保 API 接口支持代理节点的相关操作。
- 优化 LotterySettings 服务，支持批量写入设置，提升配置管理的效率。
- 更新仪表板和报告服务，增强数据统计功能，确保管理员能够获取更全面的统计信息。

app/Http/Controllers/Api/V1/Admin/Ticket/AdminTicketItemIndexController.php

@@ -9,6 +9,7 @@ use App\Support\ApiResponse;
 use App\Support\CurrencyFormatter;
 use App\Support\PaginationTrait;
 use App\Support\AdminSiteScope;
+use App\Support\AgentNodeApiPresenter;
 use App\Support\TicketItemListFilters;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
@@ -44,7 +45,8 @@ final class AdminTicketItemIndexController extends Controller
             ->with([
                 'draw:id,draw_no,business_date',
                 'order:id,order_no,currency_code,created_at',
-                'player:id,site_code,site_player_id,username,nickname',
+                'player:id,site_code,site_player_id,username,nickname,agent_node_id',
+                'player.agentNode:id,code,name',
             ])
             ->orderByDesc('ticket_items.id');
 
@@ -86,10 +88,14 @@ final class AdminTicketItemIndexController extends Controller
             is_string($validated['end_date'] ?? null) ? $validated['end_date'] : null,
         );
 
+        $agentNodeId = isset($validated['agent_node_id']) ? (int) $validated['agent_node_id'] : null;
+
         AdminSiteScope::applyViaPlayerRelationWithSiteCode(
             $query,
             $admin,
             is_string($validated['site_code'] ?? null) ? $validated['site_code'] : null,
+            'player',
+            $agentNodeId > 0 ? $agentNodeId : null,
         );
 
         $paginator = $query->paginate(perPage: $perPage, page: $page, columns: ['*']);
@@ -103,6 +109,7 @@ final class AdminTicketItemIndexController extends Controller
             return [
                 'id' => $row->id,
                 'ticket_no' => $row->ticket_no,
+                ...AgentNodeApiPresenter::embed($row->player?->agentNode),
                 'player_id' => $row->player_id,
                 'site_code' => $row->player?->site_code,
                 'site_player_id' => $row->player?->site_player_id,