派 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]>
5.4 KiB
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 个建议:
- [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