Files
dacli/docs/decisions/0013-menu-create-currentuser-cache.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

85 lines
3.6 KiB
Markdown

# 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` 或类似