模块管理与应用信息使用说明

构建时间2026-06-26 20:10:33（Asia/Shanghai）来源项目中间件文档 / 中间件后端来源仓../cl-midserver-2026来源提交号69b951a07311e75887b57e0400d888f89dd72cac

查看文档来源信息

• 来源目录：addons/sys_base/docs
• 来源文件：功能说明/模块管理与应用信息使用说明.md

## 功能用途 用于维护模块定义、当前模块可用的应用实例，以及角色授权和应用菜单治理所依赖的正式应用范围。

入口位置

• PCWEB 模块管理页
• PCWEB 应用信息页
• 角色授权抽屉中的应用绑定区域
• PCWEB 应用菜单页

使用前提

1. 模块已在模块管理页完成正式登记。
2. 应用实例已在应用信息页维护完成。
3. 角色授权和应用菜单治理依赖应用 UUID 作为正式应用定位键。

操作方法

1. 在模块管理页确认模块定义、模块标识和治理模式。
2. 在应用信息页维护当前模块下的应用实例。
3. 在角色授权抽屉中读取应用实例列表并绑定目标角色。
4. 在应用菜单页继续使用同一批正式应用 UUID 做范围治理。

规则说明

1. 按 addonsType 查询应用信息列表时，后端会按模块关联关系过滤正式可归属应用实例。
2. 角色应用绑定保存时使用与应用信息列表相同的模块归属判定口径。
3. 如果列表能选到某个应用实例，正式保存时也必须允许该实例被绑定到目标角色。
4. 当前模块没有可绑定应用实例时，允许角色保存空应用绑定结果。

常见结果

• 模块下已有正式应用实例时，角色授权抽屉可以直接绑定这些应用。
• 模块下无正式应用实例时，角色授权仍可继续维护页面、动作和默认页，只是应用绑定为空。
• 应用菜单治理读取的应用范围与角色授权绑定结果保持同一套正式应用定位键。

维护提示

• 发现“列表能选、保存失败”时，优先检查应用实例 addonsId 与当前模块 app_model.id 的关联关系。
• 不要通过前端删掉候选项来掩盖后端正式归属判定错误。