From 8cd1a48a112cbdf856e83f57989b76c90a79843f Mon Sep 17 00:00:00 2001 From: ssw Date: Mon, 13 Jul 2026 20:11:23 +0800 Subject: [PATCH] =?UTF-8?q?docs(drift):=20Round=203+4=20=E5=AE=8C=E6=95=B4?= =?UTF-8?q?=E6=80=BB=E7=BB=93=20(2026-07-12)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 新增 docs/drift/2026-07-12-round3-4-summary.md: Round 3 完成: - TC-C v0.21+ 加深 9 关卡 (新增 jnpfKey/dict/label/required-type/subtable 5 个) - TC-B 融合 dacli (dacli/src/commands/test/browser.ts, 5 form × 7/7 PASS, 7.5s/form) - 复用 chromium-1228 + ~/.dacli-snapshots/.json storage snapshot - 4 子命令全景: run / generate / render / browser Round 4 完成: - TC-C+TC-B 联动 (tc-c-then-b.spec.ts, 16/16 PASS, 65s 5 form) - 修字典 bug (webapi 响应 r.list 解套), testcustomer 9/9 - 剩 2 个 baseline columnList 错配 (user formDesigner 重配, 不在 dacli 范围) 总进度: - 16 关卡/检查 (9 + 7) - 145 vitest PASS - < 3 分钟跑完 指引 Round 5 (menu/workflow/di Phase B 复制 render.ts 模板): - render.ts 1200 行模板 - webapi/menu.ts, workflow.ts, di.ts 镜像 (15/14/9 函数) - 复制 renderForm/renderDict 写 renderMenu/renderWorkflow --- docs/drift/2026-07-12-round3-4-summary.md | 157 ++++++++++++++++++++++ 1 file changed, 157 insertions(+) create mode 100644 docs/drift/2026-07-12-round3-4-summary.md diff --git a/docs/drift/2026-07-12-round3-4-summary.md b/docs/drift/2026-07-12-round3-4-summary.md new file mode 100644 index 0000000..5d26fa5 --- /dev/null +++ b/docs/drift/2026-07-12-round3-4-summary.md @@ -0,0 +1,157 @@ +# Round 3-4 完整总结 (2026-07-12) + +> TC-C v0.21+ 加深 (9 关卡) + TC-B 融合 dacli (5 form × 7/7) + 联动 (16/16 vitest) + 修 1 个真实 baseline 误报 + +## Round 3: TC-C 加深 9 关卡 + TC-B 融合 dacli + +### ✅ 3 个核心工单 + +| # | 工单 | 状态 | 产出 | +|---|------|------|------| +| 1 | **TC-C v0.21+ 加深 4 关卡** | ✅ | `src/commands/test/render.ts` 加 jnpfKey/dict/label/required-type 4 关卡, 共 9 关卡 | +| 2 | **Step I 子表 columnList 校验** | ✅ | Round 3 加第 9 关卡: 找 testreceivable 8 + baomingguanli 1 个错配 | +| 3 | **TC-B 融合 dacli (playwright)** | ✅ | `src/commands/test/browser.ts` 新命令, 5 form × 7/7 PASS, 7.5s/form | + +### 📊 9 关卡总览 (TC-C v0.21+) + +| # | 关卡 | 状态 | 关键发现 (workSystem 5 form) | +|---|------|------|-------------------------------| +| 1 | form 编辑字段 ⊆ API 字段 | 已存在 | ✓ 5/5 PASS | +| 2 | form 列表字段 ⊆ API 字段 | 已存在 | testreceivable/baomingguanli 缺字段 | +| 3 | 必填字段 vmodel 完整性 | 已存在 | ✓ 5/5 PASS | +| 4 | columnList 列配置完整性 | 已存在 | testreceivable/baomingguanli 错配 | +| 5 | **jnpfKey 有效性** (web FormGenerator 白名单) | **新** | 抓 AI 用非法 jnpfKey | +| 6 | **字典绑定有效性** (dictionaryType 在 dict 表存在) | **新** | 修 bug 后 testcustomer 9/9 ✓ | +| 7 | **formItem label 完整性** (非空 + 唯一) | **新** | 抓空 label | +| 8 | **必填 vs 控件类型** (必填不能在 switch/button 容器) | **新** | 抓错配必填 | +| 9 | **columnList 子表字段引用** (Round 3) | **新** | 找子表 path 错配 | + +### 📦 dacli test 命令全景 (4 子命令) + +``` +dacli test run # TC-A (API 层, 100% CRUD) +dacli test generate # 生成浏览器 E2E 脚本 +dacli test render # TC-C (静态 webapi, 9 关卡, 5s) ← v0.21+ 加深 +dacli test browser # TC-B (浏览器 DOM, 7 检查, 7s) ← Round 3 新增 +``` + +### 🎯 TC-B 7 检查 (Round 3) + +| # | 检查 | 状态 | +|---|------|------| +| 1 | 页面加载 (Vue 接管) | ✓ | +| 2 | 列表 table 渲染 | ✓ | +| 3 | 新增 button 存在 | ✓ | +| 4 | form 编辑页 (inputIds 数量) | ✓ | +| 5 | 命名约定 (F_/auto/snake, 投票判定) | ✓ | +| 6 | dict select 字段可达 | ✓ | +| 7 | formItem label 完整性 | ✓ | + +**实测 5 form · workSystem: 35/35 PASS, ~35s** (含 storage snapshot 复用) + +### 🐛 Round 3 关键 bug 修复 + +| Bug | 根因 | 修法 | +|-----|------|------| +| `addInitScript "jnpf_access-token"` 失效 | JNPF 6.x 改 AES 加密 + key `jnpf-web-6.2.0-prod-core-access` | 改用 storage snapshot 注入 (一次性 login) | +| raw fetch 漏 `App-Code` header | JNPF API 必填 | 用 `JnpfClient.fromToken()` (跟 render 一致) | +| 8a3aa suffix URL 404 | form enCode 不含 suffix (menu 层加) | 改从 `CurrentUser.menuList[].urlAddress` 拿 | +| convention 误判 (snake 应 auto) | menu enCode 5-6 字符 hash, regex 限 6 | `{4,8}` 容忍 + 投票判定 | +| `testcustomer` 字典 038d293f 失效 | dict webapi 返 r.list 不是 r.data.list | 解套多种 webapi 形状 | +| label selector 不全 | Ant Design v6.2 用 `.ant-form-item-label label` | 多 selector fallback | + +## Round 4: 联动 + 修基线 + +### ✅ 4 个核心工单 + +| # | 工单 | 状态 | 产出 | +|---|------|------|------| +| 1 | **TC-C+TC-B 联动** (TC-C FAIL 才跑 TC-B) | ✅ | `tests/integration/drift/tc-c-then-b.spec.ts` 16/16 PASS, 65s 5 form | +| 2 | **修 3 个真实 baseline 问题** | ⚠️ 1/3 | testcustomer 字典修好; 2 columnList 是 baseline form 数据错配, 需 user formDesigner 重配 | +| 3 | **TC-C 加深 Phase B** (menu/workflow/di) | ⏳ 进行中 | - | + +### 🔗 TC-C+TC-B 联动 (Round 4 #1) + +```typescript +// 逻辑 (tests/integration/drift/tc-c-then-b.spec.ts) +async function decideAndRun(formId: string) { + const render = await runRender(formId) // 5s, 9 关卡 + if (render.fail === 0) { + return 'render_only' // 跳过 browser, 省 7s + } + const browser = await runBrowser(formId) // 7s, 7 检查 (拿 DOM 异常) + return 'render+browser' +} +``` + +| Form | TC-C (9) | 决策 | TC-B (7) | 节省 | +|------|----------|------|----------|------| +| hesuanjiancedengji | 9/9 ✓ | render_only | 跳过 | -7s | +| testcustomer | 9/9 ✓ (修字典后) | render_only | 跳过 | -7s | +| testreceivable | 6/9 | render+browser | 7/7 (拿 DOM 异常) | - | +| yaofangguanli | 9/9 ✓ | render_only | 跳过 | -7s | +| baomingguanli | 6/9 | render+browser | 7/7 | - | +| **总耗时** | 5 × 5s = 25s | | 2 × 7s = 14s | **省 14s** | + +### 🔧 修 1 个真实 baseline 误报 (Round 4 #2) + +`dacli test render` 之前报 testcustomer 字典 `038d293f` (kehuleixing 客户类型) 失效, 实际字典**存在** — 是 webapi 响应解套 bug (`r.list` 不是 `r.data.list`). + +**修法**: `render.ts:765-770` 加 webapi 形状解套 (支持 `r.list` / `r.data.list` / `r.data` / `r` 四种). + +**剩 2 个 columnList FAIL 是 baseline form 数据错配** (`testreceivable/baomingguanli` columnList 用 `tableField107-F_*` 子表 path, 应改用 relation 子表 API). 不在 dacli 范围, 需 user formDesigner 重配. + +## 📊 整体进度 (Round 1-4) + +| Round | 产出 | 测试 | 总耗时 | +|-------|------|------|--------| +| **1** | Drift loop 基础设施 (fetch-baseline.sh + 3 关卡) | - | - | +| **2** | BS-AI/NCPF/drift-1 修复 + TC-C 4 关卡 (webapi 静态) | 21/21 vitest | 35s | +| **3** | TC-C v0.21+ 加深 (9 关卡) + TC-B browser 子命令 | 58 + 50 vitest | 35s + 70s | +| **4** | TC-C+TC-B 联动 + 修字典 bug | 16 vitest | 65s | +| **总** | **9 + 7 = 16 关卡/检查** | **145 vitest PASS** | < 3 分钟 | + +## 🚦 Round 5 候选 (menu/workflow Phase B) + +| # | 任务 | 预计 | 价值 | +|---|------|------|------| +| 1 | TC-C 加深 menu 模块 (8 关卡 镜像 workSystem/manage menu UI) | ~150 行 | 抓 menu schema 漂移 | +| 2 | TC-C 加深 workflow 模块 (flowNodes/flowJson 完整性) | ~200 行 | 抓流程配置漂移 | +| 3 | TC-C 加深 di 模块 (interface field 完整性) | ~150 行 | 抓数据接口漂移 | +| 4 | 修剩下 2 个 baseline columnList 错配 | - | 跑通所有 baseline 9/9 | + +**TC-C 已是 Round 5 准备就绪** (v0.21+ 9 关卡 + Phase B 模板已建立, 复制 render 写新模块即可). + +## 📦 Round 3-4 Commits 总览 (本会话) + +``` +dacli/ dc8f0f7 feat(TC-C): v0.21+ 加深 4 关卡 (jnpfKey/dict/label/required-type) +dacli/ 4ae7aa2 test(TC-C): v0.21+ vitest 集成 53 测试 +dacli/ 467da41 feat(TC-C): v0.21+ Round 3 第 9 关卡 (子表 columnList) +dacli/ 29de40f feat(test): v0.21+ TC-B browser 子命令 (playwright lib, 7 检查) +dacli/ 2c8bcaf fix(TC-B): 命名约定 3 bug + label 修复 +dacli/ 947ead1 test(R4): TC-C+TC-B 联动 spec (16 tests, 65s 5 form) +dacli/ b593a79 fix(TC-C): dict 数据解套 (r.list 不是 r.data.list) +.claude/ 65f7a71 feat(dacli-ts): v0.21+ TC-C 加深 9 关卡 skill 文档 +.claude/ 54ff5aa feat(dacli-ts): v0.21+ TC-B 浏览器真实行为验证 skill 文档 +.claude/ 9233142 deprecate(TC-B): 标 tc-ab-real-test.md 为旧版 +.claude/ de3b817 round 收尾: SKILL/CLAUDE 更新 + jnpf-browser-automation 归档 +``` + +## 🎯 Round 5 推荐 + +继续 Phase B (menu/workflow/di 模块 TC-C 加深). 复制 `render.ts` 模板 (`renderDict` / `renderForm` 函数) 写新模块即可, 每模块 ~150-200 行 + vitest ~30-50 tests. + +## 📚 关键文件位置 (Round 5 入门) + +| 文件 | 用途 | +|------|------| +| `dacli/src/commands/test/render.ts` | TC-C 模板 (~1200 行, 9 关卡 + renderForm/renderDict/renderMenu/...) | +| `dacli/src/webapi/menu.ts` | menu webapi 镜像 (15 函数) | +| `dacli/src/webapi/workflow.ts` | workflow webapi 镜像 (14 函数) | +| `dacli/src/webapi/di.ts` | di webapi 镜像 (9 函数) | +| `dacli/tests/integration/drift/form-drift.spec.ts` | TC-C vitest 模板 | +| `dacli/tests/integration/drift/tc-c-then-b.spec.ts` | TC-C+TC-B 联动模板 | +| `dacli/docs/drift/2026-07-11-summary.md` | Round 1 基础 | +| `dacli/docs/drift/2026-07-12-summary.md` | Round 2 修复 | +| `dacli/docs/drift/2026-07-12-round3-4-summary.md` | **本文档 (Round 3+4)** |