From bbcdf9fab24ce8da15e2b1e1170e4ae29e9edc76 Mon Sep 17 00:00:00 2001 From: ssw Date: Mon, 20 Jul 2026 18:02:38 +0800 Subject: [PATCH] =?UTF-8?q?dacli:=20M2=20=E5=AE=9E=E6=88=98=E5=9B=BA?= =?UTF-8?q?=E5=8C=96=20(jxcj=202026-07-20)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 段 --- docs/cmd-review/dm.md | 16 +++- docs/cmd-review/form.md | 17 +++- docs/cmd-review/menu.md | 16 +++- docs/decisions/0011-dm-drop-data-blocked.md | 81 ++++++++++++++++ ...12-form-create-ai-relationform-fallback.md | 96 +++++++++++++++++++ .../0013-menu-create-currentuser-cache.md | 84 ++++++++++++++++ src/commands/dm/drop.ts | 20 +++- src/commands/form/_validate.ts | 30 +++++- 8 files changed, 352 insertions(+), 8 deletions(-) create mode 100644 docs/decisions/0011-dm-drop-data-blocked.md create mode 100644 docs/decisions/0012-form-create-ai-relationform-fallback.md create mode 100644 docs/decisions/0013-menu-create-currentuser-cache.md diff --git a/docs/cmd-review/dm.md b/docs/cmd-review/dm.md index 1874839..bf1a820 100644 --- a/docs/cmd-review/dm.md +++ b/docs/cmd-review/dm.md @@ -1,4 +1,4 @@ -# dacli `dm` 命令审计报告 (2026-06-25) +# dacli `dm` 命令审计报告 (2026-06-25, M2 实战补丁 2026-07-20) ## 1. 命令清单 @@ -35,6 +35,7 @@ - **`dm info `** — 查表详情(字段/索引/外键),webapi 已有 `getDataModelInfo` - **`dm rename
--newTable`** — 重命名表 - **`dm selector`** — 选择器 +- **`dm truncate
`** — 清空表数据(保留结构),见 [ADR 0011](../decisions/0011-dm-drop-data-blocked.md). 配套 `dm drop --force-with-data` 可一键清空+删表 ## 4. AI 痛点评估 @@ -45,6 +46,15 @@ - ❌ 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](../decisions/0011-dm-drop-data-blocked.md) + - P0 [OPTIMIZE]: `dm drop` catch DB201 输出明确修复指引(先 TRUNCATE) + - P1 [NEW-CMD]: `dm truncate
` 走 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 命令拉详情 @@ -57,3 +67,7 @@ 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](../decisions/0011-dm-drop-data-blocked.md) +5. **P1 [NEW-CMD]**: `dm truncate
` + `dm drop --force-with-data` — 数据清空重启场景 1 命令完成 diff --git a/docs/cmd-review/form.md b/docs/cmd-review/form.md index 1632a7c..4b18385 100644 --- a/docs/cmd-review/form.md +++ b/docs/cmd-review/form.md @@ -1,4 +1,4 @@ -# dacli `form` 命令审计报告 (v0.11+, 2026-06-25) +# dacli `form` 命令审计报告 (v0.11+, 2026-06-25, M2 实战补丁 2026-07-20) **审计对象**: `/home/ubuntu/ccWorkDir/dacli/src/commands/form/` (24 个文件: 14 命令 + 10 私有) **重点**: webapi 架构对齐 + AI 友好性 + 盲点覆盖 @@ -94,6 +94,16 @@ - 缺 diff: clone 后变更追踪缺失 - 菜单挂载 hard-coded: `create.ts` 第 665 行直接拼 body, 应走 `loadVisualDev.createMenu` +### 4.5 M2 form create relationForm 兜底 (2026-07-20 实战) ⚠️ +- ❌ `form create --ai` AI 生成 relationForm 时 modelId/propsValue/relationField 三元组**覆盖率 ~60%**, 剩余 40% 触发 step machine 硬 FAIL (`关联功能不能为空 / 存储字段不能为空 / 回显字段不能为空`) +- 根因: NCPF backend LLM 看不到父 form 的 formId 与字段, 仅从 description 推断 +- jxcj M2 重启 (2026-07-20) 实战: 11 form 创建时 9 form 含 FK, 即便 description 显式写 `form_id=848939189058667461`, AI 仍生空 modelId +- **当前绕路 (2-step 模式)**: `--ai` 不提 FK 字段 → PG ALTER TABLE 加 FK 列 → `form update --fields` 加 relationForm 三元组 +- **修复路径**: 见 [ADR 0012](../decisions/0012-form-create-ai-relationform-fallback.md) + - P0 [OPTIMIZE]: `_validate.ts` 软降级 - relationForm 缺三元组 → 自动改 `jnpfKey: "input"` + 警告 + - P1 [OPTIMIZE]: `_relationForm_auto.ts` 启发式注入失败 fallback 到 input + - P1 [OPTIMIZE]: `form update --fields` 检测 FK 命名模式 + 表无此列 → 自动 ALTER ADD COLUMN + ### 4.4 selector 现状 | 接口 | selector | 状态 | |------|----------|------| @@ -111,3 +121,8 @@ 3. **[NEW-CMD]** form addFields / rmFields (中需求), 写 spec 放入 W3+ 4. **[KEEP]** `_simplify.ts` 保留, `_blindspots.ts` / `_buildformdata.ts` 是核心 5. **[AI 痛点]** 字段级 BS-54 已修复, 菜单挂载走 `loadVisualDev.createMenu` + +**M2 新增建议** (2026-07-20): +6. **P0 [OPTIMIZE]**: `_validate.ts` 软降级 relationForm → input — 见 [ADR 0012](../decisions/0012-form-create-ai-relationform-fallback.md) +7. **P1 [OPTIMIZE]**: `_relationForm_auto.ts` 启发式注入失败 fallback input (避免硬 FAIL) +8. **P1 [OPTIMIZE]**: `form update --fields` 自动 ALTER TABLE 加 FK 列 (修 ADR 0003 限制) diff --git a/docs/cmd-review/menu.md b/docs/cmd-review/menu.md index 74801ef..3d069de 100644 --- a/docs/cmd-review/menu.md +++ b/docs/cmd-review/menu.md @@ -1,4 +1,4 @@ -# dacli `menu` 命令审计报告 (2026-06-25) +# dacli `menu` 命令审计报告 (2026-06-25, M2 实战补丁 2026-07-20) ## 1. 命令清单 (8 个公开子命令) @@ -67,6 +67,15 @@ - AI 需特定父时仍需 list 找 - **应加 `menu selector` 命令** +### M2 menu create CurrentUser 缓存阻塞 (2026-07-20 实战) ⚠️ +- ❌ `menu create --formId=X` 成功后, form 端 `pcIsRelease=1` 已设, 但 `/api/oauth/CurrentUser` 的 menuList **不显示**新挂菜单 +- 影响: `dacli test browser` 找 menu URL 失败 (`realUrl: ""`), TC-B 全阻塞; 用户访问 http://nginx/jnpf_app_jxcj 看不到新菜单 +- jxcj M2 重启 (2026-07-20) 实战: 11 form-bound menu 全 create 成功, `dacli menu list` 显示 11 条, 但 CurrentUser.menuList 0 条. 二次 re-login 无效 +- **修复路径**: 见 [ADR 0013](../decisions/0013-menu-create-currentuser-cache.md) + - P1 [NEW-CMD]: `menu cache clear` 一键清 CurrentUser 缓存 + - P1 [OPTIMIZE]: `menu create` 成功后自动 invalidate 缓存 + - P1 [OPTIMIZE]: `test browser` 找 menu URL 失败时 fallback 到 `/jnpf_app_${appCode}/model/${formEnCode}` 直接 URL (jxcj M2 已验证) + --- **核心结论**: webapi/menu.ts 使用率仅 1/15 (6.7%), 6 个子命令切 webapi 收益大. CRUD 闭环缺 update, AI 改名/移动需 delete+create 浪费. @@ -75,3 +84,8 @@ 1. **REFACTOR-WEBAPI** (P0): 6 命令切到 `loadMenu.*`, 消除 ~120 行硬编码 2. **NEW menu update** (P1): 补全 CRUD 闭环, 避免 delete+create 浪费 3. **NEW menu selector** (P1): 一步输出父菜单树, AI 体验大幅提升 + +**M2 新增建议** (2026-07-20): +4. **P1 [NEW-CMD]** `menu cache clear` — 清 CurrentUser 缓存, TC-B 不再阻塞 +5. **P1 [OPTIMIZE]** `menu create` 后自动 invalidate 缓存 — 避免 TC-B 阻塞 +6. **P1 [OPTIMIZE]** `test browser` fallback 到 form 直接 URL — 临时方案兜底 diff --git a/docs/decisions/0011-dm-drop-data-blocked.md b/docs/decisions/0011-dm-drop-data-blocked.md new file mode 100644 index 0000000..adf6fe7 --- /dev/null +++ b/docs/decisions/0011-dm-drop-data-blocked.md @@ -0,0 +1,81 @@ +# 0011-dm-drop-data-blocked + +> **日期**: 2026-07-20 +> **状态**: Accepted +> **作者**: claude-code (jxcj M2 重启实战) +> **前置**: 无 +> **影响命令**: `dacli dm drop` + +## Context + +`dacli dm drop --table=X` 在表有数据行时被阻塞, 错误信息 `API code=400: The table has already been used and cannot be deleted`, 但**未告知用户先 TRUNCATE**。 + +jxcj M2 重启 (2026-07-20) 实战: 用户说"数据已经清空,重新开始", 实际 DB 中 10 张 jxcj 业务表每张还有 1 行 stale 数据。`dacli dm drop` 全部 10 次报 DB201 失败, 但错误信息误导用户以为有 visualdev/form 引用残留 (实际只是 getSum() > 0)。 + +根因 (JNPF 后端 `DbTableServiceImpl.java:295-300`): +```java +private void checkTab(String table, String dbLinkId, Integer type) throws SQLException { + if (TableUtil.checkByoTable(table)) { + throw new DataException(type == 1 ? MsgCode.DB101.get() : MsgCode.DB102.get()); + } + if (getSum(dbLinkId, table) > 0) { + throw new DataException(type == 1 ? MsgCode.DB201.get() : MsgCode.DB202.get()); + } +} +``` + +`getSum()` 用 `SELECT COUNT(*)` 检查表行数, > 0 即抛 DB201 (`"表已经被使用"`)。表名语义被误用为"有数据"。 + +## Decision + +**改进 1 (dacli 端)** - `dacli dm drop` 在 catch DB201 时输出明确修复指引: + +```typescript +// dacli/src/commands/dm/drop.ts (伪代码) +if (err.code === 'DB201') { + throw new Error( + `表 "${table}" 有数据 (rowCount=N), dacli dm drop 不能删除有数据的表. ` + + `修复: 先 TRUNCATE 表 (走 PG 直连或等 dacli truncate 命令), 再 drop. ` + + `或加 --force-truncate 参数 (M2 重启已验证, 见 ADR 0011)` + ) +} +``` + +**改进 2 (dacli 新命令, P1)** - 加 `dacli dm truncate --table=X`: + +```bash +dacli dm truncate --table=X --yes +# 内部走 webapi loadDataModel.truncateTable() 或直连 PG TRUNCATE +``` + +**改进 3 (dacli 新参数, P2)** - `dacli dm drop --force-with-data`: + +```bash +dacli dm drop --table=X --force-with-data --yes +# 等价于先 TRUNCATE 再 DROP, 但要求 --yes 二次确认 +``` + +**改进 4 (跨项目建议, 已记录)** - 用户在 M2 通过 PG 直连 (`/tmp/pg-truncate/truncate-jxcj.js`) 绕开, 留下 M2 阻塞 5 分钟。 + +## Alternatives Considered + +1. **dacli 自动 fallback PG 直连**: dacli 需 psql/pg 客户端 (jnpf 没内置, 当前靠 ssw-common 提供)。考虑环境差异, 不推荐。 +2. **改 JNPF 后端 DB201 错误信息**: jnpf 平台只读, 禁止改 (CLAUDE.md §代码修改权限)。只能在 dacli 端兜底。 +3. **加 --force flag 跳过 checkTab**: 危险, 可能误删生产数据, 不推荐无确认。 + +## Consequences + +### 正面 +- dacli dm drop 错误信息明确, 用户不再误判为 visualdev 引用问题 +- 加 dm truncate 命令后, 数据清空重启场景 1 命令完成 +- 跨项目 (jxcj / testspace / dos 等) 都受益 + +### 负面 +- 加新命令 / 参数需 webapi 镜像 (loadDataModel 是否有 truncateTable?), 需先调研 +- TRUNCATE 不可恢复, 必须 --yes 强确认, 文档需警示 + +## References + +- jxcj M2 重启: `docs/jxcj/learnings.md` 阶段 4 §M2 踩坑 1 +- JNPF 后端: `jnpf/.../jnpf-system-biz/src/main/java/jnpf/base/service/impl/DbTableServiceImpl.java:295-300` +- 现有 dacli cmd-review: `dacli/docs/cmd-review/dm.md` §3.1 (无此条目, 需补) diff --git a/docs/decisions/0012-form-create-ai-relationform-fallback.md b/docs/decisions/0012-form-create-ai-relationform-fallback.md new file mode 100644 index 0000000..fe21a5b --- /dev/null +++ b/docs/decisions/0012-form-create-ai-relationform-fallback.md @@ -0,0 +1,96 @@ +# 0012-form-create-ai-relationform-fallback + +> **日期**: 2026-07-20 +> **状态**: Accepted +> **作者**: claude-code (jxcj M2 重启实战) +> **前置**: ADR 0001 (FK→relationForm 强制声明) +> **影响命令**: `dacli form create --ai` + +## Context + +`dacli form create --ai ""` 走 NCPF backend LLM 生成字段 schema, 但 LLM 对 relationForm 字段的 modelId/propsValue/relationField 三元组**生成不稳定**: + +- 60% 覆盖率 (NCPF backend 自身文档): "关联" / "FK" / "外键" 关键词能触发 +- 40% 失败率: LLM 生成 `jnpfKey: "relationForm"` 但 modelId/propsValue/relationField 全空, 触发 dacli step machine 校验失败 (`关联功能不能为空 / 存储字段不能为空 / 回显字段不能为空`) + +ADR 0001 要求 description 显式声明 `relationForm 关联 <父表enCode> 显示字段 <字段名>`, 实际验证 (jxcj M2 重启): + +``` +--ai="字段: f_competition_id (varchar relationForm 关联 competition form_id=848939189058667461 显示字段 f_competition_name)" +# 仍然失败: 3 errors, AI 把 relationField="f_competition_name" 丢了 +``` + +**根因**: NCPF backend LLM 看不到父 form 的实际 formId 与字段, 只能从 description 推断, 推断失败率高。 + +**当前绕路 (jxcj M2 实战)**: 2-step 模式: +1. `--ai` 不提 FK 字段 → AI 生成 input 字段 +2. PG `ALTER TABLE ADD COLUMN f_xxx_id varchar(50)` +3. `dacli form update --fields='[{...jnpfKey:relationForm, modelId, propsValue, relationField...}]'` + +3 步完成, 可靠但繁琐。 + +## Decision + +**改进 1 (dacli smartProps 兜底)** - 现有 `_smart_props.ts` BS-18 已启发式注入 relationForm 三元组, 但覆盖率仅匹配 `*_space` / `*_id` 命名模式。扩展到: +- 触发 `*_id` 命名 → 启发式找 `existingEnCodes` 表匹配, 自动注入三元组 +- 已存在但 modelId 空 → 用现有 enCode 列表模糊匹配 (`*competition*` → `competition`) +- **不存在** → fallback: 把 `jnpfKey: "relationForm"` 降级为 `jnpfKey: "input"`, 加警告日志 + +```typescript +// dacli/src/commands/form/_relationForm_auto.ts 改进 (伪代码) +if (autoInjectFailed && jnpfKey === 'relationForm') { + log.warn(`字段 ${vmodel} relationForm 自动注入失败, 降级为 input. 后续 form update --fields 可手动修复.`) + return { ...field, __config__: { ...field.__config__, jnpfKey: 'input' } } +} +``` + +**改进 2 (dacli step machine 软化)** - 现状: relationForm 缺三元组 → hard FAIL. 改进: 软警告, 让 form create 通过 (用户后续 form update 修复): + +```typescript +// dacli/src/commands/form/_validate.ts 改进 (伪代码) +if (config.jnpfKey === 'relationForm' && (!e.modelId || !e.propsValue || !e.relationField)) { + warnings.push({ + field: formId, + message: `relationForm 三元组不全, 降级为 input. 修复: dacli form update --id= --fields='[{...三元组...}]'`, + code: 'VS-RELATION-INCOMPLETE-FALLBACK' + }) + config.jnpfKey = 'input' // 自动降级 +} +``` + +**改进 3 (dacli form update --fields 增强)** - 现状 (ADR 0003): 加 FK varchar 字段不会 ALTER 物理表. 改进: 检测字段名 `f_*_id` (FK 模式) 且表无此列, 自动 ALTER ADD COLUMN: + +```typescript +// dacli/src/commands/form/update.ts 改进 (伪代码) +if (newField.__vModel__.match(/^f_\w+_id$/) && !tableHasColumn(tableName, newField.__vModel__)) { + await loadDataModel.addTableField(dbLinkId, tableName, { + field: newField.__vModel__, dataType: 'varchar', dataLength: '50', allowNull: 1 + }) +} +``` + +## Alternatives Considered + +1. **强制 description 写三元组 (当前 ADR 0001 路径)**: 实测覆盖率仍 ~60%, 不可靠 +2. **AI 后处理加正则识别**: 已做 (smartProps BS-18), 但扩展到 input 降级需谨慎 (可能误判) +3. **改 NCPF backend prompt**: jnpf 平台只读, 禁止改 (CLAUDE.md §代码修改权限) +4. **完全删除 relationForm 自动生成**: 让用户全部手动 form update --fields, 失去 AI 价值 + +## Consequences + +### 正面 +- 消除 relationForm 校验失败的硬阻塞 +- 2-step 模式可降为 1-step (--ai 描述不提 FK, AI 自动用 input, 后处理升级 relationForm) +- 跨项目受益 + +### 负面 +- 软警告可能掩盖真实业务错误 (用户没看到 warning 直接发布, 后续才发现) +- 自动降级增加复杂度, 需测试覆盖 (主表无 FK / 多层级 FK / FK 名字不规范等情况) + +## References + +- jxcj M2 重启: `docs/jxcj/learnings.md` 阶段 4 §M2 踩坑 3 (2-step form 创建) +- ADR 0001: `dacli/docs/decisions/0001-fk-relation-form-required.md` +- ADR 0003: `dacli/docs/decisions/0003-form-update-fields-no-alter-table.md` (form update --fields 不 ALTER, 改进 3 待解决) +- 现有 dacli smartProps: `dacli/src/commands/form/_relationForm_auto.ts` +- 现有 dacli validate: `dacli/src/commands/form/_validate.ts` diff --git a/docs/decisions/0013-menu-create-currentuser-cache.md b/docs/decisions/0013-menu-create-currentuser-cache.md new file mode 100644 index 0000000..a372988 --- /dev/null +++ b/docs/decisions/0013-menu-create-currentuser-cache.md @@ -0,0 +1,84 @@ +# 0013-menu-create-currentuser-cache + +> **日期**: 2026-07-20 +> **状态**: Accepted +> **作者**: claude-code (jxcj M2 重启实战) +> **前置**: 无 +> **影响命令**: `dacli menu create --formId=X` + `dacli test browser` + +## Context + +`dacli menu create --formId=X --pcParents=Y` 成功后, 走 web `Actions/Module` API 绑 form, 形式正确 (form 端 pcIsRelease=1, pcReleaseName 已设). 但 `/api/oauth/CurrentUser` 的 menuList **不显示**新挂菜单, 导致: + +1. **TC-B 浏览器测试阻塞**: `dacli test browser --formId=X` 找 menu URL 失败 (`realUrl: ""`) +2. **用户访问 http://nginx/jnpf_app_jxcj 看不到新菜单**: 缓存未刷新 + +jxcj M2 重启 (2026-07-20) 实战: +- 11 个 form-bound menu 全部 create 成功 (form `pcIsRelease=1`) +- `dacli menu list` 显示 11 条 form-driven menus +- 但 `curl /api/oauth/CurrentUser` 返回的 menuList 只有 5 条 (默认平台菜单: 应用设置/在线开发 等), 0 条 jxcj form-bound +- 二次 `dacli app login --account=admin --password=123456 --appCode=jxcj` (新 token) → 仍 5 条 + +**根因猜测**: JNPF CurrentUser 菜单缓存策略不透明, 可能: +- Redis 缓存 (token → menuList) 未 invalidate +- 前端 localStorage 缓存 (前端路由层) 未清 +- 用户角色权限缓存 (isAllDevUser=1 时本应全显示, 但实际没显示) + +具体根因需 JNPF 后端源码调研 (本次未深入), 当前变通方案: 用户手动清浏览器 localStorage + re-login 多次。 + +## Decision + +**改进 1 (dacli 新命令, P1)** - 加 `dacli menu cache clear` 一键清 CurrentUser 缓存: + +```bash +dacli menu cache clear +# 内部: 调用 /api/oauth/CurrentUser 重置接口, 或 invalidate Redis key +# 或: 返回前端 localStorage 清除指令 (用户手动操作) +``` + +**改进 2 (dacli menu create 自动 invalidate)** - menu create 成功后自动调用缓存清理: + +```typescript +// dacli/src/commands/menu/create.ts 改进 (伪代码) +if (opts.formId && result.success) { + await invalidateCurrentUserCache() // 新增私有命令 + log.info('✓ 已自动 invalidate CurrentUser 缓存 (避免 TC-B 阻塞)') +} +``` + +**改进 3 (dacli test browser 兼容)** - 找 menu URL 失败时 fallback 到直接 form URL: + +```typescript +// dacli/src/commands/test/browser.ts 改进 (伪代码) +const menuUrl = await findMenuUrl(formId) +if (!menuUrl) { + log.warn(`menu URL 未找到 (CurrentUser 缓存未刷新), fallback 到直接 form URL: /jnpf_app_${appCode}/model/${formEnCode}`) + return `/jnpf_app_${appCode}/model/${formEnCode}` +} +``` + +jxcj M2 实战已验证直接 URL 可访问 (绕过菜单), 临时方案。 + +## Alternatives Considered + +1. **dacli 自动 invalidate Redis**: 需知 JNPF Redis key pattern + 权限, 调研成本高 +2. **改 JNPF 后端菜单缓存策略**: 平台只读, 禁止改 +3. **要求用户每次手动清 localStorage**: 已成事实 (M2 阻塞原因), 不可接受作为长期方案 +4. **dacli test browser 不查菜单直接走 form URL**: 改进 3 已采纳作为兜底 + +## Consequences + +### 正面 +- TC-B 浏览器测试不再因 menu 缓存阻塞 +- 用户访问 jxcj 应用可立即看到新挂菜单 +- 跨项目 (jxcj / testspace / dos 等) 都受益 + +### 负面 +- invalidate CurrentUser 缓存可能影响其他用户会话 (需限速/限频) +- 找 menu URL 失败时 TC-B 误判通过 (兜底 URL 可能不是用户期望的菜单路径) + +## References + +- jxcj M2 重启: `docs/jxcj/learnings.md` 阶段 4 §M2 踩坑 4 (TC-B menu 缓存) +- 现有 dacli cmd-review: `dacli/docs/cmd-review/menu.md` §4 (无此条目, 需补) +- JNPF 菜单缓存: 需查 `jnpf-system-biz/.../service/impl/AuthorizeService.java` 或类似 diff --git a/src/commands/dm/drop.ts b/src/commands/dm/drop.ts index 412ea47..a90bd18 100644 --- a/src/commands/dm/drop.ts +++ b/src/commands/dm/drop.ts @@ -37,7 +37,19 @@ export function buildDmDropCommand(): Command { await initWebapi(c) const r = (await loadDataModel.delDataModel(dbLinkId, opts.table)) as { code?: number; msg?: string } if (r.code !== 200 && r.code !== undefined) { - log.error(`删表失败 (code=${r.code}): ${r.msg}`) + // ADR 0011: DB201 (表有数据) 错误信息明确化, 避免误导用户以为有 visualdev 引用残留 + if (r.code === 400 && r.msg && /already been used/i.test(r.msg)) { + log.error(`删表失败: 表 "${opts.table}" 有数据行 (DB201), dacli dm drop 不能删除有数据的表.`) + log.error(`修复方案 (任选一):`) + log.error(` 1) 先 TRUNCATE 表, 再 drop:`) + log.error(` - PG 直连: ALTER TABLE "${opts.table}" ADD CONSTRAINT ... no, 实际:`) + log.error(` - 跑 SQL: TRUNCATE TABLE "${opts.table}"; 然后重新跑 dm drop`) + log.error(` 2) 等 dacli 加 truncate 命令 (ADR 0011 P1)`) + log.error(` 3) 加 --force-with-data 参数 (ADR 0011 P2, 需 --yes 二次确认)`) + log.error(`根因: JNPF DbTableServiceImpl.checkTab 用 getSum() > 0 抛 DB201, 表名语义被误用为"有数据"`) + } else { + log.error(`删表失败 (code=${r.code}): ${r.msg}`) + } process.exit(1) } log.ok(`已删除: ${opts.table}`) @@ -49,7 +61,11 @@ export function buildDmDropCommand(): Command { optional: { '--dbLinkId': '业务库 id' }, example: 'dacli dm drop --table=test_table --yes', source: { api: 'DELETE /api/system/DataModel/{dbLinkId}/Table/{table}', ref: 'web/.../api/systemData/dataModel.ts delDataModel()' }, - notes: ['v0.11+ 改用 webapi 镜像', '生产环境务必先用 dacli app init --backup 备份'], + notes: [ + 'v0.11+ 改用 webapi 镜像', + '生产环境务必先用 dacli app init --backup 备份', + 'ADR 0011: DB201 错误信息明确化 (2026-07-20 M2 实战, 表有数据时给出修复指引)', + ], }) return cmd } diff --git a/src/commands/form/_validate.ts b/src/commands/form/_validate.ts index 1b28973..36f1395 100644 --- a/src/commands/form/_validate.ts +++ b/src/commands/form/_validate.ts @@ -40,6 +40,7 @@ const VMODEL_REGEXP = /(^_([a-z0-9]_?)*$)|(^[a-z](_?[a-z0-9])*_?$)/i // 增强: 校验失败时输出清晰原因 + 自动建议别名 (去下划线/连字符) // eslint-disable-next-line @typescript-eslint/no-unused-vars import { ENCODE_REGEXP, FULLNAME_REGEXP, validateEnCode, validateFullName } from '../_encode_validator.ts' +import { log } from '../../core/log.ts' /** upload folder name 正则 — 镜像 Generator.getData() line 295 */ // eslint-disable-next-line regexp/no-unused-capturing-group @@ -412,6 +413,7 @@ export function validateBasicInfo(opts: { /** step 1: formData 字段校验 (镜像 FormGenerator.getData() 核心规则, line 237-300) */ export function validateFormData(formData: { fields?: any[] } | null, type: number): StepValidation { const errors: ValidationError[] = [] + const warnings: ValidationError[] = [] // ADR 0012: 软降级警告 (vs 硬错误) // type=4 视图无 formData (Form.vue:446) if (type === 4) { @@ -445,10 +447,23 @@ export function validateFormData(formData: { fields?: any[] } | null, type: numb } // relationForm: modelId/propsValue/relationField 必填 (line 272-276) + // ADR 0012 (2026-07-20 M2): 软降级 - 三元组不全时自动改 jnpfKey='input' + 警告 (而非硬 FAIL) + // 修复原因: NCPF AI 生成 relationForm 三元组覆盖率 ~60%, 硬 FAIL 阻塞 form create + // 当前 2-step 模式绕路繁琐, 软降级让 form create 通过 (用户后续 form update --fields 修复) if (config.jnpfKey === 'relationForm') { - if (!e.modelId) errors.push({ field: formId, message: `关联功能不能为空 (label: ${label})`, code: 'VS-RELATION-MODEL' }) - if (!e.propsValue) errors.push({ field: formId, message: `存储字段不能为空 (label: ${label})`, code: 'VS-RELATION-PROPS' }) - if (!e.relationField) errors.push({ field: formId, message: `回显字段不能为空 (label: ${label})`, code: 'VS-RELATION-FIELD' }) + const missing = [] + if (!e.modelId) missing.push('modelId') + if (!e.propsValue) missing.push('propsValue') + if (!e.relationField) missing.push('relationField') + if (missing.length > 0) { + // 软降级: 自动改 jnpfKey='input', 警告而非硬错误 + warnings.push({ + field: formId, + message: `[ADR 0012 软降级] relationForm 缺三元组 [${missing.join('/')}], 自动改 jnpfKey='input' (label: ${label}). 修复: dacli form update --id= --fields='[{...relationForm 三元组...}]'`, + code: 'VS-RELATION-INCOMPLETE-FALLBACK', + }) + config.jnpfKey = 'input' // 自动降级, 让 form create 通过 + } } // popupSelect / popupTableSelect (line 277-281) @@ -541,6 +556,15 @@ export function validateFormData(formData: { fields?: any[] } | null, type: numb loop(formData.fields) + // ADR 0012: 打印软降级警告 (不阻断 form create) + if (warnings.length > 0) { + log.warn(`⚠️ validateFormData 软警告 (${warnings.length} 条, 来自 ADR 0012 软降级):`) + for (const w of warnings) { + log.warn(` - [${w.code}] ${w.message}`) + } + log.warn(`提示: 这些警告不影响 form create, 但建议后续用 dacli form update --fields 手动修复`) + } + return { ok: errors.length === 0, step: 1,