中间件准备流程

中间件准备必须先于前后端联调完成。没有应用、KEY、角色、菜单、默认页和授权，SDK 只能初始化，不能证明权限闭环已经成立。

准备步骤

1. 创建或确认应用，记录 appId / appUuid 与 addonsType。
2. 创建或确认应用 KEY，后端保存 PermanentKey，前端不得保存。
3. 确认中间件服务端 SystemKey，只交给后端服务端配置。
4. 创建或确认角色列表，至少包含本期验收需要的业务角色。
5. 准备 PCWEB 使用的 system_menu。
6. 准备 APP / 小程序使用的 app_menu。
7. 配置默认页，保证默认页对应已发布菜单中的真实页面。
8. 发布菜单版本。
9. 给角色授权页面、动作和接口。
10. 确认授权后的 grantApis 已进入角色 Casbin。

菜单准备要求

• PCWEB 使用 system_menu。
• APP / 小程序使用 app_menu。
• 页面必须有稳定 pageCode。
• 按钮或业务动作必须有稳定 actionCode。
• 写接口必须通过 grantApis 声明资源和请求方式。
• 菜单发布和角色授权完成后，再进行前后端联调。

demo 菜单 JSON 示例

{
  "pageCode": "demo.rule.list",
  "title": "规则管理",
  "routePath": "/demo/rule/list",
  "actions": [
    {
      "actionCode": "demo.rule.create",
      "title": "新增规则",
      "grantApis": [
        {
          "resource": "/demo/platform/rule/create",
          "action": "POST"
        }
      ]
    }
  ]
}

中间件准备完成标准

• 应用已创建。
• KEY 已创建。
• system_menu 已上传并发布。
• app_menu 已上传并发布。
• 角色已创建或确认。
• 角色已授权。
• 默认页已配置。
• Casbin 已生效。