Permission Management
Permission Setting 下的 Permission Management 页面 PRD，覆盖权限角色列表、权限矩阵、创建、编辑、锁定、删除和保存反馈。
Permission Management 用于维护后台权限角色和页面权限矩阵。页面左侧管理权限角色，右侧配置该角色可访问的页面与操作权限。所有角色变更和权限矩阵保存都必须受当前账号权限控制，并写入审计记录。
页面摘要
| 项目 | 说明 |
|---|---|
| 页面性质 | 权限角色和权限矩阵管理页，包含创建、编辑、锁定、删除和保存 |
| 核心动作 | 管理角色列表，配置页面权限矩阵，保存或重置权限变更 |
| 数据范围 | 当前账号有权限查看和维护的权限角色、页面权限和操作权限 |
| 当前状态 | 角色管理、权限矩阵、保存、创建、编辑、锁定、删除已定义；部分反馈和矩阵状态仍待确认 |
需求状态
| 状态 | 内容 |
|---|---|
Confirmed | Permission Management 维护后台权限角色和页面权限矩阵；所有变更必须受当前账号权限控制并写入审计。 |
Inferred from Figma | 锁定确认、删除确认和保存成功按当前截图与既有成功弹窗样式实现。 |
Open Question | 锁定/删除成功反馈、权限项半选、矩阵 loading / empty / error 状态仍待确认，见 开放问题。 |
1. Figma 原型
页面状态 Figma 截图
Permission Setting
Permission Management 默认态，左侧为角色分组、备注和 Create Permission，右侧为 Permission Page Settings 权限矩阵、Save 和 Reset。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
点击 Save 保存权限矩阵后显示成功弹窗，文案为 Permission settings was changed successfully。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
点击 Create Permission 后打开创建角色弹窗，包含 Permission Name、Phone Number、Remarks、Confirm 和 Cancel。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
创建角色成功后显示成功弹窗，文案为 Permission was created successfully。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
页面状态 Figma 截图
Permission Setting
角色三点菜单展开，菜单包含 Edit、Lock、Delete，当前 hover / 聚焦项为 Edit。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
点击 Edit 后打开编辑角色弹窗，回填 Permission Name、Phone Number 勾选状态和 Remarks。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
编辑角色保存成功后显示成功弹窗，文案为 Permission was changed successfully。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
角色三点菜单展开，当前 hover / 聚焦项为 Lock。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
点击 Lock 后显示确认弹窗，文案为 Are you sure you want to lock this role?，提供 Yes 和 No, cancel。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
角色三点菜单展开，当前 hover / 聚焦项为 Delete。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
点击 Delete 后显示危险确认弹窗，文案为 Are you sure you want to delete this permanently?，提供 Yes 和 No, cancel。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
2. 页面组成
| 区域 | UI 表现 | 功能规则 |
|---|---|---|
| 面包屑与子菜单 | Home > Permission Settings，子菜单含 Admin List、Permission Management、Login History | 当前页高亮 Permission Management。 |
| 左侧角色卡片 | 标题 Permission Management，角色分组、角色列表、备注、Create Permission | 选择角色后加载右侧权限矩阵。 |
| 角色分组 | Admin、Finance Team 等分组，支持展开 / 收起 | 展开状态保留在当前页面会话中。 |
| 角色行 | Team Leader、Sales Team、Deposit Team、Withdrawal Team，右侧三点菜单 | 当前角色高亮；三点菜单提供 Edit、Lock、Delete。 |
| Remarks | 左侧多行备注框，占位 Write text here ... | 用于展示 / 编辑当前角色备注，是否可编辑由权限决定。 |
| 权限矩阵 | 标题 Permission Page Settings，说明文案、Select All、模块行与子权限项 | 以当前选中角色为上下文保存。 |
| 操作按钮 | Save、Reset | Save 提交权限矩阵；Reset 恢复上次保存状态。 |
| 反馈弹窗 | 成功、确认、创建 / 编辑弹窗 | 所有弹窗居中，背景遮罩变暗。 |
3. 左侧角色管理
| 元素 | 规则 |
|---|---|
| 分组标题 | 分组行带用户图标和展开箭头；点击分组标题展开 / 收起子角色。 |
| 角色选择 | 点击角色行选中角色，左侧行浅灰高亮，右侧权限矩阵切换到该角色数据。 |
| 三点菜单 | 点击后显示浮层菜单，包含 Edit、Lock、Delete，hover 项浅灰高亮。 |
| 菜单关闭 | 点击菜单项、点击页面其它区域或切换角色时关闭菜单。 |
| Remarks | 显示当前角色备注；保存角色资料时随角色信息更新，不随右侧矩阵 Save 自动提交，除非产品明确合并保存。 |
| Create Permission | 打开创建权限角色弹窗。无创建权限时按钮隐藏或禁用。 |
4. 权限矩阵
| 模块 | 截图中可见权限项 |
|---|---|
| Data Report | Dashboard、Daily Report、Coupon Sending、Excel Download、Total Report |
| Coupon Management | Player Record、Coupon Sending、Redeem Coupon、Daily Record |
| Withdrawal Record | Bank Account |
| Transaction History | 模块级访问 |
| Customer Management | Member List、Coupon Sending、Player List |
| Record Inquiry | Deposit / Withdrawal Record、Excel Download、Promotion Record、Bet History |
| Notification | 模块级访问 |
| Domain Settings | Creation、Edit / Delete |
| Permission Settings | Deposit / Withdrawal Record、Creation、Edit / Delete、Permission、Login History |
矩阵交互规则：
Select All选中时，勾选当前矩阵中所有模块和子权限；取消时清空所有权限。- 模块级复选框控制该模块下所有子权限；子权限部分勾选时，模块级应展示半选或等效状态。
- 子权限勾选后，如果所属模块未勾选，系统应自动勾选模块级访问权限。
- 无权限查看或编辑的权限项不应展示为可操作状态。
- 行分隔与浅灰背景条用于区分模块组，不代表可点击区域。
5. 保存与重置
| 操作 | 规则 |
|---|---|
| Save | 提交当前角色的权限矩阵；提交期间按钮进入 loading / disabled。 |
| 保存成功 | 显示成功弹窗，文案 Permission settings was changed successfully，按钮 Ok。 |
| 保存失败 | 保留当前勾选状态，展示错误原因，允许用户再次 Save。 |
| Reset | 恢复当前角色最近一次保存成功的权限矩阵，不切换角色。 |
| 切换角色 | 如当前矩阵有未保存变更，应提示用户保存或放弃。 |
6. 创建权限角色
点击 Create Permission 打开 Create Permission 弹窗。
| 字段 / 操作 | 规则 |
|---|---|
| Permission Name | 必填，角色名不可与同组或系统全局角色重复。 |
| Phone Number | 复选框；勾选表示该角色可查看完整手机号或手机号相关字段。 |
| Remarks | 可选多行备注，占位 Write text here ...。 |
| Confirm | 校验通过后创建角色，关闭表单并显示成功弹窗。 |
| 创建成功 | 文案 Permission was created successfully，按钮 Ok。 |
| Cancel / 关闭 | 取消创建；如有输入，应提示是否放弃。 |
7. 编辑权限角色
点击角色三点菜单的 Edit 打开 Edit Permission 弹窗。
| 字段 / 操作 | 规则 |
|---|---|
| Permission Name | 回填当前角色名，例如 Team Leader，允许修改但不得重复。 |
| Phone Number | 回填当前配置，截图中为已勾选状态。 |
| Remarks | 回填当前备注，可编辑。 |
| Confirm | 保存角色基础信息，不应意外覆盖右侧未保存权限矩阵。 |
| 编辑成功 | 显示 Permission was changed successfully。 |
| Cancel / 关闭 | 取消编辑，保留原角色资料。 |
8. 锁定与删除
| 操作 | 规则 |
|---|---|
| Lock | 点击三点菜单 Lock 后显示确认弹窗，文案 Are you sure you want to lock this role?。 |
| Lock - Yes | 锁定角色；锁定后角色不能再分配给新管理员，已绑定管理员的处理策略需后端统一定义。 |
| Lock - No, cancel | 关闭确认弹窗，不改变角色状态。 |
| Delete | 点击三点菜单 Delete 后显示确认弹窗，文案 Are you sure you want to delete this permanently?。 |
| Delete - Yes | 删除角色；若角色仍绑定管理员，应阻止删除并提示先解绑。 |
| Delete - No, cancel | 关闭确认弹窗，不改变角色状态。 |
系统保留角色、当前登录账号所属角色、仍被管理员使用的角色、最后一个具备权限管理能力的角色不得删除或锁定到不可用。
9. 状态流转
| 状态 | 进入条件 | 可执行动作 | 退出条件 |
|---|---|---|---|
| 默认态 | 打开 Permission Management | 选择角色、勾选权限、Save、Reset、Create Permission、打开三点菜单 | 切换角色、打开弹窗或离开页面 |
| 权限有变更 | 勾选或取消矩阵项 | Save、Reset、切换角色前确认 | Save 成功或 Reset |
| 创建中 | 点击 Create Permission | 填写表单、Confirm、Cancel | 创建成功或取消 |
| 编辑中 | 点击 Edit | 修改角色资料、Confirm、Cancel | 编辑成功或取消 |
| 锁定确认 | 点击 Lock | Yes、No, cancel、关闭 | 成功锁定或取消 |
| 删除确认 | 点击 Delete | Yes、No, cancel、关闭 | 成功删除或取消 |
10. 异常与开放问题
| 场景 | 处理 |
|---|---|
| 权限矩阵加载失败 | 保留左侧角色选择，右侧展示错误与重试入口。 |
| 角色名重复 | 阻止 Confirm，在 Permission Name 字段展示错误。 |
| 删除角色仍被使用 | 阻止删除，提示先调整绑定管理员。 |
| 锁定当前账号角色 | 阻止锁定，提示不能锁定当前账号所属角色。 |
| Save 冲突 | 如后端版本已变化，提示刷新后重试，避免覆盖他人修改。 |
开放问题
截图覆盖了锁定确认，但未提供锁定成功反馈、删除成功反馈、权限项半选视觉、权限矩阵 loading / empty / error 状态。实现时先复用现有成功弹窗样式，并在后续 Figma 补齐时同步更新。
11. 验收标准
Permission Settings > Permission Management作为独立子页面打开并高亮。- 左侧角色分组、角色选择、备注和 Create Permission 与截图一致。
- 三点菜单支持 Edit、Lock、Delete，并按 hover 状态高亮当前项。
- 权限矩阵支持模块级、子权限、Select All、Save 和 Reset。
- Save 成功后显示
Permission settings was changed successfully。 - Create Permission、Edit Permission 弹窗字段、按钮、遮罩和成功反馈与截图一致。
- Lock 和 Delete 都必须二次确认；取消不改变数据。
- 无权限用户不能创建、编辑、锁定、删除角色或修改权限矩阵。