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 段
4.0 KiB
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 已有addTableFieldsdm update <table>— 改表结构(字段重命名/类型变更),webapi 已有updateDataModeldm info <table>— 查表详情(字段/索引/外键),webapi 已有getDataModelInfodm 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 dropcatch DB201 输出明确修复指引(先 TRUNCATE) - P1 [NEW-CMD]:
dm truncate <table>走 webapi (待确认 loadDataModel 是否暴露 truncate) - P2 [NEW-OPT]:
dm drop --force-with-data一键 TRUNCATE+DROP (需 --yes 二次确认)
- P0 [OPTIMIZE]:
与 form create 联动
- form create --autoTable 时, dm list 能验证表存在
- 但 dm 缺 info, AI 经常需要 fields 命令拉详情
核心结论: dacli dm 4 个子命令结构合理, 但 create/drop 未切 webapi. 9 系统列自动补已实现, 但字段级 CRUD (add/update) 缺失, AI 改表风险高.
3 个最关键建议:
- P0 [REFACTOR-WEBAPI]: dm create + drop 切到
loadDataModel.*调用 - P1 [NEW-CMD]: 新增
dm addFields/dm update/dm info三个命令(webapi 已镜像) - 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 命令完成