refactor: 更新权限管理与请求验证逻辑

- 在多个控制器中将权限检查从 hasAdminPermission 更新为 hasPermissionCode，以增强权限管理的灵活性。
- 引入 AdminScopePolicy，优化基于代理节点的权限和数据过滤逻辑，确保管理员能够更精确地控制访问权限。
- 在请求验证中添加 agent_node_id 字段，确保 API 接口支持代理节点的相关操作。
- 更新 AdminUser 模型，新增 hasPermissionCode 方法，以支持更细粒度的权限检查。
- 优化审计日志记录逻辑，确保在处理请求时能够准确记录管理员的操作。

app/Services/AuditLogger.php

@@ -6,6 +6,7 @@ use App\Models\Player;
 use App\Models\AuditLog;
 use App\Models\AdminUser;
 use Illuminate\Http\Request;
+use App\Http\Middleware\RecordAdminApiAudit;
 
 /**
  * 审计日志写入入口：落到表 audit_logs，仅 created_at。
@@ -70,7 +71,7 @@ final class AuditLogger
         ?array $beforeJson = null,
         ?array $afterJson = null,
     ): AuditLog {
-        return self::record(
+        $row = self::record(
             $operatorType,
             $operatorId,
             $moduleCode,
@@ -82,6 +83,24 @@ final class AuditLogger
             $request->ip(),
             $request->userAgent(),
         );
+
+        self::markAdminApiAuditRecorded($request);
+
+        return $row;
+    }
+
+    /** 业务层已写审计时，避免 {@see RecordAdminApiAudit} 重复落库（FormRequest 可能与管道中的 Request 非同一实例）。 */
+    public static function markAdminApiAuditRecorded(Request $request): void
+    {
+        $request->attributes->set(RecordAdminApiAudit::ATTRIBUTE_AUDIT_RECORDED, true);
+
+        try {
+            $resolved = request();
+            if ($resolved !== $request) {
+                $resolved->attributes->set(RecordAdminApiAudit::ATTRIBUTE_AUDIT_RECORDED, true);
+            }
+        } catch (\Throwable) {
+        }
     }
 
     public static function recordForAdmin(AdminUser $admin, ?Request $request = null, ?string $moduleCode = null, ?string $actionCode = null, ?string $targetType = null, ?string $targetId = null, ?array $beforeJson = null, ?array $afterJson = null): AuditLog