Ruby Agent System PRD

Admin List

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

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

页面摘要

项目说明
页面性质管理员账号管理页,包含查询、创建、编辑、删除和权限角色绑定
核心动作查询管理员、创建 Admin Account、编辑信息、删除账号、绑定权限角色
数据范围当前账号有权限查看和维护的管理员账号与权限角色
当前状态查询、创建、编辑、删除确认和权限绑定规则已定义

参考区

页面状态 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 证据摘要,不作为字段定义;字段口径、完整列、导出和权限规则以字段模型章节为准。

功能规则

区域UI 表现功能规则
面包屑与子菜单Home > Permission Settings,子菜单含 Admin ListPermission ManagementLogin 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 文案、每页条数、页码切页保留已提交筛选条件。

管理员表格级定义

项目定义
行粒度每一行代表当前账号权限范围内的一个后台管理员账号。
汇总粒度无 Total 汇总行;分页计数代表当前已提交筛选条件下的记录总数。
默认排序默认按 Update Time 倒序;如果 Update Time 不可用,则使用后端稳定排序。
数据范围受当前登录账号权限、Date/Time、Admin ID 和已提交 chips 限制。
父子 / 展开关系表格不展开子行;Create、Edit、Delete 弹窗继承当前行或当前筛选上下文。
导出关系当前页面未提供导出入口;默认不导出。若后续新增导出入口,按当前筛选、字段模型和权限脱敏规则导出,选择列、操作列、按钮入口和内部字段不导出。

管理员表格字段模型

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

查询与筛选

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

创建 Admin Account

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

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

编辑与删除

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

业务规则

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

页面特例

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

本页目录