Ruby Agent System PRD
Permission Setting

Admin List

Permission Setting 下的 Admin List 页面 PRD，覆盖管理员查询、创建、编辑、删除和权限角色绑定。

Admin List 用于管理代理商后台管理员账号。该页面是 Permission Settings 的默认子页面，负责管理员查询、分页、创建账号、编辑资料、删除账号和绑定权限角色。

页面摘要

项目说明
页面性质管理员账号管理页，包含查询、创建、编辑、删除和权限角色绑定
核心动作查询管理员、创建 Admin Account、编辑信息、删除账号、绑定权限角色
数据范围当前账号有权限查看和维护的管理员账号与权限角色
当前状态查询、创建、编辑、删除和验收规则已定义；暂无独立开放问题区

需求状态

状态内容
ConfirmedAdmin List 是 Permission Setting 默认子页面；管理员创建、编辑、删除和角色绑定必须受当前账号权限控制。
Inferred from Figma创建/编辑/删除成功态按当前截图和既有弹窗样式处理。
Open Question当前未发现阻塞实现的独立开放问题；如新增批量管理、冻结状态或复杂审计字段，需要补充后续 PRD。

1. Figma 原型

页面状态 Figma 截图

Permission Setting

Permission Setting - 1.1 Admin List 默认态

Admin List 默认态，包含 Date/Time、Admin ID 查询、Search、Reset、Add New Admin、刷新按钮、管理员表格和分页。

截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。

Permission Setting - 1.2 筛选日期

点击 Date/Time 后展开双月日期范围选择器，支持左右月份、时间输入、Clear 和 Apply。

截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。

Permission Setting - 1.3 筛选后的显示

筛选提交后，标题下方显示日期范围和 Admin ID chips，并刷新管理员表格。

截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。

页面状态 Figma 截图

Permission Setting

Permission Setting - 1.4 创建 Admin Account

点击 Add New Admin 后打开居中 Create Admin Account 弹窗，包含 Admin ID、Password、Permission、ID Status、Remarks、Add Account 和 Cancel。

截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。

Permission Setting - 1.5 创建时选择 Permission

创建弹窗中 Permission 下拉展开，展示 Team Leader、Sales Team、Permission 01、Permission 02 等可选权限组。

截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。

Permission Setting - 1.6 编辑 Admin Information

点击行级 Edit 后打开 Edit Admin Information 弹窗，Admin ID 回填且不可编辑，支持修改密码、Permission、ID Status 和 Remarks。

截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。

Permission Setting - 1.7 编辑成功

编辑保存成功后显示居中成功弹窗，文案为 Admin profile update successfully，并提供 Ok 关闭。

截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。

Permission Setting - 1.8 删除 Admin Account 确认

点击删除图标后显示危险确认弹窗，文案为 Are you sure you want to delete this permanently?，提供 Yes 和 No, cancel。

截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。

2. 页面组成

区域UI 表现功能规则
面包屑与子菜单Home > Permission Settings，子菜单含 Admin List、Permission Management、Login History当前页高亮 Admin List。
标题区Admin User Management 与说明文案不承载筛选逻辑，只说明列表用途。
查询区Date/Time、Admin ID、Search、Reset、Add New Admin、刷新按钮Search 显式提交条件；Reset 恢复默认；刷新按当前条件重载。
条件 chips日期范围 chip、Admin ID chipSearch 后展示，删除单个 chip 后立即刷新。
管理员表格#、Admin ID、Permission、Online Status、ID Status、Update Time、Created Time、Edit状态使用标签，行操作受权限控制。
创建弹窗Create Admin Account校验 Admin ID、Password、Permission、ID Status。
编辑弹窗Edit Admin InformationAdmin ID 只读，密码为空表示不修改。
删除确认危险确认弹窗删除前必须二次确认且写入审计。
分页Showing 文案、每页条数、页码切页保留已提交筛选条件。

2.1 管理员表格级定义

项目定义
行粒度每一行代表当前账号权限范围内的一个后台管理员账号。
汇总粒度无 Total 汇总行；分页计数代表当前已提交筛选条件下的记录总数。
默认排序默认排序字段未在 Figma 中明确；未确认前按后端返回顺序展示，建议以 Update Time 倒序作为产品待确认项。
数据范围受当前登录账号权限、Date/Time、Admin ID 和已提交 chips 限制。
父子 / 展开关系表格不展开子行；Create、Edit、Delete 弹窗继承当前行或当前筛选上下文。
导出关系当前 Figma 未展示导出入口；导出字段为 Open Question，不默认等于页面可见列。

2.2 管理员表格字段模型

字段所在区域状态定义 / 口径展示规则导出备注
#管理员表格Confirmed当前查询结果中的展示序号。当前页从 1 开始；翻页后按结果顺序更新。No不作为管理员唯一标识，不参与搜索或审计。
Admin ID管理员表格Confirmed管理员登录账号和主要识别字段。展示创建时的 Admin ID；创建后不可修改。Open Question行级编辑、删除和审计记录都必须使用真实 Admin ID。
Permission管理员表格Confirmed当前管理员绑定的权限角色。展示角色名称，例如 Team Leader、Sales Team。Open Question角色删除或禁用时需展示可解释状态。
Online Status管理员表格Confirmed管理员当前会话在线状态。Online 绿色标签，Offline 灰色标签。Open Question只表示当前会话状态，不等同账号可登录。
ID Status管理员表格Confirmed管理员账号可用状态。枚举为 Normal、Block；同页展示样式必须一致。Open QuestionBlock 禁止继续登录或操作。
Update Time管理员表格Confirmed管理员资料、权限、状态或密码最近更新时间。统一时间格式，例如 2025-08-20 16:45:00。Open Question在线状态变化是否更新该字段需后端确认。
Created Time管理员表格Confirmed管理员账号创建时间。与 Update Time 使用相同时间格式。Open Question创建后不可被编辑动作改写。
Edit管理员表格Confirmed行级操作入口。展示 Edit 按钮和删除图标；无权限时隐藏或禁用。No删除必须先打开二次确认，不得直接删除。

3. 查询与筛选

交互项规则
Date/Time点击后展开双月日期范围选择器，支持月份切换、时间输入、Clear 和 Apply。
Apply只回填输入框；点击 Search 后才作为列表条件生效。
Admin ID文本输入；空值不生成 Admin ID chip。
Search提交 Date/Time 与 Admin ID，列表回到第一页并展示 chips。
Reset恢复默认日期范围、清空 Admin ID、移除 chips，列表回到第一页。
刷新使用当前已提交条件重新请求列表，不改变 chips。

4. 创建 Admin Account

点击 Add New Admin 打开居中弹窗，背景遮罩变暗。

字段 / 操作规则
Admin ID必填，创建后不可修改，不得与现有 Admin ID 重复。
Password必填，密码输入框带显示 / 隐藏图标。
Permission必填，下拉选择权限角色；截图选项包括 Team Leader、Sales Team、Permission 01、Permission 02。
ID Status必选，包含 Normal、Block。
Remarks可选多行文本。
Add Account校验通过后创建账号，关闭弹窗并刷新当前列表。
Cancel / 关闭放弃创建；如已有输入，应提示是否放弃。

5. 编辑与删除

场景规则
打开编辑点击行级 Edit 打开 Edit Admin Information。
Admin ID编辑态只读。
Password留空表示不修改密码；输入后必须按密码规则校验。
Permission修改后影响目标管理员的菜单、页面访问和操作入口。
ID StatusBlock 后该账号不能继续登录或操作。
编辑成功显示 Admin profile update successfully，点击 Ok 返回列表并刷新。
删除确认点击删除图标后显示 Are you sure you want to delete this permanently?。
删除限制当前登录账号、系统保留账号、最后一个可管理账号不得删除。

6. 业务规则

  • 所有创建、编辑、删除动作都必须受当前账号权限控制。
  • Admin ID 创建后不可修改。
  • 创建时 Admin ID、Password、Permission、ID Status 必填。
  • 编辑时 Password 为空表示不修改密码。
  • Block 状态账号不得登录；已在线账号应在会话刷新或下一次权限校验时失效。
  • 删除 Admin Account 必须保留审计记录，不能前端静默删除。
  • 当前登录账号不能删除自己，也不能把自己编辑到无法继续管理系统的状态。

7. 异常与空态

场景处理
查询无结果保留筛选条件和 chips，表格展示空态，分页显示 0 条。
Admin ID 重复创建时阻止提交，并在 Admin ID 字段展示错误。
Password 不合法阻止提交，并提示密码规则。
Permission 加载失败禁用 Permission 下拉并提示重试。
删除被禁止不执行删除，展示禁止原因。
保存失败保留弹窗内容和用户输入，提示重试。

8. 验收标准

  1. 进入 Permission Settings > Admin List 时，左侧主菜单和子菜单都正确高亮。
  2. Date/Time 选择器支持双月范围、时间输入、Clear 和 Apply。
  3. Search 后必须展示日期范围和 Admin ID chips，并按条件刷新列表。
  4. Add New Admin 能打开创建弹窗并校验必填字段。
  5. Permission 下拉能展示并选择权限角色。
  6. Edit 能打开编辑弹窗，Admin ID 只读，Update 成功后展示成功弹窗。
  7. 删除 Admin Account 前必须二次确认；取消不改变列表。
  8. 无权限用户无法执行创建、编辑、删除操作。

Permission Setting

Permission Setting 模块 PRD，总览 Admin List、Permission Management 和 Login History 三个独立子页面。

Permission Management

Permission Setting 下的 Permission Management 页面 PRD，覆盖权限角色列表、权限矩阵、创建、编辑、锁定、删除和保存反馈。

本页目录

页面摘要需求状态1. Figma 原型2. 页面组成2.1 管理员表格级定义2.2 管理员表格字段模型3. 查询与筛选4. 创建 Admin Account5. 编辑与删除6. 业务规则7. 异常与空态8. 验收标准