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 段
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 --aiAI 生成 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
- P0 [OPTIMIZE]:
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 个建议:
- [REFACTOR-WEBAPI] 优先级: import.ts (8) > codegen.ts (4) > create.ts (4) > fixcolumndata.ts (3) > 其他 (1-2)
- [NEW-CMD] form update (高需求, 增量改 schema), 写 spec 放入 W2+
- [NEW-CMD] form addFields / rmFields (中需求), 写 spec 放入 W3+
- [KEEP]
_simplify.ts保留,_blindspots.ts/_buildformdata.ts是核心 - [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 限制)