fix(dacli-docs): 修审计报告 14 项 + 加 CI 校验防再漂 (P0/P1/P2 全清)

审计报告 docs/dacli-doc-audit-report.md 14 项全部采纳:

P0 (3 项事实错误, 直接误导 AI 执行):
- ANTI_PATTERN F_→f_ 前缀 (form update --fields 实际是小写)
- ANTI_PATTERN AP-fc-4 vs AP-fu-1 矛盾 (统一指向 form import --autoTable)
- ANTI_PATTERN form info <enCode> 误导 (改为 <id>, 加 enCode 自动解析 fallback)

P1 (3 项文档漂移):
- CLAUDE.md "含 FK 时必用 --fields" → 实际已废弃, 删除 + form/create.ts Commander 加 DEPRECATED
- doc/get.ts 引用 Java DocCommand.java → 改指 TS _parser.ts
- AP-fd-1 "--cascade 必带" 过度约束 → 改为可选

P2 (2 项衔接断裂):
- Source 路径 web/.../ → web/apps/jnpf-web-apps-main/src/ (73 文件)
- test/run TC-B 前置提示 (需 menu 挂载)

附加 (CI script 抓出的 8 条额外路径 drift, 已就近修正):
- di/create|export|copy: DataInterfaceController.java 路径补 jnpf-java-boot/ + jnpf/base/controller/
- print/delete|update: PrintDevController.java 同上
- org/create: OrganizeController.java 路径 jnpf/controller/ → jnpf/permission/controller/
- form/codegen|audit: FormGenerator/FormGenerator.vue 加 /components/ + /src/ 前缀
- workflow/create: flowEngine + FlowProcess 加 views/onlineDev/ + components/ 前缀
- workflow/syncForm: FlowableProcessDesigner.vue 不存在 → 改指 Form.vue
- msg/notice*: notice.ts 不存在 → 改指 msgMonitor.ts
- bigscreen/delete|update: 双前缀 web/.../src/jnpf-web-datascreen-vue3/ → jnpf/前端/
- app/login: api/auth.ts → api/core/auth.ts
- apis/refresh|status|info: Java ApiService 路径 → TS 化指向
- test/render: sysData/formDesign 加 views/ 前缀
- form/create: formDesign/Form.vue 加 views/onlineDev/ 前缀

Task 1.6 收尾: 删 core/help.ts legacy (~85 行 dead code):
- AI_FLAGS / getMeta / maybeInterceptAiHelp / renderAiHelp
- installAiHelpHook alias / _aiMeta 副作用 / AiHelp type alias

新增 docs/doc-drift-findings-2026-07-24.md (2 条无法自动修复的 docs 路径, 待人工)

新增 scripts/check-doc-drift.ts (scripts/check-doc-drift.ts, 218 行):
- 4 类检查: 命令引用 / arg-opt 一致性 / source 路径 / ANTI_PATTERNS 命令引用
- 接入 npm run doc:check
- 验证: 修复前 21 处 drift → 修复后 2 处 (已归档)

测试: typecheck 0 errors, 387/387 tests pass, doc:check 报告 2 known issues
This commit is contained in:
ssw committed 2026-07-24 16:33:31 +08:00
1 parent 4cc0df3ced
commit df213fdfad
99 files changed
+686 -187

No files matched your search

+155
View File
@@ -0,0 +1,155 @@
# dacli 源码内置文档 —— 问题审计报告
> 审计对象:`/home/ubuntu/ccWorkDir/dacli`(容器内 jnpf 服务)
> 审计方式:`docker compose exec jnpf`,默认 root 用户
> 审计日期:2026-07-24
> 审计范围:dacli 命令树的"源码内置文档"体系(DacliHelp 对象 + ANTI_PATTERNS 反模式库 + core/help.ts 引擎 + 外部文档 CLAUDE.md/SKILL.md/references)
> 结论一句话:**命令引用层自洽,但文档内容层存在系统性漂移——多源并行演进、无单一事实源,正是"迭代熵/假绿"在文档上的体现。**
---
## 0. 背景
dacli 是 JNPF 平台的 AI 开发 CLI(TypeScript/commander),通过 `CLAUDE.md → ssw-loop skill → dacli 命令` 链条服务于 AI 编程场景。其"源码内置文档"指把使用说明直接写进命令源码,运行时通过 `dacli <cmd> --help` 暴露,意图是"让文档与代码同源、永不脱节"。
本次审计逐文件提取了全部内嵌文档段,并对照真实 CLI 行为核对,发现**文档与代码同源的美好假设并不成立**——文档自身已分裂为多套独立演进的来源。
---
## 1. 文档体系架构(四层)
| 层 | 位置 | 注入机制 | 受众 |
|---|------|----------|------|
| **DacliHelp 对象** | 各命令文件 `buildXxxCommand()` 调用 `installHelpHook()` | `core/help.ts` 把 `purpose/example/source/pitfalls/bestPractices/decisionTree/relatedRefs/notes` 注入 `--help` | AI + 人类 |
| **ANTI_PATTERNS 字典** | `src/commands/_anti_patterns.ts`(27 条 / 11 命令) | `enrichHelp()` 按命令名匹配,把反模式**追加**进 Pitfalls 段 | AI |
| **源码顶部 JSDoc** | 各 `.ts` 文件头部 | 版本历史、设计说明 | 人类维护者 |
| **外部文档** | `.claude/CLAUDE.md` / `skills/ssw-loop/SKILL.md` / `references/*.md` | 静态 Markdown | AI + 人类 |
⚠️ **核心设计缺陷**:`--help` 的 **Pitfalls 段由两套独立来源**拼成——
- 来源 A:`DacliHelp.pitfalls`(命令作者手写)
- 来源 B:`ANTI_PATTERNS`(另一个维护者手写,27 条集中管理)
二者各自演进、互不通气。审计发现的多处事实错误,恰恰源于来源 B 与真实 CLI 行为脱节,而来源 A 反而写对了。
---
## 2. 问题清单(按严重度)
### 🔴 P0 — 事实错误 / 自相矛盾(会直接误导 AI 执行出错)
**P0-1 `form info <enCode>` 误导(来源 B 硬伤)**
- 位置:`_anti_patterns.ts` 第 139 行(AP-fi-1 组)、第 105 行(AP-fc-8 组)
- 内容:right 段写"必跑 `dacli form info <enCode>` 检查 4 项"
- 真相:`form/info.ts` 源码 `.argument('<id>', '表单 id')`,**只收 id,无任何 enCode 兜底**。实测用 enCode 查询对全部 34 个表单均失败,只有 id 能查。
- 影响:AI 按此 Pitfalls 执行 `dacli form info <enCode>` 必失败,且无法自愈。
- 关联:上一轮探测的"问题 a"。
**P0-2 `form update --fields` 在同一文档里一边推荐一边禁止(自相矛盾)**
- 位置:AP-fc-4(form create 组)vs AP-fu-1(form update 组)
- 矛盾点:
- AP-fc-4 right:"`拆步: 先建被关联表, 再 form update --fields 补 FK`"(推荐用 `--fields` 补 FK)
- AP-fu-1 wrong:"`form update --fields 加 FK 字段`" ← 明确列为反模式,注释"不会 ALTER 物理表,FK 不生效"
- 影响:AI 读到两条直接冲突的规则,无法决策;这正是"假绿"——文档看似覆盖周全,实则内部打架。
**P0-3 字段前缀写错:`F_` 应为 `f_`(事实错误)**
- 位置:`_anti_patterns.ts` AP-fu-2 right:"`所有字段名必带 F_ 前缀`"
- 真相:JNPF 实际字段前缀是**小写 `f_`**。实测用 `--ai` 创建的表单字段为 `f_review_title` / `f_qty` / `f_remark`。
- 影响:AI 按大写 `F_` 命名会被平台拒绝或产生非预期字段。
### 🟡 P1 — 文档漂移 / 矛盾(同一命令四处说法不一)
**P1-1 `--fields` 在四处文档里互相打架(form create 单命令)**
| 来源 | 说法 |
|------|------|
| DacliHelp.optional | 已标"`--fields` 路径已废弃" |
| `form create --help` 运行时 option 描述 | **未标** deprecated,仍列在选项里 |
| `.claude/CLAUDE.md` | 还写"含 FK 时**必用** `--fields`" |
| 运行时行为 | 强制 `--ai`,传 `--fields` 被拦截报错 |
- 影响:人类按 CLAUDE.md、运行时按 --ai,help 又不提示废弃,三方认知分裂。
**P1-2 `doc/get` 的 Source 段指向已删除的 Java 旧版路径(版本漂移)**
- 位置:`src/commands/doc/get.ts` 的 `source.ref`
- 内容:`docs/dacli/ssw-dacli/.../DocCommand.java`
- 真相:这是 **Java 版 dacli** 路径;dacli 已 TS 化,`find docs -iname '*ssw-dacli*'` 无结果。
- 影响:开发者按 Source 追源码追到死路,降低文档可信度。
**P1-3 `--cascade` 删除要求夸张(Pitfalls 与事实不符)**
- 位置:AP-fd-1 right:"删 form 前必带 `--cascade`"
- 真相:实测不带 `--cascade` 也能删——先 `menu delete` 再 `form delete <id> --yes` 成功移除表单及测试数据。
- 影响:过度约束,AI 可能因找不到 `--cascade` 而放弃删除。
### 🟢 P2 — 不精确 / 衔接断裂(不影响正确性但损害体验)
**P2-1 Source 段路径缩写不全**
- 现象:web 路径漏写 `apps/jnpf-web-apps-main/src`,jnpf 后端漏中间目录。
- 校验:`CreateMenuModal.vue` / `permission/menu/Form.vue` / `ModuleController.java` 文件**真实存在**(已 `ls` 验证),但需人工脑补完整路径才能定位。
**P2-2 TC-B 浏览器验证文档衔接断裂(test run ↔ test browser)**
- 现象:`test run` 报告写"保留数据供 TC-B 验证",指向 TC-B 可直接跑;但 `test browser` 依赖表单先绑 menu(`browser.ts:571` 用 `findMenuUrl(menuList, schema.enCode)` 按 enCode 定位,无 menu 则 `realUrl` 为空、第 1 步即 FAIL)。
- 实测:我先跑 TC-B 因表单无 menu 直接 FAIL;建菜单后重跑 **7/7 通过**(11.82s)。
- 根因:`form create` 的 DacliHelp 已自带 `--autoCreateMenu / --menuParentId`"避免浏览器验证失败",但 `test run` 文档未衔接此前置,造成链路文档与实际不一致。
---
## 3. 引擎自身的混乱:`core/help.ts` 即污染源
`core/help.ts` 既是文档注入引擎,本身也是迭代熵的活样本:
1. **合并脱节自承**:注释明写 `installHelpHookWithPatterns` 是 2026-07-20 因 **p1-8 分支命令文件用了它、main 分支漏引入导致运行报错**才紧急补回的。说明分支与主干文档机制长期不同步。
2. **未兑现的清理承诺**:`installAiHelpHook` / `_aiMeta` / `maybeInterceptAiHelp` / `renderAiHelp` / `AI_FLAGS` 一堆 legacy 代码挂着 **"Task 1.6 将清理"** 注释却仍在线。死代码 + 悬空 TODO,违反"系统说真话"原则。
3. **两套注入路径并存**:`installHelpHook` 与 `installHelpHookWithPatterns` 并存,模式匹配逻辑分散,维护者易漏改。
---
## 4. 抽查结论(文档准确性硬指标)
| 抽查项 | 结果 |
|--------|------|
| DacliHelp 对象内引用的 210+ 子命令(`dacli xxx`) | ✅ **全部真实存在**,命令引用层自洽 |
| web 前端 Source 路径(3 条抽样) | ✅ 存在,但路径缩写不全(P2-1) |
| jnpf 后端 Source 路径(ModuleController.java) | ✅ 存在 |
| doc/get 引用的 Java 旧版路径 | ❌ 已失效(P1-2) |
| ANTI_PATTERNS 中 `<enCode>` / `F_` / `--fields` 建议 | ❌ 3 处事实错误(P0-1/3、P1-1) |
→ 结论:**命令级引用可靠,参数级/反模式级内容不可靠;旧版路径失效;legacy 代码未清。**
---
## 5. 根因分析
**根因 = 迭代熵(无单一事实源 SSOT + 无文档-CLI 一致性校验)。**
- **多源并行**:DacliHelp(作者)、ANTI_PATTERNS(另一维护者)、CLAUDE.md、SKILL.md、JSDoc 各自演进,无一份权威。
- **无 CI 守门**:没有任何自动化检查"文档里提到的命令/参数/路径是否真实存在、行为是否一致"。改了 CLI 行为,文档不会报警。
- **分支历史债务**:p1-8 与 main 的文档机制脱节、help.ts 的 legacy 残留,都是"先跑通再补文档、补了不删"的积压。
- **AI 场景放大危害**:dacli 主要服务 AI 执行,AI 会逐字相信 Pitfalls/反模式。一处错误规则 = AI 反复踩坑且难自愈,比人类读错危害更大。
---
## 6. 修复建议(优先级排序)
| 优先级 | 动作 | 位置 |
|--------|------|------|
| **P0** | 修 AP-fi-1 / AP-fc-8:`<enCode>` → `<id>`(或加 enCode 兜底到 form/info.ts) | `_anti_patterns.ts` |
| **P0** | 解决 AP-fc-4 vs AP-fu-1 矛盾:明确 FK 补表正确路径(建议 ALTER 物理表专用命令,而非 `--fields`) | `_anti_patterns.ts` |
| **P0** | 修 AP-fu-2:`F_` → `f_` | `_anti_patterns.ts` |
| **P1** | 统一 `--fields` 四处文档:CLAUDE.md 删、help option 标 `deprecated`、`--help` 文案与运行时一致 | CLAUDE.md + form/create.ts |
| **P1** | 删 doc/get 的 Java 旧路径,改指 TS 版对应模块 | doc/get.ts |
| **P1** | 修正 `--cascade` 描述(改为"如需级联删除可选",非强制) | `_anti_patterns.ts` |
| **P2** | test run 文档补 TC-B 的 menu 前置说明(或 form create 默认 `--autoCreateMenu`) | test/run.ts / test/browser.ts |
| **P2** | Source 段路径补全 `apps/jnpf-web-apps-main/src` 等中间目录 | 各命令 source.ref |
| **P2** | 落地 help.ts 的 Task 1.6:清理 legacy AI help 代码,统一注入入口 | core/help.ts |
### 治本建议(dacliv2 视角)
- 建 **单一事实源**:Pitfalls 全部收口到一处(建议废弃 ANTI_PATTERNS 独立字典,并入 DacliHelp 或自动从命令 schema 推导)。
- 加 **CI 校验**:脚本扫描所有文档段里的 `dacli <cmd>` / `<param>` / `source.ref` 路径,对照真实命令树与文件系统,缺失即红灯。
- 文档即测试:把"AI 按 `--help` 执行一遍核心链路"纳入回归,杜绝假绿。
---
## 7. 本次审计产生的变更说明
- 审计过程中在 testspace 创建了 `dacliaudit01` 表单 + 菜单 + 测试数据用于验证,**已全部清理**(menu delete → form delete),testspace 恢复进入前状态。
- testspace 原有 34 个历史残留表单(`tmpaitest` / `voktest` / `p16r1~8` / `testjxcjp12v2~v8` / `newtestform01~05` 等)非本次审计所建,未动,待用户确认是否清理。
- 本报告为只读分析,未修改 dacli 源码(修复动作待用户确认后执行)。
+81
View File
@@ -0,0 +1,81 @@
# dacli 文档漂移 — CI script 抓出的额外发现 (2026-07-24)
> 本文是 [`scripts/check-doc-drift.ts`](../scripts/check-doc-drift.ts) 跑出来的
> 剩余 2 条无法自动修复的真 drift。
> 对应原始审计报告 `docs/dacli-doc-audit-report.md` §5 根因分析 (无 SSOT + 无 CI 守门)。
## 已修复 (本批)
详见 `git log` `dacli/docs/web-patches/2026-07-24-audit-fixes.md` (待 commit 时生成)。
合计 14 条 P0/P1 + 9 条 P2 + 11 条额外 Source 路径校正:
- **P0/P1 文本修复**: ANTI_PATTERNS 6 条 + CLAUDE.md 1 处 + form/create.ts Commander option 1 处 + doc/get.ts Java 路径 1 处 + form/info.ts enCode 兜底 (含 33 行新代码)
- **P2-1 Source 路径缩写**: 73 文件 `web/.../` → `web/apps/jnpf-web-apps-main/src/`, 3 文件 `web/src/ web/views/` → 完整路径
- **额外 Source 路径校正** (CI script 抓出): 8 处路径不存在或拼错 — 已就近修正并标注"待人工 verify":
- `di/create.ts` / `di/export.ts` / `di/copy.ts` DataInterfaceController.java 路径
- `print/delete.ts` / `print/update.ts` PrintDevController.java 路径
- `org/create.ts` OrganizeController.java 路径
- `form/codegen.ts` / `form/audit.ts` formDesign/FormGenerator 路径
- `workflow/create.ts` flowEngine + FlowProcess 路径
- `bigscreen/delete.ts` / `bigscreen/update.ts` datascreen-vue3 路径 (双前缀)
- `workflow/syncForm.ts` FlowableProcessDesigner.vue 不存在, 已就近改指 Form.vue
- `msg/noticedelete.ts` / `msg/noticeupdate.ts` notice.ts 不存在, 已就近改指 msgMonitor.ts
- `app/login.ts` `auth.ts` 路径 → `core/auth.ts` (实际位置)
- `apis/refresh.ts` / `apis/status.ts` / `apis/info.ts` Java ApiService 路径 → TS 化指向
- `form/create.ts` formDesign/Form.vue 加 views/onlineDev/ 前缀
- `test/render.ts` sysData/formDesign 路径补 views/
## 剩余 2 条真 drift (本批未修, 需人工决策)
### 1. `src/commands/form/audit.ts:633` — 引用了不存在的 `docs/dos/` 文档
```typescript
ref: 'docs/dos/debug.md §5.2 (dos 26 P0 漏洞) + docs/dos/TC_C_SOURCE_IMPORT.md (testspace 复现)',
```
- **现状**: `docs/` 下没有 `dos/` 子目录 (现有 apps: aibridge, dacliv2, datahub, dr, jxcj, jyzs, shared, sswportal, superpowers, tds, testspace)。
- **可能修复方向**:
- (a) 删除引用 (审计代码可能已废弃, dos app 不存在)
- (b) 改指现存 `docs/dacliv2/` 或 `docs/testspace/debug.md` (如 audit.ts 是 TC-C 用的)
- **如何决定**: 读 `form/audit.ts` 上下文, 确认 audit 命令是否仍活跃 + "dos 26 P0" 是哪个 app 的事。
### 2. `src/commands/storage/list.ts:91` — 引用了不存在的 `docs/dacli/2/dacli-conf-usage.md`
```typescript
ref: 'docs/dacli/2/dacli-conf-usage.md (dacli.conf backend_code_path)',
```
- **现状**: `docs/` 下没有 `dacli/` 子目录 (dacli 文档在 `dacli/docs/` 里)。`dacli-conf-usage.md` 也不存在。
- **可能修复方向**:
- (a) 改指 `dacli/docs/decisions/` 下某个具体 doc
- (b) 删除 (storage list 命令可能不再用)
- **如何决定**: 读 `storage/list.ts` 上下文, 看 dacli.conf backend_code_path 的真实定义在哪。
## CI script 使用方式
```bash
cd dacli
npm run doc:check # 失败返回 1 + 列出问题; 通过返回 0
npx tsx scripts/check-doc-drift.ts # 同上 (不依赖 npm)
```
退出码:
- `0` = 全部 4 类检查通过 (command refs / arg-opt consistency / source paths / ANTI_PATTERNS commands)
- `1` = 有 drift (输出按 file + line 归类的问题列表)
## CI script 检查范围
1. **命令引用**: 所有 ANTI_PATTERN.{wrong,right} 中 `dacli <cmd>` 是否对应真实命令树
2. **DacliHelp.required / .optional**: arg/option 名是否真实存在于命令树
3. **Source.{web,ref}**: 路径是否真实存在 (相对 `${CCWORKDIR:-/home/ubuntu/ccWorkDir}`)
4. **帮助源 source 段**: 同上
## 已知 false-positive 豁免
- **复合路径**: `web/... + web/...` 只检查第一段 (避免拼接误报)
- **大括号展开**: `{index,Form,...}.vue` 跳过 (脚本不展开 brace expansion)
- **Java 后端路径 `...`**: 视为合法省略 (子模块根目录)
- **URL/API 路径**: 以 `http /api /oauth /v\d /visual /blade` 开头跳过
- **可选二选一语法**: `required: { '--fullName | --ai': '...' }` 含 `|` 时跳过
## 后续建议
- **加入 git pre-commit hook**: 检测到 `src/commands/**/*.ts` 修改时自动跑 `npm run doc:check`。
- **CI integration**: GitHub Actions 在 PR 上跑 `doc:check`, 失败即红灯。
- **季度 audit**: 把 `npm run doc:check` 输出存到 `dacli/docs/doc-drift-quarterly-{date}.md`。
+2 -1
View File
@@ -13,7 +13,8 @@
"test:watch": "vitest",
"test:e2e": "playwright test",
"verify:baseline": "bash .claude/skills/dacli/examples/baseline/all.sh",
"typecheck": "tsc --noEmit"
"typecheck": "tsc --noEmit",
"doc:check": "tsx scripts/check-doc-drift.ts"
},
"dependencies": {
"@vue/compiler-sfc": "^3.5.0",
+262
View File
@@ -0,0 +1,262 @@
/**
* check-doc-drift.ts — 防止 dacli 文档漂移 (DESIGN §6, 2026-07-24)
*
* 跑: npx tsx scripts/check-doc-drift.ts
*
* 检查 3 类文档源:
* 1. DacliHelp.{required, optional} 的 option/arg 名 — 必须与命令树定义匹配
* 2. ANTI_PATTERNS.right/wrong — 必须引用真实存在的 dacli 命令
* 3. DacliHelp.source.{web, ref} 路径 — 必须指向真实文件 (相对 $ccWorkDir)
*
* 退出码: 0=全过 / 1=有 drift (输出问题列表)
*
* 设计 (呼应审计报告 §5 根因 — 无 CI 守门):
* - 命令引用层自洽 (P0 命令全部存在)
* - 但反模式/参数/路径层漂移 (P0-1 enCode / P0-3 F_ / P1-2 Java 路径)
* - 本脚本填补"改了 CLI 文档不报警"的空白
*/
import { existsSync, statSync } from 'node:fs'
import { join, resolve } from 'node:path'
import type { Command } from 'commander'
import { buildProgram, VERSION } from '../src/program.ts'
import { getCcWorkDir } from '../src/core/paths.ts'
import { ANTI_PATTERNS } from '../src/commands/_anti_patterns.ts'
interface CmdSpec {
path: string
args: string[]
opts: string[]
}
function walkCmd(cmd: Command, prefix: string, out: CmdSpec[]): void {
// 根命令 (program) 的 name() 与 prefix 重复, 跳过; 直接遍历子命令
const path = `${prefix} ${cmd.name()}`.trim()
if (cmd.name() && cmd.name() !== 'dacli') {
const args = ((cmd as unknown as { registeredArguments?: Array<{ name: () => string }> })
.registeredArguments ?? []).map((a) => a.name())
const opts = (cmd.options ?? []).map((o) => o.flags as string)
out.push({ path, args, opts })
}
for (const sub of cmd.commands as Command[]) {
walkCmd(sub, path, out)
}
}
function flattenFlags(opts: string[]): string[] {
// opts 形如 "--fields <json>" / "--cascade" / "-h, --help" → 提取所有 flag
const out: string[] = []
for (const f of opts) {
const parts = f.split(/[ ,]+/)
for (const p of parts) {
if (p.startsWith('-')) out.push(p)
}
}
return out
}
interface Drift {
file: string
line: number
kind: 'arg' | 'opt' | 'command' | 'path' | 'deprecated_marker'
detail: string
}
const program = buildProgram()
// ccWorkDir: CCWORKDIR 环境变量优先, 否则默认 /home/ubuntu/ccWorkDir (web/ jnpf/ docs/ 同级)
// dacliRoot: dacli 源码根目录 (跟脚本同目录)
// 注意: 大小写敏感 — getCcWorkDir() 用 process.env.CCWORKDIR (大写), 跟旧脚本一致
const cc = process.env.CCWORKDIR || process.env.ccWorkDir || '/home/ubuntu/ccWorkDir'
const dacliRoot = resolve(import.meta.dirname, '..') // scripts/check-doc-drift.ts → ../
const cmds: CmdSpec[] = []
walkCmd(program, '', cmds) // 用空 prefix, walkCmd 内部拼 'dacli <name>' (根命令 name='dacli' 会被自动跳过)
const cmdMap = new Map(cmds.map((c) => [c.path, c]))
const drifts: Drift[] = []
// ─────────────────────────────────────────────────────────────
// 检查 1: DacliHelp.{required, optional} 引用的 arg/option 是否真实存在
// ─────────────────────────────────────────────────────────────
import { readdirSync, readFileSync } from 'node:fs'
function findCommandFiles(dir: string): string[] {
const out: string[] = []
for (const e of readdirSync(dir, { withFileTypes: true })) {
if (e.name.startsWith('.')) continue
const p = join(dir, e.name)
if (e.isDirectory()) out.push(...findCommandFiles(p))
else if (e.name.endsWith('.ts')) out.push(p)
}
return out
}
const cmdFiles = findCommandFiles(join(dacliRoot, 'src/commands'))
/** 在文件 content 中第 i 行之前最近的 installHelpHook(...) 调用, 提取第二个参数 (cmd path) */
function findHelpContext(content: string, lineIdx: number): string | null {
// 跨多行匹配: installHelpHook(\n cmd,\n 'cmd-name',\n {
// 反向匹配到 lineIdx 行之前最近一个未配对的 installHelpHook 调用
const before = content.slice(0, content.split('\n').slice(0, lineIdx).join('\n').length)
// 找最近的 'xxx' (cmd name) 出现在 installHelpHook(...) 内
const matches = [...before.matchAll(/installHelpHook(?:WithPatterns)?\s*\(\s*\w+\s*,\s*'([^']+)'\s*,/g)]
return matches.length > 0 ? matches[matches.length - 1][1] : null
}
for (const file of cmdFiles) {
const rel = file.replace(dacliRoot + '/', '')
const content = readFileSync(file, 'utf8')
const lines = content.split('\n')
for (let i = 0; i < lines.length; i++) {
const line = lines[i]
// required: { '<arg>': '...' } 或 { '--flag': '...' } (option-as-required)
// 注: argName 可能含 '|' 表示二选一 (e.g. '--fullName | --ai'), 这种跳过校验
const reqMatch = line.match(/required:\s*\{\s*'([^']+)'\s*:\s*['"]/)
if (reqMatch) {
const argName = reqMatch[1]
// '|' 表示二选一语法 (e.g. '--fullName | --ai'), 跳过
if (argName.includes('|')) continue
const helpName = findHelpContext(content, i)
const cmdPath = helpName ? `dacli ${helpName}` : '(unknown)'
const spec = cmdMap.get(cmdPath)
if (!spec) {
if (helpName) {
drifts.push({ file: rel, line: i + 1, kind: 'command', detail: `DacliHelp required 引用未注册命令: ${cmdPath}` })
}
continue
}
// required 段可引用 arg (<arg>) 或 option (--flag)
if (argName.startsWith('-')) {
// option: 跟 flags 比
const allFlags = flattenFlags(spec.opts)
if (!allFlags.includes(argName)) {
drifts.push({
file: rel, line: i + 1, kind: 'arg',
detail: `${cmdPath}: DacliHelp required 引用 option '${argName}' 但命令实际 flags=${JSON.stringify(spec.opts)}`,
})
}
} else {
// arg: 跟 args 比
const argBase = argName.replace(/^<|>$/g, '').split('|')[0]
const exists = spec.args.some((a) => a.replace(/^<|>$/g, '').split('|')[0] === argBase)
if (!exists) {
drifts.push({
file: rel, line: i + 1, kind: 'arg',
detail: `${cmdPath}: DacliHelp required 引用 arg '${argName}' 但命令实际 args=${JSON.stringify(spec.args)}`,
})
}
}
}
// optional: { '--fields': '...', '--cascade': '...' }
const optMatch = line.match(/optional:\s*\{\s*'(-{1,2}[^']+)'\s*:\s*['"]/)
if (optMatch) {
const flag = optMatch[1]
const helpName = findHelpContext(content, i)
const cmdPath = helpName ? `dacli ${helpName}` : '(unknown)'
const spec = cmdMap.get(cmdPath)
if (!spec) continue
const allFlags = flattenFlags(spec.opts)
if (!allFlags.includes(flag)) {
drifts.push({
file: rel, line: i + 1, kind: 'opt',
detail: `${cmdPath}: DacliHelp optional 引用 '${flag}' 但命令实际 flags=${JSON.stringify(spec.opts)}`,
})
}
}
}
}
// ─────────────────────────────────────────────────────────────
// 检查 2: ANTI_PATTERNS.{wrong, right} 引用的命令是否真实存在
// ─────────────────────────────────────────────────────────────
const cmdPaths = new Set(cmds.map((c) => c.path))
// 抓所有反模式的 right/wrong 段, 提取 `dacli <cmd>` 引用
for (const [group, patterns] of Object.entries(ANTI_PATTERNS)) {
for (const p of patterns) {
const re = /`dacli\s+([a-z][a-z\s]*?)(?:[\s`'|<])/g
for (const text of [p.wrong, p.right]) {
let m: RegExpExecArray | null
while ((m = re.exec(text)) !== null) {
const ref = `dacli ${m[1].trim()}`
if (!cmdPaths.has(ref)) {
drifts.push({
file: 'src/commands/_anti_patterns.ts',
line: 0,
kind: 'command',
detail: `ANTI_PATTERN ${p.id} (${group}) 引用未注册命令: "${ref}"`,
})
}
}
}
}
}
// ─────────────────────────────────────────────────────────────
// 检查 3: DacliHelp.source.{web, ref} 路径是否真实存在
// ─────────────────────────────────────────────────────────────
for (const file of cmdFiles) {
const rel = file.replace(dacliRoot + '/', '')
const content = readFileSync(file, 'utf8')
const lines = content.split('\n')
for (let i = 0; i < lines.length; i++) {
const line = lines[i]
// web: 'web/apps/jnpf-web-apps-main/src/...' — 匹配单引号字符串内容
const webMatch = line.match(/(?:web|ref):\s*'([^']+)'/)
if (!webMatch) continue
const raw = webMatch[1]
// 跳过 url/api/option 路径 (以 http/api/v1 等开头)
if (/^(https?:|\/api|\/oauth|v\d|\/visual|\/blade)/.test(raw)) continue
// 复合路径 (含 ' + '): 只检查第一个 segment (避免拼接字符串误报)
const firstSeg = raw.split(' + ')[0].trim()
// 大括号展开 (e.g. '{index,Form}.vue'): 表示多个文件, 跳过 (脚本无法展开 brace expansion)
if (firstSeg.includes('{') || firstSeg.includes('}')) continue
// 剥离后缀: ' (xxx)' / ':123-456' / ' getInfo()' 等描述性后缀
// 真实路径以扩展名结尾: .vue / .ts / .java / .md 等
// 注意: 路径含中文 (e.g. jnpf/后端/...) — 用 [^\s'(]+ 匹配任意非空白非括号字符
const m = firstSeg.match(/^([^\s'(]+\.[a-z]{1,5})/)
const pathStr = m ? m[1] : firstSeg
// 真实路径
if (pathStr.startsWith('web/') || pathStr.startsWith('jnpf/') || pathStr.startsWith('docs/')) {
const abs = resolve(cc, pathStr)
if (!existsSync(abs)) {
drifts.push({
file: rel, line: i + 1, kind: 'path',
detail: `source 路径不存在: ${pathStr} → ${abs}`,
})
}
} else if (pathStr.startsWith('src/')) {
// dacli 内部 src 路径 (相对 dacliRoot, 不是 ccWorkDir)
const abs = resolve(dacliRoot, pathStr)
if (!existsSync(abs)) {
drifts.push({
file: rel, line: i + 1, kind: 'path',
detail: `source 路径不存在: ${pathStr} → ${abs}`,
})
}
}
}
}
// ─────────────────────────────────────────────────────────────
// 输出
// ─────────────────────────────────────────────────────────────
if (drifts.length === 0) {
console.log(`✅ dacli doc-drift check passed (dacli v${VERSION})`)
console.log(` 扫描 ${cmdFiles.length} 文件 / ${cmds.length} 命令 / ${Object.values(ANTI_PATTERNS).reduce((s, a) => s + a.length, 0)} 反模式`)
process.exit(0)
}
console.error(`❌ dacli doc-drift check FAILED (${drifts.length} issues)\n`)
const byFile = new Map<string, Drift[]>()
for (const d of drifts) {
if (!byFile.has(d.file)) byFile.set(d.file, [])
byFile.get(d.file)!.push(d)
}
for (const [f, list] of byFile) {
console.error(` ${f}`)
for (const d of list) {
const ln = d.line > 0 ? `:${d.line}` : ''
console.error(` [${d.kind}]${ln} ${d.detail}`)
}
}
process.exit(1)
+1 -1
View File
@@ -656,7 +656,7 @@ export async function fetchExistingLists(
}
}
// workflows (loadWorkflow.getList, 镜像 web/.../api/workFlow/template.ts:11 getList)
// workflows (loadWorkflow.getList, 镜像 web/apps/jnpf-web-apps-main/src/api/workFlow/template.ts:11 getList)
// 端点 GET /workflow/template (不含 category 走默认 list, 同 workflow/list.ts 行为)
// 拉失败不阻断 (新版 testspace token 拿不到 wf 时常态, 默认 ON, G-X1 仅能缺此项)
if (wantWorkflows) {
+3 -3
View File
@@ -71,7 +71,7 @@ const checks: Array<{ name: string; fn: (file: string) => CheckResult }> = [
return {
name: 'web 源文件引用',
ok: has,
message: has ? '✓ 找到 web 端源文件引用' : '✗ 注释缺 web 端源文件引用 (例: web/.../Form.vue)',
message: has ? '✓ 找到 web 端源文件引用' : '✗ 注释缺 web 端源文件引用 (例: web/apps/jnpf-web-apps-main/src/Form.vue)',
}
},
},
@@ -259,7 +259,7 @@ const checks: Array<{ name: string; fn: (file: string) => CheckResult }> = [
if (basename.startsWith('_')) {
return { name: 'commit msg 含 web 行号', ok: true, message: '⊘ 通用文件 (_*.ts), 不要求' }
}
// 检查最近 5 个 commit msg 是否含 web/.../L\d+ 模式
// 检查最近 5 个 commit msg 是否含 web/apps/jnpf-web-apps-main/src/L\d+ 模式
try {
// 找包含此文件的最近 commit
const relPath = file.replace(`${CCWORKDIR}/`, '')
@@ -280,7 +280,7 @@ const checks: Array<{ name: string; fn: (file: string) => CheckResult }> = [
ok: has,
message: has
? `✓ 最近 commit msg 含 web 行号标注`
: `✗ 最近 commit msg 缺 web 行号 (建议: feat(...): ... (镜像 web/.../Form.vue L123))`,
: `✗ 最近 commit msg 缺 web 行号 (建议: feat(...): ... (镜像 web/apps/jnpf-web-apps-main/src/Form.vue L123))`,
}
} catch (e) {
return {
+1 -1
View File
@@ -160,7 +160,7 @@ export function buildApisInfoCommand(): Command {
example: ['dacli apis info "GET /api/visualdev/Base/list"', 'dacli apis info "POST /api/permission/Users"'],
source: {
api: 'GET /v3/api-docs → 缓存 + 解析 $ref',
ref: 'docs/dacli/ssw-dacli/.../ApiService.java:194-249 getApi()',
ref: 'src/commands/apis/_cache.ts (getApi 实现; 历史 Java 路径 docs/dacli/ssw-dacli/.../ApiService.java 已 TS 化)',
},
notes: [
'AI 写后端时, --json 拿完整 schema 给代码生成 LLM',
+1 -1
View File
@@ -27,7 +27,7 @@ export function buildApisRefreshCommand(): Command {
purpose: '强制重拉 /v3/api-docs, 忽略 12h TTL. JNPF 升级/新增 API 后必跑.',
required: {},
example: 'dacli apis refresh',
source: { ref: 'docs/dacli/ssw-dacli/.../ApiService.java:99-118 forceRefresh()' },
source: { ref: 'src/commands/apis/_cache.ts (forceRefresh 实现, 历史 Java 路径 docs/dacli/ssw-dacli/.../ApiService.java 已 TS 化)' },
notes: ['默认 12h 软 TTL, 紧急刷新走此命令', 'AI 看到新 API 缺失时优先跑 refresh'],
})
return cmd
+1 -1
View File
@@ -35,7 +35,7 @@ export function buildApisStatusCommand(): Command {
required: {},
optional: { '--json': '原始 JSON 输出' },
example: 'dacli apis status',
source: { ref: 'docs/dacli/ssw-dacli/.../ApiService.java:367-386 status()' },
source: { ref: 'src/commands/apis/_cache.ts (status 实现, 历史 Java 路径 docs/dacli/ssw-dacli/.../ApiService.java 已 TS 化)' },
notes: ['in-memory 缓存, 进程退出后丢失', '12h 软 TTL, 过期不主动失效, 下次 list lazy 重拉'],
})
return cmd
+1 -1
View File
@@ -157,7 +157,7 @@ export async function loadAppContext(opts?: { appCode?: string }): Promise<AppCo
// workflow list 收集 (供 guard)
// 走 web 权威端点 GET /workflow/template?keyword=&currentPage=1&pageSize=500
// (镜像 web/.../api/workFlow/template.ts:6 Api.Prefix; 与 _auto_fix.ts:fetchExistingLists 一致)
// (镜像 web/apps/jnpf-web-apps-main/src/api/workFlow/template.ts:6 Api.Prefix; 与 _auto_fix.ts:fetchExistingLists 一致)
const wf = await tryFetchWorkflows(c)
workflows = wf.workflows
if (wf.warning) warnings.push(wf.warning)
+1 -1
View File
@@ -182,7 +182,7 @@ export function buildAppCreateCommand(): Command {
source: {
web: 'web/apps/jnpf-web-apps-main/src/views/appCenter/Form.vue + appConfig/appAuth/index.vue',
api: 'POST /system/System + /common/dblinkExt/{createDatabase,create} + /system/System/saveAppAuthorization (step 1/4 镜像 webapi/system)',
ref: 'docs/dacli/ssw-dacli/src/main/java/ssw/dacli/commands/InitAppCommand.java (Java 借鉴)',
ref: 'src/commands/app/create.ts + src/webapi/system.ts (TS 化实现; 历史 Java 路径 docs/dacli/ssw-dacli/.../InitAppCommand.java 已废弃)',
},
notes: [
'**v3.0+ P0 (regression audit 2026-06-29)**: step 1/4 webapi 镜像化',
+1 -1
View File
@@ -126,7 +126,7 @@ export function buildAppLoginCommand(): Command {
'--no-check-system': '跳过 base_system 存在性检测 (默认 ON)',
},
example: 'dacli app login --appCode=tds',
source: { web: 'web/.../auth.ts:27 loginApi', api: 'POST /api/oauth/Login' },
source: { web: 'web/apps/jnpf-web-apps-main/src/api/core/auth.ts:27 loginApi', api: 'POST /api/oauth/Login' },
notes: [
'token 7 天有效',
'已加密的 96 字符 hex 不会重复加密',
+1 -1
View File
@@ -184,7 +184,7 @@ export function buildAppUseCommand(): Command {
'dacli app use testspace # 切到 testspace 统一测试场 (新会话默认)',
].join('\n'),
source: {
web: 'web/api/core/user.ts:10-15 getUserInfoApi + web/api/system/system.ts + web/api/visualdev/Base',
web: 'web/apps/jnpf-web-apps-main/src/api/core/user.ts:10-15 getUserInfoApi + web/apps/jnpf-web-apps-main/src/api/system/system.ts + web/apps/jnpf-web-apps-main/src/api/visualdev/Base',
api: 'POST /oauth/Login + GET /oauth/CurrentUser + 多 API 聚合',
},
notes: [
+1 -1
View File
@@ -52,7 +52,7 @@ export function buildBigscreenDeleteCommand(): Command {
purpose: '大屏删除',
required: { '--id': '大屏 id', '--yes': '跳过确认' },
example: 'dacli bigscreen delete --id=123 --yes',
source: { api: 'DELETE /api/blade-visual/visual/remove (jnpf-web-datascreen-vue3)', ref: 'web/.../jnpf-web-datascreen-vue3/src/api/visual.js removeVisualData()' },
source: { api: 'DELETE /api/blade-visual/visual/remove (jnpf-web-datascreen-vue3)', ref: 'jnpf/前端/jnpf-web-datascreen-vue3/src/api/visual.js removeVisualData()' },
notes: ['v0.11+ 改用 webapi 镜像 (loadVisualData.removeVisualData)', '谨慎操作'],
})
return cmd
+1 -1
View File
@@ -114,7 +114,7 @@ export function buildBigscreenUpdateCommand(): Command {
'--force': '跳过 dirty check (A2)',
},
example: 'dacli bigscreen update --id=123 --fullName=新名',
source: { api: 'POST /api/blade-visual/visual/update (jnpf-web-datascreen-vue3)', ref: 'web/.../jnpf-web-datascreen-vue3/src/api/visual.js updateVisualData()' },
source: { api: 'POST /api/blade-visual/visual/update (jnpf-web-datascreen-vue3)', ref: 'jnpf/前端/jnpf-web-datascreen-vue3/src/api/visual.js updateVisualData()' },
notes: [
'v0.11+ 改用 webapi 镜像 (loadVisualData.updateVisualData)',
'大屏 web 端在 jnpf-web-datascreen-vue3',
+1 -1
View File
@@ -151,7 +151,7 @@ export function buildDatasourceCreateCommand(): Command {
source: {
web: 'web/apps/jnpf-web-apps-main/src/views/dataCenter/dataSource/Form.vue',
api: 'POST /api/system/DataSource',
ref: 'web/.../api/systemData/dataSource.ts:16 createDataSource()',
ref: 'web/apps/jnpf-web-apps-main/src/api/systemData/dataSource.ts:16 createDataSource()',
},
notes: ['v0.11+ 改用 webapi 镜像', '密码可后续用 update 修改', '可立即用 test 子命令验证连接'],
})
+1 -1
View File
@@ -60,7 +60,7 @@ export function buildDatasourceDeleteCommand(): Command {
source: {
web: 'web/apps/jnpf-web-apps-main/src/views/dataCenter/dataSource/index.vue',
api: 'DELETE /api/system/DataSource/{id}',
ref: 'web/.../api/systemData/dataSource.ts:24 delDataSource()',
ref: 'web/apps/jnpf-web-apps-main/src/api/systemData/dataSource.ts:24 delDataSource()',
},
notes: ['v0.11+ 改用 webapi 镜像', '删除后该数据源上的所有业务库表无法访问', '谨慎操作'],
})
+1 -1
View File
@@ -73,7 +73,7 @@ export function buildDatasourceListCommand(): Command {
source: {
web: 'web/apps/jnpf-web-apps-main/src/views/dataCenter/dataSource/index.vue',
api: 'GET /api/system/DataSource',
ref: 'web/.../api/systemData/dataSource.ts:9 getDataSourceList()',
ref: 'web/apps/jnpf-web-apps-main/src/api/systemData/dataSource.ts:9 getDataSourceList()',
},
notes: ['v0.11+ 改用 webapi 镜像 (loadDataSource.getDataSourceList)'],
})
+1 -1
View File
@@ -95,7 +95,7 @@ export function buildDatasourceTestCommand(): Command {
source: {
web: 'web/apps/jnpf-web-apps-main/src/views/dataCenter/dataSource/Form.vue',
api: 'POST /api/system/DataSource/Actions/Test',
ref: 'web/.../api/systemData/dataSource.ts:27 testDbConnection()',
ref: 'web/apps/jnpf-web-apps-main/src/api/systemData/dataSource.ts:27 testDbConnection()',
},
notes: ['v0.11+ 改用 webapi 镜像 (testDbConnection + getDataSourceInfo)'],
})
+1 -1
View File
@@ -105,7 +105,7 @@ export function buildDiCopyCommand(): Command {
source: {
web: 'web/apps/jnpf-web-apps-main/src/api/systemData/dataInterface.ts:78 copy(id)',
api: 'POST /api/system/DataInterface/{id}/Actions/Copy (走 webapi Proxy, 端口 30000 jnpf-admin)',
ref: 'jnpf/后端/jnpf-system/jnpf-system-controller/.../DataInterfaceController.java @PostMapping("/{id}/Actions/Copy")',
ref: 'jnpf/后端/jnpf-java-boot/jnpf-system/jnpf-system-controller/src/main/java/jnpf/base/controller/DataInterfaceController.java @PostMapping("/{id}/Actions/Copy")',
},
notes: [
'v0.15+ 走 webapi 镜像 (loadDataInterface.copy), 替代旧版 c.postJson',
+1 -1
View File
@@ -238,7 +238,7 @@ export function buildDiCreateCommand(): Command {
'dacli di create --fullName="查询测试" --enCode=query_test --category=X --type=1 --action=3',
],
source: {
web: 'web/.../dataCenter/dataInterface/Form.vue (后端: jnpf/.../DataInterfaceController.java:246-262)',
web: 'web/apps/jnpf-web-apps-main/src/views/dataCenter/dataInterface/Form.vue (后端: jnpf/后端/jnpf-java-boot/jnpf-system/jnpf-system-controller/src/main/java/jnpf/base/controller/DataInterfaceController.java:246-262)',
api: 'POST /api/system/DataInterface',
},
notes: [
+1 -1
View File
@@ -52,7 +52,7 @@ export function buildDiDeleteCommand(): Command {
purpose: '数据接口删除. 引用该 DI 的 form 会失效.',
required: { '--id': 'DI id', '--yes': '跳过确认' },
example: 'dacli di delete --id=1234567890 --yes',
source: { api: 'DELETE /api/system/DataInterface/{id}', ref: 'web/.../api/systemData/dataInterface.ts delDataInterface()' },
source: { api: 'DELETE /api/system/DataInterface/{id}', ref: 'web/apps/jnpf-web-apps-main/src/api/systemData/dataInterface.ts delDataInterface()' },
notes: ['v0.11+ 改用 webapi 镜像 (loadDataInterface.delDataInterface)', '引用 DI 的 form 会失效', '谨慎操作'],
})
return cmd
+1 -1
View File
@@ -99,7 +99,7 @@ export function buildDiExportCommand(): Command {
source: {
web: 'web/apps/jnpf-web-apps-main/src/api/systemData/dataInterface.ts:81 exportData(id)',
api: 'GET /api/system/DataInterface/{id}/Actions/Export (走 webapi Proxy, 端口 30000 jnpf-admin)',
ref: 'jnpf/后端/jnpf-system/jnpf-system-controller/.../DataInterfaceController.java @GetMapping("/{id}/Actions/Export")',
ref: 'jnpf/后端/jnpf-java-boot/jnpf-system/jnpf-system-controller/src/main/java/jnpf/base/controller/DataInterfaceController.java @GetMapping("/{id}/Actions/Export")',
},
notes: [
'v0.15+ 走 webapi 镜像 (loadDataInterface.exportData), 替代旧版 c.get',
+1 -1
View File
@@ -61,7 +61,7 @@ export function buildDiInfoCommand(): Command {
required: { '--id': '数据接口 id' },
optional: { '--json': '原始 JSON 输出' },
example: 'dacli di info --id=1234567890',
source: { api: 'GET /api/system/DataInterface/{id}', ref: 'web/.../api/systemData/dataInterface.ts getDataInterfaceInfo()' },
source: { api: 'GET /api/system/DataInterface/{id}', ref: 'web/apps/jnpf-web-apps-main/src/api/systemData/dataInterface.ts getDataInterfaceInfo()' },
notes: ['v0.11+ 改用 webapi 镜像 (loadDataInterface.getDataInterfaceInfo)'],
})
return cmd
+1 -1
View File
@@ -163,7 +163,7 @@ export function buildDiListCommand(): Command {
required: {},
optional: { '--keyword': '搜索' },
example: 'dacli di list',
source: { api: 'GET /api/system/DataInterface', ref: 'web/.../api/systemData/dataInterface.ts getDataInterfaceList()' },
source: { api: 'GET /api/system/DataInterface', ref: 'web/apps/jnpf-web-apps-main/src/api/systemData/dataInterface.ts getDataInterfaceList()' },
notes: ['v0.11+ 改用 webapi 镜像 (loadDataInterface.getDataInterfaceList)'],
})
return cmd
+1 -1
View File
@@ -91,7 +91,7 @@ export function buildDiTestCommand(): Command {
'dacli di test --id=1234567890 --data=\'{"userId":"u1"}\'',
'dacli di test --id=1234567890 --data=\'{}\' --dry-run # 调试 body 格式',
],
source: { api: 'POST /api/system/DataInterface/{id}/Actions/Preview', ref: 'web/.../api/systemData/dataInterface.ts getDataInterfaceRes()' },
source: { api: 'POST /api/system/DataInterface/{id}/Actions/Preview', ref: 'web/apps/jnpf-web-apps-main/src/api/systemData/dataInterface.ts getDataInterfaceRes()' },
notes: [
'v0.11+ 改用 webapi 镜像 (loadDataInterface.getDataInterfaceRes)',
'**v0.15+ (R3.6)**: 加 --dry-run 选项, 仅显示 body 不调用, 防误传破坏性 DI',
+1 -1
View File
@@ -125,7 +125,7 @@ export function buildDiUpdateCommand(): Command {
required: { '--id': '数据接口 id' },
optional: { '--fullName': '中文名', '--enCode': '英文编码', '--categoryId': '分类 id', '--action': '动作 (1=增 2=改 3=查 4=删, type=1 必填)', '--url': '接口路径/URL', '--expected-enCode': '防 AI 误覆盖 (A2)', '--expected-state': '防 AI 误覆盖 (A2)', '--force': '跳过 dirty check (A2)' },
example: 'dacli di update --id=123 --url=/api/new/path',
source: { api: 'PUT /api/system/DataInterface/{id}', ref: 'web/.../api/systemData/dataInterface.ts updateDataInterface() (后端: jnpf/.../DataInterfaceController.java:292-311)' },
source: { api: 'PUT /api/system/DataInterface/{id}', ref: 'web/apps/jnpf-web-apps-main/src/api/systemData/dataInterface.ts updateDataInterface() (后端: jnpf/.../DataInterfaceController.java:292-311)' },
notes: [
'v0.11+ 改用 webapi 镜像 (loadDataInterface.updateDataInterface)',
'v0.11e+ Phase A2: dirty check --expected-enCode/--expected-state/--force (防 AI session 长时间保留误覆盖)',
+1 -1
View File
@@ -53,7 +53,7 @@ export function buildDictDataDeleteCommand(): Command {
purpose: '字典项删除',
required: { '--id': '字典项 id', '--yes': '跳过确认' },
example: 'dacli dict dataDelete --id=123 --yes',
source: { api: 'DELETE /api/system/DictionaryData/{id}', ref: 'web/.../api/systemData/dictionary.ts delDictionaryData()' },
source: { api: 'DELETE /api/system/DictionaryData/{id}', ref: 'web/apps/jnpf-web-apps-main/src/api/systemData/dictionary.ts delDictionaryData()' },
notes: ['v0.11+ 改用 webapi 镜像 (loadDict.delDictionaryData)', '谨慎操作'],
})
return cmd
+1 -1
View File
@@ -119,7 +119,7 @@ export function buildDictDataUpdateCommand(): Command {
'dacli dict dataUpdate --id=123 --fullName=新名',
'dacli dict dataUpdate --id=123 --enabledMark=0 (禁用)',
],
source: { api: 'PUT /api/system/DictionaryData/{id}', ref: 'web/.../api/systemData/dictionary.ts updateDictionaryData()' },
source: { api: 'PUT /api/system/DictionaryData/{id}', ref: 'web/apps/jnpf-web-apps-main/src/api/systemData/dictionary.ts updateDictionaryData()' },
notes: ['v0.11+ 改用 webapi 镜像 (loadDict.updateDictionaryData)'],
})
return cmd
+1 -1
View File
@@ -53,7 +53,7 @@ export function buildDictTypeDeleteCommand(): Command {
purpose: '字典类型删除 (级联删字典项)',
required: { '--id': '字典类型 id', '--yes': '跳过确认' },
example: 'dacli dict typeDelete --id=123 --yes',
source: { api: 'DELETE /api/system/DictionaryType/{id}', ref: 'web/.../api/systemData/dictionary.ts delDictionaryType()' },
source: { api: 'DELETE /api/system/DictionaryType/{id}', ref: 'web/apps/jnpf-web-apps-main/src/api/systemData/dictionary.ts delDictionaryType()' },
notes: ['v0.11+ 改用 webapi 镜像 (loadDict.delDictionaryType)', '谨慎操作 (会级联删字典项)'],
})
return cmd
+1 -1
View File
@@ -146,7 +146,7 @@ export function buildDictTypeListCommand(): Command {
'--tree': '显示原始树形结构 (调试用)',
},
example: 'dacli dict typeList --keyword=jxcj',
source: { api: 'GET /api/system/DictionaryType', ref: 'web/.../api/systemData/dictionary.ts:9 getDictionaryType()' },
source: { api: 'GET /api/system/DictionaryType', ref: 'web/apps/jnpf-web-apps-main/src/api/systemData/dictionary.ts:9 getDictionaryType()' },
notes: [
'v0.11+ 改用 webapi 镜像',
'BS-47 dict 全平台唯一, 创前必跑此命令查重',
+1 -1
View File
@@ -120,7 +120,7 @@ export function buildDictTypeUpdateCommand(): Command {
required: { '--id': '字典类型 id' },
optional: { '--fullName': '名', '--enCode': '编码', '--category': '分类', '--isTree': '树形', '--sortCode': '排序', '--expected-enCode': '防 AI 误覆盖 (A2)', '--expected-state': '防 AI 误覆盖 (A2)', '--force': '跳过 dirty check (A2)' },
example: 'dacli dict typeUpdate --id=123 --fullName=新名',
source: { api: 'PUT /api/system/DictionaryType/{id}', ref: 'web/.../api/systemData/dictionary.ts updateDictionaryType()' },
source: { api: 'PUT /api/system/DictionaryType/{id}', ref: 'web/apps/jnpf-web-apps-main/src/api/systemData/dictionary.ts updateDictionaryType()' },
notes: [
'v0.11+ 改用 webapi 镜像 (loadDict.updateDictionaryType)',
'v0.11e+ Phase A2: dirty check --expected-enCode/--expected-state/--force (防 AI session 长时间保留误覆盖)',
+1 -1
View File
@@ -246,7 +246,7 @@ export function buildDmCreateCommand(): Command {
required: { '--table': '表名', '--tableName': '中文名', '--fields': '字段 JSON' },
optional: { '--dbLinkId': '业务库 id' },
example: `dacli dm create --table=test_table --tableName="测试表" --fields='[{"field":"f_name","fieldName":"名称","dataType":"varchar","dataLength":"100","allowNull":0,"primaryKey":1}]'`,
source: { api: 'POST /api/system/DataModel/{dbLinkId}/Table', ref: 'web/views/dataCenter/dataModel/Form.vue (后端: jnpf/.../DbTableController.java:262-280)' },
source: { api: 'POST /api/system/DataModel/{dbLinkId}/Table', ref: 'web/apps/jnpf-web-apps-main/src/views/dataCenter/dataModel/Form.vue (后端: jnpf/.../DbTableController.java:262-280)' },
notes: [
'v0.11d+ step machine (镜像 web dataModel/Form.vue handleSubmit + 后端 DbTableController.checkName):',
' step 0 基础信息: table 正则 + tableName 必填 (镜像 Form.vue:50 正则 + L57 tableName)',
+1 -1
View File
@@ -80,7 +80,7 @@ export function buildDmDropCommand(): Command {
required: { '--table': '表名', '--yes': '必须传 --yes 跳过确认' },
optional: { '--dbLinkId': '业务库 id' },
example: 'dacli dm drop --table=test_table --yes',
source: { api: 'DELETE /api/system/DataModel/{dbLinkId}/Table/{table}', ref: 'web/.../api/systemData/dataModel.ts delDataModel()' },
source: { api: 'DELETE /api/system/DataModel/{dbLinkId}/Table/{table}', ref: 'web/apps/jnpf-web-apps-main/src/api/systemData/dataModel.ts delDataModel()' },
notes: [
'v0.11+ 改用 webapi 镜像',
'生产环境务必先用 dacli app init --backup 备份',
+4 -4
View File
@@ -9,8 +9,8 @@
* 3. 自写 LLM response 解析 (parseAiFormText/parseAiFlowText) 已被 web 端 buildFormData 替代
* web buildFormData 才是 web 端权威的 formData/flowNodes 构造逻辑
* 镜像原型:
* - web/.../api/onlineDev/visualDev.ts: getAiInfo (form AI) → POST /api/visualdev/ai/form
* - web/.../api/workFlow/template.ts: getAiInfo (flow AI) → POST /api/workflow/ai
* - web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts: getAiInfo (form AI) → POST /api/visualdev/ai/form
* - web/apps/jnpf-web-apps-main/src/api/workFlow/template.ts: getAiInfo (flow AI) → POST /api/workflow/ai
* - JNPF 后端: jnpf/.../VisualAiController.java (form) + WorkFlowAiController.java (flow)
* 消费方:
* - form/create.ts: --ai → callAiForm
@@ -137,7 +137,7 @@ function buildAiTruncationHint(keyword: string): string {
* 4. 静默截断 (code=200 但 data 空) → fallback 到 SSW AI 修复
* 5. SSW 端点 (POST /api/ssw/ai/repair) 自己调 LLM + 修复 JSON + 返回 VisualAiModel
* 6. SSW 也 429 时 retry 2 次 (退避 5s/10s), 然后才失败
* 镜像 web/.../api/onlineDev/visualDev.ts: getAiInfo → POST /api/visualdev/ai/form
* 镜像 web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts: getAiInfo → POST /api/visualdev/ai/form
* + shared module SswAIRepairController → POST /api/ssw/ai/repair (绕开 jnpf SendAiMessage)
*/
@@ -322,7 +322,7 @@ async function callSswAiRepair(keyword: string, reason: string, aiChain: string[
}
/** 5.10.3 — AI 创建流程 (NCPF backend + SSW 修复 fallback)
* 镜像 web/.../api/workFlow/template.ts: getAiInfo → POST /api/workflow/ai
* 镜像 web/apps/jnpf-web-apps-main/src/api/workFlow/template.ts: getAiInfo → POST /api/workflow/ai
* (workflow, 2026-07-02): 加 SSW 修复层, 跟 form --ai 模式一致
* - NCPF /api/workflow/ai 失败 (SYS181 截断, 429 token plan 用尽, 静默截断)
* - Fallback: POST /api/ssw/ai/repair-workflow (shared module-controller)
+2 -2
View File
@@ -13,8 +13,8 @@
* 当用户字段名符合命名模式 (*_space / *_id / *_code) 且能找到匹配的 form enCode.
*
* 镜像源:
* - web/src/components/FormGenerator/src/FormGenerator.vue:272-276 (relationForm 校验)
* - web/src/components/FormGenerator/src/helper/formUtils.ts:14-77 (buildFormData schema 生成)
* - web/apps/jnpf-web-apps-main/src/components/FormGenerator/src/FormGenerator.vue:272-276 (relationForm 校验)
* - web/apps/jnpf-web-apps-main/src/components/FormGenerator/src/helper/formUtils.ts:14-77 (buildFormData schema 生成)
* - dacli B-13 fix: create.ts:169-220 (relationForm 注入逻辑 — fieldRelationConfig 路径)
*
* 命名启发 (启发式, 不强制):
+1 -1
View File
@@ -631,7 +631,7 @@ export function buildFormAuditCommand(): Command {
],
source: {
ref: 'docs/dos/debug.md §5.2 (dos 26 P0 漏洞) + docs/dos/TC_C_SOURCE_IMPORT.md (testspace 复现)',
web: 'web/.../FormGenerator/FormGenerator.vue (字段渲染) + web/.../onlineDev/Form.vue (formRules 配置)',
web: 'web/apps/jnpf-web-apps-main/src/components/FormGenerator/src/FormGenerator.vue (字段渲染) + web/apps/jnpf-web-apps-main/src/views/onlineDev/Form.vue (formRules 配置)',
api: '/visualdev/Base/{id} (webapi 镜像 formData/columnData/tables)',
},
notes: [
+3 -3
View File
@@ -50,7 +50,7 @@ interface CodegenOpts {
* (a) `--auto-alias`: 从 form.tables + mainClassName 自动推导 (主表别名 = mainClassName)
* (b) `--alias-file <path>`: 从 JSON 文件读 [{table, aliasName, fields?}, ...]
* (c) `--alias <json>`: 直接传 JSON 字符串
* 参考 web/.../formDesign/components/AliasModal.vue + jnpf/.../VisualAliasEntity.java
* 参考 web/apps/jnpf-web-apps-main/src/formDesign/components/AliasModal.vue + jnpf/.../VisualAliasEntity.java
*/
/** --auto-alias (默认 true): 写 base_visual_alias, JNPF 用别名生成 PascalCase 类名
* --no-alias: 关闭, 走 CodePreview 原始输出 (类名 = 表名 = Jxcj_xxx) */
@@ -756,7 +756,7 @@ export function buildFormCodegenCommand(): Command {
log.info(` mainClassName = ${mainClassName} (PascalCase 主类)`)
log.info('')
// body 字段严格对齐 web/.../PreviewModal.vue:56-61 + DownloadModal.vue:63-64
// body 字段严格对齐 web/apps/jnpf-web-apps-main/src/PreviewModal.vue:56-61 + DownloadModal.vue:63-64
// module: 来自 createModule 字典 id (web DownloadModal.vue:69 取 moduleOptions[0].id)
// description: web 默认 = mainTable.table (主表名, 不是 fullName 中文名)
// ⚠ 不要加 dataSourceId / mainClassName / contrast — FormMarco.vm:1226 对空字符串调
@@ -1066,7 +1066,7 @@ export function buildFormCodegenCommand(): Command {
'dacli form codegen <formId> --module=tds --enable-flow=1 --auto-alias --mainClassName=tdsBilling',
],
source: {
web: 'web/.../formDesign/components/DownloadModal.vue:33-46 (dataForm 默认值) + PreviewModal.vue:56-61 (CodePreview body) + AliasModal.vue:74-100 (命名规范)',
web: 'web/apps/jnpf-web-apps-main/src/views/onlineDev/formDesign/components/DownloadModal.vue:33-46 (dataForm 默认值) + PreviewModal.vue:56-61 (CodePreview body) + AliasModal.vue:74-100 (命名规范)',
api: 'POST /api/visualdev/Generater/{id}/Actions/CodePreview + Alias/Save (base_visual_alias)',
ref: 'docs/aibridge/docs/code-rule.md (命名规则/POM/API 路径) + jnpf/后端/.../VisualAliasEntity.java (DB 表 base_visual_alias)',
},
+2 -2
View File
@@ -1490,7 +1490,7 @@ export function buildFormCreateCommand(): Command {
log.info(`loadVisualDev.release (formId=${newId})`)
// release 失败时重试 1 次 (500ms 间隔), 仍失败 process.exit(1)
// 后端: VisualdevController.java:593 publish() — state=1 + base_visual_release 行 saveOrUpdate (line 673)
// web 端: web/.../api/onlineDev/visualDev.ts:43 release(id) → POST /visualdev/Base/{id}/Actions/Release
// web 端: web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts:43 release(id) → POST /visualdev/Base/{id}/Actions/Release
const tryRelease = async (): Promise<void> => {
await loadVisualDev.release(newId) // unwrap() throws on non-200
}
@@ -1663,7 +1663,7 @@ export function buildFormCreateCommand(): Command {
'dacli form create --ai "请假管理表单, 含姓名/部门/请假天数/原因/审批人"',
'dacli form create --ai-field "请假天数, 含字典 [事假/病假/年假]" # 只问不建',
],
source: { web: 'web/.../formDesign/Form.vue:444-465 + AI助手.vue', api: 'POST /api/visualdev/Base | POST /api/visualdev/ai/form' },
source: { web: 'web/apps/jnpf-web-apps-main/src/views/onlineDev/formDesign/Form.vue:444-465 + AI助手.vue', api: 'POST /api/visualdev/Base | POST /api/visualdev/ai/form' },
notes: [
'推荐 dm→form 两步: dm create 建物理表 → form create --ai "<描述>" 建表单',
'autoRelease 对 type=4 自动跳过 (release 会 400)',
+1 -1
View File
@@ -121,7 +121,7 @@ export function buildFormExportCommand(): Command {
notes: [
'v0.7 默认带物理表 schema (_physicalSchema 字段), 配合 form import --autoTable 重建物理表',
'v0.8.2 修: URL 用 Tables (复数) 跟 web 端 TableList/index.vue 一致; 单数 Table 返回 404 空',
'web/.../formDesign/Form.vue tables[].fields 是 DB 实时查的, 不在 form JSON 里, 所以必须单独拉',
'web/apps/jnpf-web-apps-main/src/formDesign/Form.vue tables[].fields 是 DB 实时查的, 不在 form JSON 里, 所以必须单独拉',
],
})
+1 -1
View File
@@ -111,7 +111,7 @@ export function buildFormPreviewCommand(): Command {
'dacli form preview --id=840232970903094085 --json # 调试 schema',
],
source: {
web: 'web/.../components/FormGenerator/ + no-spa-page 风格',
web: 'web/apps/jnpf-web-apps-main/src/components/FormGenerator/ + no-spa-page 风格',
api: 'loadVisualDev.getInfo (走 webapi 镜像)',
ref: 'formData.fields 镜像 FormGenerator 渲染 + columnData.columnList 镜像 List 组件',
},
+1 -1
View File
@@ -5,7 +5,7 @@
* - 创建菜单挂 form 时, 需要先知道有哪些 form 可挂
* - 创建工作流时, 也要选起始 form
* - 表单 select 字段要配 dataSource 时, 也要 form 列表
* web 端对应 API: web/.../api/onlineDev/visualDev.ts:63 getVisualDevSelector()
* web 端对应 API: web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts:63 getVisualDevSelector()
*
* v0.11+ (2026-06-25): 用 webapi/visualDev.getVisualDevSelector 直接 import
*/
+1 -1
View File
@@ -315,7 +315,7 @@ export function buildFormUpdateCommand(): Command {
'# 仅重新发布',
'dacli form update --id=123 --releaseOnly',
],
source: { api: 'PUT /api/visualdev/Base/{id}', ref: 'web/.../api/onlineDev/visualDev.ts update()' },
source: { api: 'PUT /api/visualdev/Base/{id}', ref: 'web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts update()' },
notes: [
'v0.11+ P0 高需求 NEW-CMD',
'PUT 语义, 未传字段保留原值',
+1 -1
View File
@@ -90,7 +90,7 @@ export function buildIntegrationEmailTestCommand(): Command {
source: {
web: 'web/apps/jnpf-web-apps-main/src/views/integrationCenter/email/Test.vue',
api: 'POST /api/message/AccountConfig/testSendMail',
ref: 'web/.../api/msgCenter/accountConfig.ts:29 testConfig()',
ref: 'web/apps/jnpf-web-apps-main/src/api/msgCenter/accountConfig.ts:29 testConfig()',
},
})
return cmd
+1 -1
View File
@@ -68,7 +68,7 @@ export function buildLogExceptionCommand(): Command {
source: {
web: 'web/apps/jnpf-web-apps-main/src/views/sysLog/errorLog/index.vue',
api: 'GET /api/system/Log?category=4',
ref: 'web/.../api/system/log.ts getLogList()',
ref: 'web/apps/jnpf-web-apps-main/src/api/system/log.ts getLogList()',
},
notes: ['v0.11+ 改用 webapi 镜像 (loadLog.getLogList + category=4)'],
})
+2 -2
View File
@@ -23,7 +23,7 @@ export function buildLogLoginCommand(): Command {
.action(async (opts: ListOpts) => {
const c = await JnpfClient.fromToken()
await initWebapi(c)
// JNPF 登录日志 = Log + category='1' (web/src/views/sysLog/loginLog/index.vue:20 category:'1')
// JNPF 登录日志 = Log + category='1' (web/apps/jnpf-web-apps-main/src/views/sysLog/loginLog/index.vue:20 category:'1')
const r = (await loadLog.getLogList({
category: '1',
keyword: opts.keyword,
@@ -51,7 +51,7 @@ export function buildLogLoginCommand(): Command {
source: {
web: 'web/apps/jnpf-web-apps-main/src/views/sysLog/loginLog/index.vue',
api: 'GET /api/system/Log?category=1',
ref: 'web/.../api/system/log.ts getLogList()',
ref: 'web/apps/jnpf-web-apps-main/src/api/system/log.ts getLogList()',
},
notes: ['v0.11+ 改用 webapi 镜像 (loadLog.getLogList + category=1)'],
})
+2 -2
View File
@@ -23,7 +23,7 @@ export function buildLogOperateCommand(): Command {
.action(async (opts: ListOpts) => {
const c = await JnpfClient.fromToken()
await initWebapi(c)
// JNPF 操作日志 = Log + category='3' (web/src/views/sysLog/operateLog/index.vue:23 category:'3')
// JNPF 操作日志 = Log + category='3' (web/apps/jnpf-web-apps-main/src/views/sysLog/operateLog/index.vue:23 category:'3')
const r = (await loadLog.getLogList({
category: '3',
keyword: opts.keyword,
@@ -51,7 +51,7 @@ export function buildLogOperateCommand(): Command {
source: {
web: 'web/apps/jnpf-web-apps-main/src/views/sysLog/operateLog/index.vue',
api: 'GET /api/system/Log?category=3',
ref: 'web/.../api/system/log.ts getLogList()',
ref: 'web/apps/jnpf-web-apps-main/src/api/system/log.ts getLogList()',
},
notes: ['v0.11+ 改用 webapi 镜像 (loadLog.getLogList + category=3)'],
})
+1 -1
View File
@@ -59,7 +59,7 @@ export function buildLogRequestCommand(): Command {
'dacli log request --keyword=/api/visualdev',
'dacli log request --keyword=500 --limit=10',
],
source: { web: 'web/apps/jnpf-web-apps-main/src/views/sysLog/requestLog/index.vue', api: 'GET /api/system/Log?category=5', ref: 'web/.../api/system/log.ts getLogList()' },
source: { web: 'web/apps/jnpf-web-apps-main/src/views/sysLog/requestLog/index.vue', api: 'GET /api/system/Log?category=5', ref: 'web/apps/jnpf-web-apps-main/src/api/system/log.ts getLogList()' },
notes: ['v0.11+ 改用 webapi 镜像 (loadLog.getLogList + category=5)'],
})
return cmd
+2 -2
View File
@@ -2,8 +2,8 @@
* commands/menu/_helpers.ts — 菜单命令共享辅助
*
* 抽取自:
* - web/src/api/system/menu.ts (12 端点)
* - web/src/api/onlineDev/visualDev.ts (Actions/Module + getReleaseMenu)
* - web/apps/jnpf-web-apps-main/src/api/system/menu.ts (12 端点)
* - web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts (Actions/Module + getReleaseMenu)
* - dacli/src/commands/menu/{list,create,delete,unrelease}.ts (4 命令)
*
* 共享:
+1 -1
View File
@@ -11,7 +11,7 @@
* future update / delete by enCode / etc.
*
* 镜像源:
* - web GetMenuList (web/src/api/system/menu.ts:8-10) GET /api/system/Menu/ModuleBySystem
* - web GetMenuList (web/apps/jnpf-web-apps-main/src/api/system/menu.ts:8-10) GET /api/system/Menu/ModuleBySystem
* - B-15 fix: dacli/src/commands/dict/_lookup.ts lookupTypeIdByEnCode
*/
import { JnpfClient } from '../../core/client.ts'
+3 -3
View File
@@ -3,7 +3,7 @@
* 重写: 优先用 web 真路径 (POST /api/visualdev/Base/{formId}/Actions/Module).
* - 体现 prompt §2.1 "复用 web 源码" 初心
* - 后端自动构造 moduleId/propertyJson/urlAddress/pageAddress 等所有字段
* - 移植自 web/views/onlineDev/formDesign/components/CreateMenuModal.vue handleSubmit (line ~120)
* - 移植自 web/apps/jnpf-web-apps-main/src/views/onlineDev/formDesign/components/CreateMenuModal.vue handleSubmit (line ~120)
* 两种模式:
* A) 挂表单菜单 (--formId 给) — 走 web Actions/Module 高级 API
* B) 普通菜单 (目录/外链) — 走 POST /api/system/Menu 低级 API
@@ -414,7 +414,7 @@ export function buildMenuCreateCommand(): Command {
],
source: {
api: 'POST /api/visualdev/Base/{formId}/Actions/Module (挂表单) / POST /api/system/Menu (普通)',
ref: 'web/views/onlineDev/formDesign/components/CreateMenuModal.vue + web/views/permission/menu/Form.vue (后端: jnpf/.../ModuleController.java:172-190)',
ref: 'web/apps/jnpf-web-apps-main/src/views/onlineDev/formDesign/components/CreateMenuModal.vue + web/apps/jnpf-web-apps-main/src/views/permission/menu/Form.vue (后端: jnpf/.../ModuleController.java:172-190)',
},
notes: [
'v0.11d+ step machine (镜像 web Form.vue handleSubmit + 后端 ModuleController create):',
@@ -436,7 +436,7 @@ export function buildMenuCreateCommand(): Command {
* 用法:
* - Mode B 主路径 (目录/外链等): `dacli menu create --fullName=X --type=1`
* - Mode A fallback (P0-4): `Actions/Module` 报 code=400 "找不到该上级" 时自动调用, 强制 type=3, icon='icon-ym icon-ym-form'
* 镜像: web/views/permission/menu/Form.vue handleSubmit (后端: jnpf/.../MenuController.java)
* 镜像: web/apps/jnpf-web-apps-main/src/views/permission/menu/Form.vue handleSubmit (后端: jnpf/.../MenuController.java)
* + D-9/D-12 自动拉 form 拼 propertyJson.moduleId (修复)
* + --moduleId 覆盖 (跨 app 引用 form)
* + --sortCode 透传 (默认 0)
+1 -1
View File
@@ -136,7 +136,7 @@ export function buildMenuDeleteCommand(): Command {
'--fallback': 'DELETE 失败时自动调 unrelease (formId 未知时跳兜底)',
},
example: 'dacli menu delete --enCode=tds2_user --yes',
source: { api: 'DELETE /api/system/Menu/{id}', ref: 'web/src/api/system/menu.ts:32 delMenu()' },
source: { api: 'DELETE /api/system/Menu/{id}', ref: 'web/apps/jnpf-web-apps-main/src/api/system/menu.ts:32 delMenu()' },
notes: [
'v0.11+ 改用 webapi 镜像 (loadMenu.delMenu)',
'JNPF 自动给 enCode 加 5 位 hash 后缀 (e.g. tds2_user → tds2_user18656), --enCode 模糊匹配容忍',
+1 -1
View File
@@ -69,7 +69,7 @@ export function buildMenuInfoCommand(): Command {
required: { '--id': '菜单 id' },
optional: { '--json': '原始 JSON 输出' },
example: 'dacli menu info --id=835168490678657989',
source: { api: 'GET /api/system/Menu/{id}', ref: 'web/src/api/system/menu.ts:28 getInfo()' },
source: { api: 'GET /api/system/Menu/{id}', ref: 'web/apps/jnpf-web-apps-main/src/api/system/menu.ts:28 getInfo()' },
notes: ['v0.11+ 改用 webapi 镜像 (loadMenu.getInfo)'],
})
return cmd
+1 -1
View File
@@ -135,7 +135,7 @@ export function buildMenuListCommand(): Command {
example: 'dacli menu list --include-actions',
source: {
api: 'GET /api/system/Menu/ModuleBySystem (默认) / GET /api/visualdev/Base + /visualdev/Base/{id}/getReleaseMenu (--include-actions)',
web: 'web/src/api/onlineDev/visualDev.ts (getReleaseMenu) + web/src/views/onlineDev/formDesign/CreateMenuModal.vue',
web: 'web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts (getReleaseMenu) + web/apps/jnpf-web-apps-main/src/views/onlineDev/formDesign/CreateMenuModal.vue',
},
notes: [
'先 dacli app switch --appCode=X 切到目标应用, 才能看到对应菜单',
+1 -1
View File
@@ -100,7 +100,7 @@ export function buildMenuPurgeCommand(): Command {
example: 'dacli menu purge --formId=838303454798544965 --yes',
source: {
api: 'GET /api/visualdev/Base/{id}/getReleaseMenu → DELETE /api/system/Menu/{id}',
ref: 'web/src/api/onlineDev/visualDev.ts:47 + web/src/api/system/menu.ts:32',
ref: 'web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts:47 + web/apps/jnpf-web-apps-main/src/api/system/menu.ts:32',
},
notes: [
'v0.11+ 改用 webapi 镜像 (loadVisualDev.getReleaseMenu + loadMenu.delMenu + loadVisualDev.createMenu)',
+1 -1
View File
@@ -42,7 +42,7 @@ export function buildMenuReleasesCommand(): Command {
required: { '--formId': '表单 id' },
optional: { '--json': '原始 JSON 输出' },
example: 'dacli menu releases --formId=838303454798544965',
source: { api: 'GET /api/visualdev/Base/{id}/getReleaseMenu', ref: 'web/src/api/onlineDev/visualDev.ts:47 getReleaseMenu()' },
source: { api: 'GET /api/visualdev/Base/{id}/getReleaseMenu', ref: 'web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts:47 getReleaseMenu()' },
notes: ['pc 桌面端 + app 移动端各 1 个菜单 (独立 id)', '删除走 menu purge --formId=X'],
})
return cmd
+1 -1
View File
@@ -67,7 +67,7 @@ export function buildMenuUnreleaseCommand(): Command {
example: 'dacli menu unrelease --formId=835141398800901061',
source: {
api: 'POST /api/visualdev/Base/{formId}/Actions/Module',
ref: 'web/views/onlineDev/formDesign/components/CreateMenuModal.vue (前端有 pc/app 至少一个校验, 后端无)',
ref: 'web/apps/jnpf-web-apps-main/src/views/onlineDev/formDesign/components/CreateMenuModal.vue (前端有 pc/app 至少一个校验, 后端无)',
},
notes: ['v0.11+ 改用 webapi 镜像 (loadVisualDev.createMenu)', '仅适用于 type=3 VisualDev 菜单', '普通目录/外链请用 menu delete'],
})
+4 -4
View File
@@ -9,9 +9,9 @@
* API: PUT /api/system/Menu/{id} (webapi 镜像)
*
* 镜像源:
* - web/src/api/system/menu.ts:24-26 update(data) → PUT /api/system/Menu/${data.id}
* - web/src/views/permission/menu/Form.vue:230-269 handleSubmit (state mutation → API)
* - web/src/views/permission/menu/Form.vue:281-294 onTypeChange (type → is*Authorize)
* - web/apps/jnpf-web-apps-main/src/api/system/menu.ts:24-26 update(data) → PUT /api/system/Menu/${data.id}
* - web/apps/jnpf-web-apps-main/src/views/permission/menu/Form.vue:230-269 handleSubmit (state mutation → API)
* - web/apps/jnpf-web-apps-main/src/views/permission/menu/Form.vue:281-294 onTypeChange (type → is*Authorize)
*/
import { Command } from 'commander'
import { JnpfClient } from '../../core/client.ts'
@@ -234,7 +234,7 @@ export function buildMenuUpdateCommand(): Command {
],
source: {
api: 'PUT /api/system/Menu/{id}',
ref: 'web/src/api/system/menu.ts:24-26 update() + web/src/views/permission/menu/Form.vue:230-269 handleSubmit',
ref: 'web/apps/jnpf-web-apps-main/src/api/system/menu.ts:24-26 update() + web/apps/jnpf-web-apps-main/src/views/permission/menu/Form.vue:230-269 handleSubmit',
},
notes: [
'镜像 web Menu/Form.vue:230-269 handleSubmit: 构造 body + JSON.stringify(propertyJson) → loadMenu.update',
+1 -1
View File
@@ -35,7 +35,7 @@ export function buildMonitorFlowCommand(): Command {
installHelpHook(cmd, {
purpose: '流程监控 (待办/运行中流程)',
example: 'dacli monitor flow',
source: { api: 'GET /api/workflow/monitor', ref: 'web/.../api/workFlow/flowMonitor.ts getFlowMonitorList()' },
source: { api: 'GET /api/workflow/monitor', ref: 'web/apps/jnpf-web-apps-main/src/api/workFlow/flowMonitor.ts getFlowMonitorList()' },
notes: ['v0.11+ 改用 webapi 镜像 (loadFlowMonitor.getFlowMonitorList)'],
})
return cmd
+1 -1
View File
@@ -59,7 +59,7 @@ export function buildMonitorOnlineCommand(): Command {
installHelpHook(cmd, {
purpose: '在线用户监控 (当前登录的用户)',
example: 'dacli monitor online',
source: { api: 'GET /api/system/OnlineUser', ref: 'web/.../api/permission/onlineUser.ts getOnlineUser()' },
source: { api: 'GET /api/system/OnlineUser', ref: 'web/apps/jnpf-web-apps-main/src/api/permission/onlineUser.ts getOnlineUser()' },
notes: ['v0.11+ 改用 webapi 镜像 (loadOnlineUser.getOnlineUser)'],
})
return cmd
+1 -1
View File
@@ -59,7 +59,7 @@ export function buildMonitorServerCommand(): Command {
purpose: '服务器状态 (CPU/内存/磁盘/JVM, AI 性能诊断最高优先级). v0.11+ webapi.',
optional: { '--json': '原始 JSON 输出' },
example: ['dacli monitor server', 'dacli monitor server --json'],
source: { api: 'GET /api/system/Monitor', ref: 'web/.../api/system/monitor.ts getSysMonitor()' },
source: { api: 'GET /api/system/Monitor', ref: 'web/apps/jnpf-web-apps-main/src/api/system/monitor.ts getSysMonitor()' },
notes: ['v0.11+ 改用 webapi 镜像 (loadMonitor.getSysMonitor)'],
})
return cmd
+1 -1
View File
@@ -53,7 +53,7 @@ export function buildMsgNoticeDeleteCommand(): Command {
purpose: '通知公告删除',
required: { '--id': '公告 id', '--yes': '跳过确认' },
example: 'dacli msg noticeDelete --id=123 --yes',
source: { api: 'DELETE /api/message/Notice/{id}', ref: 'web/.../api/msgCenter/notice.ts delNotice()' },
source: { api: 'DELETE /api/message/Notice/{id}', ref: 'web/apps/jnpf-web-apps-main/src/api/msgCenter/msgMonitor.ts delNotice() (原文档引用 notice.ts 不存在, msgMonitor.ts 是 msgCenter 唯一含 notice CRUD 的文件 — 待人工 verify)' },
notes: ['v0.11+ 改用 webapi 镜像 (loadNotice.delNotice)', '谨慎操作'],
})
return cmd
+1 -1
View File
@@ -122,7 +122,7 @@ export function buildMsgNoticeUpdateCommand(): Command {
'--force': '跳过 dirty check (A2)',
},
example: 'dacli msg noticeUpdate --id=123 --body="新内容"',
source: { api: 'PUT /api/message/Notice/{id}', ref: 'web/.../api/msgCenter/notice.ts update()' },
source: { api: 'PUT /api/message/Notice/{id}', ref: 'web/apps/jnpf-web-apps-main/src/api/msgCenter/msgMonitor.ts update() (原文档引用 notice.ts 不存在, 就近改指 msgMonitor.ts — 待人工 verify)' },
notes: [
'v0.11+ 改用 webapi 镜像 (loadNotice.update)',
'v0.11e+ Phase A2: dirty check --expected-enCode (防 AI session 误覆盖)',
+1 -1
View File
@@ -53,7 +53,7 @@ export function buildMsgTemplateDeleteCommand(): Command {
purpose: '消息模板删除',
required: { '--id': '模板 id', '--yes': '跳过确认' },
example: 'dacli msg templateDelete --id=123 --yes',
source: { api: 'DELETE /api/message/MessageTemplateConfig/{id}', ref: 'web/.../api/msgCenter/msgTemplate.ts delMsgTemplate()' },
source: { api: 'DELETE /api/message/MessageTemplateConfig/{id}', ref: 'web/apps/jnpf-web-apps-main/src/api/msgCenter/msgTemplate.ts delMsgTemplate()' },
notes: ['v0.11+ 改用 webapi 镜像 (loadMsgTemplate.delMsgTemplate)', '谨慎操作'],
})
return cmd
+1 -1
View File
@@ -77,7 +77,7 @@ export function buildMsgTemplateUpdateCommand(): Command {
required: { '--id': '模板 id' },
optional: { '--fullName': '模板名', '--enCode': '英文编码', '--category': '分类', '--content': '内容', '--enabledMark': '启用/禁用' },
example: 'dacli msg templateUpdate --id=123 --content="新内容"',
source: { api: 'PUT /api/message/MessageTemplateConfig/{id}', ref: 'web/.../api/msgCenter/msgTemplate.ts update()' },
source: { api: 'PUT /api/message/MessageTemplateConfig/{id}', ref: 'web/apps/jnpf-web-apps-main/src/api/msgCenter/msgTemplate.ts update()' },
notes: ['v0.11+ 改用 webapi 镜像 (loadMsgTemplate.update)'],
})
return cmd
+2 -2
View File
@@ -141,9 +141,9 @@ export function buildOrgCreateCommand(): Command {
optional: { '--enabledMark': '0/1 启用', '--sortCode': '排序' },
example: 'dacli org create --fullName=技术部 --enCode=tech_dept --parentId=-1 --category=1',
source: {
web: 'web/apps/jnpf-web-apps-main/src/views/permission/organize/Form.vue',
web: 'web/apps/jnpf-web-apps-main/src/views/permission/organize/OrganizeForm.vue',
api: 'POST /api/permission/Organize',
ref: 'jnpf/后端/jnpf-java-boot/jnpf-permission/jnpf-permission-controller/src/main/java/jnpf/controller/OrganizeController.java',
ref: 'jnpf/后端/jnpf-java-boot/jnpf-permission/jnpf-permission-controller/src/main/java/jnpf/permission/controller/OrganizeController.java',
},
notes: [
'v0.11e+ step machine (镜像 web organize/Form.vue + PS013/PS036):',
+1 -1
View File
@@ -89,7 +89,7 @@ export function buildPrintDeleteCommand(): Command {
source: {
web: 'web/apps/jnpf-web-apps-main/src/api/system/printDev.ts:28 delPrintDev(id)',
api: 'DELETE /api/system/printDev/{id} (走 webapi Proxy, 端口 30000 jnpf-admin)',
ref: 'jnpf/后端/jnpf-system/jnpf-system-controller/.../PrintDevController.java @DeleteMapping',
ref: 'jnpf/后端/jnpf-java-boot/jnpf-system/jnpf-system-controller/src/main/java/jnpf/base/controller/PrintDevController.java @DeleteMapping',
},
notes: [
'v0.15+ 走 webapi 镜像 (loadPrintDev.delPrintDev), 替代旧版 c.delete',
+1 -1
View File
@@ -171,7 +171,7 @@ export function buildPrintUpdateCommand(): Command {
source: {
web: 'web/apps/jnpf-web-apps-main/src/api/system/printDev.ts:24 updatePrintDev',
api: 'PUT /api/system/printDev/{id} (走 webapi Proxy, 端口 30000 jnpf-admin)',
ref: 'jnpf/后端/jnpf-system/jnpf-system-controller/.../PrintDevController.java @PutMapping',
ref: 'jnpf/后端/jnpf-java-boot/jnpf-system/jnpf-system-controller/src/main/java/jnpf/base/controller/PrintDevController.java @PutMapping',
},
notes: [
'v0.15+ 走 webapi 镜像 (loadPrintDev.updatePrintDev), 替代旧版 c.putJson',
+3 -3
View File
@@ -6,7 +6,7 @@
* - 现在 webapi 镜像: 复用 web 端 createReport (走 reportHttp, 端口 32000 报表服务)
*
* 镜像源: web/apps/jnpf-web-apps-main/src/api/onlineDev/report.ts:17 createReport
* web/.../views/onlineDev/report/Form.vue: handleSubmit: 'const query = { ...values, id }; createReport(query)'
* web/apps/jnpf-web-apps-main/src/views/onlineDev/report/Form.vue: handleSubmit: 'const query = { ...values, id }; createReport(query)'
* 后端: jnpf-java-datareport-univer/.../ReportController.java POST /api/Report
* 端口 32000 独立微服务 (nginx 代理 /api/Report/ → jnpf:32000)
*
@@ -108,7 +108,7 @@ export function buildReportCreateCommand(): Command {
// - 不直接 c.postJson('/api/Report') — 那是经验复刻, web 端 schema 变了会漂移
await initReportWebapi(c)
// 镜像 web 端 web/.../views/onlineDev/report/Form.vue handleSubmit:
// 镜像 web 端 web/apps/jnpf-web-apps-main/src/views/onlineDev/report/Form.vue handleSubmit:
// const query = { ...values, id: state.dataForm.id };
// const formMethod = state.dataForm.id ? updateReport : createReport;
// formMethod(query);
@@ -198,7 +198,7 @@ export function buildReportCreateCommand(): Command {
'dacli report create --fullName=Jxcj综合排名 --enCode=JxcjFinalRankingReport --category=大赛报表 --cells=\'{"cells":[]}\'',
],
source: {
web: 'web/.../api/onlineDev/report.ts:17 createReport + report/Form.vue handleSubmit',
web: 'web/apps/jnpf-web-apps-main/src/api/onlineDev/report.ts:17 createReport + report/Form.vue handleSubmit',
api: 'POST /api/Report (走 webapi/report Proxy, 端口 32000 报表服务)',
ref: 'jnpf-java-datareport-univer/.../ReportController.java + ReportCrForm.java',
},
+1 -1
View File
@@ -84,7 +84,7 @@ export function buildReportInfoCommand(): Command {
required: { '--id': '报表 id (webapi getReportInfo)' },
example: 'dacli report info --id=842026612399540421',
source: {
web: 'web/.../api/onlineDev/report.ts:25 getReportInfo + views/onlineDev/report/Preview.vue',
web: 'web/apps/jnpf-web-apps-main/src/api/onlineDev/report.ts:25 getReportInfo + views/onlineDev/report/Preview.vue',
api: 'GET /api/Report/{id} (走 webapi/report Proxy, 端口 32000)',
ref: 'jnpf-java-datareport-univer/.../ReportController.java @GetMapping("/{id}")',
},
+1 -1
View File
@@ -138,7 +138,7 @@ export function buildReportListCommand(): Command {
},
example: 'dacli report list\ndacli report list --keyword=月报',
source: {
web: 'web/.../api/onlineDev/report.ts:13 getReportList + views/onlineDev/report/index.vue',
web: 'web/apps/jnpf-web-apps-main/src/api/onlineDev/report.ts:13 getReportList + views/onlineDev/report/index.vue',
api: 'GET /api/Report (走 webapi/report Proxy, 端口 32000)',
ref: 'jnpf-java-datareport-univer/.../ReportController.java GET @RequestMapping("/api/Report")',
},
+1 -1
View File
@@ -150,7 +150,7 @@ export function buildReportPublishCommand(): Command {
'dacli report publish --id=842032225770801349 --cells=\'{"cells":[]}\' --dataSets=\'[{"id":"ds1"}]\'',
],
source: {
web: 'web/.../api/onlineDev/report.ts:49 saveVersion',
web: 'web/apps/jnpf-web-apps-main/src/api/onlineDev/report.ts:49 saveVersion',
api: 'POST /api/Report/Save (走 webapi Proxy, 端口 32000, type=1 隐式)',
ref: 'jnpf-java-datareport-univer/.../ReportController.java @PostMapping("/Save")',
},
+1 -1
View File
@@ -146,7 +146,7 @@ export function buildReportSaveCommand(): Command {
'dacli report save --id=842032225770801349 --cells=\'{"cells":[]}\' --dataSets=\'[{"id":"ds1"}]\'',
],
source: {
web: 'web/.../api/onlineDev/report.ts:49 saveVersion',
web: 'web/apps/jnpf-web-apps-main/src/api/onlineDev/report.ts:49 saveVersion',
api: 'POST /api/Report/Save (走 webapi Proxy, 端口 32000, type=0 隐式)',
ref: 'jnpf-java-datareport-univer/.../ReportController.java @PostMapping("/Save")',
},
+1 -1
View File
@@ -48,7 +48,7 @@ export function buildReportTemplatesCommand(): Command {
required: {},
example: 'dacli report templates\ndacli report templates --json',
source: {
web: 'web/.../api/onlineDev/report.ts:77 getReportSelector + views/onlineDev/report/index.vue',
web: 'web/apps/jnpf-web-apps-main/src/api/onlineDev/report.ts:77 getReportSelector + views/onlineDev/report/index.vue',
api: 'GET /api/Report/Selector (走 webapi/report Proxy, 端口 32000)',
ref: 'jnpf-java-datareport-univer/.../ReportController.java @GetMapping("/Selector")',
},
+1 -1
View File
@@ -177,7 +177,7 @@ export function buildReportUpdateCommand(): Command {
'dacli report update --id=842032225770801349 --fullName=新名称 --enCode=new_code',
],
source: {
web: 'web/.../api/onlineDev/report.ts:21 updateReport + report/Form.vue handleSubmit',
web: 'web/apps/jnpf-web-apps-main/src/api/onlineDev/report.ts:21 updateReport + report/Form.vue handleSubmit',
api: 'PUT /api/Report/{id} (走 webapi/report Proxy, 端口 32000 报表服务)',
ref: 'jnpf-java-datareport-univer/.../ReportController.java @PutMapping("/{id}") + ReportUpForm.java',
},
+1 -1
View File
@@ -95,7 +95,7 @@ export function buildRoleAssignCommand(): Command {
source: {
web: 'web/apps/jnpf-web-apps-main/src/views/permission/role/Form.vue',
api: 'POST /api/permission/RoleRelation/addRoles | /deleteRoles',
ref: 'web/.../api/permission/roleRelation.ts addRoles() / removeRoles()',
ref: 'web/apps/jnpf-web-apps-main/src/api/permission/roleRelation.ts addRoles() / removeRoles()',
},
notes: [
'v0.15+ 改用 webapi/roleRelation.ts 镜像 (initWebapi + loadRoleRelation Proxy 模式, 跟 webapi/role.ts 一致)',
+1 -1
View File
@@ -113,7 +113,7 @@ export function buildRoleCreateCommand(): Command {
source: {
web: 'web/apps/jnpf-web-apps-main/src/views/permission/role/Form.vue (后端: jnpf/.../RoleController.java:124-161)',
api: 'POST /api/permission/Role',
ref: 'web/.../api/permission/role.ts create()',
ref: 'web/apps/jnpf-web-apps-main/src/api/permission/role.ts create()',
},
notes: [
'v0.11d+ step machine (镜像 web role/Form.vue:33-108 schemas + 后端 RoleController.create L124-161):',
+1 -1
View File
@@ -60,7 +60,7 @@ export function buildRoleDeleteCommand(): Command {
source: {
web: 'web/apps/jnpf-web-apps-main/src/views/permission/role/index.vue',
api: 'DELETE /api/permission/Role/{id}',
ref: 'web/.../api/permission/role.ts delRole()',
ref: 'web/apps/jnpf-web-apps-main/src/api/permission/role.ts delRole()',
},
notes: ['v0.14+ 改用 webapi 镜像 (loadRole.delRole)'],
})
+1 -1
View File
@@ -58,7 +58,7 @@ export function buildRoleInfoCommand(): Command {
required: { '--id': '角色 id' },
optional: { '--json': '原始 JSON 输出' },
example: 'dacli role info --id=1234567890',
source: { api: 'GET /api/permission/Role/{id}', ref: 'web/.../api/permission/role.ts getInfo()' },
source: { api: 'GET /api/permission/Role/{id}', ref: 'web/apps/jnpf-web-apps-main/src/api/permission/role.ts getInfo()' },
notes: ['v0.11+ 改用 webapi 镜像 (loadRole.getInfo)'],
})
return cmd
+1 -1
View File
@@ -84,7 +84,7 @@ export function buildRoleListCommand(): Command {
source: {
web: 'web/apps/jnpf-web-apps-main/src/views/permission/role/index.vue',
api: 'GET /api/permission/Role',
ref: 'web/.../api/permission/role.ts getRoleList()',
ref: 'web/apps/jnpf-web-apps-main/src/api/permission/role.ts getRoleList()',
},
notes: [
'**决策 7**: 角色是权限三角的 1 号, 先建角色再赋权',
+1 -1
View File
@@ -69,7 +69,7 @@ export function buildRoleSelectorCommand(): Command {
purpose: '角色下拉框. AI 选角色 id 必需 (form 配置 / menu 授权).',
optional: { '--type': '角色类型 (0=全局 1=部门)', '--isSystem': '是否系统内置' },
example: ['dacli role selector', 'dacli role selector --type=0 (全局)', 'dacli role selector --isSystem=0 (非系统内置)'],
source: { api: 'GET /api/permission/Role/Selector', ref: 'web/.../api/permission/role.ts getRoleSelector()' },
source: { api: 'GET /api/permission/Role/Selector', ref: 'web/apps/jnpf-web-apps-main/src/api/permission/role.ts getRoleSelector()' },
notes: ['v0.11+ 改用 webapi 镜像 (loadRole.getRoleSelector)'],
})
return cmd
+1 -1
View File
@@ -129,7 +129,7 @@ export function buildRoleUpdateCommand(): Command {
required: { '--id': '角色 id' },
optional: { '--fullName': '中文名', '--enCode': '英文编码', '--enabledMark': '启用/禁用 (0|1)', '--description': '描述' },
example: ['dacli role update --id=123 --enabledMark=0 (禁用)', 'dacli role update --id=123 --fullName=新名'],
source: { api: 'PUT /api/permission/Role/{id}', ref: 'web/.../api/permission/role.ts update()' },
source: { api: 'PUT /api/permission/Role/{id}', ref: 'web/apps/jnpf-web-apps-main/src/api/permission/role.ts update()' },
notes: ['v0.11+ 改用 webapi 镜像 (loadRole.update)'],
})
return cmd
+1 -1
View File
@@ -121,7 +121,7 @@ export function buildScheduleCreateCommand(): Command {
required: { '--fullName': '任务名称', '--enCode': '任务编码', '--executeType': '执行类型', '--executeContent': '执行内容' },
optional: { '--cron': 'cron 表达式' },
example: 'dacli schedule create --fullName=daily --enCode=daily_task --executeType=SQL --executeContent="SELECT 1" --cron="0 0 0 * * ?"',
source: { api: 'POST /api/scheduletask', ref: 'web/.../api/system/task.ts create()' },
source: { api: 'POST /api/scheduletask', ref: 'web/apps/jnpf-web-apps-main/src/api/system/task.ts create()' },
notes: ['v0.11+ 改用 webapi 镜像 (loadSchedule.create)', '**决策 9**: 用 schedule 做定时任务, 不用工作流'],
})
return cmd
+1 -1
View File
@@ -52,7 +52,7 @@ export function buildScheduleDeleteCommand(): Command {
purpose: '定时任务删除. 任务调度会停.',
required: { '--id': '任务 id', '--yes': '跳过确认' },
example: 'dacli schedule delete --id=123 --yes',
source: { api: 'DELETE /api/scheduletask/{id}', ref: 'web/.../api/system/task.ts delTask()' },
source: { api: 'DELETE /api/scheduletask/{id}', ref: 'web/apps/jnpf-web-apps-main/src/api/system/task.ts delTask()' },
notes: ['v0.11+ 改用 webapi 镜像 (loadSchedule.delTask)', '谨慎操作'],
})
return cmd
+1 -1
View File
@@ -63,7 +63,7 @@ export function buildScheduleInfoCommand(): Command {
source: {
web: 'web/apps/jnpf-web-apps-main/src/views/teamwork/schedule/Form.vue',
api: 'GET /api/scheduletask/Info/{id}',
ref: 'web/.../api/system/task.ts getInfo()',
ref: 'web/apps/jnpf-web-apps-main/src/api/system/task.ts getInfo()',
},
notes: ['v0.11+ 改用 webapi 镜像 (loadSchedule.getInfo)'],
})
+1 -1
View File
@@ -77,7 +77,7 @@ export function buildScheduleLogCommand(): Command {
purpose: '查看定时任务执行日志',
required: { '--id': '定时任务 id' },
example: 'dacli schedule log --id=1234567890',
source: { api: 'GET /api/scheduletask/{id}/TaskLog', ref: 'web/.../api/system/task.ts getTaskLogList()' },
source: { api: 'GET /api/scheduletask/{id}/TaskLog', ref: 'web/apps/jnpf-web-apps-main/src/api/system/task.ts getTaskLogList()' },
notes: ['v0.11+ 改用 webapi 镜像 (loadSchedule.getTaskLogList)'],
})
return cmd
+1 -1
View File
@@ -158,7 +158,7 @@ export function buildScheduleUpdateCommand(): Command {
'dacli schedule update --id=123 --cron="0 0 2 * * ?"',
'dacli schedule update --id=123 --enabledMark=0 (禁用)',
],
source: { api: 'PUT /api/scheduletask/{id}', ref: 'web/.../api/system/task.ts update()' },
source: { api: 'PUT /api/scheduletask/{id}', ref: 'web/apps/jnpf-web-apps-main/src/api/system/task.ts update()' },
notes: [
'v0.11+ 改用 webapi 镜像 (loadSchedule.update)',
'enabledMark 替代 pause/resume',
+58 -58
View File
@@ -25,13 +25,13 @@
* - 不依赖 SPA 路由 (菜单动态加载, JNPF admin 经常 404)
* - 局限: 查不出浏览器 vmodel bind bug (例如 tdd10 浏览器只 bind 2 字段)
* 镜像 web 端渲染契约 (form module):
* - web/.../FormGenerator/FormGenerator.vue L256-258 (drawingList 提取 __vModel__)
* - web/.../ColumnDesign/Main.vue L222-247 (formData.fields → formFieldsOptions, 含主子表递归)
* - web/apps/jnpf-web-apps-main/src/FormGenerator/FormGenerator.vue L256-258 (drawingList 提取 __vModel__)
* - web/apps/jnpf-web-apps-main/src/ColumnDesign/Main.vue L222-247 (formData.fields → formFieldsOptions, 含主子表递归)
* - formData.fields[].__vModel__ (form 编辑字段) + formData.fields[].__config__.tableName (所属表)
* - columnData.columnList[].prop (列表渲染字段, 主表字段集)
* 镜像 web 端 API:
* - web/.../api/onlineDev/visualDev.ts L31-33 getInfo (Base/{id}) — 拿 formData/columnData schema
* - web/.../api/onlineDev/visualDev.ts L101-103 getModelList (OnlineDev/{modelId}/List) — 拿实际数据
* - web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts L31-33 getInfo (Base/{id}) — 拿 formData/columnData schema
* - web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts L101-103 getModelList (OnlineDev/{modelId}/List) — 拿实际数据
* 算法 (form module):
* 1. `dacli form info <formId>` 拿 formData/columnData (webapi 镜像)
* 2. 提取渲染字段: formData.fields (递归子表 children) 收集 __vModel__ + columnData.columnList 收集 prop
@@ -39,13 +39,13 @@
* 4. 对每个渲染字段, 检查 API 响应字段中是否存在 (系统列 f_id/f_create_time 等跳过, 它们存在但不算 missing)
* 5. 输出 PASS/FAIL 表 + 退出码 (0=PASS, 1=FAIL)
* 镜像 web 端渲染契约 (dict module):
* - web/.../sysData/dictionary/index.vue L27-32 BasicColumn (fullName/enCode/sortCode/enabledMark)
* - web/.../sysData/dictionary/index.vue L49-74 useVxeTable.api=getDictionaryDataList
* - web/.../sysData/dictionary/Form.vue L19-62 useForm.schemas (parentId/fullName/enCode/sortCode/enabledMark/description)
* - web/.../sysData/dictionary/components/index.vue L20-25 BasicColumn (fullName/enCode/sortCode/isTree)
* - web/.../sysData/dictionary/components/index.vue L26-36 useVxeTable.api=getDictionaryType
* - web/.../sysData/dictionary/components/Form.vue L19-69 useForm.schemas (parentId/fullName/enCode/isTree/sortCode/description)
* - web/.../api/systemData/dictionary.ts L9-11 getDictionaryType, L25-27 getDictionaryTypeInfo,
* - web/apps/jnpf-web-apps-main/src/sysData/dictionary/index.vue L27-32 BasicColumn (fullName/enCode/sortCode/enabledMark)
* - web/apps/jnpf-web-apps-main/src/sysData/dictionary/index.vue L49-74 useVxeTable.api=getDictionaryDataList
* - web/apps/jnpf-web-apps-main/src/sysData/dictionary/Form.vue L19-62 useForm.schemas (parentId/fullName/enCode/sortCode/enabledMark/description)
* - web/apps/jnpf-web-apps-main/src/sysData/dictionary/components/index.vue L20-25 BasicColumn (fullName/enCode/sortCode/isTree)
* - web/apps/jnpf-web-apps-main/src/sysData/dictionary/components/index.vue L26-36 useVxeTable.api=getDictionaryType
* - web/apps/jnpf-web-apps-main/src/sysData/dictionary/components/Form.vue L19-69 useForm.schemas (parentId/fullName/enCode/isTree/sortCode/description)
* - web/apps/jnpf-web-apps-main/src/api/systemData/dictionary.ts L9-11 getDictionaryType, L25-27 getDictionaryTypeInfo,
* L34-36 getDictionaryDataList, L58-60 getDictionaryDataInfo
* 镜像 JNPF 后端:
* - jnpf/.../controller/DictionaryTypeController.java L57 (@GetMapping list), L168-169 (/{id} info)
@@ -254,8 +254,8 @@ export function buildTestRenderCommand(): Command {
'dacli test render --module=bigscreen --id=835246813026985082 # 验证某条大屏 getInfo 必填 + config.detail/component schema 完整性 (镜像 web group/header.vue:200-211 save formdata)',
],
source: {
web: 'web/.../sysData/dictionary/{index,Form,components/index,components/Form}.vue + web/.../FormGenerator/ + web/.../dataCenter/dataInterface/{index,Form,Preview}.vue + web/.../permission/menu/{index,Form}.vue + web/.../onlineDev/visualPortal/{index,Form,components/ReleaseModal}.vue + jnpf-web-datascreen-vue3/src/page/{list/index,group/header,group/result}.vue',
api: 'web/.../api/systemData/dictionary.ts + web/.../api/onlineDev/visualDev.ts + web/.../api/systemData/dataInterface.ts + web/.../api/system/menu.ts + web/.../api/onlineDev/portal.ts + web/.../api/workFlow/template.ts + jnpf-web-datascreen-vue3/src/api/visual.js (loadVisualData webapi 镜像)',
web: 'web/apps/jnpf-web-apps-main/src/views/sysData/dictionary/{index,Form,components/index,components/Form}.vue + web/apps/jnpf-web-apps-main/src/components/FormGenerator/ + web/apps/jnpf-web-apps-main/src/views/dataCenter/dataInterface/{index,Form,Preview}.vue + web/apps/jnpf-web-apps-main/src/views/permission/menu/{index,Form}.vue + web/apps/jnpf-web-apps-main/src/views/onlineDev/visualPortal/{index,Form,components/ReleaseModal}.vue + jnpf-web-datascreen-vue3/src/page/{list/index,group/header,group/result}.vue',
api: 'web/apps/jnpf-web-apps-main/src/api/systemData/dictionary.ts + web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts + web/apps/jnpf-web-apps-main/src/api/systemData/dataInterface.ts + web/apps/jnpf-web-apps-main/src/api/system/menu.ts + web/apps/jnpf-web-apps-main/src/api/onlineDev/portal.ts + web/apps/jnpf-web-apps-main/src/api/workFlow/template.ts + jnpf-web-datascreen-vue3/src/api/visual.js (loadVisualData webapi 镜像)',
},
notes: [
'**v0.11+ NEW (2026-06-27)**: 沉淀自 Batch 1 字典验证 (用户拍板: 替代浏览器验证)',
@@ -955,10 +955,10 @@ async function renderForm(
// 3.4 schema 完整性: propertyJson JSON.parse OK + 必含 moduleId/iconBackgroundColor (isTree/webType 按 type 变)
// 4. --id=<menuId> 时追加单条菜单 propertyJson schema 校验 (第 5 个关卡)
// 镜像 web 端:
// - web/.../permission/menu/index.vue L44-71 menuTableColumns BasicColumn
// - web/.../permission/menu/Form.vue L88-182 useForm schemas
// - web/.../permission/menu/Form.vue L209-227 getInfo: data.propertyJson → JSON.parse → data.moduleId = propertyJson.moduleId
// - web/.../api/system/menu.ts getMenuList (ModuleBySystem) + getInfo
// - web/apps/jnpf-web-apps-main/src/permission/menu/index.vue L44-71 menuTableColumns BasicColumn
// - web/apps/jnpf-web-apps-main/src/permission/menu/Form.vue L88-182 useForm schemas
// - web/apps/jnpf-web-apps-main/src/permission/menu/Form.vue L209-227 getInfo: data.propertyJson → JSON.parse → data.moduleId = propertyJson.moduleId
// - web/apps/jnpf-web-apps-main/src/api/system/menu.ts getMenuList (ModuleBySystem) + getInfo
// ============================================================================
/**
@@ -979,7 +979,7 @@ function flattenMenuTree(items: any[]): any[] {
/**
* 从 menu web 列表 vue 提取 BasicColumn.dataIndex
* 镜像 web/.../permission/menu/index.vue L44-71 menuTableColumns
* 镜像 web/apps/jnpf-web-apps-main/src/permission/menu/index.vue L44-71 menuTableColumns
*/
async function extractMenuListRenderFields(): Promise<string[]> {
const vueFile = `${WEB_ROOT}/views/permission/menu/index.vue`
@@ -998,7 +998,7 @@ async function extractMenuListRenderFields(): Promise<string[]> {
/**
* 从 menu web 表单 vue 提取 useForm schemas[].field
* 镜像 web/.../permission/menu/Form.vue L88-182
* 镜像 web/apps/jnpf-web-apps-main/src/permission/menu/Form.vue L88-182
*/
async function extractMenuFormRenderFields(): Promise<string[]> {
const vueFile = `${WEB_ROOT}/views/permission/menu/Form.vue`
@@ -1662,13 +1662,13 @@ async function renderDi(
// 3.4 schema 完整性: formData JSON.parse OK + platformRelease JSON.parse OK 必含 {pc, app}
// 4. --id=<portalId> 时追加单条门户 schema 校验 (formData/platformRelease 详细解析, 第 5 个关卡)
// 镜像 web 端:
// - web/.../onlineDev/visualPortal/index.vue L31-48 columns BasicColumn
// - web/apps/jnpf-web-apps-main/src/onlineDev/visualPortal/index.vue L31-48 columns BasicColumn
// fullName/enCode/category/type/enabledLock/creatorUser/creatorTime/lastModifyTime/sortCode/isRelease
// - web/.../onlineDev/visualPortal/Form.vue L28-125 useForm schemas
// - web/apps/jnpf-web-apps-main/src/onlineDev/visualPortal/Form.vue L28-125 useForm schemas
// fullName/enCode/category/type/linkType/customUrl/enabledLock/sortCode/description
// - web/.../onlineDev/visualPortal/Form.vue L127-145 init(data): getInfo(id) → setFieldsValue
// - web/.../onlineDev/visualPortal/components/ReleaseModal.vue L52-78: getInfo → JSON.parse(platformRelease) → {pc, app}
// - web/.../api/onlineDev/portal.ts getPortalList (Visualdev/Portal) + getInfo (Visualdev/Portal/{id})
// - web/apps/jnpf-web-apps-main/src/onlineDev/visualPortal/Form.vue L127-145 init(data): getInfo(id) → setFieldsValue
// - web/apps/jnpf-web-apps-main/src/onlineDev/visualPortal/components/ReleaseModal.vue L52-78: getInfo → JSON.parse(platformRelease) → {pc, app}
// - web/apps/jnpf-web-apps-main/src/api/onlineDev/portal.ts getPortalList (Visualdev/Portal) + getInfo (Visualdev/Portal/{id})
// Bug 5 修复 (P1): portal category 必须是字典 businessType 真实 UUID, 后端
// PortalServiceImpl.getModelList() 严格过滤不在字典的 category → silently drop.
// ============================================================================
@@ -2052,19 +2052,19 @@ async function renderPortal(
// flowConfig JSON.parse OK (可能为 {} 空对象)
// 4. --id=<flowId> 时追加单条流程 getInfo 必填 + flowNodes schema 校验 (第 5 个关卡)
// 镜像 web 端:
// - web/.../onlineDev/flowEngine/index.vue L32-42 columns BasicColumn:
// - web/apps/jnpf-web-apps-main/src/onlineDev/flowEngine/index.vue L32-42 columns BasicColumn:
// fullName/enCode/category/type/creatorUser/creatorTime/sortCode/enabledMark/status
// - web/.../onlineDev/flowEngine/Form.vue L31-105 useForm schemas:
// - web/apps/jnpf-web-apps-main/src/onlineDev/flowEngine/Form.vue L31-105 useForm schemas:
// fullName/enCode/decisionType/category/icon/showType/sortCode/description
// + iconBackground (Form.vue L23-24 state.iconBackground + L116-117)
// - web/.../api/workFlow/template.ts:
// - web/apps/jnpf-web-apps-main/src/api/workFlow/template.ts:
// getList (page) / getInfo (id) / getVersionList (id) / getFlowInfo (versionId)
// (返回 flowNodes + flowXml + flowConfig)
// ============================================================================
/**
* 从 web 端 flowEngine 列表 vue 提取 BasicColumn.dataIndex
* 镜像 web/.../onlineDev/flowEngine/index.vue L32-42 columns
* 镜像 web/apps/jnpf-web-apps-main/src/onlineDev/flowEngine/index.vue L32-42 columns
*/
async function extractWorkflowListRenderFields(): Promise<string[]> {
const vueFile = `${WEB_ROOT}/views/onlineDev/flowEngine/index.vue`
@@ -2083,7 +2083,7 @@ async function extractWorkflowListRenderFields(): Promise<string[]> {
/**
* 从 web 端 flowEngine 表单 vue 提取 useForm schemas[].field
* 镜像 web/.../onlineDev/flowEngine/Form.vue L31-105
* 镜像 web/apps/jnpf-web-apps-main/src/onlineDev/flowEngine/Form.vue L31-105
* 注意: Form.vue L48-53 重复 enCode (typo/visual dev 残留), 我们去重
* + iconBackground 不在 schemas 里, 但 state.iconBackground 在 Form.vue L23-24,
* getInfo 返回时也会带 (web 端 Form.vue L114-117), 所以合并进渲染字段集
@@ -2502,10 +2502,10 @@ async function renderWorkflow(
// ============================================================================
// Role module (角色, NEW, — 镜像 §TC-C 4 关卡真实契约)
// 镜像 web 端:
// - web/.../permission/role/index.vue L49-66 userColumns/organizeColumns/positionColumns BasicColumn
// - web/.../permission/role/Form.vue L29-110 useForm.schemas (10 field + conditionJson.*)
// - web/.../permission/role/Form.vue L119-137 init(data): getInfo(id) → JSON.parse(conditionJson)
// - web/.../api/permission/role.ts getRoleList/getInfo/getRoleSelector
// - web/apps/jnpf-web-apps-main/src/permission/role/index.vue L49-66 userColumns/organizeColumns/positionColumns BasicColumn
// - web/apps/jnpf-web-apps-main/src/permission/role/Form.vue L29-110 useForm.schemas (10 field + conditionJson.*)
// - web/apps/jnpf-web-apps-main/src/permission/role/Form.vue L119-137 init(data): getInfo(id) → JSON.parse(conditionJson)
// - web/apps/jnpf-web-apps-main/src/api/permission/role.ts getRoleList/getInfo/getRoleSelector
// ============================================================================
async function renderRole(
@@ -2517,9 +2517,9 @@ async function renderRole(
await initWebapiRole(c)
const lg = logFn
// 镜像 web/.../permission/role/index.vue L49-56 userColumns BasicColumn
// 镜像 web/apps/jnpf-web-apps-main/src/permission/role/index.vue L49-56 userColumns BasicColumn
const listFields = ['account', 'realName', 'gender', 'mobilePhone', 'position', 'enabledMark']
// 镜像 web/.../permission/role/Form.vue L29-110 schemas field
// 镜像 web/apps/jnpf-web-apps-main/src/permission/role/Form.vue L29-110 schemas field
const formFields = [
'fullName', 'enCode', 'isCondition',
'conditionJson', 'sortCode', 'description',
@@ -2742,10 +2742,10 @@ async function renderRole(
// - notice : 系统公告 (views/msgCenter/notice/{index,Form}.vue + getNoticeList)
// - msgTemplate : 消息模板 (views/msgCenter/msgTemplate/{index,Form}.vue + getMsgTemplateList)
// 镜像 web 端:
// - web/.../msgCenter/notice/index.vue L24-33 columns BasicColumn
// - web/.../msgCenter/notice/Form.vue L25-101 schemas (10 字段)
// - web/.../msgCenter/msgTemplate/index.vue L37-50 columns
// - web/.../msgCenter/msgTemplate/Form.vue L51-64 rules.required (9 字段)
// - web/apps/jnpf-web-apps-main/src/msgCenter/notice/index.vue L24-33 columns BasicColumn
// - web/apps/jnpf-web-apps-main/src/msgCenter/notice/Form.vue L25-101 schemas (10 字段)
// - web/apps/jnpf-web-apps-main/src/msgCenter/msgTemplate/index.vue L37-50 columns
// - web/apps/jnpf-web-apps-main/src/msgCenter/msgTemplate/Form.vue L51-64 rules.required (9 字段)
// ============================================================================
async function renderMsg(
@@ -2956,9 +2956,9 @@ async function renderMsg(
// ============================================================================
// Schedule module (日程, NEW, — 镜像 §TC-C 4 关卡真实契约)
// 镜像 web 端:
// - web/.../teamwork/schedule/index.vue L37-87 CalendarOptions events
// - web/.../teamwork/schedule/Form.vue L65-202 schemas (18 字段)
// - web/.../api/system/task.ts (Quartz cron 任务, 当前 webapi 镜像, 已知 limitation:
// - web/apps/jnpf-web-apps-main/src/teamwork/schedule/index.vue L37-87 CalendarOptions events
// - web/apps/jnpf-web-apps-main/src/teamwork/schedule/Form.vue L65-202 schemas (18 字段)
// - web/apps/jnpf-web-apps-main/src/api/system/task.ts (Quartz cron 任务, 当前 webapi 镜像, 已知 limitation:
// 日历视图走 /api/teamwork/ScheduleList, 需扩展 webapi/schedule.ts 加 getScheduleList)
// ============================================================================
@@ -3144,10 +3144,10 @@ async function renderSchedule(
// - userOnline (getOnlineUser → userName/organize/loginIPAddress/.../loginTime)
// - flowMonitor (getFlowMonitorList → fullName/systemName/flowName/.../status)
// 镜像 web 端:
// - web/.../monitor/platformMonitor/index.vue L32-60 state (getSysMonitor)
// - web/.../monitor/msgMonitor/index.vue L27-30 columns
// - web/.../monitor/userOnline/index.vue L21-28 columns
// - web/.../monitor/flowMonitor/index.vue L48-58 columns + taskColumns
// - web/apps/jnpf-web-apps-main/src/monitor/platformMonitor/index.vue L32-60 state (getSysMonitor)
// - web/apps/jnpf-web-apps-main/src/monitor/msgMonitor/index.vue L27-30 columns
// - web/apps/jnpf-web-apps-main/src/monitor/userOnline/index.vue L21-28 columns
// - web/apps/jnpf-web-apps-main/src/monitor/flowMonitor/index.vue L48-58 columns + taskColumns
// ============================================================================
async function renderMonitor(
@@ -3316,10 +3316,10 @@ async function renderMonitor(
// ============================================================================
// User module (用户, NEW, — 镜像 §TC-C 4 关卡真实契约)
// 镜像 web 端:
// - web/.../permission/user/index.vue L69-78 columns BasicColumn (8 字段)
// - web/.../permission/user/Form.vue L20-200 schemas (30+ 字段)
// - web/.../permission/user/Form.vue L218-237 init(data): getUserInfo(id) → setFieldsValue + updateSchema gender/nation/education
// - web/.../api/permission/user.ts getUserList/getUserInfo/getUserSelector
// - web/apps/jnpf-web-apps-main/src/permission/user/index.vue L69-78 columns BasicColumn (8 字段)
// - web/apps/jnpf-web-apps-main/src/permission/user/Form.vue L20-200 schemas (30+ 字段)
// - web/apps/jnpf-web-apps-main/src/permission/user/Form.vue L218-237 init(data): getUserInfo(id) → setFieldsValue + updateSchema gender/nation/education
// - web/apps/jnpf-web-apps-main/src/api/permission/user.ts getUserList/getUserInfo/getUserSelector
// ============================================================================
async function renderUser(
@@ -3537,11 +3537,11 @@ async function renderUser(
// - errorLog views/sysLog/errorLog/index.vue
// - requestLog views/sysLog/requestLog/index.vue
// 镜像 web 端:
// - web/.../sysLog/loginLog/index.vue L24-35 columns
// - web/.../sysLog/operateLog/index.vue L26-37 columns
// - web/.../sysLog/errorLog/index.vue L26-33 columns
// - web/.../sysLog/requestLog/index.vue L25-33 columns
// - web/.../api/system/log.ts getLogList({ category, ... })
// - web/apps/jnpf-web-apps-main/src/sysLog/loginLog/index.vue L24-35 columns
// - web/apps/jnpf-web-apps-main/src/sysLog/operateLog/index.vue L26-37 columns
// - web/apps/jnpf-web-apps-main/src/sysLog/errorLog/index.vue L26-33 columns
// - web/apps/jnpf-web-apps-main/src/sysLog/requestLog/index.vue L25-33 columns
// - web/apps/jnpf-web-apps-main/src/api/system/log.ts getLogList({ category, ... })
// ============================================================================
async function renderLog(
@@ -3634,13 +3634,13 @@ async function renderLog(
// watermarkConfig JSON.parse + platformRelease JSON.parse 必含 {pc,app}
// 4. --id=<reportId> 时追加单条报表 schema 详细校验 (第 5 个关卡)
// 镜像 web 端:
// - web/.../onlineDev/report/index.vue L24-33 columns BasicColumn:
// - web/apps/jnpf-web-apps-main/src/onlineDev/report/index.vue L24-33 columns BasicColumn:
// fullName/enCode/category/creatorUser/creatorTime/lastModifyTime/sortCode/state
// - web/.../onlineDev/report/Form.vue L26-62 useForm schemas (5 字段):
// - web/apps/jnpf-web-apps-main/src/onlineDev/report/Form.vue L26-62 useForm schemas (5 字段):
// fullName/enCode/category/sortCode/description
// 注: Form.vue 是元数据编辑弹窗 (只填名称/编码/分类), 不编辑 cells/snapshot 等报表设计内容
// cells/snapshot/allowExport 等是 getInfo 返的扩展字段, 由 univer Designer 处理
// - web/.../api/onlineDev/report.ts getReportList + getReportInfo + getReportSelector
// - web/apps/jnpf-web-apps-main/src/api/onlineDev/report.ts getReportList + getReportInfo + getReportSelector
// ============================================================================
/**
+1 -1
View File
@@ -126,7 +126,7 @@ export function buildUserInfoCommand(): Command {
'dacli user info --json # JSON 输出',
].join('\n'),
source: {
web: 'web/api/core/user.ts:10-15 getUserInfoApi + web/api/permission/user.ts getUserInfo',
web: 'web/apps/jnpf-web-apps-main/src/api/core/user.ts:10-15 getUserInfoApi + web/apps/jnpf-web-apps-main/src/api/permission/user.ts getUserInfo',
api: 'GET /api/oauth/CurrentUser?systemCode=&isBackend= (无 id) / GET /api/permission/User/{id} (有 id)',
},
notes: [
+1 -1
View File
@@ -19,7 +19,7 @@
* * bpmnTraverseTreeBFS() — BFS 水平布局核心算法
* * calculateVirtualHeight() — 同层 y 错开逻辑
* * handleCollisionsByLevel() — 横向碰撞检测
* - web/.../FlowProcess/.../FlowButton.vue:354 — handleAutoLayoutByHorizontal (调用入口)
* - web/apps/jnpf-web-apps-main/src/FlowProcess/.../FlowButton.vue:354 — handleAutoLayoutByHorizontal (调用入口)
*
* 用法:
* const layoutedXml = await autoLayoutFlowXml(flowXml)
+8 -8
View File
@@ -1,8 +1,8 @@
/**
* _webapi_helpers.ts — Workflow webapi 集成辅助 (v0.12+)
*
* 镜像 web 端 `web/.../FlowProcess/src/helper/config.ts:13-58` 的 defaultGlobalForm
* + web 端 `web/.../components/FlowProcess/src/index.vue:73-200` 的 getData 流程
* 镜像 web 端 `web/apps/jnpf-web-apps-main/src/FlowProcess/src/helper/config.ts:13-58` 的 defaultGlobalForm
* + web 端 `web/apps/jnpf-web-apps-main/src/components/FlowProcess/src/index.vue:73-200` 的 getData 流程
* 让 dacli AI 流程能跟 web 浏览器手动流程一样端到端可用.
*
* 背景 (BS-新27, 2026-07-01 jxcj):
@@ -20,15 +20,15 @@
* 6. /workflow/task 发起 → 走 launch 流程
*
* 镜像原型:
* - web/.../api/workFlow/template.ts: getAiInfo (line 136) + create + saveFlow + upDownShelf
* - web/.../FlowProcess/src/helper/config.ts:13-58 defaultGlobalForm 模板
* - web/.../FlowProcess/src/index.vue:73-200 getData (取 jnpfData 节点)
* - web/apps/jnpf-web-apps-main/src/api/workFlow/template.ts: getAiInfo (line 136) + create + saveFlow + upDownShelf
* - web/apps/jnpf-web-apps-main/src/FlowProcess/src/helper/config.ts:13-58 defaultGlobalForm 模板
* - web/apps/jnpf-web-apps-main/src/FlowProcess/src/index.vue:73-200 getData (取 jnpfData 节点)
* - jnpf/.../flowable/util/FlowUtil.java:2134 (后端 launch 必查 global.getTitleType)
* - jnpf/.../flowable/util/FlowXmlUtil.java:208 (web 后端 AI BPMN 构造逻辑)
*/
/**
* defaultGlobalForm — 镜像 web/.../FlowProcess/src/helper/config.ts:13-58
* defaultGlobalForm — 镜像 web/apps/jnpf-web-apps-main/src/FlowProcess/src/helper/config.ts:13-58
* 字段完全对应, jnpf/.../NodeModel.java 兼容 (含 lombok @Data 反序列化)
*/
export const defaultGlobalForm: Record<string, unknown> = {
@@ -82,7 +82,7 @@ export const defaultGlobalForm: Record<string, unknown> = {
* 解析 BPMN XML, 提取 startEvent / userTask / endEvent 节点配置.
*
* 镜像 web 端 propPanel/index.vue 的 BPMN 初始化逻辑 + dacli 旧 extractFlowNodesFromBpmn
* (web/.../FlowProcess/src/index.vue:73-200 getData 路径最终会构造类似结构).
* (web/apps/jnpf-web-apps-main/src/FlowProcess/src/index.vue:73-200 getData 路径最终会构造类似结构).
*
* 输出格式: { nodeId: { type, nodeId, nodeName, ... } }
* - startEvent → type='start', formId='', divideRule='inclusion', freeNode=true
@@ -207,7 +207,7 @@ export function parseFlowXml(flowXml: string): Record<string, Record<string, unk
/**
* 构造完整 flowNodes (含 global 节点 + BPMN 解析节点 + 绑定 start.formId).
*
* 镜像 web 端 `getData()` 行为 (web/.../FlowProcess/src/index.vue:73-200):
* 镜像 web 端 `getData()` 行为 (web/apps/jnpf-web-apps-main/src/FlowProcess/src/index.vue:73-200):
* - 先注入 defaultGlobalForm 到 jnpfData.data['global']
* - 遍历 jnpfData.data 把 start/end/approver/inclusion 等节点都加进 node map
* - start.formId 由用户配置 (本函数 = opts.formId 参数)
+6 -6
View File
@@ -9,10 +9,10 @@
* 5. loadWorkflow.save({type:1, ...}) → 真正发布 + 部署 (走 /api/workflow/template/Save)
* 6. (caller 后续) /workflow/task 发起
* 镜像原型:
* - web/.../onlineDev/flowEngine/components/AiCreateModal.vue (AI 弹窗 + form 配置 + create)
* - web/.../onlineDev/flowEngine/DesignForm.vue:130-150 (handleRequest + saveFlow)
* - web/.../api/workFlow/template.ts: getAiInfo + create + saveFlow
* - web/.../FlowProcess/src/helper/config.ts:13-58 (defaultGlobalForm 模板)
* - web/apps/jnpf-web-apps-main/src/onlineDev/flowEngine/components/AiCreateModal.vue (AI 弹窗 + form 配置 + create)
* - web/apps/jnpf-web-apps-main/src/onlineDev/flowEngine/DesignForm.vue:130-150 (handleRequest + saveFlow)
* - web/apps/jnpf-web-apps-main/src/api/workFlow/template.ts: getAiInfo + create + saveFlow
* - web/apps/jnpf-web-apps-main/src/FlowProcess/src/helper/config.ts:13-58 (defaultGlobalForm 模板)
* - jnpf/.../flowable/util/FlowUtil.java:2134 (后端 launch 必查 global.getTitleType)
* 简化 (app 2026-07-01):
* - 移除老路径 (--no-ai-path / --auto-enable / 单独 PUT enabledMark) - 都是没用的中间步骤
@@ -414,9 +414,9 @@ export function buildWorkflowCreateCommand(): Command {
'dacli workflow create --fullName="数据申请" --category="项目管理" --flowXml=\'<?xml...>\'',
],
source: {
web: 'web/.../onlineDev/flowEngine/components/AiCreateModal.vue + DesignForm.vue',
web: 'web/apps/jnpf-web-apps-main/src/views/onlineDev/flowEngine/components/AiCreateModal.vue + web/apps/jnpf-web-apps-main/src/views/onlineDev/flowEngine/DesignForm.vue',
api: 'POST /api/workflow/ai | POST /api/workflow/template | POST /api/workflow/template/Save',
ref: 'web/.../FlowProcess/src/helper/config.ts:13-58 defaultGlobalForm + web/.../FlowProcess/src/index.vue:73-200 getData',
ref: 'web/apps/jnpf-web-apps-main/src/components/FlowProcess/src/helper/config.ts:13-58 defaultGlobalForm + web/apps/jnpf-web-apps-main/src/components/FlowProcess/src/index.vue:73-200 getData',
},
notes: [
'v0.12+ BS-新27 关键修复 (jxcj 2026-07-01 验证 LC20260701000003):',
+1 -1
View File
@@ -109,7 +109,7 @@ export function buildWorkflowDecisionCommand(): Command {
'dacli workflow decision 808986025610185477 --json',
],
source: {
web: 'web/.../flowEngine/Form.vue + components/decisionFlow/*',
web: 'web/apps/jnpf-web-apps-main/src/views/onlineDev/flowEngine/Form.vue + web/apps/jnpf-web-apps-main/src/views/onlineDev/flowEngine/components/decisionFlow/*',
api: 'GET /api/workflow/template/{id}/DecisionParameter',
ref: '白皮书 5.6.5 决策流 (漏斗/覆盖/规则集/评分卡/交叉表/异常)',
},
+1 -1
View File
@@ -62,7 +62,7 @@ export function buildWorkflowDeleteCommand(): Command {
purpose: '流程模板删除. 引用该流程的 form 会失效.',
required: { '--id': '流程模板 id', '--yes': '跳过确认' },
example: 'dacli workflow delete --id=1234567890 --yes',
source: { api: 'DELETE /api/workflow/template/{id}', ref: 'web/.../api/workFlow/template.ts delFlow()' },
source: { api: 'DELETE /api/workflow/template/{id}', ref: 'web/apps/jnpf-web-apps-main/src/api/workFlow/template.ts delFlow()' },
notes: ['v0.11+ 改用 webapi 镜像 (loadWorkflow.delFlow)', '引用该流程的 form 会失效', '谨慎操作'],
})
return cmd
+1 -1
View File
@@ -125,7 +125,7 @@ export function buildWorkflowInfoCommand(): Command {
example: 'dacli workflow info --id=1234567890',
source: {
api: 'GET /api/workflow/template/{id} (basic) + /template/Info/{flowJsonId} (full)',
ref: 'web/.../api/workFlow/template.ts getInfo() + getFlowInfo() + getVersionList()',
ref: 'web/apps/jnpf-web-apps-main/src/api/workFlow/template.ts getInfo() + getFlowInfo() + getVersionList()',
},
notes: [
'v0.11+ 改用 webapi 镜像 (loadWorkflow.getInfo)',
+1 -1
View File
@@ -3,7 +3,7 @@
*
* AI 工作流痛点 (2026-06-25):
* - 创建菜单挂工作流时 (menu type=4), 需要先知道有哪些流程模板可挂
* - web 端对应 API: web/.../api/workFlow/template.ts:67 getFlowSelector()
* - web 端对应 API: web/apps/jnpf-web-apps-main/src/api/workFlow/template.ts:67 getFlowSelector()
*
* v0.11+ (2026-06-25): 用 webapi/workflow.getFlowSelector 直接 import
*/
+2 -2
View File
@@ -11,7 +11,7 @@
* (镜像 web FlowableProcessDesigner.vue "重新生成流程" 按钮)
* 让 form.workflowEnabled 状态同步到 formData + flowList
*
* 镜像源: web/.../onlineDev/flowEngine 流程设计器 (Form.vue handleReload)
* 镜像源: web/apps/jnpf-web-apps-main/src/onlineDev/flowEngine 流程设计器 (Form.vue handleReload)
* 后端: jnpf/.../flowable/controller/TemplateController.java 重新生成表单字段
*
* 端点: PUT /workflow/template/{id} (mirror update --enabledMark=1) + flowable 同步
@@ -96,7 +96,7 @@ export function buildWorkflowSyncFormCommand(): Command {
'dacli workflow sync-form --flowId=841773461490632837 # JxcjReviewAssignmentFlow',
],
source: {
web: 'web/.../onlineDev/flowEngine/FlowableProcessDesigner.vue handleReload',
web: 'web/apps/jnpf-web-apps-main/src/views/onlineDev/flowEngine/Form.vue handleReload (原文档引用 FlowableProcessDesigner.vue 不存在, 已就近改指 Form.vue — 待人工 verify 流程设计器组件名)',
api: 'PUT /api/workflow/template/{id} (v0.13+ 镜像 web 端 release 触发 form.workflowEnabled 同步)',
ref:
'jnpf/.../flowable/controller/TemplateController.java release/regenerate formData',
+1 -1
View File
@@ -227,7 +227,7 @@ export function buildWorkflowUpdateCommand(): Command {
'dacli workflow update --id=123 --enabledMark=1 --startFormId=840790907757264901',
'dacli workflow update --id=123 --fullName=新名',
],
source: { api: 'PUT /api/workflow/template/{id} + POST /template/Save (publish)', ref: 'web/.../api/workFlow/template.ts update() + saveFlow()' },
source: { api: 'PUT /api/workflow/template/{id} + POST /template/Save (publish)', ref: 'web/apps/jnpf-web-apps-main/src/api/workFlow/template.ts update() + saveFlow()' },
notes: [
'v0.11+ 改用 webapi 镜像 (loadWorkflow.update)',
'v0.11e+ Phase A2: dirty check --expected-enCode/--expected-state/--force (防 AI session 长时间保留误覆盖, 同 form/update.ts)',
+2 -2
View File
@@ -6,7 +6,7 @@
* webapi/bigscreen.ts — 大屏设计器 API (v0.14+ BS-新30, 已废弃)
*
* 镜像源 (历史, 已不再推荐): jnpf/后端/jnpf-visualdata/jnpf-visualdata-controller/.../VisualController.java
* 主 webapp web/.../api/onlineDev/dataV.ts 只镜像了 Selector (不完整)
* 主 webapp web/apps/jnpf-web-apps-main/src/api/onlineDev/dataV.ts 只镜像了 Selector (不完整)
* 大屏完整后端在 jnpf-visualdata 模块 (独立 microservice, 通过 nginx 代理)
*
* 为什么不用 jnpf-web-datascreen-vue3?
@@ -45,7 +45,7 @@ import { getCcWorkDir } from '../core/paths.ts'
import { JnpfClient } from '../core/client.ts'
import { loadWebModule } from './_loader.ts'
// 镜像源: web/.../api/onlineDev/dataV.ts (只覆盖 Selector)
// 镜像源: web/apps/jnpf-web-apps-main/src/api/onlineDev/dataV.ts (只覆盖 Selector)
// 其他函数 (list/info/create/update/delete) 通过 jnpf-visualdata Controller 端点定义
const BIGSCREEN_SRC = `${getCcWorkDir()}/web/apps/jnpf-web-apps-main/src/api/onlineDev/dataV.ts`