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 段
This commit is contained in:
ssw committed 2026-07-20 18:02:38 +08:00
1 parent a10a829a86
commit bbcdf9fab2
8 files changed
+352 -8

No files matched your search

+15 -1
View File
@@ -1,4 +1,4 @@
# dacli `dm` 命令审计报告 (2026-06-25) # dacli `dm` 命令审计报告 (2026-06-25, M2 实战补丁 2026-07-20)
## 1. 命令清单 ## 1. 命令清单
@@ -35,6 +35,7 @@
- **`dm info <table>`** — 查表详情(字段/索引/外键),webapi 已有 `getDataModelInfo` - **`dm info <table>`** — 查表详情(字段/索引/外键),webapi 已有 `getDataModelInfo`
- **`dm rename <table> --newTable`** — 重命名表 - **`dm rename <table> --newTable`** — 重命名表
- **`dm selector`** — 选择器 - **`dm selector`** — 选择器
- **`dm truncate <table>`** — 清空表数据(保留结构),见 [ADR 0011](../decisions/0011-dm-drop-data-blocked.md). 配套 `dm drop --force-with-data` 可一键清空+删表
## 4. AI 痛点评估 ## 4. AI 痛点评估
@@ -45,6 +46,15 @@
- ❌ AI 加字段只能 `drop + create`(数据全失),风险极高 - ❌ AI 加字段只能 `drop + create`(数据全失),风险极高
- web 端 `addTableFields()` / `updateDataModel()` 已镜像但未在 dacli 暴露 - 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 <table>` 走 webapi (待确认 loadDataModel 是否暴露 truncate)
- P2 [NEW-OPT]: `dm drop --force-with-data` 一键 TRUNCATE+DROP (需 --yes 二次确认)
### 与 form create 联动 ### 与 form create 联动
- form create --autoTable 时, dm list 能验证表存在 - form create --autoTable 时, dm list 能验证表存在
- 但 dm 缺 info, AI 经常需要 fields 命令拉详情 - 但 dm 缺 info, AI 经常需要 fields 命令拉详情
@@ -57,3 +67,7 @@
1. **P0 [REFACTOR-WEBAPI]**: dm create + drop 切到 `loadDataModel.*` 调用 1. **P0 [REFACTOR-WEBAPI]**: dm create + drop 切到 `loadDataModel.*` 调用
2. **P1 [NEW-CMD]**: 新增 `dm addFields` / `dm update` / `dm info` 三个命令(webapi 已镜像) 2. **P1 [NEW-CMD]**: 新增 `dm addFields` / `dm update` / `dm info` 三个命令(webapi 已镜像)
3. **P1 [OPTIMIZE]**: 评估 dm rename 需求 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 <table>` + `dm drop --force-with-data` — 数据清空重启场景 1 命令完成
+16 -1
View File
@@ -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 私有) **审计对象**: `/home/ubuntu/ccWorkDir/dacli/src/commands/form/` (24 个文件: 14 命令 + 10 私有)
**重点**: webapi 架构对齐 + AI 友好性 + 盲点覆盖 **重点**: webapi 架构对齐 + AI 友好性 + 盲点覆盖
@@ -94,6 +94,16 @@
- 缺 diff: clone 后变更追踪缺失 - 缺 diff: clone 后变更追踪缺失
- 菜单挂载 hard-coded: `create.ts` 第 665 行直接拼 body, 应走 `loadVisualDev.createMenu` - 菜单挂载 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 现状 ### 4.4 selector 现状
| 接口 | selector | 状态 | | 接口 | selector | 状态 |
|------|----------|------| |------|----------|------|
@@ -111,3 +121,8 @@
3. **[NEW-CMD]** form addFields / rmFields (中需求), 写 spec 放入 W3+ 3. **[NEW-CMD]** form addFields / rmFields (中需求), 写 spec 放入 W3+
4. **[KEEP]** `_simplify.ts` 保留, `_blindspots.ts` / `_buildformdata.ts` 是核心 4. **[KEEP]** `_simplify.ts` 保留, `_blindspots.ts` / `_buildformdata.ts` 是核心
5. **[AI 痛点]** 字段级 BS-54 已修复, 菜单挂载走 `loadVisualDev.createMenu` 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 限制)
+15 -1
View File
@@ -1,4 +1,4 @@
# dacli `menu` 命令审计报告 (2026-06-25) # dacli `menu` 命令审计报告 (2026-06-25, M2 实战补丁 2026-07-20)
## 1. 命令清单 (8 个公开子命令) ## 1. 命令清单 (8 个公开子命令)
@@ -67,6 +67,15 @@
- AI 需特定父时仍需 list 找 - AI 需特定父时仍需 list 找
- **应加 `menu selector` 命令** - **应加 `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 浪费. **核心结论**: 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 行硬编码 1. **REFACTOR-WEBAPI** (P0): 6 命令切到 `loadMenu.*`, 消除 ~120 行硬编码
2. **NEW menu update** (P1): 补全 CRUD 闭环, 避免 delete+create 浪费 2. **NEW menu update** (P1): 补全 CRUD 闭环, 避免 delete+create 浪费
3. **NEW menu selector** (P1): 一步输出父菜单树, AI 体验大幅提升 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 — 临时方案兜底
@@ -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 (无此条目, 需补)
@@ -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 "<description>"` 走 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=<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`
@@ -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` 或类似
+18 -2
View File
@@ -37,7 +37,19 @@ export function buildDmDropCommand(): Command {
await initWebapi(c) await initWebapi(c)
const r = (await loadDataModel.delDataModel(dbLinkId, opts.table)) as { code?: number; msg?: string } const r = (await loadDataModel.delDataModel(dbLinkId, opts.table)) as { code?: number; msg?: string }
if (r.code !== 200 && r.code !== undefined) { 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) process.exit(1)
} }
log.ok(`已删除: ${opts.table}`) log.ok(`已删除: ${opts.table}`)
@@ -49,7 +61,11 @@ export function buildDmDropCommand(): Command {
optional: { '--dbLinkId': '业务库 id' }, optional: { '--dbLinkId': '业务库 id' },
example: 'dacli dm drop --table=test_table --yes', example: 'dacli dm drop --table=test_table --yes',
source: { api: 'DELETE /api/system/DataModel/{dbLinkId}/Table/{table}', ref: 'web/.../api/systemData/dataModel.ts delDataModel()' }, 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 return cmd
} }
+27 -3
View File
@@ -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 // eslint-disable-next-line @typescript-eslint/no-unused-vars
import { ENCODE_REGEXP, FULLNAME_REGEXP, validateEnCode, validateFullName } from '../_encode_validator.ts' import { ENCODE_REGEXP, FULLNAME_REGEXP, validateEnCode, validateFullName } from '../_encode_validator.ts'
import { log } from '../../core/log.ts'
/** upload folder name 正则 — 镜像 Generator.getData() line 295 */ /** upload folder name 正则 — 镜像 Generator.getData() line 295 */
// eslint-disable-next-line regexp/no-unused-capturing-group // 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) */ /** step 1: formData 字段校验 (镜像 FormGenerator.getData() 核心规则, line 237-300) */
export function validateFormData(formData: { fields?: any[] } | null, type: number): StepValidation { export function validateFormData(formData: { fields?: any[] } | null, type: number): StepValidation {
const errors: ValidationError[] = [] const errors: ValidationError[] = []
const warnings: ValidationError[] = [] // ADR 0012: 软降级警告 (vs 硬错误)
// type=4 视图无 formData (Form.vue:446) // type=4 视图无 formData (Form.vue:446)
if (type === 4) { if (type === 4) {
@@ -445,10 +447,23 @@ export function validateFormData(formData: { fields?: any[] } | null, type: numb
} }
// relationForm: modelId/propsValue/relationField 必填 (line 272-276) // 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 (config.jnpfKey === 'relationForm') {
if (!e.modelId) errors.push({ field: formId, message: `关联功能不能为空 (label: ${label})`, code: 'VS-RELATION-MODEL' }) const missing = []
if (!e.propsValue) errors.push({ field: formId, message: `存储字段不能为空 (label: ${label})`, code: 'VS-RELATION-PROPS' }) if (!e.modelId) missing.push('modelId')
if (!e.relationField) errors.push({ field: formId, message: `回显字段不能为空 (label: ${label})`, code: 'VS-RELATION-FIELD' }) 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=<id> --fields='[{...relationForm 三元组...}]'`,
code: 'VS-RELATION-INCOMPLETE-FALLBACK',
})
config.jnpfKey = 'input' // 自动降级, 让 form create 通过
}
} }
// popupSelect / popupTableSelect (line 277-281) // popupSelect / popupTableSelect (line 277-281)
@@ -541,6 +556,15 @@ export function validateFormData(formData: { fields?: any[] } | null, type: numb
loop(formData.fields) 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 { return {
ok: errors.length === 0, ok: errors.length === 0,
step: 1, step: 1,