Files
dacli/docs/cmd-review/dm.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

2.7 KiB

dacli dm 命令审计报告 (2026-06-25)

1. 命令清单

子命令 格式 用途
dacli dm list [--keyword] [--dbLinkId] [--json] 列出当前应用所有数据模型 (物理表)
dacli dm create --table --tableName --dbLinkId --fields [--autoRelease] [--json] 创建物理表 (自动补 9 系统列)
dacli dm drop <table> [--dbLinkId] [--json] 删除物理表 (数据全失, 谨慎)
dacli dm fields --table --dbLinkId [--json] 查表字段详情

2. web 端对应

  • 数据模型页: web/apps/jnpf-web-apps-main/src/views/system/dataModel/ 或 onlineDev/
  • 数据模型 API: web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts (dataModel 段)
  • webapi/dataModel.ts 已存在 (v0.11 Phase 1 已镜像, 10 函数)
  • dacli dm/list 已切 webapi

3. 改/删/留 建议

[KEEP] 保留

  • dm list — 已切 webapi,AI 找表入口
  • dm fields — 查表字段详情

[REFACTOR-WEBAPI] P0 重点

  • dm create.ts:132-135 仍用 c.postJson() — 应改用 loadDataModel.createDataModel()
  • dm drop.ts:35 仍用 c.del() — 应改用 loadDataModel.delDataModel()
  • 违反 v0.11+ 镜像架构原则,导致 L3 diagnose 失效

[DEPRECATE] 无

[NEW-CMD] P1

  • dm addFields <table> --fields — 加字段(保留数据),webapi 已有 addTableFields
  • dm update <table> — 改表结构(字段重命名/类型变更),webapi 已有 updateDataModel
  • dm info <table> — 查表详情(字段/索引/外键),webapi 已有 getDataModelInfo
  • dm rename <table> --newTable — 重命名表
  • dm selector — 选择器

4. AI 痛点评估

9 系统列自动补 (BS-15)

  • ✅ v10.6.1 已实现, dm create 自动加 f_id/f_tenant_id/f_flow_task_id/f_flow_id/f_flow_state/f_sort_code/f_create_user/f_create_time/f_modify_user/f_modify_time/f_description

字段级 CRUD 缺失

  • ❌ AI 加字段只能 drop + create(数据全失),风险极高
  • web 端 addTableFields() / updateDataModel() 已镜像但未在 dacli 暴露

与 form create 联动

  • form create --autoTable 时, dm list 能验证表存在
  • 但 dm 缺 info, AI 经常需要 fields 命令拉详情

核心结论: dacli dm 4 个子命令结构合理, 但 create/drop 未切 webapi. 9 系统列自动补已实现, 但字段级 CRUD (add/update) 缺失, AI 改表风险高.

3 个最关键建议:

  1. P0 [REFACTOR-WEBAPI]: dm create + drop 切到 loadDataModel.* 调用
  2. P1 [NEW-CMD]: 新增 dm addFields / dm update / dm info 三个命令(webapi 已镜像)
  3. P1 [OPTIMIZE]: 评估 dm rename 需求