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/Models/AgentNode.php
+++ b/app/Models/AgentNode.php
@@ -0,0 +1,82 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+final class AgentNode extends Model
+{
+    protected $table = 'agent_nodes';
+
+    protected $fillable = [
+        'admin_site_id',
+        'parent_id',
+        'path',
+        'depth',
+        'code',
+        'name',
+        'status',
+        'created_by',
+        'extra_json',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'admin_site_id' => 'integer',
+            'parent_id' => 'integer',
+            'depth' => 'integer',
+            'status' => 'integer',
+            'extra_json' => 'array',
+        ];
+    }
+
+    public function isEnabled(): bool
+    {
+        return (int) $this->status === 1;
+    }
+
+    public function isRoot(): bool
+    {
+        return $this->parent_id === null || (int) $this->depth === 0;
+    }
+
+    /** @return BelongsTo<AdminSite, AgentNode> */
+    public function adminSite(): BelongsTo
+    {
+        return $this->belongsTo(AdminSite::class, 'admin_site_id');
+    }
+
+    /** @return BelongsTo<AgentNode, AgentNode> */
+    public function parent(): BelongsTo
+    {
+        return $this->belongsTo(self::class, 'parent_id');
+    }
+
+    /** @return HasMany<AgentNode, AgentNode> */
+    public function children(): HasMany
+    {
+        return $this->hasMany(self::class, 'parent_id')->orderBy('code');
+    }
+
+    public function isDescendantOf(self $ancestor): bool
+    {
+        if ((int) $this->admin_site_id !== (int) $ancestor->admin_site_id) {
+            return false;
+        }
+
+        $ancestorPath = (string) $ancestor->path;
+        if ($ancestorPath === '') {
+            return false;
+        }
+
+        return str_starts_with((string) $this->path, $ancestorPath);
+    }
+
+    public function isSameOrDescendantOf(self $ancestor): bool
+    {
+        return (int) $this->id === (int) $ancestor->id || $this->isDescendantOf($ancestor);
+    }
+}