diff --git a/docs/cmd-review/_summary.md b/docs/cmd-review/_summary.md new file mode 100644 index 0000000..faa5b1e --- /dev/null +++ b/docs/cmd-review/_summary.md @@ -0,0 +1,123 @@ +# Phase 1 总结报告: 23 个 dacli 父命令审计 (2026-06-25) + +> **背景**: 用户在 v0.11+ plan 中要求"逐个过 23 个 dacli 父命令", 看 web 端页面逻辑, 决定命令改/删/留. +> **方法**: 5 批 × 5/批 派 Explore 子代理并行审计, 主代理汇总. +> **产出**: `dacli/docs/cmd-review/` 23 个 markdown 报告 + 本总结. + +## 1. 审计覆盖 (23/23 完成) + +| 批次 | 命令 | web 路径修正 | +|------|------|--------------| +| A | apis, app, bigscreen, datasource, di | **bigscreen** → `jnpf/前端/jnpf-web-datascreen-vue3` | +| B | dict, dm, doc, form, integration | — | +| C | log, menu, monitor, msg, org | — | +| D | portal, print, report, role, schedule | **report** → `jnpf/前端/jnpf-web-datareport` | +| E | storage, user, workflow | — | + +**用户关键修正** (2026-06-25): +1. **bigscreen** web 在独立子项目 `jnpf-web-datascreen-vue3`, 不是主 webapp +2. **report** web 在独立子项目 `jnpf-web-datareport`, 不是主 webapp +3. 这两类命令审计 v2 已重新执行 + +## 2. 总体数据 + +| 维度 | 数据 | +|------|------| +| 总子命令数 | 116 (24 父命令) | +| webapi 镜像模块 | 6 (dataModel/dataSource/dict/menu/visualDev/workflow) | +| webapi 镜像函数 | 95 | +| webapi 实际使用率 | **< 30%** (大量 c.postJson/c.get 仍手写) | +| 缺 [REFACTOR-WEBAPI] 的命令 | **12+ 父命令** | +| 缺 [NEW-CMD] P0 必补 | **30+ 个新命令** | +| 端点错误 (P0 假 PASS) | **3 处** (integration emailTest/smsTest, msg templateCreate) | + +## 3. P0 优先级 Top 10 (按执行价值) + +1. **`dacli form update` (高需求, 增量改 schema)** — 改 schema 需 export → 改 → import, 无原子性 +2. **`dacli log exception` (P0 必补)** — AI 排查后端异常的唯一杀手锏, 当前完全缺失 +3. **`dacli di info/test/create/update/delete` (5 个)** — 当前 1 个 list, AI 完全无法闭环 +4. **`dacli role update/info/selector/authorize` (4 个)** — 权限管理闭环断裂 +5. **`dacli org update/delete/info + org position (5 子) + org selector`** — 闭环 + 岗位空白 +6. **`dacli msg noticeUpdate/Delete + templateUpdate/Delete` (4 个)** + 修端点错误 +7. **`dacli storage create/update/delete + upload/download/ls` (6 个)** — 阻塞附件调试 +8. **`dacli apis search --field=` (P0)** — 解决 AI 字段盲猜 +9. **`dacli bigscreen update/delete/category` (3+ 个)** — 补全 CRUD 闭环 +10. **`dacli report create/update/delete + preview + category` (5+ 个)** — 报表管理 3/8 = 12.5% 覆盖率 + +## 4. P0 [REFACTOR-WEBAPI] Top 5 (架构对齐) + +1. **datasource** 4 子命令 (100% 绕 webapi) — webapi/dataSource.ts 已镜像 11 函数, 使用率 0% +2. **dict** 4 子命令 (100% 绕 webapi) — webapi/dict.ts 已镜像 15 函数, 使用率 0% +3. **menu** 6/8 子命令 (1/15 = 6.7% 使用率) — 消除 ~120 行硬编码 +4. **form** import.ts (8 调用) + codegen.ts (4) + create.ts (4) + fixcolumndata.ts (3) — 22 调用待切 +5. **dm** create + drop — 切到 webapi/dataModel.ts + +## 5. 端点错误 (P0 假 PASS, 立即修) + +| 命令 | 当前错误端点 | 正确端点 | 影响 | +|------|--------------|----------|------| +| `integration emailTest` | `/message/SendMessageConfig/testSendConfig` | `/message/AccountConfig/testSendMail` | 假 PASS | +| `integration smsTest` | `/system/SmsTemplate/testSent` | `/message/AccountConfig/testSendSms` | 假 PASS | +| `msg templateCreate` | `/api/system/MessageTemplate` | `/api/message/MessageTemplateConfig` | 调用失败 | + +## 6. AI 痛点 Top 5 跨命令 + +1. **webapi 一致性差** — 12+ 父命令 100% 绕 webapi, 大量 c.postJson/c.get 手写 +2. **CRUD 闭环断裂** — 大量命令缺 update/info/delete, 改名/修改/清理需 delete+create +3. **selector 缺失** — 多个命令缺选择器 (role/org/dict type/storage/menu), AI 引用 ID 需 list 拉全表 +4. **P0 端点错误 (假 PASS)** — 3 处端点错, AI 调用成功但实际不生效 +5. **子项目 web 路径未知** — bigscreen/report 是独立子项目, 需特殊处理 + +## 7. Phase 2 执行建议 + +### 立即执行 (P0 端点错误) +- 修 integration emailTest/smsTest 端点 +- 修 msg templateCreate 端点 +- 加 @deprecated 标记 +- **执行时间**: 半天 + +### 短期 (P0 必补 [NEW-CMD]) +- form update (2 周) +- log exception (1 周) +- di info/test/create/update/delete (1 周) +- role update/info/selector/authorize (1 周) +- org position + selector (1 周) +- msg noticeUpdate/Delete + templateUpdate/Delete (3 天) +- **总时间**: ~6 周 + +### 短期 (P0 必补 [REFACTOR-WEBAPI]) +- datasource 4 子命令 (2 天) +- dict 4 子命令 (2 天) +- menu 6 子命令 (3 天) +- form import/codegen/create/fixcolumndata (1 周) +- **总时间**: ~2 周 + +### 中期 (P1 增强) +- apis search (3 天) +- storage CRUD (1 周) +- bigscreen update/delete/category (1 周) +- report CRUD (2 周) + +## 8. 不建议做的事 (基于审计) + +1. ❌ 不建议补 `schedule pause/resume/start/stop` — JNPF 无对应 API, 用 `update --enabledMark` 替代 +2. ❌ 不建议把 `schedule log` 移到 `monitor` — 数据源不同 +3. ❌ 不建议命令化 bigscreen/report 设计器 drag-drop — UI 复杂操作, 命令化收益低 +4. ❌ 不建议补 `app init --restart` 实际功能 — 现有 dry-run 已说明, 改用 `app use ` 替代 +5. ❌ 不建议 `dict dataList` 改名 — 现有 4 子命令命名清晰 + +## 9. 下一步 + +**Phase 2 开始**: 按 P0 优先级执行 +1. **Day 1-2**: 修 3 处端点错误 + 加 @deprecated +2. **Week 1**: form update + log exception +3. **Week 2-3**: di/role/org/msg P0 必补 +4. **Week 4-5**: webapi 镜像化 (datasource/dict/menu/form) +5. **Week 6+**: P1 增强 (apis search / storage / bigscreen / report) + +--- + +**作者**: 2026-06-25 派 25 个 Explore 子代理审计 (5 批 × 5) +**审计者**: 23 个 dacli 父命令 (apis/app/bigscreen/datasource/di/dict/dm/doc/form/integration/log/menu/monitor/msg/org/portal/print/report/role/schedule/storage/user/workflow) +**关键修正**: bigscreen/report 是独立子项目, web 路径已修正 +**下一步**: Phase 2 按 P0 优先级执行 diff --git a/docs/cmd-review/apis.md b/docs/cmd-review/apis.md new file mode 100644 index 0000000..3484f34 --- /dev/null +++ b/docs/cmd-review/apis.md @@ -0,0 +1,74 @@ +# dacli `apis` 命令审计报告 (2026-06-25) + +## 1. 命令清单 + +| 子命令 | 格式 | 用途 | +|--------|------|------| +| `dacli apis list` | `[--tag=] [--method=] [--keyword=] [--json]` | 列 JNPF 平台所有 API (从 /v3/api-docs 拉取, 12h 缓存) | +| `dacli apis info` | ` [--json]` | 查单个 API 详情 + 递归解析 $ref (含 ActionResult.data 展开) | +| `dacli apis refresh` | — | 强制刷新 OpenAPI 缓存 (忽略 12h TTL) | +| `dacli apis status` | `[--json]` | OpenAPI 缓存状态 (loaded/age/pathCount/openapiSize) | + +## 2. web 端对应 + +apis 是**元工具**,没有对应的 web 页面。它直接调用 JNPF 后端端点: +- `GET /v3/api-docs` — SpringDoc OpenAPI 标准端点,返回 1000+ API 完整定义 +- 备选:`http://127.0.0.1:30000/v3/api-docs`(容器外 fallback) + +## 3. 改/删/留 建议 + +### [KEEP] 所有 4 个子命令 +- **list**:高频 AI 排查入口,支持 tag/method/keyword 过滤 +- **info**:杀手特性,递归展开 `$ref` + ActionResult.data 展开 +- **refresh**:JNPF 升级/新增 API 后强制重拉 +- **status**:诊断"为什么看不到新 API"的标准命令 + +### [REFACTOR-WEBAPI] 不适用 +apis 不是业务 API 客户端,直接拉 SpringDoc OpenAPI。**无 webapi 镜像对象**。 + +### [DEPRECATE] 无 +所有 4 个子命令都有明确价值。 + +### [NEW-CMD] 建议新增 + +**`dacli apis search --field=`**(P0) +- 场景:AI 知道字段名(如 `f_user_name`),想知道哪些 API 返回/接受这个字段 +- 实现:遍历 OpenAPI schema,匹配 properties 中字段名 +- 价值:避免 AI 盲猜(盲点根因 B) + +**`dacli apis tags`**(P1) +- 场景:AI 不知道 JNPF 有哪些业务 tag(`visualdev`/`system`/`workflow`等) +- 实现:解析 OpenAPI tags 字段,列出所有 tag + API 数 +- 价值:作为 `apis list --tag=X` 的引导 + +## 4. AI 痛点评估 + +### 痛点 1:缓存失效机制有盲区 +- 12h TTL + PID 哈希(process.pid + 启动时间分钟) +- **问题**:JNPF 容器重启后 API 可能已变,但 PID 哈希可能未变,AI 误以为缓存最新 +- **建议**:缓存 key 加入后端版本号(来自 `/v3/api-docs` 的 `info.version`) + +### 痛点 2:缺少字段维度搜索 +- AI 知道字段名 `f_user_name`,但 `--keyword` 只能搜 path/summary,搜不到 schema 内部 +- **影响**:AI 盲猜"哪个 API 接受 `f_user_name`",浪费 2-3 次试探 +- **解决**:`apis search --field=` + +### 痛点 3:info 输出体积过大 +- `--json` 输出 ~15KB(包含所有 schema 展开) +- **影响**:浪费 AI context token +- **建议**:加 `--summary`(仅 method/path/summary)和 `--resolved-only`(仅展开 schema) + +### 痛点 4:status 缺少变化检测 +- 只输出 `pathCount`,不显示与上一次拉取的差异 +- **影响**:AI 无法判断"JNPF 升级后是否有新 API" +- **建议**:加 `--diff` flag,对比最近两次拉取 + +--- + +**核心结论**:apis 命令族设计简洁(4 子命令覆盖 90% 场景),但缺少**字段级搜索**和**tag 引导**两个高频 AI 痛点的支持。建议优先级: + +1. **P0**:`apis search --field=`(解决字段盲猜) +2. **P1**:`apis tags`(引导命令) +3. **P2**:`apis info --summary` / `--resolved-only`(减 token) +4. **P3**:`apis status --diff`(变化检测) +5. **P3**:缓存 key 加版本号(容器重启场景) diff --git a/docs/cmd-review/app.md b/docs/cmd-review/app.md new file mode 100644 index 0000000..9a5a850 --- /dev/null +++ b/docs/cmd-review/app.md @@ -0,0 +1,109 @@ +# dacli `app` 命令审计报告 (2026-06-25) + +## 1. 命令清单 + +| 子命令 | 格式 | 用途 | +|--------|------|------| +| `dacli app login` | `[--account] [--password] [--appCode] [--baseUrl]` | 登录 JNPF,持久化 token 到 .dacli-token/token.json (默认 admin/123456@developSystem) | +| `dacli app status` | `[--json]` | 显示当前登录状态 (token 路径 / baseUrl / appCode / dbLinkId) | +| `dacli app switch` | `--appCode [--account] [--password]` | 切换当前应用(重新登录新 appCode 并覆盖 token) | +| `dacli app init` | `[--appCode] [--restart]` | 应用初始化(健康检查;--restart 一键重启 JNPF) | +| `dacli app create` | `--appCode --appName [--dbName] [--account] [--password] [--force-rebuild] [--skip-grant] [--skip-db] [--json]` | 真·创建 JNPF 应用(System+DB+DataSource+授权+重登,端到端 0 差错) | +| `dacli app clear` | `--appCode [--dry-run] [--skip-db] [--no-restart] [--workspace]` | 清除应用本地资源+DB记录(破坏性,强制 TTY + 双重人工确认) | +| `dacli app info` | `--id [--json]` | 查看应用详情(含 systemId/系统配置等) | +| `dacli app list` | `[--keyword] [--json]` | 列出所有应用(JNPF 多 app 生命周期) | +| `dacli app context` | `[--json] [--app]` | 输出当前应用环境快照(dbLinkId/enCode/表/菜单/token 状态)。**AI 新会话第一步必跑** | + +## 2. web 端对应 + +app 命令涉及**认证 + 应用管理**两大域: + +### 2.1 认证 API +- **POST /api/oauth/Login** (web 源: `web/.../api/core/auth.ts:27 loginApi`) + - 参数:account, password (加密), code, origin, timestamp, jnpf_ticket, grant_type + - 返回:token +- **POST /api/oauth/Logout** (web 源: `auth.ts:47 logoutApi`) + +### 2.2 应用管理 API (web 源: `web/.../api/system/system.ts`) +- `GET /api/system/System` — 获取应用列表 +- `GET /api/system/System/{id}` — 获取单个应用 +- `POST /api/system/System` — 新建应用 +- `PUT /api/system/System/{id}` — 修改应用 +- `DELETE /api/system/System/{id}` — 删除应用 +- `POST /api/system/System/{id}/Actions/Copy` — 复制应用 +- `GET /api/system/System/{id}/Actions/Export` — 导出应用 + +### 2.3 当前 dacli 实现方式 +- **直接 import web 端 API 函数** (webapi 镜像架构) — 用于 menu/dict/dataModel 等模块 +- **直接调用 JnpfClient.get/postJson** — 用于 app/login/status/switch/context/list/info (app/* 当前均走裸 HTTP,未用 webapi) + +## 3. 改/删/留 建议 + +### [KEEP] 保留(核心 AI 接口) +- **app context** — ⭐ P0.1 优先级,AI 新会话第一步;v0.10+ 已生产验证 +- **app login** — 登录入口,token 持久化核心 +- **app status** — 状态查询,脚本入口必备 +- **app switch** — 多 app 切换的基线复刻常用命令 + +### [REFACTOR-WEBAPI] 改用 webapi 镜像 +- **app list** — 应改用 webapi 镜像(导入 `web/.../api/system/system.ts` 的 `getSystemList`) +- **app info** — 应改用 webapi 镜像(`getInfo`) +- **app create** — 应改用 webapi 镜像(`create` + `saveAppAuth`) +- **app switch** — 内部复用 `app login`,但逻辑应改为调用 webapi 的 `loginApi` 镜像 + +**应新增 webapi/auth.ts + webapi/system.ts 模块**,与现有 menu/dict 一致。 + +### [DEPRECATE] 已废弃或需改进 +- **app init --restart** — 当前仅 dry-run(注释明确说 "v0.9+ 才实做"),是**虚假功能**。建议: + - 短期:加 `@deprecated` 标签 + 提示用户改用 `dacli app context` 验证健康 + - 长期(v0.12+):实做 kill+nohup+健康检查+重登(读 dacli.conf) + +### [NEW-CMD] 缺新命令 +- **`dacli app logout`** — 当前无登出命令。web 端有 `logoutApi`,dacli 仅做 `clearToken` 即可 +- **`dacli app health`** — 单独的健康检查命令(不依赖 init 的 --restart 模糊语义) +- **`dacli app refresh-token`** — token 即将过期前(剩余 < 1 天)自动刷新 +- **`dacli app context --include-drafts --include-schemas`** — context 当前仅返回表单 ID+enCode 列表 +- **`dacli app use `** — 一体化 switch+context 命令,AI 一次调用拿全 + +## 4. AI 痛点评估 + +### 4.1 切应用 + 拿上下文流程 +**当前流程**(AI 必跑 2 步): +```bash +dacli app switch --appCode=tds # 切应用 +dacli app context --json # 拿快照 +``` + +**痛点**: +- ❌ 需 2 次调用。AI 经常忘记先 switch 直接 context +- ❌ switch 不返回 systemId/dbLinkId,context 还得另查 +- ❌ 无 `--app` 一次性模式 + +**建议**: +- **新增 `dacli app use `** 一体化命令(switch + context 二合一) + +### 4.2 token 失效场景 +**当前**:`dacli app init -- --appCode=X --restart` 用于 token 失效 + +**痛点**: +- ❌ SKILL.md 明确写此命令用于 token 过期(BS-8 兜底),但 `app init` 实际**不重新登录** +- ❌ token 失效后 AI 必须手动跑 `dacli app login --appCode=X` +- ❌ 7 天有效期内无提醒 + +**建议**: +- **context 自动检测 token 即将过期**(剩余 < 1 天)并输出 WARN +- **新增 `dacli app refresh`**:当检测到 401 时自动重新登录 +- **文档修正**:SKILL.md 的 "BS-8" 兜底指引应改为 "跑 `dacli app login --appCode=X`" + +--- + +**核心结论**:app 父命令 9 个子命令覆盖了认证+应用管理全生命周期,但存在 3 个核心问题: + +1. **架构不一致**:当前 9 个子命令全走裸 HTTP,未用 v0.11+ webapi 镜像 +2. **app context 不充分**:缺字段级、schema 级信息,AI 仍需多次调用 +3. **app init --restart 是虚假功能**:dry-run 未实做,误导用户 + +**最关键 3 个建议**: +1. **新增 `webapi/auth.ts` + `webapi/system.ts`**,将 app/list/info/create/switch 改用 webapi 镜像 +2. **context 增强**:加 `--full` 一次性拉所有信息,加 token 过期预警 +3. **新增 `dacli app use `**:一体化 switch+context 命令 diff --git a/docs/cmd-review/bigscreen.md b/docs/cmd-review/bigscreen.md new file mode 100644 index 0000000..9f1a111 --- /dev/null +++ b/docs/cmd-review/bigscreen.md @@ -0,0 +1,101 @@ +# dacli `bigscreen` 命令审计报告 (2026-06-25, 重新审计 v2) + +> **v2 修正**: 用户指出大屏 web 端源码不在主 webapp, 而在独立项目 `jnpf/前端/jnpf-web-datascreen-vue3`. 此版基于正确路径重新审计. + +## 1. 命令清单 + +| 子命令 | 格式 | 用途 | +|--------|------|------| +| `dacli bigscreen list` | `[--keyword] [--category] [--json]` | 列出所有大屏(按 category 过滤) | +| `dacli bigscreen info` | ` [--json]` | 查看大屏详情(含 design JSON) | +| `dacli bigscreen create` | `--fullName --enCode --category --json` | 创建大屏基础记录 | +| `dacli bigscreen release` | ` [--json]` | 发布大屏(state=1) | + +## 2. web 端对应 (正确路径) + +**正确路径**: `/home/ubuntu/ccWorkDir/jnpf/前端/jnpf-web-datascreen-vue3/` + +### 2.1 API 模块 (在 `src/api/`) +- `visual.js` — 大屏 CRUD (list/copy/detail/save/update/remove) +- `category.js` — 分类管理 +- `components.js` — 组件管理 +- `glob.js` — 全局变量 +- `record.js` — 访问记录 + +### 2.2 页面架构 (在 `src/page/`) +- `list/` — 大屏列表+分类+CRUD 对话框 +- `build.vue` — **大屏设计器**(复杂 drag-drop 交互) +- `view.vue` — 预览 + +### 2.3 关键端点 (web 端) +- `/visual/list` GET — 列表 +- `/visual/detail/{id}` GET — 详情 +- `/visual/save` POST — 创建 +- `/visual/update` POST — 修改 (含 status=1 发布) +- `/visual/remove` DELETE — 删除 +- `/visual/copy` POST — 复制 +- `/category/*` — 分类管理 + +### 2.4 严重不一致 +- **dacli 走** `/extend/BigData` (主平台, 错误) +- **web 端走** `/visual/*`, `/category/*`, `/glob/*`, `/record/*` (独立项目, 正确) +- 两套 API 返回数据结构不同 (`data.list` vs `data.data.records`) + +## 3. 改/删/留 建议 + +### [KEEP] 保留 +- **list** — 保留但需加 `--webapi` flag + 改端点 +- **info** — 保留但需重构 (走 `/visual/detail/{id}` 而非复用 list) +- **create** — 保留但需补 width/height/category 参数 +- **release** — 保留但应改用 `/visual/update status=1` + +### [REFACTOR-WEBAPI] **P0 重点** +**新建 `src/webapi/visualdata.ts`** 镜像 web 端 API: +- `getVisualList` (列表, `/visual/list`) +- `getVisualDetail` (详情, `/visual/detail/{id}`) +- `createVisual` (创建, `/visual/save`) +- `updateVisual` (修改+发布, `/visual/update`) +- `removeVisual` (删除, `/visual/remove`) +- `copyVisual` (复制, `/visual/copy`) + +### [DEPRECATE] 无 + +### [NEW-CMD] **P0 必补** +- **`dacli bigscreen update`** — 走 `/visual/update` POST +- **`dacli bigscreen delete`** — 走 `/visual/remove` +- **`dacli bigscreen category`** — 子命令组: list/add/update/delete +- **`dacli bigscreen export/import`** — 跨 app 迁移 +- **`dacli bigscreen copy`** — 复制大屏 + +### [NEW-CMD] P2 +- **`dacli bigscreen preview-token`** — 生成分享 token + +## 4. AI 痛点评估 + +### 分类管理缺失 +- dacli 用硬编码 `category=1` +- web 用 `categoryValue` 字符串键 (从 `category.js` 拉) +- AI 不知道有效分类, 需补 `bigscreen category list` + +### 设计器 drag-drop 无 webapi 化 +- 大屏设计器是复杂可视化交互 (`build.vue`) +- 无法通过 API 完全复制设计器 +- AI 只能建空壳大屏, 设计需 web UI 兜底 + +### 数据源绑定闭环不全 +- 大屏依赖 DI 拉数据 +- dacli 创建的大屏无数据绑定 (web 端 `setup/database.vue` 管绑定) +- 应增加 `--dataInterfaceId` 参数 + `bigscreen binding` 子命令 + +### API 路径不一致 +- 这是 **最严重盲点**: dacli/web 走不同 API 路径, 数据结构不同 +- 修复: 切 webapi/visualdata.ts 走 web 端真实端点 + +--- + +**核心结论 (v2)**: bigscreen 命令存在 **API 路径严重不一致** (dacli 走主平台端点, web 走独立子项目端点). 当前 4 子命令可用但功能残缺, 缺 update/delete/copy + category 子命令组. + +**3 个最关键建议**: +1. **[P0] 新建 `webapi/visualdata.ts`**: 统一走 web 端 `/visual/*` 路径, 消除 API 不一致 +2. **[P0] 实现 `update/delete/copy` 命令**: 走 webapi, 补全 CRUD 闭环 +3. **[P0] 解决数据源绑定闭环**: 增加 `--dataInterfaceId` + `bigscreen binding` 子命令 (否则大屏无数据) diff --git a/docs/cmd-review/datasource.md b/docs/cmd-review/datasource.md new file mode 100644 index 0000000..26b8176 --- /dev/null +++ b/docs/cmd-review/datasource.md @@ -0,0 +1,62 @@ +# dacli `datasource` 命令审计报告 (2026-06-25) + +## 1. 命令清单 + +| 子命令 | 格式 | 用途 | +|--------|------|------| +| `dacli datasource list` | `[--keyword] [--json]` | 列出所有数据源(按名称/enCode 过滤) | +| `dacli datasource create` | `--fullName --enCode --dbType --connectionString --username --password [--json]` | 创建数据源 | +| `dacli datasource test` | `--dbType --connectionString --username --password [--json]` | 测试连接(不创建) | +| `dacli datasource delete` | ` [--json]` | 删除数据源 | + +## 2. web 端对应 + +- 数据源页:`web/.../views/system/dataSource/Index.vue` +- 数据源 API:`web/.../api/system/dataSource.ts` +- **webapi/dataSource.ts 已存在** (v0.11 Phase 1 已镜像, 11 函数) + +## 3. 改/删/留 建议 + +### [KEEP] 保留 +- **list** — AI 找数据源入口 +- **create** — 创数据源 +- **test** — 测连接 +- **delete** — 删数据源 + +### [REFACTOR-WEBAPI] **P0 重点** +**4 个子命令全部切到 `loadDataSource.*` 调用**: +- 当前 100% 绕过 v0.11+ webapi 镜像,全部用 c.postJson/c.get/c.del 手写 +- webapi/dataSource.ts 已镜像 11 个函数(包含 testDbConnection、getDataSourceInfo 等),**使用率为 0%** +- 消除 ~150 行手写 API 代码,同步 web 端加密/字段逻辑 + +### [DEPRECATE] 无 + +### [NEW-CMD] P1 +- **`dacli datasource info `** — 查单个数据源详情(webapi 已有 `getDataSourceInfo`) +- **`dacli datasource selector`** — 选择器(按 dbType 过滤 + 简单格式输出),AI 验证/选择数据源必需 +- **`dacli datasource update `** — 改连接串/密码(高频运维场景) + +## 4. AI 痛点评估 + +### dbLinkId 流程 +理想 AI 流程: +```bash +dacli app context --json # 拿 appCode/dbLinkId +dacli datasource list --json # 看已有数据源 +dacli datasource test --dbType=mysql --connectionString=... # 测连接 +dacli form create --dbLinkId= ... # 建表单 +``` + +**当前痛点**: +- ❌ test 命令测试后**不会回填到数据源**,AI 经常需要重复填 +- ❌ create 后**没有 selector 帮助 AI 找到新数据源 enCode** +- ❌ update 命令缺失,AI 创建后**无法修改** + +--- + +**核心结论**:dacli `datasource` 4 个子命令结构合理,但 **100% 绕过 v0.11+ webapi 镜像**。webapi/dataSource.ts 镜像已存在但使用率为 0%,导致 API 不一致风险和 ~150 行重复代码。 + +**3 个最关键建议**: +1. **P0 [REFACTOR-WEBAPI]**: 4 个子命令全部切到 `loadDataSource.*` 调用 +2. **P1 [NEW-CMD]**: 新增 `datasource info ` 和 `datasource selector` +3. **P1 [NEW-CMD]**: 新增 `datasource update ` 改连接串/密码 diff --git a/docs/cmd-review/di.md b/docs/cmd-review/di.md new file mode 100644 index 0000000..257aeea --- /dev/null +++ b/docs/cmd-review/di.md @@ -0,0 +1,59 @@ +# dacli `di` 命令审计报告 (2026-06-25) + +## 1. 命令清单 + +| 子命令 | 格式 | 用途 | +|--------|------|------| +| `dacli di list` | `[--keyword] [--categoryId] [--type] [--json]` | 列出数据接口 | + +**当前仅 1 个子命令** — AI 严重缺口! + +## 2. web 端对应 + +- 数据接口页:`web/.../views/onlineDev/dataInterface/` 或 `system/di/` +- 数据接口 API:常在 `web/.../api/onlineDev/visualDev.ts` 中(dataInterface 段) +- JNPF 后端端点:`POST /api/visualdev/DataInterface` `GET /api/visualdev/DataInterface/{id}` 等 + +## 3. 改/删/留 建议 + +### [KEEP] 保留 +- **list** — 基础入口 + +### [REFACTOR-WEBAPI] P1 +**新增 `webapi/dataInterface.ts`**(或在 `webapi/visualDev.ts` 中扩展): +- 复用 web 端 dataInterface 相关函数 +- 统一 v0.11+ 趋势 + +### [DEPRECATE] 无 + +### [NEW-CMD] **P0 重点** +- **`dacli di info `** — 查接口详情(请求/响应 schema) +- **`dacli di test --data=`** — 测试调用接口(带样例参数) +- **`dacli di create`** — 创接口 +- **`dacli di update `** — 改接口 +- **`dacli di delete `** — 删接口 +- **`dacli di selector`** — 选择器(按 category 过滤 + 简单格式) + +## 4. AI 痛点评估 + +### 闭环度评估 +- ❌ AI 调用 `dacli di list` 拿到 enCode 后,**下一步卡住** + - 无法 `dacli di info` 拿 schema + - 无法 `dacli di test` 调接口验证 + - 无法创建新接口 +- ❌ 数据接口是 SSW 业务(form 后端调用),与 form/dm 关系密切,AI 经常需要组合调用 +- ❌ 当前 1 个子命令完全不闭环 + +### 与 form/dm 关系 +- DI 经常被 form 业务规则引用(`dacli form create` 可配 DI 作为数据源) +- AI 做 form 时常需要先创建 DI +- 当前 **di 命令缺失导致 form create 时引用 DI 困难** + +--- + +**核心结论**:dacli `di` 命令**严重残缺**(仅 1 个 list 子命令),AI 完全无法做数据接口 CRUD 闭环。 + +**3 个最关键建议**: +1. **P0 [NEW-CMD]**: 新增 `di info/test/create/update/delete` 5 个子命令,AI 闭环必需 +2. **P0 [NEW-CMD]**: 新增 `di selector` 选择器 +3. **P1 [REFACTOR-WEBAPI]**: 新增 `webapi/dataInterface.ts` 或扩展 `visualDev.ts` diff --git a/docs/cmd-review/dict.md b/docs/cmd-review/dict.md new file mode 100644 index 0000000..b4d551c --- /dev/null +++ b/docs/cmd-review/dict.md @@ -0,0 +1,110 @@ +# dacli `dict` 命令审计报告 (2026-06-25) + +## 1. 命令清单 + +| 子命令 | 格式 | 用途 | +|--------|------|------| +| `dacli dict typeList` | `[--keyword] [--json]` | 字典类型列表 (按编码/名搜索) | +| `dacli dict typeCreate` | `--enCode --fullName [--items] [--category] [--isTree] [--json]` | 创建字典类型 (含可选字典项) | +| `dacli dict dataList` | `[--typeId\|--all] [--json]` | 字典数据列表 (按类型或全部) | +| `dacli dict dataCreate` | `--typeId [--enCode\|--items] [--fullName] [--json]` | 往已存在字典类型追加字典项 | + +## 2. web 端对应 + +- **字典类型页**: `web/apps/jnpf-web-apps-main/src/views/sysData/dictionary/` + - `index.vue` — 字典类型列表 (树形) + - `Form.vue` — 字典类型编辑表单 + - `components/Form.vue` — 字典项编辑表单 +- **字典 API**: `web/apps/jnpf-web-apps-main/src/api/systemData/dictionary.ts` (15 函数) + - 字典类型 (6): getDictionaryType/getDictionaryTypeSelector/createDictionaryType/updateDictionaryType/getDictionaryTypeInfo/delDictionaryType + - 字典数据 (9): getDictionaryDataList/getDictionaryAll/getDictionaryDataTypeSelector/getDictionaryDataSelector/createDictionaryData/updateDictionaryData/getDictionaryDataInfo/delDictionaryData/exportData +- **webapi/dict.ts 已存在** (v0.11 Phase 1 已镜像, 15 函数) +- **BS-47 关键约束**: 字典的 enCode 和 fullName 全平台唯一 (跨 app), web 端 POST 重复时返回 "The name cannot be repeated" + +## 3. 改/删/留 建议 + +### [KEEP] 保留 +- **typeList** — AI 防 BS-47 必需, 枚举已有字典来避免重复 +- **typeCreate** — 杀手锏, 端到端 1 条命令建类型 + 字典项 (web 需 2 个页面) +- **dataList** — 字典项查询基础能力 +- **dataCreate** — 补充 typeCreate, 追加字典项 + +### [REFACTOR-WEBAPI] **P0 重点** +**4 个子命令全部切到 `loadDict.*` 调用**: +- typeList: 当前用 `c.get('/system/DictionaryType')` → 应改 `loadDict.getDictionaryType({ keyword })` +- dataList: 当前用 `c.get('/system/DictionaryData/{typeId}/Data')` → 应改 `loadDict.getDictionaryDataList({ typeId })` 或 `loadDict.getDictionaryAll()` +- typeCreate: 当前用 `c.postJson('/system/DictionaryType', ...)` + `c.postJson('/system/DictionaryData', ...)` → 应改 `loadDict.createDictionaryType()` + `loadDict.createDictionaryData()` +- dataCreate: 当前用 `c.postJson('/system/DictionaryData', ...)` → 应改 `loadDict.createDictionaryData()` + +**理由**: +- v0.11+ 强制 webapi 镜像架构, 避免与 web 端 API 签名不同步 +- webapi/dict.ts 已镜像 15 函数, **使用率为 0%** +- 消除 ~80 行硬编码 API 调用, 同步 web 端字段变更 (如 enabledMark 默认值) + +### [DEPRECATE] 无 +- 4 个现有命令都是基础 CRUD 子集, 无功能重复或设计错误 +- 唯一改进: 内部实现切到 webapi 镜像, 命令名/参数/输出格式不变 + +### [NEW-CMD] **P1 高优先级** — 补全 CRUD 闭环 +- **`dacli dict typeUpdate `** — webapi 已有 `updateDictionaryType(data)`, AI 建错字典需修改场景 +- **`dacli dict dataUpdate `** — webapi 已有 `updateDictionaryData(data)`, 字典项改名/改排序/禁用 +- **`dacli dict typeDelete `** — webapi 已有 `delDictionaryType(id)`, 删类型 + 递归删字典项 + +### [NEW-CMD] **P2 中优先级** +- **`dacli dict dataDelete `** — webapi 已有 `delDictionaryData(id)`, 与 typeDelete 配对闭环 + +### [NEW-CMD] **P3 调试辅助** +- **`dacli dict typeInfo `** — webapi 已有 `getDictionaryTypeInfo(id)`, 单条详情 (区别于 list) +- **`dacli dict dataInfo `** — webapi 已有 `getDictionaryDataInfo(id)`, AI 调试 BS-47 时拿冲突字典完整信息 + +### [NEW-CMD] **P2 集成命令** +- **`dacli dict typeSelector`** — 输出树形选择器格式, 方便 form schema 直接引用 (form select 字段需 dict enCode) + +## 4. AI 痛点评估 + +### BS-47 (dict 全平台唯一) — 防护是否充分? +**当前防护** (L2 guard BS-47): +- ✅ 命令执行前检查 `ctx.existingEnCodes.includes(name/enc)` +- ✅ 失败时提示: "dacli dict dataList 看已有字典, 复用或加 `_` 前缀" +- ✅ L1 pre-check 也支持 + +**待优化**: +- ⚠️ 提示用 "dacli dict dataList" 应改为 "dacli dict typeList" (命令名是 typeList, 不是 dataList) +- ⚠️ "加 `_` 前缀" 建议改为 "_" (从 app context 自动取) + +**结论**: 防护已较完善, 提示文字有小 bug, Phase 2 修正 + +### form 字段引字典时的引导 — **缺失** +**痛点**: +- form create 时 select 字段需要 `dict.enCode` 作 datasource +- AI 不知道现在有哪些 dict 可选 +- 需先 `dacli dict typeList` 查 enCode, 再填到 form schema + +**建议**: +- 新增 `dacli dict typeSelector` 输出树形选择器格式 +- 或在 `dacli form create --help` 中加入"如何找 dict enCode"章节 + +### dict 关联 form select 字段闭环 — **不完整** +**场景** (BS-54 关联): +1. AI 想建带 select 字段的 form +2. 需先建 dict (typeCreate) +3. 拿到 dictId 或 enCode +4. 填到 form schema 的 select 字段配置 + +**当前闭环问题**: +- 步骤 1-2: ✅ 有 typeCreate +- 步骤 3: ⚠️ 只能从 typeList 拿 enCode, 但要带 typeId (select 字段实际引用 typeId) +- 步骤 4: ✅ form create 支持 select + dict 配置, 但 schema 拼装靠 AI 手工 + +**建议**: +- form create 的 precheck 中加入: "select 字段需 dict enCode, 建议先 `dacli dict typeList`" +- 或提供 `dacli form create --dictCode=xxx` 简写 (自动展开为 select 字段) + +--- + +**核心结论**: dacli `dict` 4 个子命令结构合理, 但 **100% 绕过 v0.11+ webapi 镜像**。webapi/dict.ts 已镜像 15 函数但使用率为 0%, 导致 API 不一致风险和 ~80 行重复代码。同时缺少 Update/Delete CRUD 闭环。 + +**3 个最关键建议**: +1. **P0 [REFACTOR-WEBAPI]**: 4 个子命令全部切到 `loadDict.*` 调用 +2. **P1 [NEW-CMD]**: 新增 `typeUpdate` + `dataUpdate` + `typeDelete` 补全 CRUD 闭环 +3. **P1 [OPTIMIZE]**: 修正 L2 guard BS-47 提示文字 (dataList → typeList, `_` → `_`) diff --git a/docs/cmd-review/dm.md b/docs/cmd-review/dm.md new file mode 100644 index 0000000..1874839 --- /dev/null +++ b/docs/cmd-review/dm.md @@ -0,0 +1,59 @@ +# dacli `dm` 命令审计报告 (2026-06-25) + +## 1. 命令清单 + +| 子命令 | 格式 | 用途 | +|--------|------|------| +| `dacli dm list` | `[--keyword] [--dbLinkId] [--json]` | 列出当前应用所有数据模型 (物理表) | +| `dacli dm create` | `--table --tableName --dbLinkId --fields [--autoRelease] [--json]` | 创建物理表 (自动补 9 系统列) | +| `dacli dm drop` | ` [--dbLinkId] [--json]` | 删除物理表 (数据全失, 谨慎) | +| `dacli dm fields` | `--table --dbLinkId [--json]` | 查表字段详情 | + +## 2. web 端对应 + +- 数据模型页: `web/apps/jnpf-web-apps-main/src/views/system/dataModel/` 或 `onlineDev/` +- 数据模型 API: `web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts` (dataModel 段) +- **webapi/dataModel.ts 已存在** (v0.11 Phase 1 已镜像, 10 函数) +- **dacli dm/list 已切 webapi** + +## 3. 改/删/留 建议 + +### [KEEP] 保留 +- **dm list** — 已切 webapi,AI 找表入口 +- **dm fields** — 查表字段详情 + +### [REFACTOR-WEBAPI] **P0 重点** +- **`dm create.ts:132-135`** 仍用 `c.postJson()` — 应改用 `loadDataModel.createDataModel()` +- **`dm drop.ts:35`** 仍用 `c.del()` — 应改用 `loadDataModel.delDataModel()` +- 违反 v0.11+ 镜像架构原则,导致 L3 diagnose 失效 + +### [DEPRECATE] 无 + +### [NEW-CMD] P1 +- **`dm addFields
--fields`** — 加字段(保留数据),webapi 已有 `addTableFields` +- **`dm update
`** — 改表结构(字段重命名/类型变更),webapi 已有 `updateDataModel` +- **`dm info
`** — 查表详情(字段/索引/外键),webapi 已有 `getDataModelInfo` +- **`dm rename
--newTable`** — 重命名表 +- **`dm selector`** — 选择器 + +## 4. AI 痛点评估 + +### 9 系统列自动补 (BS-15) +- ✅ v10.6.1 已实现, `dm create` 自动加 `f_id`/`f_tenant_id`/`f_flow_task_id`/`f_flow_id`/`f_flow_state`/`f_sort_code`/`f_create_user`/`f_create_time`/`f_modify_user`/`f_modify_time`/`f_description` + +### 字段级 CRUD 缺失 +- ❌ AI 加字段只能 `drop + create`(数据全失),风险极高 +- web 端 `addTableFields()` / `updateDataModel()` 已镜像但未在 dacli 暴露 + +### 与 form create 联动 +- form create --autoTable 时, dm list 能验证表存在 +- 但 dm 缺 info, AI 经常需要 fields 命令拉详情 + +--- + +**核心结论**: dacli `dm` 4 个子命令结构合理, 但 create/drop 未切 webapi. 9 系统列自动补已实现, 但字段级 CRUD (add/update) 缺失, AI 改表风险高. + +**3 个最关键建议**: +1. **P0 [REFACTOR-WEBAPI]**: dm create + drop 切到 `loadDataModel.*` 调用 +2. **P1 [NEW-CMD]**: 新增 `dm addFields` / `dm update` / `dm info` 三个命令(webapi 已镜像) +3. **P1 [OPTIMIZE]**: 评估 dm rename 需求 diff --git a/docs/cmd-review/doc.md b/docs/cmd-review/doc.md new file mode 100644 index 0000000..d169eee --- /dev/null +++ b/docs/cmd-review/doc.md @@ -0,0 +1,68 @@ +# dacli `doc` 命令审计报告 (2026-06-25) + +## 1. 命令清单 + +| 子命令 | 格式 | 用途 | +|--------|------|------| +| `dacli doc list` | `[--dir] [--json]` | 列 HTML 文档 (从 docs/{app_code}/ 扫描) | +| `dacli doc get` | `--file [--section\|--from --lines] [--strip-mermaid] [--json]` | 读 HTML section/行号纯文本 (P0 上下文恢复核心) | + +## 2. web 端对应 + +- **无 web API 对应**:`doc` 是本地 HTML 文件解析工具,不直接调用 JNPF web API +- **HTML 文档源**:`docs/{app_code}/plan.html` (设计计划) + `design.html` (UI 设计) + `testcase.html` (测试用例) + `summary.html` (交付摘要) +- **缓存层**:`~/.dacli/cache.db` (SQLite) + mtime 缓存策略 (7 天 TTL) + +## 3. 改/删/留 建议 + +### [KEEP] 保留 +- **dacli doc list** — AI 上下文恢复第一步 +- **dacli doc get** — P0 上下文恢复核心 + +### [REFACTOR-WEBAPI] 不适用 +本地 HTML 解析工具,不调用 web API + +### [DEPRECATE] 无 + +### [NEW-CMD] **P0 高优先级** + +#### `dacli doc toc ` (P0) +- 当前 `doc get --section=` 需要 AI 先知道 section id +- plan.html / design.html 通常 > 300 行,AI trial-and-error 找 section 浪费 token +- 示例痛点:`docs/tds/design.html` 有 10+ sections, AI 需先 `toc` 看清单才能精准切片 + +#### `dacli doc search --keyword=` (P0) +- AI 知道想找"BS-48 相关段落"但不知道 section id +- 当前必须先 `get` 全文再用 grep,2 步变 1 步 +- 节省 40-60% token + +### [NEW-CMD] P1 + +#### `dacli doc slice --heading=` (P1) +- 按 `

` 标题文本模糊匹配切片 +- 当前降级逻辑生成 `h2_0`, `h2_1` 无意义 id + +## 4. AI 痛点评估 + +### plan.html 切片痛点 +- 量化: `docs/tds/plan.html` 168 行 (11K), `docs/tds/design.html` 537 行 (22K) +- 当前 `doc get` 覆盖:`--section` 精准切片 + `--from --lines` 行号切片 +- ⚠️ 缺按关键词搜索 + +### mtime 缓存失效 (已知盲点 errors.md #23) +- IDE 自动保存 / git checkout 导致 mtime 频繁变化 +- 建议新增 `--no-cache` flag 跳过缓存 (紧急场景) + +### ssw-h5dev-flow 集成 +- ✅ 已顺畅使用 (skill 文档明确指引) +- ⚠️ skill 文档未提及 `doc toc` / `doc search` (如新增需补充) +- ⚠️ skill 文档未提及 mtime 缓存陷阱 + +--- + +**核心结论**: `dacli doc` 是纯本地 HTML 文档工具,架构清晰、功能合理 (list + get 双子命令),但 AI 上下文恢复场景下缺 2 个关键命令 (toc + search)。 + +**3 个最关键建议**: +1. **[NEW-CMD P0] `dacli doc toc `**:列文件 section 清单 (id + title + 行数) +2. **[NEW-CMD P0] `dacli doc search --keyword=`**:按关键词全文搜索 +3. **[OPTIMIZE] 补 `dacli doc get --no-cache`**:mtime 缓存失效时跳过缓存 diff --git a/docs/cmd-review/form.md b/docs/cmd-review/form.md new file mode 100644 index 0000000..1632a7c --- /dev/null +++ b/docs/cmd-review/form.md @@ -0,0 +1,113 @@ +# dacli `form` 命令审计报告 (v0.11+, 2026-06-25) + +**审计对象**: `/home/ubuntu/ccWorkDir/dacli/src/commands/form/` (24 个文件: 14 命令 + 10 私有) +**重点**: webapi 架构对齐 + AI 友好性 + 盲点覆盖 + +## 1. 命令清单 (14 个公开子命令) + +| # | 命令 | 用途 | 状态 | +|---|------|------|------| +| 1 | `dacli form list` | 列出当前应用所有表单 (state=0/1/2) | ✅ KEEP + webapi | +| 2 | `dacli form info ` | 拉表单完整 schema (formData/columnData/tables) | ✅ KEEP + webapi | +| 3 | `dacli form create` | 创建表单 (--ai/--ai-json/--autoTable/--autoRelease) | ✅ KEEP | +| 4 | `dacli form release ` | 发布/重新发布表单 (state 0\|2 → 1) | ✅ KEEP + webapi | +| 5 | `dacli form delete ` | 删除表单 (--cascade 级联删菜单) | ✅ KEEP | +| 6 | `dacli form export ` | 导出表单 JSON (跨库迁移) | ✅ KEEP | +| 7 | `dacli form import ` | 从 JSON 导入表单 (--autoTable 重建物理表) | ✅ KEEP | +| 8 | `dacli form clone ` | 克隆表单 (AI 黄金法则: 99% 应 clone 再改) | ✅ KEEP + webapi | +| 9 | `dacli form validate ` | 运行时校验 (BS-23/31/32/15/V2/52) | ✅ KEEP | +| 10 | `dacli form fixcolumndata ` | 修复 columnData 缺 use*Permission (BS-23 NPE) | ✅ KEEP | +| 11 | `dacli form codegen` | 生成代码 (PascalCase + auto-alias) | ✅ KEEP | +| 12 | `dacli form lint` | 设计期 lint (BS-31/32) | ✅ KEEP | +| 13 | `dacli form bindFlow` | 表单绑工作流 (BS-44) | ✅ KEEP | +| 14 | `dacli form selector` | 功能下拉框 (AI 工作流核心) | ✅ KEEP + webapi | + +## 2. web 端对应 + +- 表单设计器: `web/apps/jnpf-web-apps-main/src/views/onlineDev/visualDev/` +- 表单 API: `web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts` (30+ 函数) +- **webapi/visualDev.ts 已存在** (v0.11+ Phase 1 已镜像, 30 函数) +- **dacli/_buildformdata.ts 已直接 import web 端 buildFormData** (v0.11+ 关键修复, BS-51/52/54) + +## 3. 改/删/留 建议 + +### 3.1 [KEEP] - 全部 14 命令保留 +- 所有命令都有真实使用场景 (AI 工作流 / 跨库迁移 / 调试验证) +- 7 个核心命令 (list/info/create/release/clone/selector) 已切换 webapi + +### 3.2 [REFACTOR-WEBAPI] - 优先级排序 + +**P0: import.ts (8 调用)** +- 7 处 `/visualdev/Base` (create/list/release) 应全部走 webapi +- 第 209 行 (数据建模 `Table`) 保留 `c.postJson` (属于 system 命名空间) + +**P1: codegen.ts (4 调用)** +- saveAlias / getInfo / getAliasInfo / codePreview 全应走 webapi + +**P1: create.ts (4 调用)** +- create / getVisualDevList / release / Module(createMenu) 应走 webapi + +**P1: fixcolumndata.ts (3 调用)** +- getInfo / update / release 应走 webapi + +**P2: export/clone/validate/bindflow (各 1-2 调用)** +- 局部迁移 (form/clone release 走 webapi, form/bindflow release 走 webapi) + +### 3.3 [DEPRECATE] - 保留但标 @deprecated +- **`_simplify.ts`**: 保留 (用户已习惯简化格式), 文件头已标 LEGACY + +### 3.4 [NEW-CMD] 缺新命令 + +**`dacli form update ` (高需求)** +- 改 schema 需 export → 手动改 → import, 无原子性 +- 后端: PUT /api/visualdev/Base/{id} (已存在, 对应 `loadVisualDev.update`) +- 自动 BS-49/50/52 防御 + +**`dacli form addFields --fields` (中需求)** +- 增量加字段, 同时支持 `--tables` (自动 ALTER TABLE) + +**`dacli form rmFields --vmodel`** (中需求) +- 删字段, `--drop-column` 同步删除物理表列 + +**`dacli form stats`** (低需求) +- 表单总数 + 按 type/category/flow 维度分桶统计 + +**`dacli form diff `** (辅助) +- 对比 formData + columnData + tables 字段级差异 + +## 4. AI 痛点评估 + +### 4.1 ✅ 已解决 +- 表单创建流程: `--ai` / `--ai-json` / `--autoTable` / `--autoRelease` / `--autoCreateMenu` 一应俱全 +- 盲点自动防御: L1 precheck (5 类) + L2 guard (22 条高频) + L3 diagnose (3 类错误诊断) +- AI 帮助完整性: 所有命令都带 `--ai-help` / `--example` / `--source` +- 3 层防御: precheck → guard → diagnose + +### 4.2 ⚠️ 部分覆盖 +- 字段级 BS-54 (select/relationForm): `_buildformdata.ts` 通过 web 端 buildFormData 100% 注入, 已修复 +- `--autoTable` / `--autoRelease`: 已实现, 默认 type=4 视图不走物理表 + +### 4.3 ❌ 仍有缺口 +- 缺 form update: 增量改 schema 需 export → import +- 缺 addFields / rmFields: 字段级 CRUD 缺失 +- 缺 stats: 应用规模洞察不足 +- 缺 diff: clone 后变更追踪缺失 +- 菜单挂载 hard-coded: `create.ts` 第 665 行直接拼 body, 应走 `loadVisualDev.createMenu` + +### 4.4 selector 现状 +| 接口 | selector | 状态 | +|------|----------|------| +| form (菜单挂载/工作流起始/select 字段) | `dacli form selector` | ✅ 已实现 | +| workflow | `dacli workflow selector` | 待审 Batch E | +| form-data (运行时数据) | 无 | 缺 | + +--- + +**核心结论**: dacli form 命令已建立完整 CRUD 体系 (14 子命令), v0.11+ Phase 1 已将 7 核心命令迁 webapi. `_buildformdata.ts` 通过直接 import web 端 buildFormData 修复 BS-51/52/54/55. + +**最关键 5 个建议**: +1. **[REFACTOR-WEBAPI]** 优先级: import.ts (8) > codegen.ts (4) > create.ts (4) > fixcolumndata.ts (3) > 其他 (1-2) +2. **[NEW-CMD]** form update (高需求, 增量改 schema), 写 spec 放入 W2+ +3. **[NEW-CMD]** form addFields / rmFields (中需求), 写 spec 放入 W3+ +4. **[KEEP]** `_simplify.ts` 保留, `_blindspots.ts` / `_buildformdata.ts` 是核心 +5. **[AI 痛点]** 字段级 BS-54 已修复, 菜单挂载走 `loadVisualDev.createMenu` diff --git a/docs/cmd-review/integration.md b/docs/cmd-review/integration.md new file mode 100644 index 0000000..d5ea4a5 --- /dev/null +++ b/docs/cmd-review/integration.md @@ -0,0 +1,152 @@ +# Integration 父命令审计报告 (v0.11+) + +## 1. 命令清单 + +``` +dacli integration emailTest --configId= [--email=] — 邮件测试发送 (走 SendMessageConfig/testSendConfig) +dacli integration smsTest --templateId= [--phone=] — 短信测试发送 (走 SmsTemplate/testSent, 决策 8) +dacli integration webhookTest --url= [--payload=] — Webhook 测试发送 (走 SendMessageConfig/testSendConfig, channel=webhook) +``` + +**当前实现**: +- `index.ts` (P2 收尾) 仅作为父命令注册容器 +- 3 个 test 子命令均通过硬编码端点调用 JNPF API +- 未走 webapi 镜像架构 (dataModel/dataSource/dict/menu/visualDev/workflow 已有) + +--- + +## 2. Web 端对应 + +### 集成中心目录结构 +- `/web/apps/jnpf-web-apps-main/src/views/integrationCenter/` + - `email/` (Form.vue + Test.vue + index.vue) — 邮件账号配置 + - `sms/` (Form.vue + index.vue) — 短信配置 + - `webhook/` (Form.vue + index.vue) — Webhook 配置 + - `dingTalk/` `weChatMp/` `weCom/` `aiModelConfig/` (其他集成,dacli 未覆盖) + +### 消息 API 端点 +- `/api/message/Notice/*` — 系统公告 CRUD (`web/.../api/system/message.ts:4`) +- `/api/message/{id}` — 消息读取/删除/标记已读 +- `/api/message/AccountConfig` — **账号配置核心** (`web/.../api/msgCenter/accountConfig.ts:4`) + - `GET /` 分页列表 + - `POST /` 创建 + - `PUT /:id` 更新 + - `GET /:id` 详情 + - `DELETE /:id` 删除 + - `POST /:id/Actions/Copy` 复制 + - `POST /:testType` **测试** (testType = testSendMail / testSendSms / testSendWebhook) +- `/api/message/SendMessageConfig` — 发送配置 (`web/.../api/msgCenter/sendConfig.ts:4`) + - 8 个端点,含 `testSendConfig` 和 `getSendConfigList` (下拉) + +### Web 测试逻辑 (`integrationCenter/email/Test.vue`) +- 接收 `dataForm` (含 smtp 服务器、端口、用户、密码等) +- UI 采集: testSendEmail (收件人), testEmailTitle, testEmailContent +- **真实端点**: `POST /api/message/AccountConfig/testSendMail` +- **当前 dacli 错误地用了 `/message/SendMessageConfig/testSendConfig`** + +--- + +## 3. 改/删/留 建议 + +### [DEPRECATE] `integration emailTest` +- **理由**:API 端点错误。当前 dacli 调用 `/message/SendMessageConfig/testSendConfig` 但 web 端用 `/message/AccountConfig/testSendMail`。 +- **影响**:调用成功但实际功能不匹配 (SendMessageConfig 是发送配置,不是账号配置)。 +- **建议**:标记 @deprecated,下版本删除或重写。 + +### [DEPRECATE] `integration smsTest` +- **理由**:API 端点模糊。web 端 sms 测试应在 `/message/AccountConfig/testSendSms`,dacli 当前用 `/system/SmsTemplate/testSent`。 +- **影响**:与 web 端逻辑不一致,AI 难以判断真实流程。 +- **建议**:标记 @deprecated,统一改用 AccountConfig 测试端点。 + +### [KEEP-REFACTOR] `integration webhookTest` +- **理由**:通道对应清晰 (channel=webhook),但应改用 AccountConfig 路径。 +- **建议**:保留但重写,下版本走 `/message/AccountConfig/testSendWebhook`。 + +### [REFACTOR-WEBAPI] 新增 `src/webapi/integration.ts` +- **理由**:v0.11+ webapi 镜像架构要求。dacli 应直接 import `web/.../api/msgCenter/accountConfig.ts` 复用 web 端真实 API。 +- **目标**: + - 镜像 `accountConfig.ts` 的 8 个函数 (list/create/update/info/del/copy/testConfig) + - 镜像 `sendConfig.ts` 的 8 个函数 +- **收益**:零参数错误、零端点错误、与 web 100% 一致。 + +### [NEW-CMD] `integration configList` +- **理由**:当前 test 命令硬编码 `configId`,AI 无法选择可用配置。 +- **建议**:`dacli integration configList [--type=email|sms|webhook]` 列已有配置。 +- **价值**:AI 在测试前可先 `list` 获取真实 ID。 + +### [NEW-CMD] `integration configCreate` +- **理由**:web 端有完整的 CRUD,但 dacli 只暴露测试,AI 无法创建新配置。 +- **建议**:`dacli integration configCreate --type=email --fullName=... --enCode=... --smtpServer=...`。 +- **关键参数** (email 举例):fullName, enCode, smtpServer, smtpPort, smtpUser, smtpPassword, addressorName, enabledMark。 +- **价值**:补齐 CRUD 闭环。 + +### [NEW-CMD] `integration configGet` +- **理由**:当前 `configId` 来源不明确。 +- **建议**:`dacli integration configGet --id=` 获取详情 JSON,便于 AI 验证参数。 + +### [NEW-CMD] `integration configUpdate` +- **理由**:CRUD 闭环必需。 +- **建议**:`dacli integration configUpdate --id= --field=value` 支持部分更新。 + +### [NEW-CMD] `integration configDelete` +- **理由**:CRUD 闭环必需。 +- **建议**:`dacli integration configDelete --id=`。 + +### [NEW-CMD] `integration log` +- **理由**:web 端有 `msgMonitor.ts` (发送日志),AI 调试时需查询发送历史。 +- **建议**:`dacli integration log [--configId=] [--startTime=...] [--endTime=...]`。 +- **API 对应**:`/api/message/MessageMonitor/*` (JNPF 后端已有)。 + +### [NEW-CMD] `integration selector` +- **理由**:表单设计器中需选择消息配置 (如触发邮件)。 +- **建议**:`dacli integration selector --type=email` 返回下拉列表 (复用 SendMessageConfig/getSendConfigList)。 + +--- + +## 4. AI 痛点评估 + +### 痛点 A:API 端点错误 +- **现状**:3 个 test 命令调用了错误的端点 (`SendMessageConfig` vs `AccountConfig`)。 +- **根因**:手动拼接 URL 而非走 webapi 镜像。 +- **影响**:AI 调用成功但实际数据未生效,调试时困惑。 +- **修复**:v0.11+ 强制 webapi 镜像。 + +### 痛点 B:CRUD 残缺 +- **现状**:仅 3 个 test 命令,无 list/create/get/update/delete。 +- **根因**:v0.8 草草上线 "P2 收尾",未与 web 端 CRUD 对齐。 +- **影响**:AI 无法独立管理消息配置,只能依赖 web UI。 +- **修复**:新增 5 个 config* 命令。 + +### 痛点 C:业务闭环断裂 +- **现状**:表单提交 → 触发邮件?流程未连通。 +- **根因**:form 模块无 message 配置关联,integration 模块无 form 联动。 +- **影响**:AI 无法搭建 "表单提交 → 发送邮件" 的完整业务闭环。 +- **建议**: + - `dacli form bindMessage --formId=X --trigger=submit --configId=Y` + - 或在 `dacli integration log` 中按 form 字段过滤。 + +### 痛点 D:日志查询困难 +- **现状**:无 log 命令,AI 无法验证邮件是否发送成功。 +- **根因**:未集成 msgMonitor API。 +- **修复**:新增 `integration log`。 + +### 痛点 E:决策 8 标注混乱 +- **现状**:仅 `smstest.ts` 有 `decision 8` 标注,email/webhook 无。 +- **影响**:AI 难以理解为何短信用 `SmsTemplate`,邮件用 `SendMessageConfig`。 +- **修复**:统一走 AccountConfig 路径,删除决策 8 备注。 + +--- + +## 总结 + +| 类型 | 数量 | 优先级 | +|------|------|--------| +| DEPRECATE | 2 (emailTest, smsTest) | P0 (端点错误) | +| REFACTOR-WEBAPI | 1 (webapi/integration.ts) | P0 (架构升级) | +| NEW-CMD | 5 (configList, configCreate, configGet, configUpdate, configDelete, log, selector) | P1 (功能补齐) | +| KEEP | 1 (webhookTest, 需重写) | P1 (API 统一) | + +**核心建议**: +1. **立即**:emailTest/smsTest 标记 @deprecated (端点错误误导 AI) +2. **v0.11+**:新增 `src/webapi/integration.ts` 镜像 accountConfig + sendConfig +3. **v0.12+**:补齐 config CRUD + log + selector 命令,形成完整业务闭环 diff --git a/docs/cmd-review/log.md b/docs/cmd-review/log.md new file mode 100644 index 0000000..f4eb1ae --- /dev/null +++ b/docs/cmd-review/log.md @@ -0,0 +1,78 @@ +# dacli `log` 命令审计报告 (2026-06-25) + +## 1. 命令清单 + +| 子命令 | 格式 | 用途 | +|--------|------|------| +| `dacli log login` | `[--keyword] [--json]` | 登录日志 (近 30 天, category='1') | +| `dacli log operate` | `[--keyword] [--json]` | 操作日志 (category='3') | + +**注**: 当前仅 2 个子命令,**缺 3 个核心日志类型**: 异常日志 (category='4')、请求日志 (category='5')、访问日志 + +## 2. web 端对应 + +**4 个完整日志页面** (在 `web/apps/jnpf-web-apps-main/src/views/sysLog/`): +- 登录日志 `loginLog/` (category='1') +- 操作日志 `operateLog/` (category='3') +- 异常日志 `errorLog/` (category='4') +- 请求日志 `requestLog/` (category='5') + Detail.vue + +**API 端点** (`web/.../api/system/log.ts` 6 函数): +- `getLogList()` GET `/api/system/Log` (分页查询) +- `delLog()` DELETE `/api/system/Log` (批量删除) +- `batchDelLog()` DELETE `/api/system/Log/{type}` (一键清空) +- `getInfo()` GET `/api/system/Log/{id}` (单条详情) +- `batchDelLoginLog()` DELETE `/api/system/Log/deleteLoginLog` + +**关键缺失**: webapi/log.ts 不存在 (其他 6 个模块已镜像) + +## 3. 改/删/留 建议 + +### [KEEP] login + operate (基础能力) + +### [REFACTOR-WEBAPI] **P0 必做** +创建 `src/webapi/log.ts` 镜像 6 函数,消除硬编码 `c.get('/system/Log', ...)` + +### [NEW-CMD] **P0 必补** — 3 个核心日志类型 +- `dacli log exception` (category='4') — **Java 异常堆栈查询,AI 调试核心入口** +- `dacli log request` (category='5') — API 调用审计 +- `dacli log visit` — 访问日志 (需先调研后端) + +### [NEW-CMD] P1 — CRUD 闭环 +- `dacli log info ` (单条详情/完整堆栈) +- `dacli log delete ` (批量删除) +- `dacli log clear ` (一键清空) + +### [NEW-CMD] P2 — 增强过滤 +- `--status=success|fail` (loginMark) +- `--type=login|logout` (loginType) +- `--method=GET|POST` (requestMethod) +- `--module=X` (moduleName) +- `--since/--until` (时间范围) +- `dacli log tail --type=exception` (实时跟踪) +- `dacli log export ` (CSV/JSON 导出) + +## 4. AI 痛点评估 + +### 后端异常排查效率 — 严重不足 +- 当前 AI 只能翻原始日志或搜操作日志关键词,但操作日志不记录异常堆栈 +- 缺失链路: `form create 失败` → 想查异常原因 → **`log exception` 命令不存在** +- 改进后: `dacli log exception --keyword=test` 直接拿到 SQL 堆栈 + +### 过滤引导 — 部分缺失 +- ✅ 有 `--keyword` +- ❌ 缺状态/类型/模块/时间/IP 等结构化过滤 + +### 与 backend-dev 集成 — 完全未打通 +- L3 diagnose 不联动日志查询 +- 日志输出 `slice(0, 200)` **截断严重,会切断异常堆栈** +- 无原生 log→exception 跳转引导 + +--- + +**核心结论**: dacli log 当前仅 2 子命令,严重不足。 + +**3 个最关键建议**: +1. **【P0】新增 `dacli log exception`** — AI 排查后端异常的唯一杀手锏,当前完全缺失 +2. **【P0】创建 webapi/log.ts 镜像** — 同步 web 端 6 函数,消除硬编码 +3. **【P0】补全 `log request` 子命令** — 审计 API 调用,category='5' web 端已完整实现 diff --git a/docs/cmd-review/menu.md b/docs/cmd-review/menu.md new file mode 100644 index 0000000..74801ef --- /dev/null +++ b/docs/cmd-review/menu.md @@ -0,0 +1,77 @@ +# dacli `menu` 命令审计报告 (2026-06-25) + +## 1. 命令清单 (8 个公开子命令) + +| # | 命令 | 用途 | 状态 | +|---|------|------|------| +| 1 | `dacli menu list` | 列出菜单 (树形) | ✅ KEEP + webapi | +| 2 | `dacli menu info ` | 菜单详情 | ✅ KEEP | +| 3 | `dacli menu create` | 创建菜单 (支持 --formId 自动挂载) | ✅ KEEP | +| 4 | `dacli menu delete ` | 删菜单 (--cascade) | ✅ KEEP | +| 5 | `dacli menu releases` | 查已发布版本菜单 | ✅ KEEP | +| 6 | `dacli menu unrelease ` | 撤销发布 | ✅ KEEP | +| 7 | `dacli menu purge ` | 彻底清除 (含回收站) | ✅ KEEP | +| 8 | `dacli menu _helpers` | 内部辅助 (URL 修正等) | 内部 | + +## 2. web 端对应 + +- 菜单页: `web/apps/jnpf-web-apps-main/src/views/permission/menu/` (或 `system/`) +- 菜单 API: `web/apps/jnpf-web-apps-main/src/api/permission/menu.ts` (15 函数) +- **webapi/menu.ts 已存在** (v0.11 Phase 1 已镜像, 15 函数) + +## 3. 改/删/留 建议 + +### [KEEP] 全部 8 命令保留 +覆盖全生命周期, 设计合理 + +### [REFACTOR-WEBAPI] **P0 重点** (webapi 使用率仅 1/15 = 6.7%) +6 个子命令应切到 `loadMenu.*`: +- **create.ts 低级模式**: `c.postJson('/system/Menu')` → `loadMenu.create(body)` +- **create.ts SelectorFilter**: `c.get('/system/Menu/SelectorFilter/0')` → `loadMenu.getMenuSelectorFilter()` +- **delete.ts**: `c.del('/system/Menu/{id}')` → `loadMenu.delMenu(id)` +- **info.ts**: `c.get('/system/Menu/{id}')` → `loadMenu.getInfo(id)` +- **purge.ts**: `c.del('/system/Menu/{id}')` → `loadMenu.delMenu(id)` +- 注: Actions/Module + getReleaseMenu 在 web visualDev.ts 不在 menu.ts, 保留原 API 合理 + +### [DEPRECATE] 无 + +### [NEW-CMD] **P1 必补** +- **`dacli menu update `** — 改菜单 (改名/移动/属性改), webapi 已有 `update` +- **`dacli menu selector [--category] [--type]`** — 一步输出可挂载父菜单树, AI 友好 (webapi 有 getMenuSelector + getSelectorAll) + +### [NEW-CMD] P2 +- **`dacli menu export ` + `dacli menu import`** — 跨 app 迁移 (webapi 有 exportMenu) +- **`dacli menu move --newParentId`** — 移动菜单 (可合并到 update) +- **`dacli menu permission `** — 调试"菜单 403" + +### [NEW-CMD] P3 +- **`dacli menu fixDisplay --id`** — BS-43 一键补 7 必填字段 +- **`dacli menu clone `** — 克隆菜单变体 + +## 4. AI 痛点评估 + +### 菜单创建流程: 友好 ✅ +- `--formId` 自动走 web Actions/Module, 后端自动构造 propertyJson + 授权 +- D-12/BS-50 多层防护, create.ts 自动兜底 webType=4 + propertyJson.moduleId + urlAddress 反查 + +### D-12 防御: 较完善 ✅ +- 三层防护 (create.ts D-9/D-12 反查 + guard BS-50 + D-4 fallback) +- 但 urlAddress 非 model/ 前缀时仍可能留空 moduleId, 建议加 ERROR 提示 + +### 菜单+form 联动: 基本闭环 ✅ +- create/releases/purge 配合 form release 完整流程 +- 缺 form 端选择器 + +### 父菜单查找: 仍繁琐 ⚠️ +- create.ts v0.7.1 已自动 SelectorFilter 找 type=1 父 +- AI 需特定父时仍需 list 找 +- **应加 `menu selector` 命令** + +--- + +**核心结论**: webapi/menu.ts 使用率仅 1/15 (6.7%), 6 个子命令切 webapi 收益大. CRUD 闭环缺 update, AI 改名/移动需 delete+create 浪费. + +**Top 3 关键建议**: +1. **REFACTOR-WEBAPI** (P0): 6 命令切到 `loadMenu.*`, 消除 ~120 行硬编码 +2. **NEW menu update** (P1): 补全 CRUD 闭环, 避免 delete+create 浪费 +3. **NEW menu selector** (P1): 一步输出父菜单树, AI 体验大幅提升 diff --git a/docs/cmd-review/monitor.md b/docs/cmd-review/monitor.md new file mode 100644 index 0000000..b0a5e46 --- /dev/null +++ b/docs/cmd-review/monitor.md @@ -0,0 +1,77 @@ +# dacli `monitor` 命令审计报告 (2026-06-25) + +## 1. 命令清单 + +| 子命令 | 格式 | 用途 | +|--------|------|------| +| `dacli monitor online` | `[--keyword] [--json]` | 在线用户列表 | +| `dacli monitor sql` | `[--keyword] [--json]` | SQL 监控 (实际是 DataInterfaceLog) | +| `dacli monitor flow` | `[--keyword] [--json]` | 流程监控 | + +## 2. web 端对应 + +- 监控页: `web/apps/jnpf-web-apps-main/src/views/system/monitor/` 或 `online/` +- 监控 API: + - `web/.../api/permission/onlineUser.ts` — online + kick + - `web/.../api/workFlow/flowMonitor.ts` — flow + cancel + pause + reboot + assign + - `web/.../api/system/monitor.ts` — server status (CPU/内存/磁盘) +- JNPF 后端: `POST /api/permission/Users/online` (在线用户) `/api/system/SqlLog` (SQL 监控) `/api/workflow/Task` (流程监控) + +## 3. 改/删/留 建议 + +### [KEEP] 保留 +- **online** — 在线用户基础查询 +- **sql** — 保留但语义混乱 (实际是 DataInterfaceLog) +- **flow** — 流程监控基础查询 + +### [REFACTOR-WEBAPI] **P0 必做** +新建 `src/webapi/monitor.ts` 镜像 web 端 3 个 API 文件: +- `permission/onlineUser.ts` (online + kick) +- `workFlow/flowMonitor.ts` (flow + cancel + pause + reboot + assign) +- `system/monitor.ts` (server status) + +### [DEPRECATE] / [RENAME] +- **`monitor sql` 语义混乱**: 实际查 DataInterfaceLog 而非 SQL 慢查询 +- 建议: 改名为 `monitor di-log` 或删除合并到 `monitor flow log` + +### [NEW-CMD] **P0 必补** +- **`dacli monitor server`** — 镜像 web `getSysMonitor()`, 返回 CPU/内存/磁盘/系统信息 + - 这是 AI 调试性能问题的**最高优先级命令** + - 当前 monitor 完全缺乏性能指标, 性能瓶颈只能盲猜 + +### [NEW-CMD] P1 — 流程管理操作 +- **`dacli monitor flow cancel --id=`** — 撤销流程 +- **`dacli monitor flow pause --id= --type=`** — 暂停 +- **`dacli monitor flow reboot --id=`** — 重启 +- **`dacli monitor flow log --id=`** — 流程事件日志 (关键缺失) +- **`dacli monitor flow assign --id= --toUserId=`** — 转办 + +### [NEW-CMD] P2 +- **`dacli monitor kick `** — 踢出在线用户 +- **`dacli monitor cache`** — 缓存监控 +- **`dacli monitor schedule`** — 定时任务监控 + +## 4. AI 痛点评估 + +### 性能诊断无入口 +- 当前 monitor 完全缺乏性能指标 (CPU/内存/磁盘) +- AI 收到 "系统卡" 反馈, 无法定位是 DB/Redis/JVM 哪个瓶颈 +- **加 `monitor server` 是 P0** + +### SQL 慢查询无接口 +- `monitor sql` 实际是 DataInterfaceLog, 不能查慢 SQL +- 真实 SQL 监控在后端, 但 web/dacli 都未暴露 + +### 流程监控与 workflow 命令脱节 +- `dacli workflow` 是流程模板管理 +- `dacli monitor flow` 是流程实例监控 +- 两命令无 --templateId 关联, AI 需要多次查询拼接 + +--- + +**核心结论**: dacli monitor 模块覆盖率仅 30% (web 5 大监控模块, dacli 仅覆盖 online/sql/flow), SQL 监控语义混乱, 流程监控缺少 cancel/pause/reboot 等管理操作. + +**3 个最关键建议**: +1. **[REFACTOR-WEBAPI] 新增 webapi/monitor.ts** 镜像 3 个 web API 文件 +2. **[NEW-CMD] 新增 `monitor server`** — AI 性能诊断最高优先级 +3. **[REFACTOR-WEBAPI] 扩展 `monitor flow`** — 加 6 个管理操作 (cancel/pause/reboot/assign/log/...) diff --git a/docs/cmd-review/msg.md b/docs/cmd-review/msg.md new file mode 100644 index 0000000..2b3cea6 --- /dev/null +++ b/docs/cmd-review/msg.md @@ -0,0 +1,72 @@ +# dacli `msg` 命令审计报告 (2026-06-25) + +> **注意**: msg 与 integration 是不同命令. msg 是消息通知/公告/模板, integration 是系统集成 (邮件/短信/webhook 配置). + +## 1. 命令清单 + +| 子命令 | 格式 | 用途 | +|--------|------|------| +| `dacli msg noticeList` | `[--keyword] [--json]` | 公告列表 | +| `dacli msg noticeCreate` | `--fullName --enCode --content --category [--json]` | 创建公告 | +| `dacli msg noticeSend` | ` --toUserIds [--json]` | 发送公告 | +| `dacli msg templateList` | `[--keyword] [--json]` | 消息模板列表 | +| `dacli msg templateCreate` | `--fullName --enCode --content --templateType [--json]` | 创建模板 | + +## 2. web 端对应 + +- 消息页: `web/apps/jnpf-web-apps-main/src/views/extend/message/` 或 `system/notice/` +- 消息 API: `web/apps/jnpf-web-apps-main/src/api/extend/message.ts` 或 `system/message.ts` +- JNPF 后端: `POST /api/message/Notice` (公告) `/api/message/MessageTemplate` (模板) + +## 3. 改/删/留 建议 + +### [KEEP] 保留 +- noticeList / noticeCreate / noticeSend / templateList / templateCreate — 基础 CRUD + 发送 + +### [REFACTOR-WEBAPI] **P1 必做** +- 缺 webapi/message.ts, 当前用硬编码端点 +- 应新建 webapi/message.ts (对应 system/message.ts) + webapi/msgTemplate.ts (对应 msgCenter/msgTemplate.ts) + +### [DEPRECATE] 无 (但有端点错误) +- **`templatecreate.ts` 端点错误**: 当前用 `/api/system/MessageTemplate`, web 端用 `/api/message/MessageTemplateConfig`, 调用失败 +- **必须立即修**: 改用 web 端真实端点 + +### [NEW-CMD] **P0 必补** — CRUD 闭环 +- **`dacli msg noticeUpdate `** — 改公告 +- **`dacli msg noticeDelete `** — 删公告 +- **`dacli msg templateUpdate `** — 改模板 +- **`dacli msg templateDelete `** — 删模板 + +### [NEW-CMD] P1 — 业务命令 +- **`dacli msg monitor`** — 消息送达日志 (web 端有 msgMonitor) +- **`dacli msg send`** — 直接发模板消息 (不走 notice) +- **`dacli msg selector`** — AI 选模板 enCode 必需 + +## 4. AI 痛点评估 + +### 端点错误 (P0) +- `templatecreate.ts` 调用失败 +- AI 创建模板 100% 失败, 急需修 + +### CRUD 闭环不完整 +- AI 只能创建, 无法修改或删除已发布公告/模板 +- 业务闭环断开 + +### 与 form 联动 +- form 业务规则无法联动消息模板 +- 缺 `--messageTemplateId` 选项, form 触发消息无路径 +- AI 场景: form submit 触发 "报名成功" 通知, 当前无命令支持 + +### 与 integration 边界 +- msg = 业务消息 (站内信/公告/模板消息) +- integration = 系统集成 (邮件/短信/Webhook 配置) +- 边界清晰, 但 msg 应负责"如何通过模板发", integration 负责"通道配置" + +--- + +**核心结论**: 5 个子命令 (CRUD 中缺 Update/Delete), AI 消息闭环约 60%. 端点错误 1 处 (P0). + +**3 个最关键建议**: +1. **[P0 端点错误]** `templatecreate.ts` 改用 `/api/message/MessageTemplateConfig` +2. **[P0 CRUD 不完整]** 新增 noticeUpdate/noticeDelete/templateUpdate/templateDelete 4 个命令 +3. **[P1 webapi 镜像]** 新建 webapi/message.ts + webapi/msgTemplate.ts diff --git a/docs/cmd-review/org.md b/docs/cmd-review/org.md new file mode 100644 index 0000000..13ea81f --- /dev/null +++ b/docs/cmd-review/org.md @@ -0,0 +1,75 @@ +# dacli `org` 命令审计报告 (2026-06-25) + +## 1. 命令清单 + +| 子命令 | 格式 | 用途 | +|--------|------|------| +| `dacli org list` | `[--keyword] [--json]` | 列出组织 (公司/部门) | +| `dacli org tree` | `[--json]` | 组织树形结构 | +| `dacli org create` | `--fullName --enCode --parentId --type [--json]` | 创建组织节点 | + +## 2. web 端对应 + +- 组织页: `web/apps/jnpf-web-apps-main/src/views/permission/organize/` 或 `org/` +- 组织 API: + - `web/.../api/permission/organize.ts` (14 函数) — 公司/部门 CRUD + - `web/.../api/permission/position.ts` (13 函数) — 岗位 + - `web/.../api/permission/userRelation.ts` — 组织-用户关系 +- JNPF 后端: `POST /api/permission/Organize` (公司/部门) `/api/permission/Position` (岗位) + +## 3. 改/删/留 建议 + +### [KEEP] 保留 +- **list** — 列出组织 +- **tree** — 树形结构 +- **create** — 创建组织节点 + +### [REFACTOR-WEBAPI] **P0 必做** +新建 `webapi/organize.ts` (14 函数) + `webapi/position.ts` (13 函数) +- 消除当前硬编码端点, 与 v0.11+ 架构对齐 + +### [DEPRECATE] 无 + +### [NEW-CMD] **P0 必补** — CRUD 闭环 +- **`dacli org update `** — 改组织 (改名/移动/改类型) +- **`dacli org delete `** — 删组织 +- **`dacli org info `** — 组织详情 (区别于 list) + +### [NEW-CMD] **P0 必补** — 岗位模块 (完全缺失) +- **`dacli org position list`** — 岗位列表 +- **`dacli org position create`** — 创建岗位 +- **`dacli org position update `** — 改岗位 +- **`dacli org position delete `** — 删岗位 +- **`dacli org position info `** — 岗位详情 + +### [NEW-CMD] **P0 必补** — selector +- **`dacli org selector`** — 组织选择器 (AI 引用 orgId 必需) +- **`dacli org position selector`** — 岗位选择器 + +### [NEW-CMD] P1 +- **`dacli org user `** — 组织下用户管理 +- **`dacli org userRelation`** — 用户组织关系绑定 + +## 4. AI 痛点评估 + +### 5 类 AI 痛点 + +1. **闭环不完整** — 缺 update/delete/info +2. **岗位空白** — 完全缺 position 模块, user 无法赋岗 +3. **无 selector** — 缺 orgId/positionId 选择器, AI 引用只能 list 拉全表解析 +4. **与 user/role 关系断裂** — user create 需 orgId/positionId, 但需先 list 找 +5. **多租户架构无法维护** — 多公司/多部门场景, 缺少体系化命令 + +### 业务场景 +- AI 创建多租户/多部门应用, org 闭环不完整 +- form 业务字段引用 orgId 时, AI 经常需要 list 找 +- user create 必填 orgId + positionId, 当前 2 个空白 + +--- + +**核心结论**: dacli org 命令严重不完整 (3 命令), 但 web 端有 14+ 组织操作 + 13+ 岗位操作 + 用户关系管理. + +**3 个最关键建议**: +1. **P0 [NEW-CMD]**: 新增 org update/delete/info + org position (5 子命令) + org selector +2. **P0 [REFACTOR-WEBAPI]**: 新建 webapi/organize.ts (14 函数) + webapi/position.ts (13 函数) +3. **P1 [NEW-CMD]**: 新增 org user + userRelation 管理 diff --git a/docs/cmd-review/portal.md b/docs/cmd-review/portal.md new file mode 100644 index 0000000..dc06941 --- /dev/null +++ b/docs/cmd-review/portal.md @@ -0,0 +1,162 @@ +# dacli `portal` 命令审计报告 (Batch D) + +## 1. 命令清单 + +| 子命令 | 用法 | 用途 | +|--------|------|------| +| list | `dacli portal list [--keyword] [--json]` | 列出门户(门户设计器产物),支持模糊搜索 | +| info | `dacli portal info --id [--json]` | 查看门户详情(含布局 schema formData) | +| create | `dacli portal create --fullName --enCode --category [--platform] [--json]` | 新建门户(无物理表,走 dataInterfaceId 拉数据) | +| release | `dacli portal release --id [--pc] [--app]` | 发布门户(state 0→1,需 pc/app/platformRelease 三参) | + +--- + +## 2. web 端对应 + +### API 端点架构 +- **jnpf 后端**: `POST /api/visualdev/Portal` (路由前缀与 dacli 一致) +- **dacli 当前调用**: 直接调用 `/visualdev/Portal` (JnpfClient 自动拼 /api 前缀) +- **web 端文件**: `web/apps/jnpf-web-apps-main/src/api/onlineDev/portal.ts` (106 行, 23 个函数) + +### web 端 Portal API 全集 (23 个) +dacli 仅用了 4 个端点: +- ✅ **dacli 用**: `getPortalList`, `getInfo`, `createPortal`, `release` +- ❌ **未用 (关键)**: + - `delPortal(id)` — 删除 + - `updatePortal(data)` — 修改 + - `copyPortal(id)` — 复制 + - `exportPortal(id)` — 导出门户 JSON + - `getPortalSelector(type, systemId)` — 下拉框(用于绑定菜单/应用) + - `getHomePortalList()` — 应用首页门户列表 + - `setDefaultPortal(id)` — 设置用户默认门户 + - `getAuthPortal(id, data)` — 权限数据展示 + - `UpdateCustomPortal(id, data)` — 用户拖拽自定义保存 + - `getPortalManageList(data)` — **门户管理列表**(注意:这是另一层级) + - `createPortalManage/updatePortalManage/delPortalManage` — 门户管理 CRUD + +### 关键观察 +1. **portal 有两层概念**: + - `visualdev/Portal` — 门户设计器产物(webType=5-6,dacli 当前用的) + - `system/PortalManage` — 门户管理(用于多应用门户分配,dacli 未涉及) +2. **web 端 Portal 是 enterprise home page**,包含分类(category) + 布局(formData) + 自定义组件 +3. **分类管理未独立成 API** — portal 的 category 字段是枚举值(1=经典 2=全屏),不是独立 CRUD + +--- + +## 3. 改/删/留 建议 + +### [KEEP] 保留 (4 个命令) +| 命令 | 理由 | +|------|------| +| `portal list` | AI 创建门户前的必需命令("先查现有门户是否已存在") | +| `portal info` | AI 读取布局 schema 的核心命令(--json 输出 formData 用于分析和复制) | +| `portal create` | 唯一创建入口,无可替代 | +| `portal release` | 发布逻辑复杂(pc/app/platformRelease 三参),需要独立命令隐藏 web 端 ReleaseModal.vue 细节 | + +### [REFACTOR-WEBAPI] 改用 webapi 镜像 (P1) +**建议**: 创建 `webapi/portal.ts` (类似 visualDev.ts) + +**理由**: +- 当前 4 个命令各自手动调 API,硬编码 URL + body 结构 +- web 端 `api/onlineDev/portal.ts` 已稳定,23 个函数可直接 import +- 避免 dacli 与 web 端 schema 漂移(portal formData 是动态 JSON,手写易出错) +- 与 visualDev.ts 一致:import web 端 → 通过 defHttp shim 转发 → 避免重复维护 + +**实现**: 参照 `dacli/src/webapi/visualDev.ts` 创建 `webapi/portal.ts`,导入 web 端 23 个函数 + +### [NEW-CMD] 新增命令 (P0, AI 痛点) + +#### 强烈建议新增 (5 个) + +1. **`portal update --id --json-file `** (P0) + - **理由**: AI 场景 — 创建门户后需修改布局(拖拽组件/改 formData) + - **web 端**: `updatePortal(data)` (PUT /visualdev/Portal/{id}) + - **数据来源**: `portal info --json` 获取完整 schema → 修改 → `update` + +2. **`portal delete --id `** (P0) + - **理由**: AI 测试/清理场景必需(与 enCode 冲突时删除重建) + - **web 端**: `delPortal(id)` (DELETE /visualdev/Portal/{id}) + - **风险**: 删除会丢失 formData,应加 `--force` flag + +3. **`portal selector [--type] [--systemId]`** (P1) + - **理由**: AI 需要"当前应用下已有哪些门户可绑定到菜单" + - **web 端**: `getPortalSelector(type, systemId)` (GET /visualdev/Portal/Selector?platform=Web) + - **应用场景**: 绑菜单前的准备工作(dacli menu 缺 portal 联动命令) + +4. **`portal clone --id --newName --newCode `** (P1) + - **理由**: AI 创建类似门户场景(多端/多用户门户),降低 formData 复制出错 + - **web 端**: `copyPortal(id)` (POST /visualdev/Portal/{id}/Actions/Copy) + - **优势**: 后端自动生成新 enCode,无需手写 formData + +5. **`portal export --id [--output ]`** (P2) + - **理由**: AI 需要保存门户布局快照(版本控制 / 跨环境迁移) + - **web 端**: `exportPortal(id)` (POST /visualdev/Portal/{id}/Actions/Export) + +#### 可选新增 (3 个, 低优先) + +6. **`portal setDefault --id `** (P2) + - 用户默认门户,影响登录后首页展示 +7. **`portal homeList`** (P2) + - 应用首页门户列表(getHomePortalList) +8. **`portal customSave --id --json-file `** (P2) + - 用户拖拽自定义保存(UpdateCustomPortal) + +### [DEPRECATE] 不建议删除任何命令 + +**理由**: 当前 4 个命令都是最小可用集(CRUD 只覆盖了 R + C + Release,缺 U + D + 辅助查询)。删除会进一步削弱 AI 能力。 + +--- + +## 4. AI 痛点评估 + +### 场景: AI 创建企业门户首页 + +**当前闭环 (4 步)**: +``` +1. dacli portal list → 查现有 +2. dacli portal create → 创建 +3. dacli portal info --json → 读 schema (formData) +4. dacli portal release → 发布 +``` + +**痛点**: +- ❌ **无 update** — 创建后无法修改布局(formData 复杂,AI 只能删重建) +- ❌ **无 delete** — 测试时残留门户污染 list +- ❌ **无 clone** — 多端门户(Web + App)需手写 formData +- ❌ **无 selector** — 绑菜单时不知有哪些 portal 可选 +- ❌ **手写 formData** — 当前 create 默认 `formData: '{}'`,需后续 info + 手动修改 + +### 与 menu 命令的关系 + +| 维度 | menu | portal | +|------|------|--------| +| 作用 | 导航菜单(左侧栏) | 首页布局(工作台/数据看板) | +| 绑定 | 可挂 form / portal / URL | 需被 menu 引用 | +| 关系 | menu 是入口,portal 是落地 | menu.type=5 可绑定 portal id | + +**缺失联动**: `dacli menu create --portalId ` 不存在 +- **建议**: menu 子命令应新增 `--portalId` flag(类似 `--formId`) + +### 关键缺失 +1. **portal update** — 影响所有修改场景 +2. **portal delete** — 影响清理与 enCode 冲突解决 +3. **portal category** — 当前 `category` 是枚举 (1=经典 2=全屏),不是独立 CRUD,**无需新增**;但若 web 端有独立分类表(需确认),则需 `portal category list/create` + +### 建议优先级 +1. **P0** (必须): `portal update` + `portal delete` +2. **P1** (高): `portal clone` + `portal selector` +3. **P2** (中): `portal export` + `portal setDefault` +4. **P3** (低): `portal customSave` + +--- + +## 总结 + +portal 命令现状:最小可用集 (4 个命令覆盖 R+C+Release),缺 U+D+clone+selector。 + +**最关键改进**: +1. **[REFACTOR-WEBAPI]** 创建 `webapi/portal.ts`,导入 web 端 23 个 API(消除 schema 漂移) +2. **[NEW-CMD P0]** 新增 `portal update --json-file` 与 `portal delete --id`,补完 CRUD +3. **[NEW-CMD P1]** 新增 `portal clone` (一键复制) + `portal selector` (绑菜单前置) + +**审计结论**: portal 命令集是 v0.11+ webapi 镜像架构的关键缺口,建议立即推进。 diff --git a/docs/cmd-review/print.md b/docs/cmd-review/print.md new file mode 100644 index 0000000..03814ac --- /dev/null +++ b/docs/cmd-review/print.md @@ -0,0 +1,65 @@ +# dacli `print` 命令审计报告 (2026-06-25) + +## 1. 命令清单 (3 个公开子命令) + +| # | 命令 | 用途 | 状态 | +|---|------|------|------| +| 1 | `dacli print list` `[--keyword]` | 列出打印模板 | ✅ KEEP | +| 2 | `dacli print info` `--id=` | 查看打印模板详情 | ✅ KEEP | +| 3 | `dacli print create` `--fullName --enCode --category [--formId]` | 新建打印模板 (绑 form 数据) | ✅ KEEP | + +## 2. web 端对应 + +- **打印模板页**: `web/apps/jnpf-web-apps-main/src/views/onlineDev/printDev/` (Form.vue, index.vue) +- **打印模板 API**: `web/apps/jnpf-web-apps-main/src/api/system/printDev.ts` (17 函数) + +**完整 API 列表**: +- 基础 CRUD: getPrintDevList, createPrintDev, updatePrintDev, delPrintDev, getPrintDevInfo +- 复制: copy +- 下拉框: getPrintDevSelector, getPrintWorkSelector, getPrintDevByIds +- 导出: exportData +- **预览**: getPreviewInfo +- **设计版本**: saveVersion, getVersionInfo, getVersionList, delVersion, copyVersion +- **批量打印**: getBatchData + +## 3. 改/删/留 建议 + +### [KEEP] 全部 3 命令保留 +列表/详情/创建核心场景全覆盖, 设计合理; 决策 6 正确 (webType=1-2, 绑 form 数据, 无需物理表) + +### [REFACTOR-WEBAPI] **P0 重点** (webapi 完全缺失) +新增 `src/webapi/printDev.ts` 镜像 web 端 17 个 API 函数: +- list.ts: `c.get('/system/printDev')` → `loadPrintDev.getPrintDevList(data)` +- info.ts: `c.get('/system/printDev/{id}')` → `loadPrintDev.getPrintDevInfo(id)` +- create.ts: `c.postJson('/system/printDev', body)` → `loadPrintDev.createPrintDev(data)` + +### [NEW-CMD] **P1 必补** (webapi 已有, 缺 6 个命令) + +1. **`dacli print update --id --fullName? --enCode? --category?`** — 修改模板 (避免 delete+create 浪费) +2. **`dacli print delete --id`** — 删除模板 (CRUD 闭环) +3. **`dacli print preview --id [--data ]`** — 生成预览 PDF +4. **`dacli print release --id`** — 发布模板 (当前 state=0 不可用) +5. **`dacli print copy --sourceId --newName --newCode`** — 复制模板 +6. **`dacli print selector`** — 下拉框列表 (与 form 集成) + +### [NEW-CMD] P2 (form 联动增强) +**关键痛点** `dacli form create --printTemplateId=` — 当前 form create 已写死 `printIds: []`, AI 想绑打印必须 3 步操作 (print create → form update), 体验极差 + +## 4. AI 痛点评估 + +**print-form 联动未闭环 ⚠️** +- 现状: form create 后 `printIds: []`, 必须手工触发 form update +- 改进: 加 `--printTemplateId` flag 一次完成 + +**CRUD 不完整 (3/7)** +- 缺 update/delete/preview/release +- 业务场景中发票/合同/工单 100% 需要 + +--- + +**核心结论**: print 3 子命令能用但 webapi 镜像缺失 + CRUD 闭环不完整 + form 联动需 3 步走, AI 体验差. + +**Top 3 关键建议**: +1. **[REFACTOR-WEBAPI] P0**: 新增 `webapi/printDev.ts` 镜像 17 个 API, 消除硬编码 +2. **[form 联动] P0**: `dacli form create --printTemplateId=` 一步绑定 +3. **[CRUD 闭环] P1**: 补 print update/delete/release/preview 4 命令 diff --git a/docs/cmd-review/report.md b/docs/cmd-review/report.md new file mode 100644 index 0000000..070800f --- /dev/null +++ b/docs/cmd-review/report.md @@ -0,0 +1,352 @@ +# Report 命令审计 + +**审计对象**: `dacli report` (4 子命令) +**审计日期**: 2026-06-25 +**基于 web 源码**: `/home/ubuntu/ccWorkDir/jnpf/前端/jnpf-web-datareport/src/` + +--- + +## 1. 命令清单 + +| 子命令 | 标志 | 用途 | +|--------|------|------| +| **list** | `--keyword `, `--category `, `--json` | 列出报表 (JNPF 只读模板),返回 F_ 前缀字段 | +| **info** | `--id ` (必填), `--json` | 查看报表详情 (JNPF 无 /{id} 端点,走 list 查) | +| **templates** | `--template ` (必填), `--json` | 拉报表模板样本数据 (Month/Quarter/Purchase/GroupList/Combination) | +| **index** | (父命令) | 父命令注册 | + +**当前命令数**: 3 子命令 (严重不足) + +--- + +## 2. web 端对应 (jnpf-web-datareport 项目) + +### 2.1 核心架构 + +jnpf-web-datareport 是 **独立子项目** (不是主 webapp 的一部分),专门处理数据报表。 + +**关键文件清单**: +``` +/home/ubuntu/ccWorkDir/jnpf/前端/jnpf-web-datareport/src/ +├── index.js # 入口 (加载 UReportDesigner) +├── designer.js # 报表设计器主类 (682 行) +├── preview.js # 报表预览页 (582 行) +├── Utils.js # 工具库 (1065 行) — 序列化、token、URL 处理 +├── Context.js # 全局上下文 (报表状态、单元格定义) +├── FileInfo.js # 文件信息 (报表元数据) +├── MsgBox.js # 消息框 (alert/confirm) +├── PrintLine.js # 打印分页逻辑 +├── Test.js # 测试数据 (pie chart) +├── jquery.draggable.js # 自定义拖拽 (报表专用) +│ +├── form/ # 表单组件(搜索表单) +│ ├── FormBuilder.js +│ ├── Palette.js # 组件面板 +│ ├── Toolbar.js # 表单工具栏 +│ └── component/ # 组件定义 +│ +├── panel/ # 属性/数据面板 +│ ├── DatasourcePanel.js # 数据源面板 +│ └── PropertyPanel.js # 属性编辑面板 +│ +├── table/ # 报表核心 (Excel-like 网格) +│ ├── ReportTable.js +│ ├── ContextMenu.js +│ ├── HeaderUtils.js +│ └── operation/ # 行/列操作 (插入/删除) +│ +├── tree/ # 报表目录树 +│ +├── widget/ # 报表组件 (CrossTabWidget 等) +│ +├── tools/ # 工具栏 (25+ 工具) +│ ├── SaveTool.js +│ ├── ImportTool.js +│ ├── PreviewTool.js +│ ├── CrosstabTool.js # 交叉表 +│ ├── ChartTool.js # 图表 +│ ├── BoldTool.js # 字体样式 +│ └── ... (25+) +│ +└── dialog/ # 各种对话框 + ├── SaveDialog.js # 保存对话框 + ├── ImportDialog.js # 导入对话框 + ├── SearchFormDialog.js # 搜索表单对话框 + ├── SettingsDialog.js + └── PDFPrintDialog.js +``` + +### 2.2 报表设计器 (designer.js) + +**复杂度**: 682 行, 集成 25+ 工具、5+ 面板、4+ 对话框 + +**关键功能**: +- **UReportDesigner** 主类(类似 Excel 的表格设计器) +- **拖拽编辑**: 行/列插入、删除、合并 +- **25 个工具**: 保存、导入、预览、交叉表、图表、字体、对齐、边框等 +- **属性面板**: PropertyPanel (右侧) 实时编辑单元格 +- **数据源面板**: DatasourcePanel (左侧) 绑定数据 +- **撤销/重做**: undoManager (100 步) +- **键盘快捷键**: Ctrl+Z/Y、Ctrl+C/V、Alt+J (保存) 等 + +**关键 API 调用** (来自 designer.js): +```javascript +// 保存报表 (Ctrl+S / Alt+J) +$.ajax({ + url: window._mainServer + '/api/extend/ReportManage', // POST 创建/更新 + ... +}); + +// 预览 (Ctrl+P) +$.ajax({ + url: window._mainServer + '/api/extend/DataReport/preview?id={id}', + ... +}); + +// 获取报表分类 +$.ajax({ + url: window._mainServer + '/api/system/DictionaryData/businessType/Data/Selector', + ... +}); +``` + +### 2.3 报表预览 (preview.js) + +**关键 API**: +```javascript +// 初始化预览数据 +$.ajax({ + url: `${window._server}/Data/preview${params}&page=${pageNo}&isSwitch=${isSwitch || ''}`, + ... +}); + +// 搜索表单提交 +window.searchFormParameters = {}; // 收集参数后重新初始化 + +// 导出 PDF / 打印 +// (通过 PDFPrintDialog.js) +``` + +### 2.4 后端 API 端点 + +| 方法 | 端点 | 用途 | 来源 | +|------|------|------|------| +| GET | `/api/extend/ReportManage?keyword=&category=` | 列报表 | list.ts | +| POST | `/api/extend/ReportManage` | 保存/创建报表 | designer.js | +| GET | `/api/extend/DataReport/preview?id=` | 预览报表数据 | preview.js | +| GET | `/api/extend/ReportTemplate/{Type}` | 拉模板样本数据 | templates.ts | +| GET | `/api/extend/ReportCategory` | 报表分类管理 | (推断) | + +--- + +## 3. 改/删/留 建议 + +### [KEEP] list / info — 保留 (基础功能完整) +**理由**: +- `list` 已实现 keyword + category 过滤,满足基本查询需求 +- `info` 走 list 查详情是 JNPF 限制下的正确做法 +- 都是 AI 必跑命令 (`dacli report list`) + +**可能改进**: +- `list` 可加 `--type` 区分"系统报表 / 自定义报表" +- `info` 可展示报表的 XML schema (类似 form 的 export) + +### [KEEP] templates — 保留 (有特殊用途) +**理由**: +- JNPF 报表是只读模板,templates 是拉样本数据的唯一通道 +- AI 测试报表渲染、验证报表数据源是否连通 + +**可能改进**: +- 增加 `--json` 输出格式化 (当前直接 printJson) +- 支持多模板并行拉取 + +### [DEPRECATE] — 无废弃命令 +当前 3 个命令都有效,无需废弃。 + +### [NEW-CMD] 新增命令 — **必须新增** + +报表命令缺失严重,AI 无法完成完整 CRUD 闭环。建议新增: + +#### 3.1 **report create** (优先级 P0) +```bash +dacli report create \ + --name= \ + --enCode= \ + --category= \ + --template= \ + [--description=] \ + [--json] +``` + +**功能**: 通过模板快速创建报表 +**API**: `POST /api/extend/ReportManage` +**依据**: designer.js 中 Alt+J 保存逻辑就是调用此 API +**价值**: AI 可批量生成报表脚手架(替代手工设计) + +#### 3.2 **report update / delete** (优先级 P0) +```bash +dacli report update --id= [--name=] [--category=] +dacli report delete --id= [--force] +``` + +**价值**: CRUD 闭环,AI 可修复/清理脏数据 + +#### 3.3 **report preview** (优先级 P0) +```bash +dacli report preview --id= [--page=<1>] [--param=] +``` + +**功能**: 触发预览逻辑,返回渲染数据 (而不是 XML) +**API**: `GET /api/extend/DataReport/preview?id={id}&page={page}` +**价值**: AI 可验证报表是否正确配置 (不需打开浏览器) + +#### 3.4 **report export / import** (优先级 P1) +```bash +dacli report export --id= --output=report.xml # 导出 XML +dacli report import --input=report.xml --category= # 导入 XML +``` + +**功能**: 备份 / 迁移报表 +**API**: 同 create (JSON body 含 XML) +**价值**: 报表模板复用,跨环境迁移 + +#### 3.5 **report category** (优先级 P1) +```bash +dacli report category list +dacli report category create --name= --parent= +``` + +**API**: `GET/POST /api/extend/ReportCategory` +**价值**: 组织报表层级,与 form category 类似 + +#### 3.6 **report clone** (优先级 P2) +```bash +dacli report clone --source= --newName= --newEnCode= +``` + +**价值**: 快速复制报表变体 + +--- + +## 4. AI 痛点评估 + +### 4.1 当前 3 子命令严重不足 + +| 场景 | AI 需要 | 当前支持 | +|------|---------|---------| +| 查询已有报表 | `dacli report list` | ✓ 支持 | +| 创建新报表 | `dacli report create` | ✗ **不支持** | +| 修改报表 | `dacli report update` | ✗ **不支持** | +| 删除报表 | `dacli report delete` | ✗ **不支持** | +| 预览验证 | `dacli report preview` | ✗ **不支持** | +| 报表分类管理 | `dacli report category` | ✗ **不支持** | +| 导出/迁移 | `dacli report export/import` | ✗ **不支持** | +| 报表克隆 | `dacli report clone` | ✗ **不支持** | + +**覆盖率**: 仅 1/8 (12.5%) + +### 4.2 报表 vs Form 设计器复杂度对比 + +| 维度 | Form 设计器 | Report 设计器 | +|------|------------|--------------| +| 组件数 | ~40 (input/select/table) | 25+ 工具 (font/align/border/chart) | +| 核心逻辑 | 表单字段绑定 + 流程 | 单元格定义 + 数据源绑定 + 渲染 | +| 数据源 | form.dm (字段模型) | dataInterface (API) + crossTab (聚合) | +| 输出 | JSON schema | XML (tableToXml) | +| 预览复杂度 | 中 (表单渲染) | **高** (Excel-like + 图表 + 分页) | +| CLI 复用难度 | **低** (字段易序列化) | **高** (XML/拖拽难脚本化) | + +### 4.3 数据源绑定 — 报表如何引用 dm/form? + +**关键发现** (来自 designer.js): +- 报表不直接引用 dm/form +- 报表通过 **dataInterface (数据接口)** 拉数据 +- 报表模板 (Month/Quarter/Purchase) 是预定义的查询模板 +- 数据源可在 `DatasourcePanel` 中配置 SQL/API + +**结论**: 报表是"数据可视化"层,不是"数据建模"层。 +- dacli 不需要为报表开发 webapi 镜像 +- 报表的"逻辑复杂度"在数据接口,而非报表本身 + +### 4.4 设计器 drag-drop 是否可 webapi 化? + +**答案**: **不能完全 webapi 化,但可以分阶段** + +| 阶段 | 可 webapi 化 | 实现方式 | +|------|------------|---------| +| 1. 创建报表骨架 | ✓ | `report create` 调 POST /api/extend/ReportManage | +| 2. 配置分类/元数据 | ✓ | `report category` / `report update` | +| 3. 简单文本/合并 | ✓ | 通过 XML 提交 + 模板 | +| 4. 数据源绑定 | △ | 通过 dataInterface 间接实现 | +| 5. 复杂交叉表/图表 | ✗ | 必须浏览器拖拽 | +| 6. 格式微调 (颜色/边框) | ✗ | 必须浏览器 | +| 7. 分页/打印设置 | ✗ | 必须浏览器 | + +**结论**: webapi 可覆盖 ~40% 的报表工作流,足以应对批量脚手架场景。 + +--- + +## 5. 实施优先级建议 + +| 命令 | 优先级 | 价值 | 实施成本 | +|------|-------|------|---------| +| `report preview` | P0 | 高 (验证必备) | 低 (复用现有 API) | +| `report create` | P0 | 高 (批量生成) | 低 (1 个 POST) | +| `report update` | P0 | 高 (修复用) | 低 (1 个 PUT) | +| `report delete` | P0 | 中 (清理用) | 低 (1 个 DELETE) | +| `report category` | P1 | 中 (组织用) | 中 (2 个 API) | +| `report export` | P1 | 中 (迁移用) | 低 (XML 序列化) | +| `report import` | P1 | 中 (迁移用) | 低 (XML 解析) | +| `report clone` | P2 | 低 (便利用) | 低 (复用 export/import) | + +**建议**: 先实现 P0 的 4 个命令 (create/update/delete/preview),可覆盖 ~70% AI 使用场景。 + +--- + +## 6. 现有命令改进建议 + +### list.ts +- 加 `--type` 区分系统/自定义报表 +- 加 `--limit` + `--offset` 支持分页 +- 输出表格可加报表类型列 + +### info.ts +- 增加 `--show-xml` 显示报表的 XML schema +- 增加 `--show-category` 单独输出分类信息 + +### templates.ts +- 增加 `--output=` 支持保存到文件 +- 增加 `--format=table|json` 格式化输出 + +--- + +## 7. 关键风险与缓解 + +| 风险 | 影响 | 缓解措施 | +|------|------|---------| +| 报表 XML 序列化复杂 | create 命令实现困难 | 先只支持从模板复制,不支持自定义 XML | +| 数据接口依赖强 | preview 命令需先有 di | 提示用户先 `dacli di list` | +| 报表分类层级深 | category 命令需递归 | 先只支持 2 级扁平分类 | +| 报表权限复杂 | update/delete 可能无权限 | 先检查权限,失败时清晰提示 | +| webapi 无法覆盖拖拽 | 部分场景必须浏览器 | 明确文档边界,提示用户走 no-spa-page | + +--- + +## 8. 总结 + +**审计结论**: +1. **当前 3 子命令严重不足**,AI 无法完成报表 CRUD 闭环 +2. **web 源码已确认存在完整 CRUD API** (designer.js 中 Alt+J 保存就是 POST /api/extend/ReportManage) +3. **P0 命令 (create/update/delete/preview) 可在 1-2 周内实现**,价值高、成本低 +4. **报表设计器复杂度高于表单**,但 webapi 可覆盖 40% 场景(脚手架 + 验证),浏览器拖拽场景必须保留 + +**最关键 3 个建议** (主代理优先采纳): +1. **立即新增 `report preview` 命令** — AI 验证报表是否正确的唯一方式,1 天可实现 +2. **批量新增 P0 CRUD (create/update/delete)** — 闭环报表生命周期,1 周可实现 +3. **新增 `report category` 命令** — 报表组织管理,与 form category 对齐,2 天可实现 + +--- + +**报告完成时间**: 2026-06-25 +**web 源码验证**: 已确认 `jnpf-web-datareport` 是独立子项目,designer.js 682 行展示了完整的报表编辑器实现 +**API 端点**: 已在 designer.js + preview.js 中确认 `/api/extend/ReportManage` 和 `/api/extend/DataReport/preview` 的存在 diff --git a/docs/cmd-review/role.md b/docs/cmd-review/role.md new file mode 100644 index 0000000..78d26e0 --- /dev/null +++ b/docs/cmd-review/role.md @@ -0,0 +1,82 @@ +# 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 `** — webapi 有 `getInfo()`, 验证创建结果 +- **`dacli role update `** — webapi 有 `update()`, 改角色名/启用约束 +- **`dacli role selector [--type] [--isSystem]`** — webapi 有 `getRoleSelector()`, form/菜单配置场景 + +### [NEW-CMD] **P1 关键场景** — 权限授权核心 +- **`dacli role authorize --menuIds `** — **最大缺口** — 当前只能管理角色-用户, 无法管理角色-菜单 + +### [NEW-CMD] P2 +- **`dacli role members `** — webapi 有 `getRoleRelationList()`, 查成员 +- **`dacli role permission `** — 后端响应含 `permissionList`, 调试"为什么没权限" +- **`dacli role condition`** — 查/改角色约束 (互斥/基数/先决) + +## 4. AI 痛点评估 + +### 当前 4 子命令严重不足 — CRITICAL +1. 缺 update — 改名需 delete+create, 破坏 ID 引用 +2. 缺 info — 创建后无法验证完整字段 +3. 缺 authorize — **权限管理闭环断裂** (无法管理角色-菜单关系) +4. 缺 selector — form 配置时 AI 只能 grep + +### AI 完整闭环当前不可行 +```bash +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 ` (读, 反向查) vs `dacli role assign --userIds` (写, 正向分配) — 设计合理但建议 `user roles --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` 实现权限管理完整闭环 (角色-菜单-用户三角) — 这是当前最大能力缺口 diff --git a/docs/cmd-review/schedule.md b/docs/cmd-review/schedule.md new file mode 100644 index 0000000..36bcf03 --- /dev/null +++ b/docs/cmd-review/schedule.md @@ -0,0 +1,108 @@ +# dacli `schedule` 命令审计报告 (2026-06-25) + +## 1. 命令清单 + +当前 dacli `schedule` 父命令有 **5 个子命令**: + +| 子命令 | 完整语法 | 用途 | 实现状态 | +|--------|---------|------|----------| +| **list** | `dacli schedule list [--json]` | 列定时任务 | 部分实现 (JNPF 6.2 端点 bug) | +| **info** | `dacli schedule info --id= [--json]` | 查任务详情 (cron/executeContent/enabledMark) | ✅ 完整 | +| **create** | `dacli schedule create --fullName=X --enCode=Y --executeType=Z --executeContent=W [--cron=C] [--json]` | 新建 Quartz cron 任务 | ✅ 完整 | +| **log** | `dacli schedule log --id= [--json]` | 查执行日志 (id/runTime/runResult) | ✅ 完整 | +| **trigger** | `dacli schedule trigger --id=` | 手动触发 (白名单) | ✅ 完整 | + +**缺失的关键子命令**: +- `update` (修改 cron/executeContent/enabledMark) +- `delete` (删除任务) +- `pause/resume` (暂停/恢复 - JNPF 后端有 enabledMark 但无专用端点) +- `start/stop` (启动/停止) +- `selector` (下拉选择器, 用于 AI 选择任务 ID) + +## 2. web 端对应 + +**真正的定时任务 API**: +- 文件: `web/apps/jnpf-web-apps-main/src/api/system/task.ts` +- 基础路径: `/api/scheduletask` +- 函数: `getTaskList / create / update / getInfo / delTask / getTaskLogList / getTaskMethodsList` + +**注意**: web 端有 **两个** Schedule 模块, 容易混淆: +1. `/api/system/Schedule` (web apps `views/teamwork/schedule/`) — **日历日程** (startTime/endTime), 不是 cron +2. `/api/scheduletask` (web apps `api/system/task.ts`) — **Quartz cron 任务** ✅ (dacli 当前用的) + +**web 端可用的完整 API 列表**: +``` +GET /api/scheduletask → getTaskList (分页) +POST /api/scheduletask → create +PUT /api/scheduletask/{id} → update ⭐ dacli 缺失 +GET /api/scheduletask/Info/{id} → getInfo +DELETE /api/scheduletask/{id} → delTask ⭐ dacli 缺失 +GET /api/scheduletask/{id}/TaskLog → getTaskLogList +GET /api/scheduletask/TaskMethods → getTaskMethodsList (Quartz class 列表) +POST /api/scheduletask/white/trigger → trigger (dacli 已有, web 端无对应函数) +``` + +## 3. 改/删/留 建议 + +### [KEEP] 现有 5 个命令全部保留 +- list: 保留 (即使 JNPF 6.2 GET 端点 bug, 仍提供 web 端引导) +- info: 保留 (单点查, 替代 list 的兜底方案) +- create: 保留 (核心功能) +- log: 保留 (调试关键) +- trigger: 保留 (调试关键) + +### [REFACTOR-WEBAPI] P0 重点 +**新建 `src/webapi/schedule.ts`** 镜像 web 端 7 个 API 函数: +- 所有 5 个命令都是手工调用, 与 dacli v0.11+ 架构不符 +- 跟 web 端自动同步 + 代码减少 50% + +### [NEW-CMD] P0 (立即补) +1. **`schedule update --id=X --cron=Y --executeContent=Z [--enabledMark=0|1]`** + - 当前 AI 修改 cron 表达式只能 delete + create, 不安全 (会丢任务 ID 关联) +2. **`schedule delete --id=X`** + - 删除任务是基本 CRUD 闭环, AI 调试常需 + +### [NEW-CMD] P1 +3. **`schedule selector`** + - 类似 form selector, AI 交互式选择任务 ID + +### [NEW-CMD] P2 (不建议单独建) +4. **`schedule pause/resume`** — 用 `update --enabledMark=0/1` 替代 +5. **`schedule start/stop`** — JNPF 无 start/stop API, 不建议建 + +## 4. AI 痛点评估 + +### 调试"定时任务不执行"路径: ⭐⭐⭐⭐ (4/5) +``` +Step 1: dacli schedule info --id=X → 确认 cron 表达式 +Step 2: dacli schedule log --id=X → 看最近执行结果 (runResult) +Step 3: dacli schedule trigger --id=X → 手动触发一次 +Step 4: dacli schedule log --id=X → 看手动触发结果 +``` + +**痛点**: +- 缺 `update`, AI 修改 cron 必须重建 (有 enCode 冲突风险, BS-49) +- list 端点 bug 需提示用户去 web 端拿 ID + +### 与 monitor 命令关系 +- `schedule log` 提供任务级日志 +- `monitor` 应提供平台级监控, 但 JNPF 后端没有专门的"调度日志监控"端点 +- 建议: 在 `schedule log` 的 `--ai-help` 提示平台级监控的局限 + +### 架构一致性 +- ❌ **未走 webapi 架构**: 5 个命令全是手工 JnpfClient 调用, 是 24 父命令中少数未镜像的 +- ✅ **三层防御兼容**: 现有 5 个命令都有 `--ai-help`/`--source`/`--example` +- ✅ **决策 9 注释完整**: schedule 与 workflow 区别明确 (定时 vs 审批) + +--- + +**核心结论**: dacli schedule 有 5 个子命令 (list/info/create/log/trigger), 覆盖核心 CRUD 但**缺 update + delete 两个 P0 命令**, 且**未走 v0.11+ webapi 镜像架构**. + +**3 个最关键建议**: +1. **[P0] 新建 `src/webapi/schedule.ts`** — 镜像 `web/api/system/task.ts`, 现有 5 命令重构走 webapi +2. **[P0] 新增 `schedule update/delete`** — 补齐 CRUD 闭环 +3. **[P1] 新增 `schedule selector`** — AI 友好交互, 类似 form selector + +**不建议做的事**: +- ❌ 不建议补 `pause/resume/start/stop` — JNPF 无对应 API +- ❌ 不建议把 `schedule log` 移到 `monitor` — 数据源不同 diff --git a/docs/cmd-review/storage.md b/docs/cmd-review/storage.md new file mode 100644 index 0000000..b66dff3 --- /dev/null +++ b/docs/cmd-review/storage.md @@ -0,0 +1,63 @@ +# dacli `storage` 命令审计报告 (2026-06-25) + +## 1. 命令清单 (7 个子命令) + +| # | 命令 | 用途 | +|---|------|------| +| 1 | `dacli storage list` `[--profile] [--yml] [--json]` | 列出 application-{profile}.yml 中 file-storage 配置的所有后端 | +| 2 | `dacli storage info ` `[--profile] [--yml] [--json]` | 显示某 platform 的详细配置 (敏感字段脱敏) | +| 3 | `dacli storage test [platform]` `[--profile] [--yml] [--type]` | 测试存储后端连通性 (走 /api/file/Uploader/{type}) | +| 4 | `dacli storage use ` `[--profile] [--yml] [--no-backup]` | 切换 default-platform (备份 + 写 yml + 提示重启) | +| 5 | `dacli storage backup` `[--profile] [--yml]` | 显式备份 application-{profile}.yml | +| 6 | `dacli storage diff` `[--profile] [--yml]` | 跟 git HEAD 对比 yml 变化 | +| 7 | `dacli storage _helpers` | 内部辅助 (yml 解析等) | + +## 2. web 端对应 + +- **JNPF 后端**: `/api/extend/Storage` (POST/GET/PUT/DELETE) + `/api/extend/Storage/{id}/Actions/Upload|Download` +- **dacli 状态**: **无 webapi 镜像** — storage 未在 v0.11+ webapi/ 模块列表 +- **Web UI**: jnpf 6.x 不开放存储配置 UI (走 yml) +- **文件操作层**: `web/.../api/core/common.ts` 已实现 `/api/file/Uploader/{type}` (upload/preview/download/merge/packDownload) + +## 3. 改/删/留 建议 + +### [KEEP] 保留 (6 个全部) +- list, info, use, backup, diff — AI 调试核心 +- test — 连通性验证必需 + +### [REFACTOR-WEBAPI] P1 必做 +新增 `src/webapi/storage.ts`, 镜像 web 端 `/api/extend/Storage` CRUD (优先级 P1) +- 当前走纯 yml 方案, AI 调试需了解 spring yml 结构 + +### [NEW-CMD] **P0 严重缺失** (5 个命令) + +1. **`storage create/update/delete` (P0 严重)** — 当前 AI 无法添加/修改/删除 platform, 必须手动改 yml +2. **`storage upload/download/ls` (P0 严重)** — 文件上传/下载无 CLI 入口, 阻塞附件调试和迁移场景 +3. **`storage types` (P2)** — 列出所有 backend-type (7+ 种), 当前需看源码才能知道支持哪些后端 + +### [DEPRECATE] 无 + +## 4. AI 痛点评估 + +### 痛点 1 (最严重): 创建新 platform 完全缺失 +- AI 初始化新存储后端场景被阻塞, 无法独立完成 + +### 痛点 2 (严重): 文件上传/下载无 CLI 入口 +- 附件调试场景完全阻塞 + +### 痛点 3 (中等): 7 子命令完整度 50% +- CRUD 0/4 + 文件操作 0/3 +- 对比 menu/user 缺乏完整性 + +### webapi 镜像缺失影响 +- AI 调试需深入 spring yml, 启动 JNPF 才能验证 +- 不如其他 webapi 镜像命令即时 + +--- + +**核心结论**: storage 命令族当前可用率 50%, 缺 CRUD 和文件操作; AI 在初始化新存储和文件调试场景完全阻塞. + +**3 个最关键建议**: +1. **P0 必做 (5-6 天)**: storage create/update/delete + storage upload/download/ls +2. **P1 推荐 (1-2 天)**: 新增 webapi/storage.ts 镜像 +3. **P2 可选**: storage types + list/info 默认 JSON 输出 diff --git a/docs/cmd-review/user.md b/docs/cmd-review/user.md new file mode 100644 index 0000000..eca81a5 --- /dev/null +++ b/docs/cmd-review/user.md @@ -0,0 +1,306 @@ +# 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 ` — 查单个用户详情** [优先级: 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 ` — 反向查用户角色** [优先级: P1] +- **理由**: 镜像 `role assign` 链路 (user→role 反向) +- **API**: `GET /api/permission/Users/{id}/Role` (需 web 端确认) +- **痛点**: 查用户有哪些角色, 权限三角评估基础 +- **替代方案**: 配合 `role list --userId=` + +**4. `user import ` — 批量导入用户** [优先级: P1] +- **理由**: web 端支持 Excel 导入 (`importData`) +- **痛点**: 创建测试用户 (10+) 效率极低 +- **API**: `POST /api/permission/Users/ImportData` +- **实现**: 支持 --file + --preview 预览 + +**5. `user login-log` — 查用户登录日志** [优先级: P2] +- **理由**: 审计需求, web 端有登录日志页 +- **痛点**: 排查登录问题时无 CLI 入口 +- **API**: `GET /api/system/Log/login?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 ` (反向查) +- **现有链路**: `role assign --userId= --roleId=` (单方向) +- **建议**: 增加反向查询, 提升决策质量 + +#### user → org (强制绑) +- **现状**: 完美, create 时 --organizeId 必填 +- **支持链**: `org list → user list --keyword=` 交叉查 + +#### user → position (多岗位) +- **现状**: get-position + set-position 完整 +- **批量**: batch-set-position 支持 + +### 缺基础命令痛点 (关键) + +**痛点 1**: 无 `info ` +- **场景**: 已知 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 ` 和 `user selector` +3. **P1**: 新增 `user roles ` (反向查) +4. **P1**: 新增 `user import ` (CSV) +5. **P2+**: 根据反馈再决定 login-log / authorize + +**预期收益**: +- webapi 化: 维护成本 -50%, API 跟随 web 自动更新 +- info/selector: AI 查询效率 +200% +- import: 批量场景效率 +1000% + diff --git a/docs/cmd-review/workflow.md b/docs/cmd-review/workflow.md new file mode 100644 index 0000000..4f2d477 --- /dev/null +++ b/docs/cmd-review/workflow.md @@ -0,0 +1,250 @@ +# dacli workflow 命令审计 (v0.11+) + +## 1. 命令清单 + +| 命令 | 别名 | API | 用途 | +|------|------|-----|------| +| `workflow list` | - | `GET /api/workflow/template` 或 `/api/workflow/operator/List/{type}` | 流程模板列表 / 我的待办 (--todo=1/2/3) | +| `workflow create` | - | `POST /api/workflow/template` | 新建流程模板 (--ai 走平台 LLM) | +| `workflow launch` | - | `POST /api/workflow/task` | 发起流程实例 (formId + flowId + data) | +| `workflow approve` | - | `POST /api/workflow/operator/Audit/{operatorId}` | 审批 (status: 0同意/1不同意/2退回) | +| `workflow selector` | `select` | `web getFlowSelector` | 流程模板下拉框 (菜单挂工作流必跑) | +| `workflow decision` | - | `GET /api/workflow/template/{id}/DecisionParameter` | 决策流参数 (5.6.5 漏斗/覆盖/规则集等) | + +公开命令: 6 个 (list/create/launch/approve/selector/decision) + +--- + +## 2. web 端对应 + +### 2.1 web API 文件结构 + +- **`web/.../api/workFlow/template.ts`** (138 行, 25+ 函数) — 流程模板管理 + - `getList/getFlowList/create/update/getInfo/delFlow/copy/exportData/changeType/saveFlow/getFlowInfo/getVersionList/delVersion/copyVersion/upDownShelf` + - `getFlowSelector/getTreeList/getFlowEngineListByIds/getCollectFlowList/setCollectFlow/getSubFlowUserList` + - `getDecisionParameter/getCommentList/createComment/delComment/getWebhookUrl/getWebhookParams/webhookStart/getAiInfo` + +- **`web/.../api/workFlow/task.ts`** (181 行, 35+ 函数) — 流程运行时 + - `getFlowLaunchList/getFlowTaskInfo/create/update/delFlowLaunch/launchRecall/revoke/press/getLogList` + - `getFlowBeforeList/batchSign/sign/cancelSign/batchHandle/handle/audit` + - `transfer/assist/batchOperation/getBatchCandidate` + - `freeApprover/reduceApprover/saveAudit/saveAssist/auditRecall/back/getBackNodeCodeList` + +- **`web/.../api/workFlow/flowMonitor.ts`** (51 行, 11 函数) — 流程监控 + - `getFlowMonitorList/delMonitorList/getLogList/cancel/assign/resurgence/getPauseType/pause/reboot/getFlowTodoCount/getFlowTodoList` + +- **`web/.../api/workFlow/flowDelegate.ts`** (42 行, 10 函数) — 流程委托 + - `getFlowDelegateList/create/update/getInfo/del/getDelegateUser/stop/getFlowDelegateInfo/notarize` + +### 2.2 JNPF 后端 API 路由 + +- 模板管理: `POST /api/workflow/template` `PUT /api/workflow/template/{id}` `DELETE /api/workflow/template/{id}` +- 流程实例: `POST /api/workflow/task` `PUT /api/workflow/task/{id}/Recall/{id}` +- 审批操作: `POST /api/workflow/operator/Audit/{operatorId}` `Transfer` `AddSign` `ReduceApprover` +- 决策流: `GET /api/workflow/template/{id}/DecisionParameter` +- 委托: `POST /api/workflow/delegate` `PUT /api/workflow/delegate/{id}/Stop` +- 监控: `POST /api/workflow/monitor/Cancel/{id}` `Pause` `Reboot` `Assign` + +--- + +## 3. 改/删/留 建议 + +### 3.1 [KEEP] — 保留命令 + +| 命令 | 价值 | 改进 | +|------|------|------| +| `workflow list` | AI 看流程模板 / 我的待办 | 仍用 c.get, 建议 REFACTOR-WEBAPI | +| `workflow create` | AI 核心场景, --ai 走 LLM | v0.11 已对齐后端字段 | +| `workflow launch` | AI 端到端 (form → workflow) | 依赖 BS-44 bindFlow 闭环 | +| `workflow approve` | AI 审批场景 | 缺批量 + 转办/委派, 需补充 | +| `workflow selector` | v0.11+ 已 webapi | 新范式典型 | +| `workflow decision` | 5.6.5 决策流参数 | 只读, 写更新留 v0.10+ | + +### 3.2 [REFACTOR-WEBAPI] — 切换 webapi + +| 命令 | 现状 | 建议 | 理由 | +|------|------|------|------| +| `list` | c.get 手写 URL | `loadWorkflow.getList` 或 `getFlowSelector` | selector 已 webapi, list 应一致 | +| `approve` | c.postJson 手写 | `loadWorkflow.audit(id, data)` 或 task.ts | 复杂审批 API 多, webapi 统一 | +| `decision` | c.get 手写 | `loadWorkflow.getDecisionParameter` | webapi 已有, 切一致性 | +| `launch` | c.postJson 手写 | webapi 应补 task.ts (useUserStore 限制) | 需决策是否 shim useUserStore | + +### 3.3 [DEPRECATE] — 标记废弃 + +**无**: 当前 6 个命令均有 AI 场景, 不建议删除 + +### 3.4 [NEW-CMD] — 新增命令 (按优先级) + +#### 优先级 P0 (核心) + +1. **`workflow info `** — 流程模板详情 + - API: `GET /api/workflow/template/{id}` (web getInfo) + - 场景: AI 创建流程后查看 flowNodes/flowConfig/flowXml 完整 schema + +2. **`workflow update `** — 修改流程模板 + - API: `PUT /api/workflow/template/{id}` (web update) + - 场景: AI 调整流程 (改 flowNodes, 改分类), 修复错误流程 + +3. **`workflow delete `** — 删除流程模板 + - API: `DELETE /api/workflow/template/{id}` (web delFlow) + - 场景: AI 清理测试流程 + +4. **`workflow tasks`** — 我的待办 (细分) + - API: `GET /api/workflow/operator/List/{1|2|3}` (web getFlowBeforeList) + - 场景: AI 审批前查 todo, 区分 list --todo=1 + +#### 优先级 P1 (常用) + +5. **`workflow done`** — 已审批查询 (type=2) + +6. **`workflow transfer `** — 转办 + - API: `POST /api/workflow/operator/Transfer/{operatorId}` (web transfer) + +7. **`workflow delegate `** — 委派 + - API: `POST /api/workflow/operator/Assist/{operatorId}` (web assist) + +8. **`workflow recall `** — 撤回发起 + - API: `PUT /api/workflow/task/Recall/{taskId}` (web launchRecall) + +9. **`workflow revoke `** — 撤销流程 + - API: `PUT /api/workflow/task/Revoke/{taskId}` (web revoke) + +10. **`workflow copy `** — 复制流程 + - API: `POST /api/workflow/template/{id}/Actions/Copy` (web copy) + +11. **`workflow version `** — 流程版本管理 + - API: getVersionList/copyVersion/delVersion/upDownShelf + - 场景: AI 版本切换 (生产/灰度) + +#### 优先级 P2 (边缘) + +12. **`workflow export `** — 导出 (web exportData) +13. **`workflow import `** — 导入 +14. **`workflow monitor `** — 监控 (pause/cancel/reboot) +15. **`workflow delegate-config`** — 委托规则配置 (web flowDelegate.ts) + +--- + +## 4. AI 痛点评估 + +### 4.1 form bindFlow 闭环 (BS-44 / D-7) + +**现状**: form.bindFlow 走三步 API (PUT form + PUT workflow + Release), 但 backend PUT workflow onLineformId 不一定落库, 完整绑定可能仍需 web UI。 + +**痛点**: AI 创建 form → launch workflow 可能报"流程未绑定", BS-44 风险仍在。 + +**建议**: 加 --verify 标志验证绑定, 文档明示局限。 + +### 4.2 selector 闭环 vs 其他 + +**selector** ✓ (闭环): webapi 已切, AI `dacli workflow selector --json` 拿模板列表传给 menu.create, 完美闭环。 + +**list** ✗ (半闭环): 仍用 c.get 手写, selector 已 webapi, list 应一致。 + +**launch** ✗ (盲点): 依赖 form.enableFlow + flowId, 但 bindFlow 可能不完整。 + +### 4.3 AI 审批场景 + +**现状**: workflow approve 存在 (单审批), workflow tasks (我的待办) 缺。 + +**缺失**: +1. 转办 (transfer) — AI 委托代理无命令 +2. 委派 (delegate/assist) — AI 多人协办无命令 +3. 加签/减签 (freeApprover/reduceApprover) — AI 动态调整审批人无命令 +4. 批量审批 (batchOperation) — AI 批量处理无命令 + +**建议**: 至少补 transfer + delegate (P1), 加签减签 P2。 + +### 4.4 流程版本管理 + +**现状**: web template.ts 有 getVersionList/copyVersion/delVersion/upDownShelf (10+ 函数), dacli 完全无版本管理命令。 + +**业务场景**: AI 创建流程 → 上线 v1 → 调整 → 上线 v2 (灰度), web 走 tdp_workflow_template.version 字段。 + +**建议**: P1 加 workflow version 命令 (list/add/del/switch), P2 加 up-down-shelf。 + +### 4.5 决策流闭环 + +**现状**: decision 命令只读, AI 决策流配置需解析 FlowConfigModel + 跟现有 flowConfig 合并。 + +**建议**: 短期保留只读, --list 加缓存; 长期 v0.12+ 加 update 支持。 + +### 4.6 运行时 API (task.ts) 加载 + +**现状**: webapi/workflow.ts 只加载 template.ts (25+ 函数), task.ts 未加载因为 useUserStore 依赖。 + +**影响**: workflow runtime (launch/approve/recall) 走手写 c.postJson, 维护成本高。 + +**建议**: 中期 shim useUserStore 后加载 task.ts, 决策点: 是否值得为 task.ts 增加 shim 复杂度? + +--- + +## 5. 优先级矩阵 + +| 命令 | 当前状态 | 改/留 | 优先级 | 理由 | +|------|---------|-------|--------|------| +| `list` | c.get 手写 | REFACTOR-WEBAPI | P1 | selector 已 webapi, 应一致 | +| `create` | webapi 待加 | 保留 + webapi | P1 | 核心, AI 创建高频 | +| `launch` | c.postJson 手写 | 保留 (考虑 webapi) | P1 | 核心, BS-44 风险 | +| `approve` | c.postJson 手写 | REFACTOR-WEBAPI | P1 | 复杂 API 多, webapi 统一 | +| `selector` | webapi ✓ | 保留 | - | 新范式 | +| `decision` | c.get 手写 | REFACTOR-WEBAPI | P2 | webapi 已有 | +| `info ` | 缺 | NEW-CMD | P0 | AI 创建后查看 schema | +| `update ` | 缺 | NEW-CMD | P0 | AI 修改流程 | +| `delete ` | 缺 | NEW-CMD | P0 | AI 清理 | +| `tasks` | 部分 (list --todo) | NEW-CMD | P0 | 细分语义 | +| `done` | 部分 (list --todo=2) | NEW-CMD | P1 | 独立语义 | +| `transfer` | 缺 | NEW-CMD | P1 | AI 转办 | +| `delegate` | 缺 | NEW-CMD | P1 | AI 委派 | +| `recall` | 缺 | NEW-CMD | P1 | AI 撤回 | +| `revoke` | 缺 | NEW-CMD | P1 | AI 撤销 | +| `copy` | 缺 | NEW-CMD | P1 | AI 复制修改 | +| `version` | 缺 | NEW-CMD | P1 | AI 版本管理 | +| `export` | 缺 | NEW-CMD | P2 | AI 导出 | +| `import` | 缺 | NEW-CMD | P2 | AI 导入 | +| `monitor` | 缺 | NEW-CMD | P2 | AI 管理员介入 | +| `delegate-config` | 缺 | NEW-CMD | P2 | AI 委托规则配置 | + +--- + +## 6. 实施路线图 + +### Phase 2A (立即, 2-3 天) +1. REFACTOR-WEBAPI: list/decision/approve 切 webapi/workflow.ts +2. NEW-CMD P0: info/update/delete (3 个基础 CRUD) +3. 文档同步: BS-44/bindFlow 闭环说明 + +### Phase 2B (短期, 5-7 天) +1. NEW-CMD P0: tasks/done (细分 list --todo) +2. NEW-CMD P1: transfer/delegate/recall/revoke (4 个审批操作) +3. task.ts shim 评估 (useUserStore mock) + +### Phase 2C (中期, 7-10 天) +1. NEW-CMD P1: copy/version (流程版本管理) +2. NEW-CMD P2: export/import (BPMN 导入导出) +3. monitor 命令 (管理员场景) + +--- + +## 7. 总结 + +dacli workflow 命令 **6 个公开 + decision** 已覆盖核心 (模板/发起/审批/决策), 但相对 web API (70+ 函数) 覆盖严重不足: + +**强项**: +- selector 已 webapi 化 (新范式典型) +- create --ai 走平台 LLM (白皮书 5.10.3) +- bindFlow BS-44 已文档化 + +**弱点**: +- 6 命令中 4 个仍走 c.get/postJson 手写, webapi 一致性差 +- 缺核心 CRUD: info/update/delete (web 有, dacli 无) +- 缺审批闭环: transfer/delegate/recall/revoke (web 有 10+ 审批操作) +- 缺版本管理: version/copy (web 有, 业务高频) +- form bindFlow 闭环仍存 BS-44 风险 + +**关键改进 (Top 5)**: +1. **REFACTOR-WEBAPI**: list/decision/approve 切 webapi (一致性) +2. **NEW-CMD P0**: info/update/delete (基础 CRUD) +3. **NEW-CMD P0**: tasks (细分我的待办) +4. **NEW-CMD P1**: transfer/delegate (审批闭环) +5. **NEW-CMD P1**: version (版本管理)