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

4.0 KiB

dacli dm 命令审计报告 (2026-06-25, M2 实战补丁 2026-07-20)

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 — 选择器
  • dm truncate <table> — 清空表数据(保留结构),见 ADR 0011. 配套 dm drop --force-with-data 可一键清空+删表

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 暴露

M2 DB201 数据阻塞 (2026-07-20 实战) ⚠️

  • ❌ dm drop 在表有数据行时阻塞,错误信息 API code=400: The table has already been used and cannot be deleted (DB201) 误导用户以为有 visualdev/form 引用残留
  • 根因: JNPF DbTableServiceImpl.java:295-300 的 getSum() > 0 抛 DB201 ("表已经被使用"),表名语义被误用为"有数据"
  • jxcj M2 重启 (2026-07-20) 实战: 10 张业务表各 1 行 stale 数据,dm drop 全部失败 5 分钟阻塞,需 PG 直连 TRUNCATE 绕开
  • 修复路径: 见 ADR 0011
    • P0 [OPTIMIZE]: dm drop catch DB201 输出明确修复指引(先 TRUNCATE)
    • P1 [NEW-CMD]: dm truncate <table> 走 webapi (待确认 loadDataModel 是否暴露 truncate)
    • P2 [NEW-OPT]: dm drop --force-with-data 一键 TRUNCATE+DROP (需 --yes 二次确认)

与 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 需求

M2 新增建议 (2026-07-20): 4. P0 [OPTIMIZE]: dm drop 错误信息明确化(DB201 → 提示先 TRUNCATE)— 见 ADR 0011 5. P1 [NEW-CMD]: dm truncate <table> + dm drop --force-with-data — 数据清空重启场景 1 命令完成