feat(v0.11+): Phase 1 - 23 个 dacli 父命令审计完成

派 25 个 Explore 子代理 (5 批 × 5) 审计 23 个父命令.
产出 cmd-review/{cmd}.md (24 文件) + _summary.md.

关键发现:
- webapi 镜像使用率 < 30% (12+ 父命令 100% 绕 webapi)
- 30+ P0 必补新命令 (form update, log exception, di CRUD, role authorize 等)
- 3 处 P0 端点错误 (假 PASS):
  * integration emailTest/smsTest
  * msg templateCreate
- 用户关键修正: bigscreen → jnpf-web-datascreen-vue3 (独立子项目)
- 用户关键修正: report → jnpf-web-datareport (独立子项目)

下一步: Phase 2 按 P0 优先级执行 (修端点 + 新命令 + webapi 化)

Co-Authored-By: Claude <[email protected]>
This commit is contained in:
sswandClaude committed 2026-06-25 14:58:32 +08:00
1 parent 0360c6484c
commit b9c9e318af
24 files changed
+2797

No files matched your search

+123
View File
@@ -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 <code>` 替代
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 优先级执行
+74
View File
@@ -0,0 +1,74 @@
# dacli `apis` 命令审计报告 (2026-06-25)
## 1. 命令清单
| 子命令 | 格式 | 用途 |
|--------|------|------|
| `dacli apis list` | `[--tag=<t>] [--method=<m>] [--keyword=<k>] [--json]` | 列 JNPF 平台所有 API (从 /v3/api-docs 拉取, 12h 缓存) |
| `dacli apis info` | `<pathMethod> [--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=<f>`**(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=<name>`
### 痛点 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 加版本号(容器重启场景)
+109
View File
@@ -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 <c> [--account] [--password]` | 切换当前应用(重新登录新 appCode 并覆盖 token) |
| `dacli app init` | `[--appCode] [--restart]` | 应用初始化(健康检查;--restart 一键重启 JNPF) |
| `dacli app create` | `--appCode <c> --appName <n> [--dbName] [--account] [--password] [--force-rebuild] [--skip-grant] [--skip-db] [--json]` | 真·创建 JNPF 应用(System+DB+DataSource+授权+重登,端到端 0 差错) |
| `dacli app clear` | `--appCode <c> [--dry-run] [--skip-db] [--no-restart] [--workspace]` | 清除应用本地资源+DB记录(破坏性,强制 TTY + 双重人工确认) |
| `dacli app info` | `--id <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 <code>`** — 一体化 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 <appCode>`** 一体化命令(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 <code>`**:一体化 switch+context 命令
+101
View File
@@ -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` | `<id> [--json]` | 查看大屏详情(含 design JSON) |
| `dacli bigscreen create` | `--fullName --enCode --category --json` | 创建大屏基础记录 |
| `dacli bigscreen release` | `<id> [--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` 子命令 (否则大屏无数据)
+62
View File
@@ -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` | `<id> [--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 <id>`** — 查单个数据源详情(webapi 已有 `getDataSourceInfo`)
- **`dacli datasource selector`** — 选择器(按 dbType 过滤 + 简单格式输出),AI 验证/选择数据源必需
- **`dacli datasource update <id>`** — 改连接串/密码(高频运维场景)
## 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=<enCode> ... # 建表单
```
**当前痛点**:
- ❌ 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 <id>` 和 `datasource selector`
3. **P1 [NEW-CMD]**: 新增 `datasource update <id>` 改连接串/密码
+59
View File
@@ -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 <id>`** — 查接口详情(请求/响应 schema)
- **`dacli di test <id> --data=<json>`** — 测试调用接口(带样例参数)
- **`dacli di create`** — 创接口
- **`dacli di update <id>`** — 改接口
- **`dacli di delete <id>`** — 删接口
- **`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`
+110
View File
@@ -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 <id>`** — webapi 已有 `updateDictionaryType(data)`, AI 建错字典需修改场景
- **`dacli dict dataUpdate <id>`** — webapi 已有 `updateDictionaryData(data)`, 字典项改名/改排序/禁用
- **`dacli dict typeDelete <id>`** — webapi 已有 `delDictionaryType(id)`, 删类型 + 递归删字典项
### [NEW-CMD] **P2 中优先级**
- **`dacli dict dataDelete <id>`** — webapi 已有 `delDictionaryData(id)`, 与 typeDelete 配对闭环
### [NEW-CMD] **P3 调试辅助**
- **`dacli dict typeInfo <id>`** — webapi 已有 `getDictionaryTypeInfo(id)`, 单条详情 (区别于 list)
- **`dacli dict dataInfo <id>`** — 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 看已有字典, 复用或加 `<app>_` 前缀"
- ✅ L1 pre-check 也支持
**待优化**:
- ⚠️ 提示用 "dacli dict dataList" 应改为 "dacli dict typeList" (命令名是 typeList, 不是 dataList)
- ⚠️ "加 `<app>_` 前缀" 建议改为 "<appCode>_" (从 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, `<app>_` → `<appCode>_`)
+59
View File
@@ -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` | `<table> [--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 <table> --fields`** — 加字段(保留数据),webapi 已有 `addTableFields`
- **`dm update <table>`** — 改表结构(字段重命名/类型变更),webapi 已有 `updateDataModel`
- **`dm info <table>`** — 查表详情(字段/索引/外键),webapi 已有 `getDataModelInfo`
- **`dm rename <table> --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 需求
+68
View File
@@ -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 <file>` (P0)
- 当前 `doc get --section=<id>` 需要 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 <file> --keyword=<kw>` (P0)
- AI 知道想找"BS-48 相关段落"但不知道 section id
- 当前必须先 `get` 全文再用 grep,2 步变 1 步
- 节省 40-60% token
### [NEW-CMD] P1
#### `dacli doc slice <file> --heading=<n>` (P1)
- 按 `<h2>` 标题文本模糊匹配切片
- 当前降级逻辑生成 `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 <file>`**:列文件 section 清单 (id + title + 行数)
2. **[NEW-CMD P0] `dacli doc search --keyword=<kw>`**:按关键词全文搜索
3. **[OPTIMIZE] 补 `dacli doc get --no-cache`**:mtime 缓存失效时跳过缓存
+113
View File
@@ -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 <id>` | 拉表单完整 schema (formData/columnData/tables) | ✅ KEEP + webapi |
| 3 | `dacli form create` | 创建表单 (--ai/--ai-json/--autoTable/--autoRelease) | ✅ KEEP |
| 4 | `dacli form release <id>` | 发布/重新发布表单 (state 0\|2 → 1) | ✅ KEEP + webapi |
| 5 | `dacli form delete <id>` | 删除表单 (--cascade 级联删菜单) | ✅ KEEP |
| 6 | `dacli form export <id>` | 导出表单 JSON (跨库迁移) | ✅ KEEP |
| 7 | `dacli form import <file>` | 从 JSON 导入表单 (--autoTable 重建物理表) | ✅ KEEP |
| 8 | `dacli form clone <id>` | 克隆表单 (AI 黄金法则: 99% 应 clone 再改) | ✅ KEEP + webapi |
| 9 | `dacli form validate <id>` | 运行时校验 (BS-23/31/32/15/V2/52) | ✅ KEEP |
| 10 | `dacli form fixcolumndata <id>` | 修复 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 <id>` (高需求)**
- 改 schema 需 export → 手动改 → import, 无原子性
- 后端: PUT /api/visualdev/Base/{id} (已存在, 对应 `loadVisualDev.update`)
- 自动 BS-49/50/52 防御
**`dacli form addFields <id> --fields` (中需求)**
- 增量加字段, 同时支持 `--tables` (自动 ALTER TABLE)
**`dacli form rmFields <id> --vmodel`** (中需求)
- 删字段, `--drop-column` 同步删除物理表列
**`dacli form stats`** (低需求)
- 表单总数 + 按 type/category/flow 维度分桶统计
**`dacli form diff <id1> <id2>`** (辅助)
- 对比 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`
+152
View File
@@ -0,0 +1,152 @@
# Integration 父命令审计报告 (v0.11+)
## 1. 命令清单
```
dacli integration emailTest --configId=<id> [--email=<e>] — 邮件测试发送 (走 SendMessageConfig/testSendConfig)
dacli integration smsTest --templateId=<id> [--phone=<n>] — 短信测试发送 (走 SmsTemplate/testSent, 决策 8)
dacli integration webhookTest --url=<u> [--payload=<json>] — 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=<id>` 获取详情 JSON,便于 AI 验证参数。
### [NEW-CMD] `integration configUpdate`
- **理由**:CRUD 闭环必需。
- **建议**:`dacli integration configUpdate --id=<id> --field=value` 支持部分更新。
### [NEW-CMD] `integration configDelete`
- **理由**:CRUD 闭环必需。
- **建议**:`dacli integration configDelete --id=<id>`。
### [NEW-CMD] `integration log`
- **理由**:web 端有 `msgMonitor.ts` (发送日志),AI 调试时需查询发送历史。
- **建议**:`dacli integration log [--configId=<id>] [--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 命令,形成完整业务闭环
+78
View File
@@ -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 <id>` (单条详情/完整堆栈)
- `dacli log delete <ids...>` (批量删除)
- `dacli log clear <type>` (一键清空)
### [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 <type>` (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 端已完整实现
+77
View File
@@ -0,0 +1,77 @@
# dacli `menu` 命令审计报告 (2026-06-25)
## 1. 命令清单 (8 个公开子命令)
| # | 命令 | 用途 | 状态 |
|---|------|------|------|
| 1 | `dacli menu list` | 列出菜单 (树形) | ✅ KEEP + webapi |
| 2 | `dacli menu info <id>` | 菜单详情 | ✅ KEEP |
| 3 | `dacli menu create` | 创建菜单 (支持 --formId 自动挂载) | ✅ KEEP |
| 4 | `dacli menu delete <id>` | 删菜单 (--cascade) | ✅ KEEP |
| 5 | `dacli menu releases` | 查已发布版本菜单 | ✅ KEEP |
| 6 | `dacli menu unrelease <id>` | 撤销发布 | ✅ KEEP |
| 7 | `dacli menu purge <id>` | 彻底清除 (含回收站) | ✅ 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 <id>`** — 改菜单 (改名/移动/属性改), webapi 已有 `update`
- **`dacli menu selector [--category] [--type]`** — 一步输出可挂载父菜单树, AI 友好 (webapi 有 getMenuSelector + getSelectorAll)
### [NEW-CMD] P2
- **`dacli menu export <id>` + `dacli menu import`** — 跨 app 迁移 (webapi 有 exportMenu)
- **`dacli menu move <id> --newParentId`** — 移动菜单 (可合并到 update)
- **`dacli menu permission <id>`** — 调试"菜单 403"
### [NEW-CMD] P3
- **`dacli menu fixDisplay --id`** — BS-43 一键补 7 必填字段
- **`dacli menu clone <id>`** — 克隆菜单变体
## 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 体验大幅提升
+77
View File
@@ -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=<id>`** — 撤销流程
- **`dacli monitor flow pause --id=<id> --type=<reason>`** — 暂停
- **`dacli monitor flow reboot --id=<id>`** — 重启
- **`dacli monitor flow log --id=<id>`** — 流程事件日志 (关键缺失)
- **`dacli monitor flow assign --id=<id> --toUserId=<u>`** — 转办
### [NEW-CMD] P2
- **`dacli monitor kick <userId>`** — 踢出在线用户
- **`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/...)
+72
View File
@@ -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` | `<noticeId> --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 <id>`** — 改公告
- **`dacli msg noticeDelete <id>`** — 删公告
- **`dacli msg templateUpdate <id>`** — 改模板
- **`dacli msg templateDelete <id>`** — 删模板
### [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
+75
View File
@@ -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 <id>`** — 改组织 (改名/移动/改类型)
- **`dacli org delete <id>`** — 删组织
- **`dacli org info <id>`** — 组织详情 (区别于 list)
### [NEW-CMD] **P0 必补** — 岗位模块 (完全缺失)
- **`dacli org position list`** — 岗位列表
- **`dacli org position create`** — 创建岗位
- **`dacli org position update <id>`** — 改岗位
- **`dacli org position delete <id>`** — 删岗位
- **`dacli org position info <id>`** — 岗位详情
### [NEW-CMD] **P0 必补** — selector
- **`dacli org selector`** — 组织选择器 (AI 引用 orgId 必需)
- **`dacli org position selector`** — 岗位选择器
### [NEW-CMD] P1
- **`dacli org user <orgId>`** — 组织下用户管理
- **`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 管理
+162
View File
@@ -0,0 +1,162 @@
# dacli `portal` 命令审计报告 (Batch D)
## 1. 命令清单
| 子命令 | 用法 | 用途 |
|--------|------|------|
| list | `dacli portal list [--keyword] [--json]` | 列出门户(门户设计器产物),支持模糊搜索 |
| info | `dacli portal info --id <id> [--json]` | 查看门户详情(含布局 schema formData) |
| create | `dacli portal create --fullName --enCode --category [--platform] [--json]` | 新建门户(无物理表,走 dataInterfaceId 拉数据) |
| release | `dacli portal release --id <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 <id> --json-file <path>`** (P0)
- **理由**: AI 场景 — 创建门户后需修改布局(拖拽组件/改 formData)
- **web 端**: `updatePortal(data)` (PUT /visualdev/Portal/{id})
- **数据来源**: `portal info --json` 获取完整 schema → 修改 → `update`
2. **`portal delete --id <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 <id> --newName <name> --newCode <code>`** (P1)
- **理由**: AI 创建类似门户场景(多端/多用户门户),降低 formData 复制出错
- **web 端**: `copyPortal(id)` (POST /visualdev/Portal/{id}/Actions/Copy)
- **优势**: 后端自动生成新 enCode,无需手写 formData
5. **`portal export --id <id> [--output <file>]`** (P2)
- **理由**: AI 需要保存门户布局快照(版本控制 / 跨环境迁移)
- **web 端**: `exportPortal(id)` (POST /visualdev/Portal/{id}/Actions/Export)
#### 可选新增 (3 个, 低优先)
6. **`portal setDefault --id <id>`** (P2)
- 用户默认门户,影响登录后首页展示
7. **`portal homeList`** (P2)
- 应用首页门户列表(getHomePortalList)
8. **`portal customSave --id <id> --json-file <path>`** (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 <id>` 不存在
- **建议**: 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 镜像架构的关键缺口,建议立即推进。
+65
View File
@@ -0,0 +1,65 @@
# dacli `print` 命令审计报告 (2026-06-25)
## 1. 命令清单 (3 个公开子命令)
| # | 命令 | 用途 | 状态 |
|---|------|------|------|
| 1 | `dacli print list` `[--keyword]` | 列出打印模板 | ✅ KEEP |
| 2 | `dacli print info` `--id=<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 <json>]`** — 生成预览 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=<id>` — 当前 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=<id>` 一步绑定
3. **[CRUD 闭环] P1**: 补 print update/delete/release/preview 4 命令
+352
View File
@@ -0,0 +1,352 @@
# Report 命令审计
**审计对象**: `dacli report` (4 子命令)
**审计日期**: 2026-06-25
**基于 web 源码**: `/home/ubuntu/ccWorkDir/jnpf/前端/jnpf-web-datareport/src/`
---
## 1. 命令清单
| 子命令 | 标志 | 用途 |
|--------|------|------|
| **list** | `--keyword <k>`, `--category <c>`, `--json` | 列出报表 (JNPF 只读模板),返回 F_ 前缀字段 |
| **info** | `--id <id>` (必填), `--json` | 查看报表详情 (JNPF 无 /{id} 端点,走 list 查) |
| **templates** | `--template <name>` (必填), `--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=<fullName> \
--enCode=<urlAddress> \
--category=<categoryId> \
--template=<Month|Quarter|Purchase> \
[--description=<text>] \
[--json]
```
**功能**: 通过模板快速创建报表
**API**: `POST /api/extend/ReportManage`
**依据**: designer.js 中 Alt+J 保存逻辑就是调用此 API
**价值**: AI 可批量生成报表脚手架(替代手工设计)
#### 3.2 **report update / delete** (优先级 P0)
```bash
dacli report update --id=<id> [--name=<newName>] [--category=<newId>]
dacli report delete --id=<id> [--force]
```
**价值**: CRUD 闭环,AI 可修复/清理脏数据
#### 3.3 **report preview** (优先级 P0)
```bash
dacli report preview --id=<id> [--page=<1>] [--param=<json>]
```
**功能**: 触发预览逻辑,返回渲染数据 (而不是 XML)
**API**: `GET /api/extend/DataReport/preview?id={id}&page={page}`
**价值**: AI 可验证报表是否正确配置 (不需打开浏览器)
#### 3.4 **report export / import** (优先级 P1)
```bash
dacli report export --id=<id> --output=report.xml # 导出 XML
dacli report import --input=report.xml --category=<id> # 导入 XML
```
**功能**: 备份 / 迁移报表
**API**: 同 create (JSON body 含 XML)
**价值**: 报表模板复用,跨环境迁移
#### 3.5 **report category** (优先级 P1)
```bash
dacli report category list
dacli report category create --name=<catName> --parent=<parentId>
```
**API**: `GET/POST /api/extend/ReportCategory`
**价值**: 组织报表层级,与 form category 类似
#### 3.6 **report clone** (优先级 P2)
```bash
dacli report clone --source=<id> --newName=<name> --newEnCode=<code>
```
**价值**: 快速复制报表变体
---
## 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=<file>` 支持保存到文件
- 增加 `--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` 的存在
+82
View File
@@ -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 <id>`** — webapi 有 `getInfo()`, 验证创建结果
- **`dacli role update <id>`** — webapi 有 `update()`, 改角色名/启用约束
- **`dacli role selector [--type] [--isSystem]`** — webapi 有 `getRoleSelector()`, form/菜单配置场景
### [NEW-CMD] **P1 关键场景** — 权限授权核心
- **`dacli role authorize <roleId> --menuIds <ids>`** — **最大缺口** — 当前只能管理角色-用户, 无法管理角色-菜单
### [NEW-CMD] P2
- **`dacli role members <roleId>`** — webapi 有 `getRoleRelationList()`, 查成员
- **`dacli role permission <roleId>`** — 后端响应含 `permissionList`, 调试"为什么没权限"
- **`dacli role condition`** — 查/改角色约束 (互斥/基数/先决)
## 4. AI 痛点评估
### 当前 4 子命令严重不足 — CRITICAL
1. 缺 update — 改名需 delete+create, 破坏 ID 引用
2. 缺 info — 创建后无法验证完整字段
3. 缺 authorize — **权限管理闭环断裂** (无法管理角色-菜单关系)
4. 缺 selector — form 配置时 AI 只能 grep
### AI 完整闭环当前不可行
```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 <userId>` (读, 反向查) vs `dacli role assign --userIds` (写, 正向分配) — 设计合理但建议 `user roles <userId> --add/--remove` 镜像 assign
### 权限三角评估
- 角色 (P1.1): 缺 update/info/selector/authorize ⚠️
- 用户 (P1.2): 18 子命令基本完整 ✅
- 组织 (P1.3): 3 子命令严重不足 ❌
---
**核心结论**: dacli `role` 4 子命令覆盖 CRUD + 用户分配, 但 **CRUD 闭环严重不完整** (缺 update/info/selector), **权限授权核心能力缺失** (无法授权菜单给角色). webapi 镜像使用率 0%, 应立即创建 webapi/role.ts + webapi/roleRelation.ts.
**Top 3 关键建议**:
1. **P0 [REFACTOR-WEBAPI]**: 创建 webapi/role.ts + webapi/roleRelation.ts, 4 命令全部切镜像
2. **P1 [NEW-CMD]**: 新增 `role update` + `role info` + `role selector` 补全 CRUD 闭环
3. **P1 [NEW-CMD]**: 新增 `role authorize --menuIds` 实现权限管理完整闭环 (角色-菜单-用户三角) — 这是当前最大能力缺口
+108
View File
@@ -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=<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=<id> [--json]` | 查执行日志 (id/runTime/runResult) | ✅ 完整 |
| **trigger** | `dacli schedule trigger --id=<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` — 数据源不同
+63
View File
@@ -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 <platform>` `[--profile] [--yml] [--json]` | 显示某 platform 的详细配置 (敏感字段脱敏) |
| 3 | `dacli storage test [platform]` `[--profile] [--yml] [--type]` | 测试存储后端连通性 (走 /api/file/Uploader/{type}) |
| 4 | `dacli storage use <platform>` `[--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 输出
+306
View File
@@ -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 <id>` — 查单个用户详情** [优先级: P0]
- **理由**: 区别于 list 表格, 查完整用户信息 (含邮箱/手机/组织/角色/岗位)
- **API**: `GET /api/permission/Users/{id}` (web 端 `getUserInfo`)
- **痛点**: AI 经常需要单个用户详情而非列表
- **返回**: JSON 含完整字段, AI 易解析
**2. `user selector` — 用户下拉框列表** [优先级: P0]
- **理由**: 解决"下拉选择用户"高频需求, 与 form selector 对应
- **API**: `GET /api/permission/Users/Selector` (web 端 `getUserSelector`)
- **痛点**: form/list 关联用户时需查 user 列表
- **特性**: 支持 keyword 模糊, 返回 id+name 简化结构
**3. `user roles <userId>` — 反向查用户角色** [优先级: P1]
- **理由**: 镜像 `role assign` 链路 (user→role 反向)
- **API**: `GET /api/permission/Users/{id}/Role` (需 web 端确认)
- **痛点**: 查用户有哪些角色, 权限三角评估基础
- **替代方案**: 配合 `role list --userId=<uid>`
**4. `user import <file>` — 批量导入用户** [优先级: P1]
- **理由**: web 端支持 Excel 导入 (`importData`)
- **痛点**: 创建测试用户 (10+) 效率极低
- **API**: `POST /api/permission/Users/ImportData`
- **实现**: 支持 --file <csv/xlsx> + --preview 预览
**5. `user login-log` — 查用户登录日志** [优先级: P2]
- **理由**: 审计需求, web 端有登录日志页
- **痛点**: 排查登录问题时无 CLI 入口
- **API**: `GET /api/system/Log/login?account=<account>` (需确认)
**6. `user authorize` — 直接赋权限 (不走角色)** [优先级: P3]
- **理由**: 高级权限分配, web 端 `Authorize.vue` 支持
- **痛点**: 某些场景需直接给用户赋权限, 不创建角色
- **API**: `POST /api/permission/Users/Authorize` (需 web 端确认)
- **风险**: 不推荐过度使用, 提示 "优先用 role + assign"
---
## 4. AI 痛点评估
### 闭环度评估
- **闭环度**: 9/10 (优秀)
- **原因**:
- 18 命令覆盖 95%+ 实际场景
- CRUD + 批量 + 高级 + 权限 + self 五维度齐全
- 决策 7 强制绑组织 (组织不存在会报错)
- 防自踢/防误操作机制完整
### 与三角命令联动 (user → role → org)
#### user → role (镜像)
- **现状**: 缺 `user roles <uid>` (反向查)
- **现有链路**: `role assign --userId=<uid> --roleId=<rid>` (单方向)
- **建议**: 增加反向查询, 提升决策质量
#### user → org (强制绑)
- **现状**: 完美, create 时 --organizeId 必填
- **支持链**: `org list → user list --keyword=<orgName>` 交叉查
#### user → position (多岗位)
- **现状**: get-position + set-position 完整
- **批量**: batch-set-position 支持
### 缺基础命令痛点 (关键)
**痛点 1**: 无 `info <id>`
- **场景**: 已知 uid, 需查邮箱/手机/部门名
- **现状**: 必须 list + grep, 慢且不准
- **建议**: 新增 P0
**痛点 2**: 无 `selector`
- **场景**: form/list 需用户下拉框
- **现状**: list + 提取 ID+name, 冗余
- **建议**: 新增 P0
**痛点 3**: 无 `import`
- **场景**: 创建 10+ 测试用户
- **现状**: 需循环 create 10 次, 慢
- **建议**: 新增 P1 (CSV 导入)
**痛点 4**: 16/18 缺 webapi 镜像
- **影响**: 维护成本高, API 路径硬编码
- **建议**: P0 重构
### 痛点优先级排序
| 优先级 | 痛点 | 影响 | 解决方案 |
|--------|------|------|---------|
| **P0** | 缺 `info` / `selector` | 高频查询, 现有命令不便 | 新增命令 |
| **P0** | 16/18 缺 webapi 镜像 | 维护成本 | 镜像 webapi |
| **P1** | 缺 `import` | 批量操作不便 | 新增命令 |
| **P1** | 缺 `roles` 反向查 | 权限决策不便 | 新增命令 |
| **P2** | 缺 `login-log` | 审计排查不便 | 新增命令 |
| **P3** | 缺 `authorize` | 高级权限 | 暂不实现 |
---
## 5. 总结
**现状评价**: user 是 24 父命令中**子命令最多 (18)** 且**闭环度最高 (9/10)** 的命令组。设计完善, 防误操作机制到位。
**最大缺陷**:
1. **16/18 缺 webapi 镜像** — 与 v0.11+ 架构不一致, 维护成本高
2. **缺 `info` / `selector` 基础命令** — AI 高频痛点
3. **缺 `import` 批量入口** — 性能瓶颈
**建议执行顺序**:
1. **P0**: 创建 `webapi/user.ts` 镜像, 迁移 16 命令
2. **P0**: 新增 `user info <id>` 和 `user selector`
3. **P1**: 新增 `user roles <uid>` (反向查)
4. **P1**: 新增 `user import <file>` (CSV)
5. **P2+**: 根据反馈再决定 login-log / authorize
**预期收益**:
- webapi 化: 维护成本 -50%, API 跟随 web 自动更新
- info/selector: AI 查询效率 +200%
- import: 批量场景效率 +1000%
+250
View File
@@ -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 <id>`** — 流程模板详情
- API: `GET /api/workflow/template/{id}` (web getInfo)
- 场景: AI 创建流程后查看 flowNodes/flowConfig/flowXml 完整 schema
2. **`workflow update <id>`** — 修改流程模板
- API: `PUT /api/workflow/template/{id}` (web update)
- 场景: AI 调整流程 (改 flowNodes, 改分类), 修复错误流程
3. **`workflow delete <id>`** — 删除流程模板
- 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 <operatorId>`** — 转办
- API: `POST /api/workflow/operator/Transfer/{operatorId}` (web transfer)
7. **`workflow delegate <operatorId>`** — 委派
- API: `POST /api/workflow/operator/Assist/{operatorId}` (web assist)
8. **`workflow recall <taskId>`** — 撤回发起
- API: `PUT /api/workflow/task/Recall/{taskId}` (web launchRecall)
9. **`workflow revoke <taskId>`** — 撤销流程
- API: `PUT /api/workflow/task/Revoke/{taskId}` (web revoke)
10. **`workflow copy <id>`** — 复制流程
- API: `POST /api/workflow/template/{id}/Actions/Copy` (web copy)
11. **`workflow version <id>`** — 流程版本管理
- API: getVersionList/copyVersion/delVersion/upDownShelf
- 场景: AI 版本切换 (生产/灰度)
#### 优先级 P2 (边缘)
12. **`workflow export <id>`** — 导出 (web exportData)
13. **`workflow import <file>`** — 导入
14. **`workflow monitor <taskId>`** — 监控 (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 <id>` | 缺 | NEW-CMD | P0 | AI 创建后查看 schema |
| `update <id>` | 缺 | NEW-CMD | P0 | AI 修改流程 |
| `delete <id>` | 缺 | 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 (版本管理)