- 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>
33 lines
1.6 KiB
Markdown
33 lines
1.6 KiB
Markdown
# 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`),不直接给单用户授菜单。
|