Files
dacli/docs/cmd-review/role.md
T
sswandClaude b9c9e318af feat(v0.11+): Phase 1 - 23 个 dacli 父命令审计完成
派 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]>
2026-06-25 14:58:32 +08:00

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

  1. 缺 update — 改名需 delete+create, 破坏 ID 引用
  2. 缺 info — 创建后无法验证完整字段
  3. 缺 authorize — 权限管理闭环断裂 (无法管理角色-菜单关系)
  4. 缺 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> (读, 反向查) vs dacli 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 关键建议:

  1. P0 [REFACTOR-WEBAPI]: 创建 webapi/role.ts + webapi/roleRelation.ts, 4 命令全部切镜像
  2. P1 [NEW-CMD]: 新增 role update + role info + role selector 补全 CRUD 闭环
  3. P1 [NEW-CMD]: 新增 role authorize --menuIds 实现权限管理完整闭环 (角色-菜单-用户三角) — 这是当前最大能力缺口