Admin List
Permission Setting 下的 Admin List 页面 PRD,覆盖管理员查询、创建、编辑、删除和权限角色绑定。
Admin List 用于管理代理商后台管理员账号。该页面是 Permission Settings 的默认子页面,负责管理员查询、分页、创建账号、编辑资料、删除账号和绑定权限角色。
页面摘要
| 项目 | 说明 |
|---|---|
| 页面性质 | 管理员账号管理页,包含查询、创建、编辑、删除和权限角色绑定 |
| 核心动作 | 查询管理员、创建 Admin Account、编辑信息、删除账号、绑定权限角色 |
| 数据范围 | 当前账号有权限查看和维护的管理员账号与权限角色 |
| 当前状态 | 查询、创建、编辑、删除确认和权限绑定规则已定义 |
参考区
页面状态 Figma 截图
Permission Setting

Admin List 默认态,包含 Date/Time、Admin ID 查询、Search、Reset、Add New Admin、刷新按钮、管理员表格和分页。
截图说明只作为 Figma 证据摘要,不作为字段定义;字段口径、完整列、导出和权限规则以字段模型章节为准。

点击 Date/Time 后展开双月日期范围选择器,支持左右月份、时间输入、Clear 和 Apply。
截图说明只作为 Figma 证据摘要,不作为字段定义;字段口径、完整列、导出和权限规则以字段模型章节为准。

筛选提交后,标题下方显示日期范围和 Admin ID chips,并刷新管理员表格。
截图说明只作为 Figma 证据摘要,不作为字段定义;字段口径、完整列、导出和权限规则以字段模型章节为准。
页面状态 Figma 截图
Permission Setting

点击 Add New Admin 后打开居中 Create Admin Account 弹窗,包含 Admin ID、Password、Permission、ID Status、Remarks、Add Account 和 Cancel。
截图说明只作为 Figma 证据摘要,不作为字段定义;字段口径、完整列、导出和权限规则以字段模型章节为准。

创建弹窗中 Permission 下拉展开,展示 Team Leader、Sales Team、Permission 01、Permission 02 等可选权限组。
截图说明只作为 Figma 证据摘要,不作为字段定义;字段口径、完整列、导出和权限规则以字段模型章节为准。

点击行级 Edit 后打开 Edit Admin Information 弹窗,Admin ID 回填且不可编辑,支持修改密码、Permission、ID Status 和 Remarks。
截图说明只作为 Figma 证据摘要,不作为字段定义;字段口径、完整列、导出和权限规则以字段模型章节为准。

编辑保存成功后显示居中成功弹窗,文案为 Admin profile update successfully,并提供 Ok 关闭。
截图说明只作为 Figma 证据摘要,不作为字段定义;字段口径、完整列、导出和权限规则以字段模型章节为准。

点击删除图标后显示危险确认弹窗,文案为 Are you sure you want to delete this permanently?,提供 Yes 和 No, cancel。
截图说明只作为 Figma 证据摘要,不作为字段定义;字段口径、完整列、导出和权限规则以字段模型章节为准。
功能规则
| 区域 | 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 chip | Search 后展示,删除单个 chip 后立即刷新。 |
| 管理员表格 | #、Admin ID、Permission、Online Status、ID Status、Update Time、Created Time、Edit | 状态使用标签,行操作受权限控制。 |
| 创建弹窗 | Create Admin Account | 校验 Admin ID、Password、Permission、ID Status。 |
| 编辑弹窗 | Edit Admin Information | Admin ID 只读,密码为空表示不修改。 |
| 删除确认 | 危险确认弹窗 | 删除前必须二次确认且写入审计。 |
| 分页 | Showing 文案、每页条数、页码 | 切页保留已提交筛选条件。 |
管理员表格级定义
| 项目 | 定义 |
|---|---|
| 行粒度 | 每一行代表当前账号权限范围内的一个后台管理员账号。 |
| 汇总粒度 | 无 Total 汇总行;分页计数代表当前已提交筛选条件下的记录总数。 |
| 默认排序 | 默认按 Update Time 倒序;如果 Update Time 不可用,则使用后端稳定排序。 |
| 数据范围 | 受当前登录账号权限、Date/Time、Admin ID 和已提交 chips 限制。 |
| 父子 / 展开关系 | 表格不展开子行;Create、Edit、Delete 弹窗继承当前行或当前筛选上下文。 |
| 导出关系 | 当前页面未提供导出入口;默认不导出。若后续新增导出入口,按当前筛选、字段模型和权限脱敏规则导出,选择列、操作列、按钮入口和内部字段不导出。 |
管理员表格字段模型
| 字段 | 所在区域 | 定义 / 口径 | 展示规则 | 导出 | 备注 |
|---|---|---|---|---|---|
# | 管理员表格 | 当前查询结果中的展示序号。 | 当前页从 1 开始;翻页后按结果顺序更新。 | 不导出 | 不作为管理员唯一标识,不参与搜索或审计。 |
Admin ID | 管理员表格 | 管理员登录账号和主要识别字段。 | 展示创建时的 Admin ID;创建后不可修改。 | 不导出 | 行级编辑、删除和审计记录都必须使用真实 Admin ID。 |
Permission | 管理员表格 | 当前管理员绑定的权限角色。 | 展示角色名称,例如 Team Leader、Sales Team。 | 不导出 | 角色删除或禁用时需展示可解释状态。 |
Online Status | 管理员表格 | 管理员当前会话在线状态。 | Online 绿色标签,Offline 灰色标签。 | 不导出 | 只表示当前会话状态,不等同账号可登录。 |
ID Status | 管理员表格 | 管理员账号可用状态。 | 枚举为 Normal、Block;同页展示样式必须一致。 | 不导出 | 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 Leader、Sales Team、Permission 01、Permission 02。 |
| ID Status | 必选,包含 Normal、Block。 |
| Remarks | 可选多行文本。 |
| Add Account | 校验通过后创建账号,关闭弹窗并刷新当前列表。 |
| Cancel / 关闭 | 放弃创建;如已有输入,应提示是否放弃。 |
编辑与删除
| 场景 | 规则 |
|---|---|
| 打开编辑 | 点击行级 Edit 打开 Edit Admin Information。 |
| Admin ID | 编辑态只读。 |
| Password | 留空表示不修改密码;输入后必须按密码规则校验。 |
| Permission | 修改后影响目标管理员的菜单、页面访问和操作入口。 |
| ID Status | Block 后该账号不能继续登录或操作。 |
| 编辑成功 | 显示 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 下拉并提示重试。 |
| 删除被禁止 | 不执行删除,展示禁止原因。 |
| 保存失败 | 保留弹窗内容和用户输入,提示重试。 |