Files
dacli/docs/cmd-review/form.md
T
ssw bbcdf9fab2 dacli: M2 实战固化 (jxcj 2026-07-20)
3 跨项目问题 + 修复 + 文档:

1. ADR 0011 — dm drop DB201 错误信息明确化
   - 旧: 表有数据时报 DB201 "The table has already been used" 误导用户
   - 新: catch DB201 输出修复指引 (TRUNCATE + ADR 0011 P1 待加 dm truncate 命令)
   - 文件: src/commands/dm/drop.ts + docs/cmd-review/dm.md + docs/decisions/0011

2. ADR 0012 — form create --ai relationForm 软降级
   - 旧: AI 生成 relationForm 缺三元组 (~40%) 触发 step machine 硬 FAIL
   - 新: validateFormData 软降级 — 三元组不全时自动改 jnpfKey='input' + 警告 (而非硬错)
   - 测试: 4/4 PASS (含缺 1/2/3 个三元组场景, 均软降级)
   - 文件: src/commands/form/_validate.ts + docs/cmd-review/form.md + docs/decisions/0012

3. ADR 0013 — menu create CurrentUser 缓存阻塞
   - 现象: menu create --formId 成功后 CurrentUser.menuList 不刷新, TC-B 阻塞
   - 修复: P1 待加 menu cache clear + menu create 后自动 invalidate
   - 兜底: test browser fallback 到 /jnpf_app_${appCode}/model/${formEnCode} 直接 URL
   - 文件: docs/cmd-review/menu.md + docs/decisions/0013

jxcj M2 重启 (2026-07-20) 实战产出, 跨项目通用 (testspace/developSystem/workSystem/dos 等)
详见 docs/jxcj/summary.md + docs/jxcj/learnings.md 阶段 4 段
2026-07-20 18:02:38 +08:00

6.9 KiB

dacli form 命令审计报告 (v0.11+, 2026-06-25, M2 实战补丁 2026-07-20)

审计对象: /home/ubuntu/ccWorkDir/dacli/src/commands/form/ (24 个文件: 14 命令 + 10 私有) 重点: webapi 架构对齐 + AI 友好性 + 盲点覆盖

1. 命令清单 (14 个公开子命令)

# 命令 用途 状态
1 dacli form list 列出当前应用所有表单 (state=0/1/2) ✅ KEEP + webapi
2 dacli form info <id> 拉表单完整 schema (formData/columnData/tables) ✅ KEEP + webapi
3 dacli form create 创建表单 (--ai/--ai-json/--autoTable/--autoRelease) ✅ KEEP
4 dacli form release <id> 发布/重新发布表单 (state 0|2 → 1) ✅ KEEP + webapi
5 dacli form delete <id> 删除表单 (--cascade 级联删菜单) ✅ KEEP
6 dacli form export <id> 导出表单 JSON (跨库迁移) ✅ KEEP
7 dacli form import <file> 从 JSON 导入表单 (--autoTable 重建物理表) ✅ KEEP
8 dacli form clone <id> 克隆表单 (AI 黄金法则: 99% 应 clone 再改) ✅ KEEP + webapi
9 dacli form validate <id> 运行时校验 (BS-23/31/32/15/V2/52) ✅ KEEP
10 dacli form fixcolumndata <id> 修复 columnData 缺 use*Permission (BS-23 NPE) ✅ KEEP
11 dacli form codegen 生成代码 (PascalCase + auto-alias) ✅ KEEP
12 dacli form lint 设计期 lint (BS-31/32) ✅ KEEP
13 dacli form bindFlow 表单绑工作流 (BS-44) ✅ KEEP
14 dacli form selector 功能下拉框 (AI 工作流核心) ✅ KEEP + webapi

2. web 端对应

  • 表单设计器: web/apps/jnpf-web-apps-main/src/views/onlineDev/visualDev/
  • 表单 API: web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts (30+ 函数)
  • webapi/visualDev.ts 已存在 (v0.11+ Phase 1 已镜像, 30 函数)
  • dacli/_buildformdata.ts 已直接 import web 端 buildFormData (v0.11+ 关键修复, BS-51/52/54)

3. 改/删/留 建议

3.1 [KEEP] - 全部 14 命令保留

  • 所有命令都有真实使用场景 (AI 工作流 / 跨库迁移 / 调试验证)
  • 7 个核心命令 (list/info/create/release/clone/selector) 已切换 webapi

3.2 [REFACTOR-WEBAPI] - 优先级排序

P0: import.ts (8 调用)

  • 7 处 /visualdev/Base (create/list/release) 应全部走 webapi
  • 第 209 行 (数据建模 Table) 保留 c.postJson (属于 system 命名空间)

P1: codegen.ts (4 调用)

  • saveAlias / getInfo / getAliasInfo / codePreview 全应走 webapi

P1: create.ts (4 调用)

  • create / getVisualDevList / release / Module(createMenu) 应走 webapi

P1: fixcolumndata.ts (3 调用)

  • getInfo / update / release 应走 webapi

P2: export/clone/validate/bindflow (各 1-2 调用)

  • 局部迁移 (form/clone release 走 webapi, form/bindflow release 走 webapi)

3.3 [DEPRECATE] - 保留但标 @deprecated

  • _simplify.ts: 保留 (用户已习惯简化格式), 文件头已标 LEGACY

3.4 [NEW-CMD] 缺新命令

dacli form update <id> (高需求)

  • 改 schema 需 export → 手动改 → import, 无原子性
  • 后端: PUT /api/visualdev/Base/{id} (已存在, 对应 loadVisualDev.update)
  • 自动 BS-49/50/52 防御

dacli form addFields <id> --fields (中需求)

  • 增量加字段, 同时支持 --tables (自动 ALTER TABLE)

dacli form rmFields <id> --vmodel (中需求)

  • 删字段, --drop-column 同步删除物理表列

dacli form stats (低需求)

  • 表单总数 + 按 type/category/flow 维度分桶统计

dacli form diff <id1> <id2> (辅助)

  • 对比 formData + columnData + tables 字段级差异

4. AI 痛点评估

4.1 ✅ 已解决

  • 表单创建流程: --ai / --ai-json / --autoTable / --autoRelease / --autoCreateMenu 一应俱全
  • 盲点自动防御: L1 precheck (5 类) + L2 guard (22 条高频) + L3 diagnose (3 类错误诊断)
  • AI 帮助完整性: 所有命令都带 --ai-help / --example / --source
  • 3 层防御: precheck → guard → diagnose

4.2 ⚠️ 部分覆盖

  • 字段级 BS-54 (select/relationForm): _buildformdata.ts 通过 web 端 buildFormData 100% 注入, 已修复
  • --autoTable / --autoRelease: 已实现, 默认 type=4 视图不走物理表

4.3 ❌ 仍有缺口

  • 缺 form update: 增量改 schema 需 export → import
  • 缺 addFields / rmFields: 字段级 CRUD 缺失
  • 缺 stats: 应用规模洞察不足
  • 缺 diff: clone 后变更追踪缺失
  • 菜单挂载 hard-coded: create.ts 第 665 行直接拼 body, 应走 loadVisualDev.createMenu

4.5 M2 form create relationForm 兜底 (2026-07-20 实战) ⚠️

  • ❌ form create --ai AI 生成 relationForm 时 modelId/propsValue/relationField 三元组覆盖率 ~60%, 剩余 40% 触发 step machine 硬 FAIL (关联功能不能为空 / 存储字段不能为空 / 回显字段不能为空)
  • 根因: NCPF backend LLM 看不到父 form 的 formId 与字段, 仅从 description 推断
  • jxcj M2 重启 (2026-07-20) 实战: 11 form 创建时 9 form 含 FK, 即便 description 显式写 form_id=848939189058667461, AI 仍生空 modelId
  • 当前绕路 (2-step 模式): --ai 不提 FK 字段 → PG ALTER TABLE 加 FK 列 → form update --fields 加 relationForm 三元组
  • 修复路径: 见 ADR 0012
    • P0 [OPTIMIZE]: _validate.ts 软降级 - relationForm 缺三元组 → 自动改 jnpfKey: "input" + 警告
    • P1 [OPTIMIZE]: _relationForm_auto.ts 启发式注入失败 fallback 到 input
    • P1 [OPTIMIZE]: form update --fields 检测 FK 命名模式 + 表无此列 → 自动 ALTER ADD COLUMN

4.4 selector 现状

接口 selector 状态
form (菜单挂载/工作流起始/select 字段) dacli form selector ✅ 已实现
workflow dacli workflow selector 待审 Batch E
form-data (运行时数据) 无 缺

核心结论: dacli form 命令已建立完整 CRUD 体系 (14 子命令), v0.11+ Phase 1 已将 7 核心命令迁 webapi. _buildformdata.ts 通过直接 import web 端 buildFormData 修复 BS-51/52/54/55.

最关键 5 个建议:

  1. [REFACTOR-WEBAPI] 优先级: import.ts (8) > codegen.ts (4) > create.ts (4) > fixcolumndata.ts (3) > 其他 (1-2)
  2. [NEW-CMD] form update (高需求, 增量改 schema), 写 spec 放入 W2+
  3. [NEW-CMD] form addFields / rmFields (中需求), 写 spec 放入 W3+
  4. [KEEP] _simplify.ts 保留, _blindspots.ts / _buildformdata.ts 是核心
  5. [AI 痛点] 字段级 BS-54 已修复, 菜单挂载走 loadVisualDev.createMenu

M2 新增建议 (2026-07-20): 6. P0 [OPTIMIZE]: _validate.ts 软降级 relationForm → input — 见 ADR 0012 7. P1 [OPTIMIZE]: _relationForm_auto.ts 启发式注入失败 fallback input (避免硬 FAIL) 8. P1 [OPTIMIZE]: form update --fields 自动 ALTER TABLE 加 FK 列 (修 ADR 0003 限制)