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

- 在多个控制器中引入 agent_node_id，以支持基于代理节点的权限和数据过滤。 - 更新 AdminRole 和 AdminUser 模型，新增角色范围和代理节点相关功能，提升角色管理的灵活性。 - 在请求验证中添加 agent_node_id 字段，确保 API 接口支持代理节点的相关操作。 - 优化 LotterySettings 服务，支持批量写入设置，提升配置管理的效率。 - 更新仪表板和报告服务，增强数据统计功能，确保管理员能够获取更全面的统计信息。
2026-06-02 14:36:58 +08:00
parent d5232c756f
commit 0841fbed32
96 changed files with 5004 additions and 182 deletions
--- a/app/Support/AgentNodePresenter.php
+++ b/app/Support/AgentNodePresenter.php
@@ -0,0 +1,79 @@
+<?php
+
+namespace App\Support;
+
+use App\Models\AgentNode;
+
+final class AgentNodePresenter
+{
+    /**
+     * @return array{
+     *   id: int,
+     *   admin_site_id: int,
+     *   parent_id: ?int,
+     *   path: string,
+     *   depth: int,
+     *   code: string,
+     *   name: string,
+     *   status: int,
+     *   is_root: bool
+     * }
+     */
+    public static function item(AgentNode $node): array
+    {
+        return [
+            'id' => (int) $node->id,
+            'admin_site_id' => (int) $node->admin_site_id,
+            'parent_id' => $node->parent_id !== null ? (int) $node->parent_id : null,
+            'path' => (string) $node->path,
+            'depth' => (int) $node->depth,
+            'code' => (string) $node->code,
+            'name' => (string) $node->name,
+            'status' => (int) $node->status,
+            'is_root' => $node->isRoot(),
+        ];
+    }
+
+    /**
+     * @param  iterable<AgentNode>  $nodes
+     * @return list<array<string, mixed>>
+     */
+    public static function tree(iterable $nodes): array
+    {
+        $items = [];
+        $byParent = [];
+
+        foreach ($nodes as $node) {
+            $row = self::item($node);
+            $row['children'] = [];
+            $items[(int) $node->id] = $row;
+            $parentKey = $node->parent_id !== null ? (int) $node->parent_id : 0;
+            $byParent[$parentKey][] = (int) $node->id;
+        }
+
+        $attach = static function (int $id) use (&$attach, &$items, $byParent): array {
+            $node = $items[$id];
+            foreach ($byParent[$id] ?? [] as $childId) {
+                $node['children'][] = $attach($childId);
+            }
+
+            return $node;
+        };
+
+        $ids = array_keys($items);
+        $rootIds = [];
+        foreach ($items as $id => $row) {
+            $parentId = $row['parent_id'];
+            if ($parentId === null || ! in_array((int) $parentId, $ids, true)) {
+                $rootIds[] = (int) $id;
+            }
+        }
+
+        $roots = [];
+        foreach ($rootIds as $rootId) {
+            $roots[] = $attach($rootId);
+        }
+
+        return $roots;
+    }
+}