角色管理

本手册面向平台管理员，详细说明AIHUB系统角色管理的前置规范、新增、修改、删除等全流程操作，明确角色ID使用规则、内置角色权限限制，指导管理员规范完成平台角色配置工作。。

一、前置说明

1.1 适用场景

管理员登录AIHUB管理后台，进行平台角色新增、信息修改、角色删除、权限配置等角色管理相关操作。

1.2 权限要求

操作账号需拥有超级管理员（root）或平台管理员（admin）权限，普通用户、运营人员无角色管理操作权限。

1.3 系统内置角色规范

系统预设内置固定角色，为平台基础权限角色，不支持删除、不支持修改编码、角色ID，仅可查看基础信息，具体内置角色信息如下：

1.4 角色ID号段使用规范

平台角色ID取值范围为1-99，不同号段对应不同使用规则，严禁违规占用系统保留号段，具体规则如下：

• 保留号段（禁止使用）：ID为1、10、100为系统内置固定角色ID，全局不可占用、不可修改；ID为2-9号段，无实际使用权限，无法配置管理端完整权限，禁止创建使用。
• 自定义专用号段：21-40号段为常规自定义角色号段，适用于运营、财务、审核等常规岗位角色创建，创建时需手动指定唯一角色ID。
• 扩展备用号段：41-99号段为预留扩展号段，可用于新增特殊岗位、细分权限角色创建，满足平台后续权限扩容需求。
• 命名规则：同一号段可细分创建多个岗位角色，例如21（运营管理员）、22（运营只读员），需保证ID唯一、编码规范、名称清晰。

二、详细操作步骤

2.1 进入角色管理页面

1. 打开浏览器，登录AIHUB平台管理后台；

2. 在页面左侧导航菜单栏，找到并展开【管理员配置】模块；

3. 在展开菜单中点击【身份与权限】，进入权限管理主页面；

4. 在页面顶部选项卡中，点击【角色管理】，即可进入角色列表及配置页面。

2.2 新增自定义角色

1. 在角色管理页面，点击【新建角色】按钮，弹出角色创建配置弹窗；

2. 填写必填配置项：角色ID（唯一、合规号段）、角色编码、角色名称，可按需填写排序、状态、备注信息；

3. 核对角色ID是否符合号段规范、编码是否唯一、名称是否准确；

4. 确认信息无误后，点击【保存】，即可完成新角色创建。

2.3 修改角色信息

1. 在角色管理列表中，找到需要修改的自定义角色（内置角色不支持修改）；

2. 点击对应角色后方的【编辑】按钮，进入角色修改页面；

3. 可修改角色名称、排序、状态、备注等信息，禁止修改已生效角色ID、角色编码，避免权限异常；

4. 修改完成后，核对信息无误，点击【保存】即可更新角色配置。

三、操作注意事项

• 内置角色（common、admin、root）为系统核心角色，严禁删除、修改ID及编码，仅支持查看基础信息；

• 所有自定义角色必须严格遵循ID号段规范，禁止使用保留号段，避免系统权限冲突；

• 角色修改、删除前，需核查是否有账号绑定该角色，防止操作后用户权限失效；

• 新增角色后，需同步配置对应模块、菜单、资源权限，否则角色无操作权限；

• 游客模式无需配置角色ID，无需录入系统，避免干扰未登录用户权限判断。