Files

- 在多个控制器中更新权限检查逻辑，确保管理员能够更灵活地管理代理和玩家。
- 在 AdminPlayerStoreController 中引入对玩家创建能力的验证，确保只有具备相应权限的管理员能够创建玩家。
- 更新请求验证逻辑，新增 credit_limit、rebate_rate 和 extra_rebate_rate 字段，以支持更细粒度的玩家管理。
- 在 AgentNodeProfileController 中添加对父代理能力授予的验证，确保子代理的权限在父代理范围内。
- 引入 AgentProfileFieldRules 以简化代理资料更新请求的规则定义，提升代码复用性。

2026-06-04 18:00:50 +08:00

5.8 KiB

Raw Permalink Blame History

后台 RBAC 与导航分工

单一真相源

能力	来源	说明
侧栏 / `auth/me` 的 `navigation`	`App\Support\AdminAuthorizationRegistry::navigationDefinitions()`	代码注册表，改菜单需发版
角色可勾选的产品权限 `prd.*`	同上 `permissionDefinitions()`	UI 展示名与 `permission_code` 映射
API 鉴权 `permission_code`	库表 `admin_menu_actions`	运行时校验
路由资源	库表 `admin_api_resources` + `admin_api_resource_bindings`	由 `php artisan lottery:admin-auth-sync` 从 Registry 同步

`admin_menus` 不是侧栏配置

表 admin_menus：仅用于 admin_menu_actions 的业务分组（权限模块树）。
不要通过改 admin_menus 期望侧栏变化；侧栏只看 Registry + 用户拥有的 prd.*。

角色权限如何存储

权威数据：admin_role_menu_actions（角色 ↔ 动作权限）。
prd.* 展示：由 AdminPermissionBridge::legacySlugsGrantedByMenuActionCodes() 从已授权动作反推，不单独落库。
用户直接授权：admin_user_menu_actions（可选，与角色权限合并生效）。

维护命令

php artisan lottery:admin-auth-sync --audit   # 同步 API 资源与 bindings，并体检
php artisan lottery:admin-auth-audit          # 仅体检：受保护路由是否登记、permission_required 是否已绑定

migrate:fresh --seed 会跑完全部迁移（含将 Registry 写回库的 resync 类迁移）与 DatabaseSeeder；仅修改 AdminAuthorizationRegistry.php 时，在已有库上执行 lottery:admin-auth-sync --audit，不要依赖单独补丁 migration。

仪表盘 API 与子块权限

GET /api/v1/admin/dashboard 与 …/analytics：中间件要求 dashboard.view（对应产品权限 prd.dashboard.view）。
子块权限判定统一按 permission_code（如 draw.results.view、risk.monitor.view、service.reconcile.view），prd.* 仅作为展示映射。

站点优先作用域约束（2026-06）

后台查询范围统一为：site_scope ∩ agent_subtree_scope。
新增统一入口 App\Support\AdminScopePolicy，查询应优先通过该策略应用数据范围。
auth/me 继续返回 permissions（prd.*）兼容前端，同时新增 operational_permissions 字段用于显式表达可操作权限集合。

已废弃的 `prd.*`（请求体仍可传入，会自动归一）

旧 slug	归一为
`prd.audit.all` / `prd.audit.self` / `prd.audit.finance`	`prd.audit.view`
`prd.report.all` / `prd.report.risk` / `prd.report.finance` / `prd.report.player`	`prd.report.view`

按站点开通后台（数据隔离）

所有人登录同一套 lotteryadmin（POST /api/v1/admin/auth/login）。登录后 API 按账号绑定自动过滤站点数据，无需为每个站点单独部署后台域名。

给谁	账号形态	数据范围来源	推荐入口
整条代理线负责人	代理经营账号（`admin_user_agents` 主绑定）	`agent_nodes.admin_site_id` + 代理子树 `path`	超管：代理线路 → 开通线路
平台侧站点运营	平台账号（无代理绑定）	`admin_user_site_roles.site_id`	超管：系统 → 平台账号，创建时选择 `admin_site_id` 与角色

菜单权限（能进哪些页）由角色的 admin_role_menu_actions / 反推 prd.* 决定；数据范围（能看哪些站点的行）由 admin_user_site_roles.site_id（平台）或代理绑定（线路）决定，二者独立。

路径 A：开通线路（代理主账号）

侧栏 代理线路 → 开通线路（prd.agent-line.provision）。
填写站点 code、名称、线路主 用户名 / 密码。
后端一次性创建：admin_sites、根 agent_nodes、admin_users、admin_user_agents、平台代理经营角色。
将账号密码交给对方；对方用同一 lotteryadmin 地址登录。
登录后 auth/me.agent 含 admin_site_id、site_code；侧栏隐藏「开通线路」等平台-only 菜单；列表经 AdminScopePolicy 收敛到该站点 + 代理子树。

子账号：在代理树下 代理节点 → 管理员（POST /api/v1/admin/agent-nodes/{id}/admin-users），站点不变、子树更窄。勿在「系统 → 平台账号」为线路主建号。

路径 B：平台运营账号（单站）

平台 角色管理 仅有两个内置角色：超级管理员（自动拥有全部 prd.*，随 lottery:admin-auth-sync 补齐）与代理（经营主账号默认模板，可在此调整 prd.*）。若需更细的平台运营分工，请使用不同平台账号并绑定代理角色后按需收窄权限；勿授予 prd.agent-line.provision、全站接入密钥类权限。
系统 → 平台账号 → 新建：填写账号信息，选择目标站点（admin_site_id），勾选上一步角色。
对方登录后仅见绑定站点数据；auth/me.accessible_sites 列出可访问站点（单站时一项）。

改角色绑定时须带上同一 admin_site_id（PUT /api/v1/admin/admin-users/{id}/roles），仅替换该站点上的角色 pivot，不影响其他站点绑定。

运行时过滤（已实现）

可访问站点：AdminUser::accessibleAdminSiteIds()（超管 null = 不限）。
查询：AdminSiteScope + AdminScopePolicy（site_scope ∩ agent_subtree_scope）。
操作者授权站点：AdminIntegrationSiteAccess::canAccess()（创建/改绑平台用户时校验）。

临时手工绑站（迁移前）

若 UI 未就绪，超管建用户后可在库表 admin_user_site_roles 插入 (admin_user_id, site_id, role_id)，参考 tests/Feature/AdminIntegrationSiteApiTest.php。

5.8 KiB Raw Permalink Blame History Unescape Escape