派 25 个 Explore 子代理 (5 批 × 5) 审计 23 个父命令.
产出 cmd-review/{cmd}.md (24 文件) + _summary.md.
关键发现:
- webapi 镜像使用率 < 30% (12+ 父命令 100% 绕 webapi)
- 30+ P0 必补新命令 (form update, log exception, di CRUD, role authorize 等)
- 3 处 P0 端点错误 (假 PASS):
* integration emailTest/smsTest
* msg templateCreate
- 用户关键修正: bigscreen → jnpf-web-datascreen-vue3 (独立子项目)
- 用户关键修正: report → jnpf-web-datareport (独立子项目)
下一步: Phase 2 按 P0 优先级执行 (修端点 + 新命令 + webapi 化)
Co-Authored-By: Claude <[email protected]>
4.1 KiB
4.1 KiB
dacli role 命令审计报告 (2026-06-25)
1. 命令清单 (4 个公开子命令)
| # | 命令 | 格式 | 用途 |
|---|---|---|---|
| 1 | dacli role list |
[--keyword] [--json] |
列出角色 (P1 权限三角核心) |
| 2 | dacli role create |
--fullName --enCode [--type] [--json] |
新建角色 (返回 id) |
| 3 | dacli role delete |
--id --yes |
删除角色 (非系统内置) |
| 4 | dacli role assign |
--roleId --userIds [--action add/remove] |
给角色赋用户/删用户 |
2. web 端对应
- 角色页:
web/.../views/permission/role/— index.vue (左侧树+右侧成员表, 3 个 tab: user/organize/position) + Form.vue (含约束配置) - 角色 API:
web/.../api/permission/role.ts(8 函数: getRoleList/getRoleSelector/create/update/getInfo/delRole/getRoleByCondition) - 角色关联 API:
web/.../api/permission/roleRelation.ts(5 函数: getRoleRelationList/addRoleRelation/removeRoleRelation/addRoles/removeRoles/getRoleList) - webapi 镜像: 缺失 (dataModel/dataSource/dict/menu/visualDev/workflow 已镜像)
3. 改/删/留 建议
[KEEP] 保留全部 4 个
list/create/delete/assign 设计合理无冗余
[REFACTOR-WEBAPI] P0 重点 — webapi 使用率 0%
4 子命令全部应切到 webapi 镜像 (消除 ~60 行硬编码):
- list →
loadRole.getRoleList() - create →
loadRole.create() - delete →
loadRole.delRole() - assign →
loadRoleRelation.addRoles() / removeRoles()
[DEPRECATE] 无
[NEW-CMD] P1 高优先级 — CRUD 闭环缺失
dacli role info <id>— webapi 有getInfo(), 验证创建结果dacli role update <id>— webapi 有update(), 改角色名/启用约束dacli role selector [--type] [--isSystem]— webapi 有getRoleSelector(), form/菜单配置场景
[NEW-CMD] P1 关键场景 — 权限授权核心
dacli role authorize <roleId> --menuIds <ids>— 最大缺口 — 当前只能管理角色-用户, 无法管理角色-菜单
[NEW-CMD] P2
dacli role members <roleId>— webapi 有getRoleRelationList(), 查成员dacli role permission <roleId>— 后端响应含permissionList, 调试"为什么没权限"dacli role condition— 查/改角色约束 (互斥/基数/先决)
4. AI 痛点评估
当前 4 子命令严重不足 — CRITICAL
- 缺 update — 改名需 delete+create, 破坏 ID 引用
- 缺 info — 创建后无法验证完整字段
- 缺 authorize — 权限管理闭环断裂 (无法管理角色-菜单关系)
- 缺 selector — form 配置时 AI 只能 grep
AI 完整闭环当前不可行
ROLE_ID=$(dacli role create --fullName=管理员 --enCode=admin_role --json | jq -r .id)
dacli role assign --roleId=$ROLE_ID --userIds=u1,u2,u3 --action=add
# 菜单授权 ??? 无法做!
应补充 authorize + permission 验证才能闭环。
BS 防御盲点
- enCode 全平台唯一无 L1 pre-check (类比 dict BS-47)
- isSystem=1 系统角色 delete 已保护, update 应同样检查
- 授权菜单被删导致孤儿授权需联动检测
与 user 命令关系
dacli user role <userId>(读, 反向查) vsdacli role assign --userIds(写, 正向分配) — 设计合理但建议user roles <userId> --add/--remove镜像 assign
权限三角评估
- 角色 (P1.1): 缺 update/info/selector/authorize ⚠️
- 用户 (P1.2): 18 子命令基本完整 ✅
- 组织 (P1.3): 3 子命令严重不足 ❌
核心结论: dacli role 4 子命令覆盖 CRUD + 用户分配, 但 CRUD 闭环严重不完整 (缺 update/info/selector), 权限授权核心能力缺失 (无法授权菜单给角色). webapi 镜像使用率 0%, 应立即创建 webapi/role.ts + webapi/roleRelation.ts.
Top 3 关键建议:
- P0 [REFACTOR-WEBAPI]: 创建 webapi/role.ts + webapi/roleRelation.ts, 4 命令全部切镜像
- P1 [NEW-CMD]: 新增
role update+role info+role selector补全 CRUD 闭环 - P1 [NEW-CMD]: 新增
role authorize --menuIds实现权限管理完整闭环 (角色-菜单-用户三角) — 这是当前最大能力缺口