Files
dacli/docs/cmd-review/form.md
T
sswandClaude b9c9e318af feat(v0.11+): Phase 1 - 23 个 dacli 父命令审计完成
派 25 个 Explore 子代理 (5 批 × 5) 审计 23 个父命令.
产出 cmd-review/{cmd}.md (24 文件) + _summary.md.

关键发现:
- webapi 镜像使用率 < 30% (12+ 父命令 100% 绕 webapi)
- 30+ P0 必补新命令 (form update, log exception, di CRUD, role authorize 等)
- 3 处 P0 端点错误 (假 PASS):
  * integration emailTest/smsTest
  * msg templateCreate
- 用户关键修正: bigscreen → jnpf-web-datascreen-vue3 (独立子项目)
- 用户关键修正: report → jnpf-web-datareport (独立子项目)

下一步: Phase 2 按 P0 优先级执行 (修端点 + 新命令 + webapi 化)

Co-Authored-By: Claude <[email protected]>
2026-06-25 14:58:32 +08:00

5.4 KiB

dacli form 命令审计报告 (v0.11+, 2026-06-25)

审计对象: /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.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