Files
dacli/docs/cmd-review/menu.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.6 KiB

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

1. 命令清单 (8 个公开子命令)

# 命令 用途 状态
1 dacli menu list 列出菜单 (树形) ✅ KEEP + webapi
2 dacli menu info <id> 菜单详情 ✅ KEEP
3 dacli menu create 创建菜单 (支持 --formId 自动挂载) ✅ KEEP
4 dacli menu delete <id> 删菜单 (--cascade) ✅ KEEP
5 dacli menu releases 查已发布版本菜单 ✅ KEEP
6 dacli menu unrelease <id> 撤销发布 ✅ KEEP
7 dacli menu purge <id> 彻底清除 (含回收站) ✅ KEEP
8 dacli menu _helpers 内部辅助 (URL 修正等) 内部

2. web 端对应

  • 菜单页: web/apps/jnpf-web-apps-main/src/views/permission/menu/ (或 system/)
  • 菜单 API: web/apps/jnpf-web-apps-main/src/api/permission/menu.ts (15 函数)
  • webapi/menu.ts 已存在 (v0.11 Phase 1 已镜像, 15 函数)

3. 改/删/留 建议

[KEEP] 全部 8 命令保留

覆盖全生命周期, 设计合理

[REFACTOR-WEBAPI] P0 重点 (webapi 使用率仅 1/15 = 6.7%)

6 个子命令应切到 loadMenu.*:

  • create.ts 低级模式: c.postJson('/system/Menu') → loadMenu.create(body)
  • create.ts SelectorFilter: c.get('/system/Menu/SelectorFilter/0') → loadMenu.getMenuSelectorFilter()
  • delete.ts: c.del('/system/Menu/{id}') → loadMenu.delMenu(id)
  • info.ts: c.get('/system/Menu/{id}') → loadMenu.getInfo(id)
  • purge.ts: c.del('/system/Menu/{id}') → loadMenu.delMenu(id)
  • 注: Actions/Module + getReleaseMenu 在 web visualDev.ts 不在 menu.ts, 保留原 API 合理

[DEPRECATE] 无

[NEW-CMD] P1 必补

  • dacli menu update <id> — 改菜单 (改名/移动/属性改), webapi 已有 update
  • dacli menu selector [--category] [--type] — 一步输出可挂载父菜单树, AI 友好 (webapi 有 getMenuSelector + getSelectorAll)

[NEW-CMD] P2

  • dacli menu export <id> + dacli menu import — 跨 app 迁移 (webapi 有 exportMenu)
  • dacli menu move <id> --newParentId — 移动菜单 (可合并到 update)
  • dacli menu permission <id> — 调试"菜单 403"

[NEW-CMD] P3

  • dacli menu fixDisplay --id — BS-43 一键补 7 必填字段
  • dacli menu clone <id> — 克隆菜单变体

4. AI 痛点评估

菜单创建流程: 友好 ✅

  • --formId 自动走 web Actions/Module, 后端自动构造 propertyJson + 授权
  • D-12/BS-50 多层防护, create.ts 自动兜底 webType=4 + propertyJson.moduleId + urlAddress 反查

D-12 防御: 较完善 ✅

  • 三层防护 (create.ts D-9/D-12 反查 + guard BS-50 + D-4 fallback)
  • 但 urlAddress 非 model/ 前缀时仍可能留空 moduleId, 建议加 ERROR 提示

菜单+form 联动: 基本闭环 ✅

  • create/releases/purge 配合 form release 完整流程
  • 缺 form 端选择器

父菜单查找: 仍繁琐 ⚠️

  • create.ts v0.7.1 已自动 SelectorFilter 找 type=1 父
  • 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
    • 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 浪费.

Top 3 关键建议:

  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 — 临时方案兜底