Files
dacli/docs/web-patches/_buildformdata-formUtils.md
T
sswandClaude a0242714ef docs(v0.11): dacli/docs/web-patches/ 建立 - patch 文档化流程
按 feedback-web-patch-docs.md 规则, 建立 dacli/docs/web-patches/ 目录:

- README.md: 文档化规则 + 当前 patches 状态 + Phase 3 候选 (说明)
- _visualDev-api-shim.md: Phase 1 webapi/visualDev patch (commit d4506fe)
- _buildformdata-formUtils.md: Task 4-10 _buildformdata.ts patch (commit bb3ebaf~fd8ef3b)

Phase 3 候选改造 (formDesign/Form.vue / CreateMenuModal.vue / sysForm/Form.vue)
通过 Phase 1 webapi 间接覆盖 (web 端组件仍调原端点, dacli 用 webapi 调同样端点),
直接抽纯函数价值有限, 暂不执行. 如果未来 BS-48/49/50 反复修, 再启动真正 Phase 3.

升级 web 后, AI 读本目录所有 patch 文档逐个对照, 缺失的重新应用.

Co-Authored-By: Claude <[email protected]>
2026-06-25 13:12:10 +08:00

2.6 KiB

Patch: _buildformdata-formUtils — v0.11+ buildFormData 直 import

状态: ✅ 已应用 (从 v0.11+ Task 4 起的多次 commit) 生效 commit: bb3ebaf 3a388dc 5473fd4 d9505ae fd8ef3b 对应 web 端文件: web/apps/jnpf-web-apps-main/src/components/FormGenerator/src/helper/formUtils.ts

改动原因

dacli form create 之前复刻了 web 端 buildFormData() 函数, 但漏 formId / renderKey / isSubTable / options 等关键字段 → 浏览器层渲染空 (BS-51/52/54/55 反复修).

v0.11+ Task 4-10: 用 dacli/src/commands/form/_buildformdata.ts 直接 dynamic import web 端 formUtils.ts 原版 buildFormData + buildFields, 0 复刻.

实际改动

新增 dacli 端

文件 作用
dacli/src/commands/form/_buildformdata.ts 读 formUtils.ts → 替换 import → 写 tmp → dynamic import
dacli/src/commands/form/_ai.ts 双路径 (ANTHROPIC_* env 直连 / JNPF backend)
dacli/src/commands/form/_ai_prompts.ts 抽 JNPF 原版 prompt (GEN_MODEL_QUESTION 等)
dacli/data/buildformdata-contract.md buildFormData 契约清单 (16+50+23 keys)

web 端零改动

web/apps/jnpf-web-apps-main/src/components/FormGenerator/src/helper/formUtils.ts 保持原样.

import 替换规则

// _buildformdata.ts 应用的 3 条替换
src = src
  .replace(/from\s+['"]#\/(.+?)['"]/g, (_, p) => `from '${WEB_SRC}/${p}'`)
  .replace(/from\s+['"]@jnpf\/utils['"]/g, `from '${JNPF_UTILS_UUID}'`)
  .replace(/import\s*\{\s*cloneDeep\s*\}\s*from\s+['"]lodash-es['"];?/g,
    `const cloneDeep = (x) => structuredClone(x);`);

验收方法

# 1. 跑 AI 建表端到端
dacli form create --ai "建一个员工表, 含姓名/年龄" --autoRelease
# 期望: 成功, state=1, 浏览器能渲染

# 2. 跑 AI JSON 直入
dacli form create --ai-json '[{"vmodel":"f_name","label":"姓名","jnpfKey":"input"}]' \
  --fullName=test --enCode=test_v011_aijson --autoRelease
# 期望: 成功, 无 LLM 调用

# 3. 跑视觉测试
npx tsx dacli/tests/test-import-buildformdata.ts
# 期望: 成功 import buildFormData + buildFields

web 升级后如何重应用

web 升级如果:

  • formUtils.ts buildFormData 签名没变: 不需任何操作
  • buildFormData 加了新字段 (web 自动透传, dacli 自动受益):
    • 跑 AI 建表, 看 form 浏览器渲染是否完整
    • 如有字段缺, 跑 baseline 验证
  • buildFormData 签名大变 (破坏性): 升级 _buildformdata.ts 替换规则, 加新 import 处理

不需要做的事

  • ❌ 不要重写 buildFormData
  • ❌ 不要在 dacli 端维护 schema defaults (web 端是唯一权威)
  • ❌ 不要修改 web/.../helper/formUtils.ts