docs(drift): Round 3+4 完整总结 (2026-07-12)
新增 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/<app>.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
This commit is contained in:
1 parent
b593a79c0e
commit
8cd1a48a11
1 file changed
+157
@@ -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)** |
|
||||
Reference in new issue
Block a user