From c6d70720a98451173f7b3cf6712cc015d31af5d8 Mon Sep 17 00:00:00 2001 From: ssw Date: Fri, 19 Jun 2026 17:06:42 +0800 Subject: [PATCH] =?UTF-8?q?fix(v0.8.3):=20fixcolumndata=20=E7=A9=BA?= =?UTF-8?q?=E6=95=B0=E7=BB=84=20columnData=20+=20BS-31/BS-15=20=E8=80=81?= =?UTF-8?q?=20workFlow=20form=20=E5=85=BC=E5=AE=B9=20(=E7=9B=B2=E7=82=B9?= =?UTF-8?q?=2034/35/36)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 触发: tdd1 v0.8.3 round, 跑 validate 发现 tdd1_leaveApply 报 20 ERROR. 1 真 bug: fixcolumndata.ts patchColumnData() - 老 form columnData='[]' (空数组) 时, 4 use*Permission 加在 array 上 - JSON.stringify([]) 永远返回 '[]', array 不序列化额外属性 - changed:true 误判, fix 静默无效, validate 立刻二次校验仍失败 - 修: 只把 plain object 当可 patch 目标, array/null 一律视为 {} 重写 2 误报: _blindspots.ts checkBs31 + checkBs15 - checkBs31 老 workFlow form formData=flat list[{filedName, filedId,...}] 无 __config__.label → 15 ERROR 误报 - checkBs15 老 form tables=[{table,tableName,typeId}] 无 fields[] → ERROR 误报 - 修: checkBs31 优先 __config__.label, 缺失回退 filedName - 修: checkBs15 Array.isArray(t.fields)===false → 降级 WARN 验证: - tdd1_leaveApply: 20 ERROR → 1 WARN (老 workFlow, 表 schema 在 DB) - tdd1_bdgz/095656/kyyfw/zdydy: PASS (无回归) - workSystem leaveApply: 同样修复 (源 form 也有同样老问题) - vitest 174/175 (T1.9 失败是 tdss 脚本已清, 与本轮无关) 固化: - dacli/doc/v0.8.3-changelog.md 完整 changelog - .claude/skills/dacli-ts/SKILL.md 加 v0.8.3 校准段 (盲点 34/35/36) - .claude/skills/dacli-ts/references/troubleshooting.md 加错误 34/35/36 Co-Authored-By: Claude --- .claude/skills/dacli-ts/SKILL.md | 27 +++++ .../dacli-ts/references/troubleshooting.md | 98 +++++++++++++++++++ doc/v0.8.3-changelog.md | 98 +++++++++++++++++++ src/commands/form/_blindspots.ts | 25 ++++- src/commands/form/fixcolumndata.ts | 11 ++- 5 files changed, 253 insertions(+), 6 deletions(-) create mode 100644 doc/v0.8.3-changelog.md diff --git a/.claude/skills/dacli-ts/SKILL.md b/.claude/skills/dacli-ts/SKILL.md index 97d4930..e73b317 100644 --- a/.claude/skills/dacli-ts/SKILL.md +++ b/.claude/skills/dacli-ts/SKILL.md @@ -28,6 +28,33 @@ description: Use when working with JNPF platform form/menu/workflow creation, da --- +## 🆕 v0.8.3 关键校准 (2026-06-19, AI 必读 — 老 workFlow form 三类兼容) + +| 校准项 | 旧 (v0.8.2) | 新 (v0.8.3) | 影响 | +|--------|-----------|------------|------| +| **`fixcolumndata` 空数组 columnData 不生效** (盲点 34) | `patchColumnData()` 把 `use*Permission` 加在 array 上 → `JSON.stringify([])` 永远 `"[]"`, `changed: true` 是误判, fix 静默无效 | 只把 plain object 当可 patch 目标; array/null/缺字段对象 → 一律视为 `{}` 重写 4 字段 | 老 form (columnData=`"[]"`) 真正修通, BS-23 闭环 | +| **`checkBs31` 在老 workFlow form 误报 label 空** (盲点 35) | 老 workFlow form `formData` 是 flat list `[{filedName, filedId, ...}]`, 校验 `__config__.label` 找不到 → 报 15 次 ERROR | 优先 `__config__.label` (新表单), 缺失时回退到 `filedName` (老 workFlow form 的 label 等价物); path 用 `__vModel__ || filedId` | 老 workFlow form 不再误报 15 个 BS-31 | +| **`checkBs15` 老 form tables 无 fields[] 误报** (盲点 36) | 老 workFlow form `tables=[{table, tableName, typeId}]` 无 `fields[]`, 校验 `f_flow_task_id` 找不到 → ERROR | `Array.isArray(t.fields)===false` → 降级为 WARN (提示"请人工确认 DB schema"); 有 fields 但缺 → 仍 ERROR | 老 workFlow form 不再误报 BS-15 | + +**如何识别老 workFlow form**: +- `enableFlow === 1` +- `formData` 是 list 不是 `{fields: [...]}` (或 list 里每项只有 `filedName/filedId/required/tableName`) +- `tables[i].fields === undefined` (只有 `table/tableName/typeId`) + +**典型场景**: +- workSystem `leaveApply` (1589964488616407041) +- workSystem 任何 `enableFlow=1` 且 `formData` 是 flat list 的老 form + +**修法** (新行为已自动兼容): +```bash +dacli form validate # 期望: 0 ERROR, 0-1 WARN +dacli form fixcolumndata # 现在真正修通 columnData +``` + +详见 [references/troubleshooting.md](references/troubleshooting.md) 错误 34-36 + [doc/v0.8.3-changelog.md](../../../doc/v0.8.3-changelog.md). + +--- + ## 🆕 v0.7.1 关键校准 (2026-06-12, AI 必读) | 校准项 | 旧 (v0.7) | 新 (v0.7.1) | 影响 | diff --git a/.claude/skills/dacli-ts/references/troubleshooting.md b/.claude/skills/dacli-ts/references/troubleshooting.md index 23463b0..6656428 100644 --- a/.claude/skills/dacli-ts/references/troubleshooting.md +++ b/.claude/skills/dacli-ts/references/troubleshooting.md @@ -739,8 +739,106 @@ dacli form clone 831608797251244549 --newEnCode=tdsaProduct1 --- +## 错误 34: `dacli form fixcolumndata ` 报"修复成功"但 validate 仍缺 4 use*Permission (盲点 34, v0.8.3 修) + +**症状**: +```bash +dacli form fixcolumndata 1589964488616407041 +# ✓ 修复成功: columnData 补 4 字段, appColumnData 补 4 字段 +dacli form validate 1589964488616407041 +# ✗ [ERROR] columnData.useBtnPermission: 缺 useBtnPermission → 后端 setPcPermission NPE +# ✗ [ERROR] columnData.useColumnPermission: 缺 useColumnPermission ... +# ✗ [ERROR] columnData.useFormPermission: 缺 useFormPermission ... +# ✗ [ERROR] columnData.useDataPermission: 缺 useDataPermission ... +``` + +**根因** (JS 对象序列化坑): +```ts +// 原 patchColumnData(): +const obj = (safeParse(json) ?? {}) as Record // 若 json='[]', obj=[] +for (const k of PERMISSION_FIELDS) obj[k] = false // obj=[].useBtnPermission=false (加在 array 上) +return { patched: JSON.stringify(obj) } // → "[]" (array 不序列化额外属性) +``` +- `JSON.stringify([])` 永远返回 `"[]"`, array 上的额外属性被丢弃 +- `changed: true` 是错的, fix 静默无效 + +**修法** (v0.8.3 已修, 自动行为): +```bash +dacli form fixcolumndata # 现在真正修通, validate 应 PASS BS-23 +dacli form validate # 期望: BS-23 消失 +``` + +**识别**: +```bash +dacli form info | jq -r '.columnData' # 若输出 '"[]"' (空数组) → 走原 fix-columndata 是无操作, 需升级 v0.8.3 +``` + +**AI 防错**: +- **不要**依赖 fix-columndata 的"成功"消息, 一定要 `validate` 二次确认 +- v0.8.3 后 fix-columndata 会真正改 columnData 为 `{"useBtnPermission":false,...}` 对象 + +--- + +## 错误 35: `dacli form validate ` 老 workFlow form 报 `formData.fields[i] (?): label 为空` (盲点 35, v0.8.3 修) + +**症状**: +```bash +dacli form validate 1589964488616407041 # leaveApply +# ✗ [ERROR] formData.fields[0] (?): label 为空 → 浏览器层空白 +# ✗ [ERROR] formData.fields[1] (?): label 为空 → 浏览器层空白 +# ... × 15 +``` + +**根因**: 老 workFlow form (`enableFlow=1`) 的 `formData` 是 **flat list** `[{filedName, filedId, required, ...}]`, **没有 `__config__.label` 结构**. BS-31 校验 `__config__.label` 找不到, 全报"label 为空". + +**如何识别**: +```bash +dacli form info | python3 -c "import json,sys; d=json.load(sys.stdin); fd=json.loads(d['formData']); print(type(fd).__name__, fd[0] if isinstance(fd, list) else fd.get('fields',[None])[0])" +# 若 type=list + 每项含 filedName/filedId → 老 workFlow form +``` + +**修法** (v0.8.3 已修, 自动行为): +```bash +dacli form validate # 期望: BS-31 消失 (因 filedName 是老 form 的 label 等价物) +``` + +**AI 防错**: +- 老 workFlow form **不要** 自己手改 formData (会破坏流程表单的内部引用) +- v0.8.3 后 validate 自动兼容: 优先 `__config__.label`, 缺失时回退 `filedName` + +--- + +## 错误 36: `dacli form validate ` 老 workFlow form 报 `tables.X.fields: enableFlow=1 必须含 f_flow_task_id 列` (盲点 36, v0.8.3 修) + +**症状**: +```bash +dacli form validate 1589964488616407041 +# ✗ [ERROR] tables.wform_leaveapply.fields: enableFlow=1 必须含 f_flow_task_id 列 +``` + +**根因**: 老 workFlow form 的 `tables` 是 `[{table, tableName, typeId}]`, **没有 `fields[]` 数组** (字段定义在数据库, 不在 form schema). BS-15 校验 `t.fields?.some(f => f.field === 'f_flow_task_id')` 找不到, 报 ERROR. + +**如何识别**: +```bash +dacli form info | python3 -c "import json,sys; d=json.load(sys.stdin); tables=json.loads(d['tables']); print(tables)" +# 若 [{'table':'wform_xxx','tableName':'...','typeId':'1'}] 无 fields 键 → 老 workFlow form +``` + +**修法** (v0.8.3 已修, 自动行为): +```bash +dacli form validate # 期望: BS-15 降为 WARN ("老 form 无 fields[], 请人工确认 DB schema") +# 人工确认: 进 MySQL 看 wform_xxx 表是否真含 f_flow_task_id 列 +``` + +**AI 防错**: +- 老 workFlow form 的物理表是 JNPF 工作流引擎 runtime 创建, **不要**自己用 dacli dm create 建表 (会冲突) +- 真缺 f_flow_task_id 列时: 用 `ALTER TABLE wform_xxx ADD COLUMN f_flow_task_id VARCHAR(50) DEFAULT NULL` 兜底 + +--- + ## v0.8.2+ dacli 改进建议 (基于 tdca/tdsa 实战) 1. **新增 `dacli form data` 子命令族** (create/list/update/delete), 封装 `/visualdev/OnlineDev/{modelId}/...` 4 端点, body 自动 `{data: JSON.stringify(...)}` 包装, 解决盲点 30+31+32 2. **`dacli form clone` 跨应用校验**: 跨 appCode clone 必须传 `--newDbLinkId`, 否则警告 + 拒绝 3. **`dacli form fixcolumndata` 自动调用**: form release / menu create Actions/Module 前自动跑 fixcolumndata, 一次跑通不报错 (解决盲点 23 复合坑) +4. **v0.8.3 老 workFlow form 兼容**: validate/lint/fixcolumndata 自动识别 `enableFlow=1` + flat list formData + tables 无 fields[] 的老 workFlow form, 不再误报 (盲点 34/35/36) diff --git a/doc/v0.8.3-changelog.md b/doc/v0.8.3-changelog.md new file mode 100644 index 0000000..cbf6ffd --- /dev/null +++ b/doc/v0.8.3-changelog.md @@ -0,0 +1,98 @@ +# v0.8.3 Changelog (2026-06-19) + +> **本轮主题**: tdd1 实战二阶段 — `dacli form validate` 触发 + 发现 1 真 bug + 2 误报, 修在源头. +> **触发场景**: 跑 `dacli form validate` 校验 tdd1 5 张 form 时, `tdd1_leaveApply` 报 20 错, 4 张 PASS. +> **数据源**: `docs/tdd1/plan.html` + 源码 `src/commands/form/fixcolumndata.ts` + `_blindspots.ts`. + +--- + +## 1. 1 真 bug + 2 误报 闭环 + +### 盲点 28 (真 bug): fix-columndata 空数组 columnData 不生效 +- **症状**: `dacli form fixcolumndata ` 跑在 `columnData="[]"` (空数组) 的老 form 上, 报"修复成功 补 4 字段", 但立刻 `dacli form validate ` 仍报 4 个 `use*Permission` 缺失 +- **根因**: 原 `patchColumnData()` 实现: + ```ts + const obj = (safeParse(json) ?? {}) as Record // obj = [] (空数组) + for (const k of PERMISSION_FIELDS) { + obj[k] = false // 加在 array 上 → array 不序列化额外属性 + } + return { patched: JSON.stringify(obj) } // → "[]" 没变 + ``` + `JSON.stringify([])` 永远返回 `"[]"`, **array 上的额外属性被丢弃**. `changed: true` 是错的. +- **修复**: `src/commands/form/fixcolumndata.ts` + - 只把 `typeof === 'object' && !Array.isArray()` 当可 patch 目标 + - array / null / 缺字段对象 → 一律视为空对象 `{}` 重写, 4 字段都补 `false` + - `changed` 标志: 仅当"原对象已含全部 4 字段"才算 noop +- **实测**: + - `dacli form fixcolumndata 837619160715362373` (tdd1_leaveApply) + - 修复前: `columnData='[]'`, validate 报 4 ERROR (BS-23) + - 修复后: `columnData='{"useBtnPermission":false,...}'`, validate BS-23 消失 + +### 盲点 29 (误报): BS-31 在老 workFlow form formData 上 false positive +- **症状**: 老 workFlow form (`enableFlow=1`) 的 `formData` 是 **flat list** `[{filedName, filedId, required, ...}]`, **没有 `__config__.label` 结构**. BS-31 校验 `__config__.label` 找不到, 报"label 为空" 15 次 +- **根因**: 老 workFlow form 是 JNPF 6.2 之前的流程表单形态, 与设计器拖出来的标准 form (`{fields: [{__config__: {label}, __vModel__}]}`) 完全不同. `_blindspots.ts` 的 `extractFields` 已兼容两种形态 (扁平数组), 但 `checkBs31` 只看 `__config__.label` +- **修复**: `src/commands/form/_blindspots.ts:checkBs31` + - 优先取 `__config__.label` (新表单) + - 缺失时回退到 `filedName` (老 workFlow form 的显示名等价物) + - path 用 `__vModel__ || filedId || '?'` 都兼容 +- **实测**: tdd1_leaveApply 从 15 个 label ERROR → 0 + +### 盲点 30 (误报): BS-15 在老 workFlow form tables 无 fields[] 时 false positive +- **症状**: 老 workFlow form 的 `tables` 是 `[{table, tableName, typeId}]`, **没有 `fields[]` 数组** (字段定义在数据库, 不在 form schema). BS-15 校验 `t.fields?.some(f => f.field === 'f_flow_task_id')` 找不到, 报 ERROR +- **根因**: 老 workFlow form 的物理表 schema 是 JNPF 后端 runtime 管理的 (创建工作流时自动建表), 不像设计器拖出来的 form 那样把字段定义放在 form schema 里 +- **修复**: `src/commands/form/_blindspots.ts:checkBs15` + - `Array.isArray(t.fields)` 为 `false` → **降级为 WARN** (而非 ERROR), 提示"请人工确认 DB schema" + - `fields[]` 存在但缺 `f_flow_task_id` → 仍 ERROR (这是真错) +- **实测**: tdd1_leaveApply + workSystem leaveApply 从 ERROR → 1 WARN + +--- + +## 2. 修复结果 + +### tdd1 (5 张 form 端到端可用 + 全部 PASS/WARN) + +| enCode | 修复前 | 修复后 | +|--------|--------|--------| +| `tdd1_bdgz` | ✅ PASS | ✅ PASS | +| `tdd1_095656` | ✅ PASS | ✅ PASS | +| `tdd1_kyyfw` | ✅ PASS | ✅ PASS | +| `tdd1_zdydy` | ✅ PASS | ✅ PASS | +| `tdd1_leaveApply` | ❌ 20 ERROR (4 BS-23 + 15 BS-31 + 1 BS-15) | ✅ 1 WARN (老 workFlow form, 表 schema 在 DB) | + +### workSystem 源 (同样老 workFlow form) +- `leaveApply`: ❌ 20 ERROR → ✅ 1 WARN (同样修复) + +--- + +## 3. 改动文件清单 + +| 文件 | 改动 | +|------|------| +| `src/commands/form/fixcolumndata.ts` | `patchColumnData()` 兼容空数组 columnData (盲点 28 真 bug) | +| `src/commands/form/_blindspots.ts` | `checkBs31` 兼容 `filedName` (盲点 29 误报) + `checkBs15` 兼容无 fields[] (盲点 30 误报) | + +--- + +## 4. 三关验证 + +| 关 | 结果 | 备注 | +|----|------|------| +| typecheck | 5 错 (pre-existing, 全在 `tests/e2e/verify-form.ts`, lib 不含 dom) | 与本轮无关 | +| vitest | 174/175 PASS (1 失败是 T1.9 期望 "解析 14 form", tdss 脚本文件已清, 与本轮无关) | blindspot T1.1-T1.7 全过 | +| 实测 | tdd1_leaveApply validate 20→1 (BS-23/31 真修, BS-15 降 WARN) | 端到端 OK | + +--- + +## 5. 关联文档 + +- `docs/tdd1/plan.html` — tdd1 7 阶段记录 (v0.8.2 4 盲点 + v0.8.3 1 bug + 2 误报) +- `docs/tdd1/design.html` — tdd1 5 张 form 详细 schema +- `dacli/.claude/skills/dacli-ts/SKILL.md` — v0.8.3 段已加 +- `dacli/.claude/skills/dacli-ts/references/troubleshooting.md` — 错误 28-30 已固化为"老 workFlow form 三类兼容" + +--- + +**生成时间**: 2026-06-19 +**作者**: Claude (M3) + 用户 +**本轮成果**: tdd1 5/5 form validate 闭环 (4 PASS + 1 WARN) + 源 workSystem leaveApply 同样修复 + 1 真 bug + 2 误报固化 +**下轮入口**: v0.8.4 — `tdd1` 浏览器层端到端验证 (Playwright 截图 list/add/data 三步) \ No newline at end of file diff --git a/src/commands/form/_blindspots.ts b/src/commands/form/_blindspots.ts index 1173882..a531903 100644 --- a/src/commands/form/_blindspots.ts +++ b/src/commands/form/_blindspots.ts @@ -75,10 +75,21 @@ export function checkBs31(formDataRaw: unknown): BlindspotIssue[] { const fields = extractFields(safeParse(formDataRaw)) if (!fields) return issues fields.forEach((f, i) => { - const ff = f as { __config__?: { label?: string }; __vModel__?: string } - const label = ff.__config__?.label + // v0.8.3 修复 (盲点 28): 老 workFlow form formData 是 flat list, 字段是 {filedName, filedId, ...} + // 这种形态下 `__config__.label` 不存在, BS-31 不应误报 + // 兼容两种形态: + // - 标准: f.__config__.label (新表单, 设计器拖出来的) + // - 老 workFlow: f.filedName (流程表单的字段描述, filedName=显示名=label 等价物) + const ff = f as { + __config__?: { label?: string } + __vModel__?: string + filedName?: string + filedId?: string + } + const label = ff.__config__?.label ?? ff.filedName + const vmodel = ff.__vModel__ || ff.filedId || '?' if (!label || !label.trim()) { - issues.push({ id: 'BS-31', level: 'ERROR', path: `formData.fields[${i}] (${ff.__vModel__ || '?'})`, message: 'label 为空 → 浏览器层空白' }) + issues.push({ id: 'BS-31', level: 'ERROR', path: `formData.fields[${i}] (${vmodel})`, message: 'label 为空 → 浏览器层空白' }) } }) return issues @@ -110,7 +121,13 @@ export function checkBs15(tablesRaw: unknown, enableFlow: number | undefined): B const tables = safeParse(tablesRaw) as Array<{ table?: string; fields?: Array<{ field: string }> }> | null if (!tables) return issues for (const t of tables) { - const hasFlowTaskId = t.fields?.some(f => f.field === 'f_flow_task_id') + // v0.8.3 修复 (盲点 28): 老 workFlow form tables 是 [{table, tableName, typeId}] 只有元数据, 无 fields[] + // 这种形态无法校验 f_flow_task_id, 不应误报 (实际表 schema 可能在数据库已建好) + if (!Array.isArray(t.fields)) { + issues.push({ id: 'BS-15', level: 'WARN', path: `tables.${t.table || '?'}.fields`, message: 'enableFlow=1 + 老 form 无 fields[], 无法校验 f_flow_task_id (请人工确认 DB schema)' }) + continue + } + const hasFlowTaskId = t.fields.some(f => f.field === 'f_flow_task_id') if (!hasFlowTaskId) { issues.push({ id: 'BS-15', level: 'ERROR', path: `tables.${t.table || '?'}.fields`, message: 'enableFlow=1 必须含 f_flow_task_id 列' }) } diff --git a/src/commands/form/fixcolumndata.ts b/src/commands/form/fixcolumndata.ts index e4cefa9..800ff7b 100644 --- a/src/commands/form/fixcolumndata.ts +++ b/src/commands/form/fixcolumndata.ts @@ -43,7 +43,12 @@ function hasAllPermissions(obj: Record | null): boolean { } function patchColumnData(json: string | null | undefined): { patched: string; changed: boolean } { - const obj = (safeParse>(json) ?? {}) as Record + // v0.8.3 修复 (盲点 28): 老 form columnData 可能是 "[]" (空数组) / null / 缺字段对象, + // 原实现 `obj[k] = false` 加到 array 上, JSON.stringify 时 array 不序列化额外属性 → "[]" 没变 + // 修法: 只把 plain object 当可 patch 目标, 其他情况 (array / null / 缺) 一律视为空对象重写 + const parsed = safeParse(json) + const isObject = parsed != null && typeof parsed === 'object' && !Array.isArray(parsed) + const obj: Record = isObject ? { ...(parsed as Record) } : {} let changed = false for (const k of PERMISSION_FIELDS) { if (typeof obj[k] !== 'boolean') { @@ -51,7 +56,9 @@ function patchColumnData(json: string | null | undefined): { patched: string; ch changed = true } } - return { patched: JSON.stringify(obj), changed } + // 只有"原对象已含全部 4 字段"才算 noop; 否则都是 changed + const wasAlreadyValid = isObject && PERMISSION_FIELDS.every((k) => typeof (parsed as Record)[k] === 'boolean') + return { patched: JSON.stringify(obj), changed: !wasAlreadyValid } } export function buildFormFixColumnDataCommand(): Command {