diff --git a/docs/dacli-doc-audit-report.md b/docs/dacli-doc-audit-report.md new file mode 100644 index 0000000..a9d6433 --- /dev/null +++ b/docs/dacli-doc-audit-report.md @@ -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 --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 ` 误导(来源 B 硬伤)** +- 位置:`_anti_patterns.ts` 第 139 行(AP-fi-1 组)、第 105 行(AP-fc-8 组) +- 内容:right 段写"必跑 `dacli form info ` 检查 4 项" +- 真相:`form/info.ts` 源码 `.argument('', '表单 id')`,**只收 id,无任何 enCode 兜底**。实测用 enCode 查询对全部 34 个表单均失败,只有 id 能查。 +- 影响:AI 按此 Pitfalls 执行 `dacli form info ` 必失败,且无法自愈。 +- 关联:上一轮探测的"问题 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 --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 中 `` / `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 兜底到 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 ` / `` / `source.ref` 路径,对照真实命令树与文件系统,缺失即红灯。 +- 文档即测试:把"AI 按 `--help` 执行一遍核心链路"纳入回归,杜绝假绿。 + +--- + +## 7. 本次审计产生的变更说明 + +- 审计过程中在 testspace 创建了 `dacliaudit01` 表单 + 菜单 + 测试数据用于验证,**已全部清理**(menu delete → form delete),testspace 恢复进入前状态。 +- testspace 原有 34 个历史残留表单(`tmpaitest` / `voktest` / `p16r1~8` / `testjxcjp12v2~v8` / `newtestform01~05` 等)非本次审计所建,未动,待用户确认是否清理。 +- 本报告为只读分析,未修改 dacli 源码(修复动作待用户确认后执行)。 diff --git a/docs/doc-drift-findings-2026-07-24.md b/docs/doc-drift-findings-2026-07-24.md new file mode 100644 index 0000000..9d1f807 --- /dev/null +++ b/docs/doc-drift-findings-2026-07-24.md @@ -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 ` 是否对应真实命令树 +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`。 \ No newline at end of file diff --git a/package.json b/package.json index af47dde..2cfebe8 100644 --- a/package.json +++ b/package.json @@ -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", diff --git a/scripts/check-doc-drift.ts b/scripts/check-doc-drift.ts new file mode 100644 index 0000000..6abd099 --- /dev/null +++ b/scripts/check-doc-drift.ts @@ -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 " / "--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='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: { '': '...' } 或 { '--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 () 或 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 ` 引用 +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() +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) \ No newline at end of file diff --git a/src/commands/_auto_fix.ts b/src/commands/_auto_fix.ts index dd52dd0..9a63304 100644 --- a/src/commands/_auto_fix.ts +++ b/src/commands/_auto_fix.ts @@ -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) { diff --git a/src/commands/_selfcheck.ts b/src/commands/_selfcheck.ts index 47579dd..bc652dd 100644 --- a/src/commands/_selfcheck.ts +++ b/src/commands/_selfcheck.ts @@ -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 { diff --git a/src/commands/apis/info.ts b/src/commands/apis/info.ts index a7f4f54..41856a2 100644 --- a/src/commands/apis/info.ts +++ b/src/commands/apis/info.ts @@ -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', diff --git a/src/commands/apis/refresh.ts b/src/commands/apis/refresh.ts index 851cb96..6ac14d9 100644 --- a/src/commands/apis/refresh.ts +++ b/src/commands/apis/refresh.ts @@ -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 diff --git a/src/commands/apis/status.ts b/src/commands/apis/status.ts index 76c4e3d..78cc420 100644 --- a/src/commands/apis/status.ts +++ b/src/commands/apis/status.ts @@ -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 diff --git a/src/commands/app/context.ts b/src/commands/app/context.ts index 0873660..ac59d13 100644 --- a/src/commands/app/context.ts +++ b/src/commands/app/context.ts @@ -157,7 +157,7 @@ export async function loadAppContext(opts?: { appCode?: string }): Promise`: 从 JSON 文件读 [{table, aliasName, fields?}, ...] * (c) `--alias `: 直接传 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 --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)', }, diff --git a/src/commands/form/create.ts b/src/commands/form/create.ts index 494dc32..1c3b8bb 100644 --- a/src/commands/form/create.ts +++ b/src/commands/form/create.ts @@ -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 => { 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)', diff --git a/src/commands/form/export.ts b/src/commands/form/export.ts index 596775f..67fd06f 100644 --- a/src/commands/form/export.ts +++ b/src/commands/form/export.ts @@ -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 里, 所以必须单独拉', ], }) diff --git a/src/commands/form/preview.ts b/src/commands/form/preview.ts index c96326f..06325fa 100644 --- a/src/commands/form/preview.ts +++ b/src/commands/form/preview.ts @@ -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 组件', }, diff --git a/src/commands/form/selector.ts b/src/commands/form/selector.ts index a0fb0bc..1c4fc90 100644 --- a/src/commands/form/selector.ts +++ b/src/commands/form/selector.ts @@ -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 */ diff --git a/src/commands/form/update.ts b/src/commands/form/update.ts index 2bec7d5..9a8cf3f 100644 --- a/src/commands/form/update.ts +++ b/src/commands/form/update.ts @@ -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 语义, 未传字段保留原值', diff --git a/src/commands/integration/emailtest.ts b/src/commands/integration/emailtest.ts index 816d85c..7df1aa3 100644 --- a/src/commands/integration/emailtest.ts +++ b/src/commands/integration/emailtest.ts @@ -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 diff --git a/src/commands/log/exception.ts b/src/commands/log/exception.ts index 9e6c147..cb9e895 100644 --- a/src/commands/log/exception.ts +++ b/src/commands/log/exception.ts @@ -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)'], }) diff --git a/src/commands/log/login.ts b/src/commands/log/login.ts index a6ceec6..b5f5714 100644 --- a/src/commands/log/login.ts +++ b/src/commands/log/login.ts @@ -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)'], }) diff --git a/src/commands/log/operate.ts b/src/commands/log/operate.ts index 387ff7a..8f5e39f 100644 --- a/src/commands/log/operate.ts +++ b/src/commands/log/operate.ts @@ -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)'], }) diff --git a/src/commands/log/request.ts b/src/commands/log/request.ts index 72ddb7a..b245f13 100644 --- a/src/commands/log/request.ts +++ b/src/commands/log/request.ts @@ -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 diff --git a/src/commands/menu/_helpers.ts b/src/commands/menu/_helpers.ts index 2500b27..7085b7d 100644 --- a/src/commands/menu/_helpers.ts +++ b/src/commands/menu/_helpers.ts @@ -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 命令) * * 共享: diff --git a/src/commands/menu/_lookup.ts b/src/commands/menu/_lookup.ts index 0e59ae9..a78fe20 100644 --- a/src/commands/menu/_lookup.ts +++ b/src/commands/menu/_lookup.ts @@ -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' diff --git a/src/commands/menu/create.ts b/src/commands/menu/create.ts index 48138d5..b1ddd5e 100644 --- a/src/commands/menu/create.ts +++ b/src/commands/menu/create.ts @@ -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) diff --git a/src/commands/menu/delete.ts b/src/commands/menu/delete.ts index 35fdc35..544ec89 100644 --- a/src/commands/menu/delete.ts +++ b/src/commands/menu/delete.ts @@ -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 模糊匹配容忍', diff --git a/src/commands/menu/info.ts b/src/commands/menu/info.ts index 6074a38..76d6e92 100644 --- a/src/commands/menu/info.ts +++ b/src/commands/menu/info.ts @@ -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 diff --git a/src/commands/menu/list.ts b/src/commands/menu/list.ts index a944167..027675e 100644 --- a/src/commands/menu/list.ts +++ b/src/commands/menu/list.ts @@ -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 切到目标应用, 才能看到对应菜单', diff --git a/src/commands/menu/purge.ts b/src/commands/menu/purge.ts index 7cb3205..899f4bd 100644 --- a/src/commands/menu/purge.ts +++ b/src/commands/menu/purge.ts @@ -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)', diff --git a/src/commands/menu/releases.ts b/src/commands/menu/releases.ts index 4d476a7..2b0e6a8 100644 --- a/src/commands/menu/releases.ts +++ b/src/commands/menu/releases.ts @@ -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 diff --git a/src/commands/menu/unrelease.ts b/src/commands/menu/unrelease.ts index 644aeb7..817db32 100644 --- a/src/commands/menu/unrelease.ts +++ b/src/commands/menu/unrelease.ts @@ -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'], }) diff --git a/src/commands/menu/update.ts b/src/commands/menu/update.ts index 37b9226..fbc864e 100644 --- a/src/commands/menu/update.ts +++ b/src/commands/menu/update.ts @@ -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', diff --git a/src/commands/monitor/flow.ts b/src/commands/monitor/flow.ts index 821f467..332138d 100644 --- a/src/commands/monitor/flow.ts +++ b/src/commands/monitor/flow.ts @@ -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 diff --git a/src/commands/monitor/online.ts b/src/commands/monitor/online.ts index f8fcd92..6087ca8 100644 --- a/src/commands/monitor/online.ts +++ b/src/commands/monitor/online.ts @@ -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 diff --git a/src/commands/monitor/server.ts b/src/commands/monitor/server.ts index bdffb0b..86beda4 100644 --- a/src/commands/monitor/server.ts +++ b/src/commands/monitor/server.ts @@ -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 diff --git a/src/commands/msg/noticedelete.ts b/src/commands/msg/noticedelete.ts index 3526afd..7abe745 100644 --- a/src/commands/msg/noticedelete.ts +++ b/src/commands/msg/noticedelete.ts @@ -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 diff --git a/src/commands/msg/noticeupdate.ts b/src/commands/msg/noticeupdate.ts index 3140273..1773cf8 100644 --- a/src/commands/msg/noticeupdate.ts +++ b/src/commands/msg/noticeupdate.ts @@ -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 误覆盖)', diff --git a/src/commands/msg/templatedelete.ts b/src/commands/msg/templatedelete.ts index a2620c5..46c081f 100644 --- a/src/commands/msg/templatedelete.ts +++ b/src/commands/msg/templatedelete.ts @@ -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 diff --git a/src/commands/msg/templateupdate.ts b/src/commands/msg/templateupdate.ts index 7562a49..c2766bc 100644 --- a/src/commands/msg/templateupdate.ts +++ b/src/commands/msg/templateupdate.ts @@ -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 diff --git a/src/commands/org/create.ts b/src/commands/org/create.ts index 8de39ee..2babf9d 100644 --- a/src/commands/org/create.ts +++ b/src/commands/org/create.ts @@ -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):', diff --git a/src/commands/print/delete.ts b/src/commands/print/delete.ts index 47ad041..d04aa48 100644 --- a/src/commands/print/delete.ts +++ b/src/commands/print/delete.ts @@ -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', diff --git a/src/commands/print/update.ts b/src/commands/print/update.ts index 2c9a034..4d47bce 100644 --- a/src/commands/print/update.ts +++ b/src/commands/print/update.ts @@ -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', diff --git a/src/commands/report/create.ts b/src/commands/report/create.ts index bc943e8..615aa91 100644 --- a/src/commands/report/create.ts +++ b/src/commands/report/create.ts @@ -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', }, diff --git a/src/commands/report/info.ts b/src/commands/report/info.ts index cf2d0b4..03191e6 100644 --- a/src/commands/report/info.ts +++ b/src/commands/report/info.ts @@ -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}")', }, diff --git a/src/commands/report/list.ts b/src/commands/report/list.ts index 04cfcfb..f135c8d 100644 --- a/src/commands/report/list.ts +++ b/src/commands/report/list.ts @@ -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")', }, diff --git a/src/commands/report/publish.ts b/src/commands/report/publish.ts index 2e06798..b049309 100644 --- a/src/commands/report/publish.ts +++ b/src/commands/report/publish.ts @@ -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")', }, diff --git a/src/commands/report/save.ts b/src/commands/report/save.ts index 8f5bd55..98eb18b 100644 --- a/src/commands/report/save.ts +++ b/src/commands/report/save.ts @@ -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")', }, diff --git a/src/commands/report/templates.ts b/src/commands/report/templates.ts index 9d83ae9..f8cc3c7 100644 --- a/src/commands/report/templates.ts +++ b/src/commands/report/templates.ts @@ -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")', }, diff --git a/src/commands/report/update.ts b/src/commands/report/update.ts index f283de7..9717c12 100644 --- a/src/commands/report/update.ts +++ b/src/commands/report/update.ts @@ -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', }, diff --git a/src/commands/role/assign.ts b/src/commands/role/assign.ts index 4f87bd1..cc456f4 100644 --- a/src/commands/role/assign.ts +++ b/src/commands/role/assign.ts @@ -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 一致)', diff --git a/src/commands/role/create.ts b/src/commands/role/create.ts index c320a86..98ad968 100644 --- a/src/commands/role/create.ts +++ b/src/commands/role/create.ts @@ -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):', diff --git a/src/commands/role/delete.ts b/src/commands/role/delete.ts index a28816a..a41fef5 100644 --- a/src/commands/role/delete.ts +++ b/src/commands/role/delete.ts @@ -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)'], }) diff --git a/src/commands/role/info.ts b/src/commands/role/info.ts index fad131e..638d402 100644 --- a/src/commands/role/info.ts +++ b/src/commands/role/info.ts @@ -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 diff --git a/src/commands/role/list.ts b/src/commands/role/list.ts index 1d57ca8..d2add27 100644 --- a/src/commands/role/list.ts +++ b/src/commands/role/list.ts @@ -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 号, 先建角色再赋权', diff --git a/src/commands/role/selector.ts b/src/commands/role/selector.ts index 00be948..0abf294 100644 --- a/src/commands/role/selector.ts +++ b/src/commands/role/selector.ts @@ -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 diff --git a/src/commands/role/update.ts b/src/commands/role/update.ts index 97990c2..b1c9572 100644 --- a/src/commands/role/update.ts +++ b/src/commands/role/update.ts @@ -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 diff --git a/src/commands/schedule/create.ts b/src/commands/schedule/create.ts index 430252e..b60d85d 100644 --- a/src/commands/schedule/create.ts +++ b/src/commands/schedule/create.ts @@ -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 diff --git a/src/commands/schedule/delete.ts b/src/commands/schedule/delete.ts index 6478ecb..645aa51 100644 --- a/src/commands/schedule/delete.ts +++ b/src/commands/schedule/delete.ts @@ -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 diff --git a/src/commands/schedule/info.ts b/src/commands/schedule/info.ts index 59005b2..5bed723 100644 --- a/src/commands/schedule/info.ts +++ b/src/commands/schedule/info.ts @@ -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)'], }) diff --git a/src/commands/schedule/log.ts b/src/commands/schedule/log.ts index 7183615..b72a07f 100644 --- a/src/commands/schedule/log.ts +++ b/src/commands/schedule/log.ts @@ -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 diff --git a/src/commands/schedule/update.ts b/src/commands/schedule/update.ts index 9ffbbfe..29edc44 100644 --- a/src/commands/schedule/update.ts +++ b/src/commands/schedule/update.ts @@ -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', diff --git a/src/commands/test/render.ts b/src/commands/test/render.ts index 322df9a..dd64f97 100644 --- a/src/commands/test/render.ts +++ b/src/commands/test/render.ts @@ -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 ` 拿 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= 时追加单条菜单 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 { const vueFile = `${WEB_ROOT}/views/permission/menu/index.vue` @@ -998,7 +998,7 @@ async function extractMenuListRenderFields(): Promise { /** * 从 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 { 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= 时追加单条门户 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= 时追加单条流程 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 { const vueFile = `${WEB_ROOT}/views/onlineDev/flowEngine/index.vue` @@ -2083,7 +2083,7 @@ async function extractWorkflowListRenderFields(): Promise { /** * 从 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= 时追加单条报表 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 // ============================================================================ /** diff --git a/src/commands/user/info.ts b/src/commands/user/info.ts index 604b888..8a526cc 100644 --- a/src/commands/user/info.ts +++ b/src/commands/user/info.ts @@ -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: [ diff --git a/src/commands/workflow/_autoLayout.ts b/src/commands/workflow/_autoLayout.ts index 6931e31..40bfdfc 100644 --- a/src/commands/workflow/_autoLayout.ts +++ b/src/commands/workflow/_autoLayout.ts @@ -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) diff --git a/src/commands/workflow/_webapi_helpers.ts b/src/commands/workflow/_webapi_helpers.ts index 45dce87..cfde193 100644 --- a/src/commands/workflow/_webapi_helpers.ts +++ b/src/commands/workflow/_webapi_helpers.ts @@ -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 = { @@ -82,7 +82,7 @@ export const defaultGlobalForm: Record = { * 解析 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\'', ], 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):', diff --git a/src/commands/workflow/decision.ts b/src/commands/workflow/decision.ts index 00dfabf..1e57247 100644 --- a/src/commands/workflow/decision.ts +++ b/src/commands/workflow/decision.ts @@ -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 决策流 (漏斗/覆盖/规则集/评分卡/交叉表/异常)', }, diff --git a/src/commands/workflow/delete.ts b/src/commands/workflow/delete.ts index f671839..418107f 100644 --- a/src/commands/workflow/delete.ts +++ b/src/commands/workflow/delete.ts @@ -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 diff --git a/src/commands/workflow/info.ts b/src/commands/workflow/info.ts index d139439..1427804 100644 --- a/src/commands/workflow/info.ts +++ b/src/commands/workflow/info.ts @@ -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)', diff --git a/src/commands/workflow/selector.ts b/src/commands/workflow/selector.ts index 85ff21e..d3544cf 100644 --- a/src/commands/workflow/selector.ts +++ b/src/commands/workflow/selector.ts @@ -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 */ diff --git a/src/commands/workflow/syncForm.ts b/src/commands/workflow/syncForm.ts index ab52a84..c1345e7 100644 --- a/src/commands/workflow/syncForm.ts +++ b/src/commands/workflow/syncForm.ts @@ -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', diff --git a/src/commands/workflow/update.ts b/src/commands/workflow/update.ts index 67f5319..b8d7ff0 100644 --- a/src/commands/workflow/update.ts +++ b/src/commands/workflow/update.ts @@ -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)', diff --git a/src/webapi/bigscreen.ts b/src/webapi/bigscreen.ts index 15e96fd..741cefb 100644 --- a/src/webapi/bigscreen.ts +++ b/src/webapi/bigscreen.ts @@ -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`