infra-parent

租户应用菜单同步

设计目标

租户 1 是平台模板租户，负责维护平台下发的应用、菜单、按钮以及租户管理员的默认授权范围。其他租户在创建时获得独立数据副本，后续由租户 1 的平台管理员按需增量同步。

同步不依赖客户端提交租户请求头。当前登录人必须是租户 1 的平台管理员，目标租户 ID 只是受控平台接口的业务参数。

数据对应关系

• 应用编码 upm_application.code 在租户内唯一且创建后不可修改，应用通过编码建立对应关系。
• upm_permission.source_id 保存租户 1 的模板菜单 ID。
• 租户 1 的模板菜单 source_id 为空。
• 其他租户从平台复制或同步的菜单，source_id 为对应模板菜单 ID。
• 租户自行创建的菜单 source_id 为空，同步过程不会修改。
• (tenant_id, source_id) 唯一索引保证同一模板菜单在一个租户中只有一份副本。

新建租户

新建租户以租户 1 为模板，依次初始化设备端、默认部门、应用、第三方认证占位配置、菜单按钮和租户管理员。应用的 SSO 密钥、回调地址及注销推送地址不会复制。

每个业务租户只创建租户管理员，不再创建平台管理员。平台管理员只存在于租户 1。

同步规则

• 模板新增应用：在目标租户创建应用，SSO 默认关闭且不复制客户端凭据。
• 模板修改应用：同步名称、图标、Logo、首页、描述、排序和可操作状态，不覆盖目标租户的启停状态及 SSO 配置。
• 模板新增菜单按钮：创建副本并重建目标租户内的父子关系。
• 模板修改菜单按钮：同步应用、父级、名称、路由、组件、图标、排序、终端、权限编码和状态。
• 模板删除菜单按钮：目标租户对应记录停用，不执行物理或逻辑删除。
• 平台下发且带有来源的菜单不能由目标租户删除，避免破坏后续幂等同步；租户自建菜单仍按原规则维护。
• 租户自建应用编码属于平台模板编码命名空间；同步时相同编码被视为同一个应用。
• 租户自建菜单来源为空，不参与更新或停用。
• 租户管理员对平台菜单的授权与租户 1 的租户管理员保持一致，租户自建菜单授权保持不变。

预览和执行使用同一套差异计算规则。同步具有幂等性，没有模板变化时重复执行不会新增或更新数据。

接口

GET  /tenant/{id}/permission-sync/preview
POST /tenant/{id}/permission-sync

两个接口都需要 system:tenant:sync 权限，并在处理器中再次校验当前登录人属于租户 1 且拥有平台管理员角色。

历史数据

增量脚本只增加来源字段、唯一索引和平台同步权限，不尝试通过名称、路由等不稳定字段匹配历史租户菜单。已有菜单但没有任何来源记录的历史租户会被同步接口拒绝，应清理后通过新流程重新创建。

数据库升级脚本：

• MySQL：sql/migration/20260925_tenant_permission_sync.mysql.sql
• PostgreSQL：sql/migration/20260925_tenant_permission_sync.postgres.sql

This site is open source. Improve this page.