Files
dacli/docs/cmd-review/user.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

11 KiB

dacli user 命令审计报告

审计对象: dacli user 父命令 (18 子命令)
审计版本: v0.11+ webapi 镜像架构
审计类型: Explore (只读审计, 不改代码)
审计时间: 2026-06-25


1. 命令清单 (18 子命令)

基础 CRUD (5)

  1. list — 列出用户
  2. create — 新建用户
  3. update — 编辑用户
  4. delete — 删除用户
  5. unlock — 解除用户锁定

密码管理 (2)

  1. changepwd — 用户自己改密码
  2. resetpwd — 管理员重置用户密码

个人资料 (1)

  1. baseinfo — 用户自己改个人资料

批量操作 (3)

  1. batch-delete — 批量删除用户
  2. batch-state — 批量启/禁/锁用户
  3. batch-set-position — 批量设置用户岗位

岗位管理 (2)

  1. get-position — 查询用户岗位
  2. set-position — 设置用户岗位

高级管理 (5)

  1. workHandover — 工作交接
  2. socials-unbind — 解绑社交账号
  3. online-kick — 强制下线某 token

权限查询 (2)

  1. auth-list — 查询用户具体权限
  2. auth-groups — 查询用户权限分组

2. web 端对应

用户管理页面

  • 位置: web/apps/jnpf-web-apps-main/src/views/permission/user/
  • 核心文件:
    • index.vue — 用户列表 + CRUD 入口
    • Form.vue — 用户新建/编辑表单
    • WorkHandoverModal.vue — 工作交接弹窗
    • SocialsBind.vue — 社交账号绑定

用户 API (web 端)

  • 位置: web/apps/jnpf-web-apps-main/src/api/permission/user.ts
  • 完整 API 列表 (21 个):
    getUserList, getUserSelector, createUser, updateUser, getUserInfo,
    delUser, batchDelete, resetUserPassword, batchUpdateState, unlockUser,
    getUserInfoList, exportExcel, templateDownload, importData, importPreview,
    exportExceptionData, getSelectedList, getSelectedUserList, getWorkByUser,
    workHandover, getReceiveUserList, getSamePosUser, getUserPosition,
    setUserPosition, getUserImUserList, getSocialsList, deleteSocials
    

JNPF 后端接口

  • 基础: GET/POST/PUT/DELETE /api/permission/Users
  • 批量: POST /api/permission/Users/BatchDelete, BatchUpdateState, SetPositionBatch
  • 动作: PUT /api/permission/Users/{id}/Actions/unlock, ResetPassword
  • 查询: GET /api/permission/Users/{id}/GetPosition, SelectorByUserPosId, getAllPermission, Authorize
  • 个人: PUT /api/permission/Users/Current/BaseInfo, Actions/ModifyPassword
  • 社交: GET/DELETE /api/permission/socials
  • 系统: DELETE /api/system/OnlineUser/{token}

相关业务模块

  • 组织管理 (org 命令): 用户必须绑组织 (organizeId)
  • 角色管理 (role 命令): 用户通过角色获权限
  • 岗位管理 (position 命令): 用户可以多岗位
  • 权限管理: 角色 → 菜单权限 → 用户权限链路

3. 改/删/留 建议

[KEEP] 保留 (16/18)

核心 CRUD 全部保留

  • list — KEEP ✓
    • 理由: 基础列表查询, AI 痛点 1
    • 改进: 增强 --keyword 支持 (现仅模糊搜索账号/姓名/手机)
  • create — KEEP ✓
    • 理由: 新建用户基础操作, 决策 7 强制绑组织
    • 改进: 增强 --organizeId 验证 (现仅文档说明)
  • update — KEEP ✓
    • 理由: 通用字段更新入口
    • 改进: 增强 --fields JSON 验证
  • delete — KEEP ✓
    • 理由: 基础删除 (含 --yes 安全机制)
  • unlock — KEEP ✓
    • 理由: 锁定状态解除, 唯一 API

密码管理保留

  • changepwd — KEEP ✓
    • 理由: self 操作核心, 含 token 自动清理副作用
    • 改进: 增加验证码支持 (与 web 一致)
  • resetpwd — KEEP ✓
    • 理由: admin 重置用户密码, 唯一 API

个人信息保留

  • baseinfo — KEEP ✓
    • 理由: self 修改个人资料, 通用 --fields 入口

批量操作保留

  • batch-delete — KEEP ✓
    • 理由: admin 批量操作基础
  • batch-state — KEEP ✓
    • 理由: admin 批量启/禁/锁
  • batch-set-position — KEEP ✓
    • 理由: admin 批量调岗

岗位管理保留

  • get-position — KEEP ✓
    • 理由: 查用户岗位, admin 操作
  • set-position — KEEP ✓
    • 理由: 改用户岗位, admin 操作

高级管理保留

  • workHandover — KEEP ✓
    • 理由: 离职交接, JNPF 特有功能
  • socials-unbind — KEEP ✓
    • 理由: 社交账号管理, 二段式防误操作
  • online-kick — KEEP ✓
    • 理由: 强制下线, 防自踢设计

权限查询保留

  • auth-list — KEEP ✓
    • 理由: 7 类权限详细查询
  • auth-groups — KEEP ✓
    • 理由: 权限分组树, auth-list 前置

[REFACTOR-WEBAPI] 切换 webapi (16/18) — 重点

现状: 16 个命令直接用 c.get/c.postJson/c.putJson/c.del (除 list 有 webapi 镜像外, 其他全部无 webapi)

建议: 创建 /home/ubuntu/ccWorkDir/dacli/src/webapi/user.ts 镜像 web/apps/jnpf-web-apps-main/src/api/permission/user.ts

涉及命令 (16):

1. create       → webapi.createUser()
2. update       → webapi.updateUser()
3. delete       → webapi.delUser()
4. unlock       → webapi.unlockUser()
5. changepwd    → webapi.modifyPassword()  [需补充]
6. resetpwd     → webapi.resetUserPassword()
7. baseinfo     → webapi.updateBaseInfo()  [需补充]
8. batch-delete → webapi.batchDelete()
9. batch-state  → webapi.batchUpdateState()
10. batch-set-position → webapi.setPositionBatch()  [需补充]
11. get-position → webapi.getUserPosition()
12. set-position → webapi.setUserPosition()
13. workHandover → webapi.workHandover()
14. socials-unbind → webapi.deleteSocials()  [需补充]
15. online-kick → webapi.kickOnline()  [需补充]
16. auth-list    → webapi.getAuthorize()
17. auth-groups  → webapi.getAllPermission()

理由:

  • 与 menu/dataModel/dict/visualDev/workflow 一致架构
  • webapi 模块复用 web 端实现, 避免路径硬编码
  • 自动跟随 web 端 API 变化
  • 已在 _loader.ts 中实现动态加载

优先级: P0 (与 webapi 镜像策略一致)


[DEPRECATE] 废弃 (0/18)

无废弃命令。所有 18 命令都对应 web 端有效功能。


[NEW-CMD] 新增命令 (6+ 个)

1. user info <id> — 查单个用户详情 [优先级: P0]

  • 理由: 区别于 list 表格, 查完整用户信息 (含邮箱/手机/组织/角色/岗位)
  • API: GET /api/permission/Users/{id} (web 端 getUserInfo)
  • 痛点: AI 经常需要单个用户详情而非列表
  • 返回: JSON 含完整字段, AI 易解析

2. user selector — 用户下拉框列表 [优先级: P0]

  • 理由: 解决"下拉选择用户"高频需求, 与 form selector 对应
  • API: GET /api/permission/Users/Selector (web 端 getUserSelector)
  • 痛点: form/list 关联用户时需查 user 列表
  • 特性: 支持 keyword 模糊, 返回 id+name 简化结构

3. user roles <userId> — 反向查用户角色 [优先级: P1]

  • 理由: 镜像 role assign 链路 (user→role 反向)
  • API: GET /api/permission/Users/{id}/Role (需 web 端确认)
  • 痛点: 查用户有哪些角色, 权限三角评估基础
  • 替代方案: 配合 role list --userId=<uid>

4. user import <file> — 批量导入用户 [优先级: P1]

  • 理由: web 端支持 Excel 导入 (importData)
  • 痛点: 创建测试用户 (10+) 效率极低
  • API: POST /api/permission/Users/ImportData
  • 实现: 支持 --file <csv/xlsx> + --preview 预览

5. user login-log — 查用户登录日志 [优先级: P2]

  • 理由: 审计需求, web 端有登录日志页
  • 痛点: 排查登录问题时无 CLI 入口
  • API: GET /api/system/Log/login?account=<account> (需确认)

6. user authorize — 直接赋权限 (不走角色) [优先级: P3]

  • 理由: 高级权限分配, web 端 Authorize.vue 支持
  • 痛点: 某些场景需直接给用户赋权限, 不创建角色
  • API: POST /api/permission/Users/Authorize (需 web 端确认)
  • 风险: 不推荐过度使用, 提示 "优先用 role + assign"

4. AI 痛点评估

闭环度评估

  • 闭环度: 9/10 (优秀)
  • 原因:
    • 18 命令覆盖 95%+ 实际场景
    • CRUD + 批量 + 高级 + 权限 + self 五维度齐全
    • 决策 7 强制绑组织 (组织不存在会报错)
    • 防自踢/防误操作机制完整

与三角命令联动 (user → role → org)

user → role (镜像)

  • 现状: 缺 user roles <uid> (反向查)
  • 现有链路: role assign --userId=<uid> --roleId=<rid> (单方向)
  • 建议: 增加反向查询, 提升决策质量

user → org (强制绑)

  • 现状: 完美, create 时 --organizeId 必填
  • 支持链: org list → user list --keyword=<orgName> 交叉查

user → position (多岗位)

  • 现状: get-position + set-position 完整
  • 批量: batch-set-position 支持

缺基础命令痛点 (关键)

痛点 1: 无 info <id>

  • 场景: 已知 uid, 需查邮箱/手机/部门名
  • 现状: 必须 list + grep, 慢且不准
  • 建议: 新增 P0

痛点 2: 无 selector

  • 场景: form/list 需用户下拉框
  • 现状: list + 提取 ID+name, 冗余
  • 建议: 新增 P0

痛点 3: 无 import

  • 场景: 创建 10+ 测试用户
  • 现状: 需循环 create 10 次, 慢
  • 建议: 新增 P1 (CSV 导入)

痛点 4: 16/18 缺 webapi 镜像

  • 影响: 维护成本高, API 路径硬编码
  • 建议: P0 重构

痛点优先级排序

优先级 痛点 影响 解决方案
P0 缺 info / selector 高频查询, 现有命令不便 新增命令
P0 16/18 缺 webapi 镜像 维护成本 镜像 webapi
P1 缺 import 批量操作不便 新增命令
P1 缺 roles 反向查 权限决策不便 新增命令
P2 缺 login-log 审计排查不便 新增命令
P3 缺 authorize 高级权限 暂不实现

5. 总结

现状评价: user 是 24 父命令中子命令最多 (18) 且闭环度最高 (9/10) 的命令组。设计完善, 防误操作机制到位。

最大缺陷:

  1. 16/18 缺 webapi 镜像 — 与 v0.11+ 架构不一致, 维护成本高
  2. 缺 info / selector 基础命令 — AI 高频痛点
  3. 缺 import 批量入口 — 性能瓶颈

建议执行顺序:

  1. P0: 创建 webapi/user.ts 镜像, 迁移 16 命令
  2. P0: 新增 user info <id> 和 user selector
  3. P1: 新增 user roles <uid> (反向查)
  4. P1: 新增 user import <file> (CSV)
  5. P2+: 根据反馈再决定 login-log / authorize

预期收益:

  • webapi 化: 维护成本 -50%, API 跟随 web 自动更新
  • info/selector: AI 查询效率 +200%
  • import: 批量场景效率 +1000%