资源管理

本文档面向平台管理员，规范 AIHUB 系统资源管理全流程，明确资源前置配置规范、新增、修改、删除操作标准，统一资源类型使用规则、内置资源管控要求，指导管理员标准化完成平台资源配置工作，保障菜单权限、按钮权限正常生效。

1. 前置规范说明

1.1 适用场景

平台管理员登录 AIHUB 后台，进行系统业务资源新增、信息修改、无用资源删除等日常配置工作，适配平台菜单、页面、按钮权限的资源迭代与维护场景。

1.2 操作权限要求

操作账号必须拥有超级管理员（100）权限，仅查看、普通管理员、运营、财务角色无资源新增、修改、删除操作权限，仅可查看资源目录。

1.3 前置约束

• 平台资源固定为模块→菜单→元素（按钮）三级树形结构，层级不可错乱、不可跨级挂载；
• 所有资源必须绑定合法父节点，严格区分资源类型，不同类型挂载规则固定，不支持自定义层级；
• 系统内置资源为平台基础核心资源，禁止一切新增复刻、修改、删除操作，仅支持查看。

2. 资源核心基础规则

2.1 三类资源类型使用规范

• 模块（顶级资源）：侧栏大分组顶级节点，为最高层级资源，无父节点，用于归类同业务所有菜单页面，如仪表盘、管理员配置、运营管理、系统配置。
• 菜单（页面资源）：对应后台具体功能页面，必须归属某一个模块，绑定页面访问路径，是页面权限控制的核心载体。
• 元素（按钮/操作资源）：页面内新增、编辑、保存、删除等操作按钮，必须归属某一个菜单，仅用于精细化按钮权限管控。

2.2 资源状态与展示规则

• 通用状态：启用、停用，停用资源自动从用户侧栏隐藏，权限临时失效；
• 元素专属展示状态：可见可点、不展示、可见但禁用（置灰），优先级高于资源默认展示配置；
• 资源展示生效逻辑：父节点未启用/未授权，子节点无论配置状态如何，均自动隐藏、权限不生效。

2.3 内置资源说明

平台默认仪表盘、管理员配置、运营管理、系统配置下所有基础菜单、核心按钮均为系统内置资源，固化在系统内核，禁止删除、禁止修改名称、编码、路径、挂载关系，仅支持查看默认配置。

3. 全流程操作指引（新增/修改/删除）

3.1 进入资源管理页面

登录 AIHUB 平台后台，在左侧菜单栏展开 管理员配置，点击【身份与权限】进入权限管理页面，在顶部选项卡切换至 资源管理，即可进行资源全流程配置。

页面支持按名称、编码、路径模糊检索资源，支持树形列表全部收起、刷新，可快速定位目标资源。

3.2 新增资源操作步骤

1. 在资源管理页面，点击【新建资源】按钮，打开新增资源配置弹窗；

2. 选择资源类型（模块/菜单/元素），严格遵循层级规则选择对应父节点：模块无父节点、菜单绑定模块、元素绑定菜单；

3. 填写资源名称、唯一编码、访问路径（菜单专用），按需勾选默认展示状态；

4. 核对信息无误后，点击【保存】，即可完成资源新增。

新增必填规范：类型、父节点、编码、名称为四项必填项，编码全局唯一，禁止重复，建议与业务场景、归属菜单关联命名。

3.3 修改资源操作步骤

1. 在资源树形列表中，找到需要调整的自定义资源，点击操作列【编辑】按钮；

2. 按需修改资源名称、展示状态、访问路径等可配置参数，禁止修改内置资源及已授权资源的类型、父节点、核心编码；

3. 核对修改后信息，确认层级挂载关系无误，点击【保存】完成修改。

修改禁忌：已绑定角色授权、正在使用的核心资源，不建议随意修改父节点与编码，会导致权限失效、菜单消失。

3.4 删除资源操作步骤

1. 在资源树形列表中，定位无用、过期的自定义非内置资源，点击操作列【删除】按钮；

2. 弹窗二次确认删除提示，确认无误后点击【确定】，完成资源删除；

3. 删除完成后，系统自动级联清理该资源下所有子孙节点，同时清空所有角色对应该资源的授权记录。

删除核心规则：内置资源禁止删除；删除前需确认资源无业务依赖，避免批量权限异常。

4. 资源操作禁忌与约束

• 层级约束：严禁跨级挂载资源，模块下仅可创建菜单、菜单下仅可创建元素，层级错乱会导致菜单不显示、权限不生效。

• 编码约束：所有资源编码全局唯一，新增、修改时禁止重复编码，按钮元素编码建议遵循「菜单编码操作标识」规范（如 identityauthorization_save）。

• 内置资源约束：系统所有内置模块、菜单、按钮，禁止新增复刻、修改、删除，仅支持查看默认配置。

• 级联约束：删除父级资源会级联删除所有子资源、清空对应授权，核心业务父资源禁止随意删除。

• 权限联动约束：新增资源后不会自动授权，需手动为对应角色配置授权，否则所有角色均无法访问使用。

5. 常见问题说明

• 新增资源后侧栏不显示：大概率未配置角色授权、仅新增子资源未挂载父级模块/菜单、资源状态为停用，需逐级核对资源层级与授权配置。

• 资源修改后权限失效：修改了资源编码、父节点导致原有授权匹配失效，需重新同步角色授权列表。

• 无法删除资源：该资源为系统内置资源，或存在未清理的子节点/授权记录，内置资源禁止删除，非内置资源需先清理关联数据。

• 按钮权限不生效：仅配置按钮资源未授权对应上级菜单、模块，未满足「模块+菜单+元素」完整授权层级要求。