派 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]>
307 lines
11 KiB
Markdown
307 lines
11 KiB
Markdown
# 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)
|
|
6. `changepwd` — 用户自己改密码
|
|
7. `resetpwd` — 管理员重置用户密码
|
|
|
|
### 个人资料 (1)
|
|
8. `baseinfo` — 用户自己改个人资料
|
|
|
|
### 批量操作 (3)
|
|
9. `batch-delete` — 批量删除用户
|
|
10. `batch-state` — 批量启/禁/锁用户
|
|
11. `batch-set-position` — 批量设置用户岗位
|
|
|
|
### 岗位管理 (2)
|
|
12. `get-position` — 查询用户岗位
|
|
13. `set-position` — 设置用户岗位
|
|
|
|
### 高级管理 (5)
|
|
14. `workHandover` — 工作交接
|
|
15. `socials-unbind` — 解绑社交账号
|
|
16. `online-kick` — 强制下线某 token
|
|
|
|
### 权限查询 (2)
|
|
17. `auth-list` — 查询用户具体权限
|
|
18. `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%
|
|
|