- fix: page-recipe 的 maintenance-crud 漏 `-v1`,而 compile 端点精确匹配 maintenance-crud-v1,agent 照抄示例会 400;统一为 -v1,并引导以 GET /api/ai/page-recipes 为权威列表,避免硬写字面量漂移。 - env-manage 新增「鉴权/Token」段:非 prod profile permitAll 免 token, prod/JWT 环境需 POST /api/auth/login 取顶层 `token` + `Authorization: Bearer` (核实 AuthController/JwtAuthFilter)。 - AGENTS.md(writeAgentsMd):把「优先 platform-cli」误导修为按类分流 (env/ai/release 用 CLI,建模/页面/授权用 REST 或 platform-mcp), 并点名 platform-mcp 注册方式 + token 获取指引。 - data-modeling/page-recipe/acl-manage 各加调用方式与 token 交叉引用。 - 测试 +3:page-recipe recipe-id 回归、AGENTS.md MCP/auth、bundled skills 防漂移。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1.6 KiB
1.6 KiB
Skill: eip4-acl-manage
触发场景
- 给角色授菜单、管理用户组 / 角色成员、查看菜单树。
调用方式:经 REST(无对应 CLI 子命令),或经
platform-mcp(MCP)。非 local 环境需带Authorization: Bearer <token>,取 token 见eip4-env-manage。
菜单
GET {{EIP4_BASE_URL}}/api/admin/menu-all— 管理视角全量菜单树(roots[]两级,含templateId)。GET {{EIP4_BASE_URL}}/api/menu— 当前用户可见菜单树。GET {{EIP4_BASE_URL}}/api/admin/user/{userId}/menu— 指定用户可见菜单。- 菜单写:
POST {{EIP4_BASE_URL}}/api/admin/menus/create、/api/admin/menus/{id}/update、/api/admin/menus/{id}/delete。
角色授权
POST {{EIP4_BASE_URL}}/api/admin/roles/{id}/set-menus,body{"menuIds": ["..."]}(整存差量,空数组=清空)。GET {{EIP4_BASE_URL}}/api/admin/roles/{roleId}/users— 角色成员。
用户 / 用户组
GET {{EIP4_BASE_URL}}/api/admin/users?page=1&perPage=20&keyword=— 用户分页(密码列不下发)。POST {{EIP4_BASE_URL}}/api/admin/usergroups/create,body{"name","description"}。POST {{EIP4_BASE_URL}}/api/admin/usergroups/{id}/update | /delete。POST {{EIP4_BASE_URL}}/api/admin/usergroups/{id}/add-user | /remove-user(幂等)。POST {{EIP4_BASE_URL}}/api/admin/usergroups/{id}/add-role | /remove-role。
红线
- 写操作仅管理员,事务性。
- 授权走「用户组 → 角色 → 菜单」链(
sys_usergrouprole/sys_usergroupuser),不直接给单用户授菜单。