Files
eip4-platform/docs/归档/2026-06-15-菜单维护树模式重建与树选择框修复-plan.md
zhengwr 1b02036153 docs+javadoc: 文档-代码对抗核查对齐 + 归档候选物理归档
5 路并行核对总览 §9/§10/§11 + A/B 矩阵声明 vs 两仓代码(48 条 46 条完全一致,无虚报),修正不一致处:
- A10 行 🔴→🟡:W1 Flyway(V1-V3)+W2-W4 容器化/nginx/compose 骨架 06-25 已合 main,文档此前低报;§10.2 Flyway/compose 两条标 ✅
- §9 P0② 表格「同族扩长」与对抗审查①矛盾(代码一律拒 TYPE 变更)改齐
- §10.2 render-plan 行号迁 AiDraftGateValidator.java:246(SRP 拆分后位置)
- §11 报表单测 73→79;§2「五步编排壳」改四步向导
- CandidateUsersHandler 类级 javadoc:scriptUser 已于 06-26 接入(resolveScriptUsers),删「WARN 降级未接入」陈旧表述(纯注释零行为变更)

归档整理(总览 §8 归档候选落地):
- 10 份已完成/被取代文档 git mv 入 docs/归档/(06-14×3/06-15/06-16/06-20 plans、CRUD-QA、C3/C5、总览-06-17)
- 引用同步改路径:README 索引、M0剩余项登记、通用模板收口计划、架构方向-design、新闻管理plan
- README 刷新至 07-02:补 06-22→06-26 增量一节、审批/报表行状态、§2 补登 06-25/06-26 四份 design/计划、§4 过时「未 push」表述修正

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:01:23 +08:00

5.6 KiB
Raw Permalink Blame History

✅ 已完成·归档候选(2026-06-21):菜单树模式 + 字段级树选择框已修复 live 验收。可后续 git mv 入 docs/归档/。

菜单维护改老系统模式 + 字段级树选择框修复 — 实施计划

日期:2026-06-15 触发:用户以"菜单维护"为例质疑树模板/树选择框是否真正实现,附老系统截图(左树 + 右表单 + 工具栏 添加/修改/删除/保存,上级菜单为树选择框)。

一、调查结论(均已证据坐实)

存在两套并行实现,用户看到的菜单管理走的是"没用转换器"的那套:

路径 树模板 树选择框 现状
通用转换器 TemplateToAmisConverter ✅ type=3 → input-tree + 节点CRUD,多级 字段级 ❌(见下) —
手写后台 schema(菜单/用户/角色) ❌ 扁平 CRUD ❌ 扁平 select 用户看到的就是这套

关键事实:

  1. 菜单管理当前页 = 入库的手写扁平 CRUD(docs/sql/A1_sys_admin_menu_manage_upsert.sql,templateId=sys-admin-menu,DB 覆盖 resource 文件)。上级所属分组是扁平 select,逐行弹窗加子菜单。
  2. 菜单维护本就是 type=3 树模板:id=b38737be-aecf-44d9-b3d4-1823c5443fba,绑 SYS_MENU,自引用列 PARENTID,节点按钮 insert/update/delete/save(= 截图工具栏)。编辑页 pageid=4611e954-fa49-4926-82ce-7da5318e60b0。
    • 证据:framework/com.dsasp.server.db/META-INF/sql/install/1.0.78/view_template.copy、view_page.copy。
  3. 该模板已被转换过,产物在 eip4-platform/转换产物/schema/b38737be-….json,已是老系统模式:<input-tree editable removable source=/api/template/b38737be/tree> + "新增分类"弹窗(加载编辑页 4611e954 + SYS_MENU_ADD 保存)+ 行内改名/删除。只是没被接成菜单管理入口。
  4. 上级菜单"列表选择框"根因:编辑页 4611e954 转换产物里 PARENTID → picker source=/api/picker/b38737be/list。dialogid b38737be 是 type=3 树,但 UiTypeMapper 的 case "SelectDialog"(platform-converter/.../UiTypeMapper.java:215-241)不解析 dialogid 类型,一律产 picker。
  5. 2 级限制根因(手写路径):AdminController.buildMenuChildren(platform-metadata/.../web/AdminController.java:204-237,注释明写"两级")+ MenuService.buildTree(menu/MenuService.java:32-99,buildLeafNode 把叶子 children 硬设 List.of())。但改走 b38737be 后不再依赖此端点——树数据来自 /api/template/.../tree(TemplateTreeController.resolveLevels 已递归任意层级)。
  6. 字段级 uitype 全表里没有 "TreeSelect";老系统树选择 = SelectDialog 的 dialogid 指向 type=3 树模板。运行时 PickerController.resolveByViewTemplate 已会按 dialog XML 根元素 <tree>/<crud> 区分树/列表,但转换期不区分。

二、改动收敛为两处

改动 A — 菜单维护页:接通已转换的 type=3 产物(修复第 1、2 点)

  • 把后台导航"菜单管理"入口从手写扁平 CRUD 切到 templateId=b38737be(已转换的树页)。
  • 步骤:
    1. 确认/导入 b38737be + 4611e954 进运行时 sys_page_schema(产物已在 转换产物/,用 SchemaImportCli 导入或核验 8093 已 live)。
    2. 验证 /api/template/b38737be/tree 返回多级 SYS_MENU 树(自引用 PARENTID,TemplateTreeController 递归)→ 第 1 点解决。
    3. 改菜单入口指向 b38737be(前端导航 / sys_menu 的 view_templateid,或用产物覆盖 sys-admin-menu 入库 schema)。
    4. 废弃手写 A1_sys_admin_menu_manage_upsert.sql(保留备份)。
  • 产物天然含 input-tree + 添加/修改(行内改名)/删除 + 新增弹窗 → 第 2 点(老系统模式)解决。

改动 B — 转换器 SelectDialog 树感知(修复第 3 点 + 全站 883 页)

  • 改 UiTypeMapper case "SelectDialog"(及 MultiSelectDialog):转换期解析 dialogid 指向模板的 type;
    • type==3(树)或目标自引用实体 → 产 amis input-tree(或 tree-select),source=/api/template/{dialogid}/tree(复用现成端点)。
    • 否则维持 picker(不回归列表选择框场景)。
  • 实现关键:转换器需在转换期拿到"dialogid → 模板 type"映射。BatchConvertCli 读取全量 view_template 行,可构建 id→type map 注入 UiTypeMapper;或复用 TemplateTreeController.resolveLevels/PickerController 的解析逻辑。实现第一步先确认此映射可得。
  • TDD:新增单测——SelectDialog(树 dialogid) → input-tree;SelectDialog(crud dialogid) → picker(保 72 测试绿)。
  • 全量重转 883 + 重导(BatchConvertCli / SchemaImportCli)。

三、风险与验证

  • 转换器改动影响全站 → 重转后需回归(72 单测 + 抽样 diff)。
  • MENUROOT(根级菜单, dialogid 80554409) 是 sys_menu_root 扁平列表,维持 picker 正确;功能(VIEW_TEMPLATEID, 8b89fd29) 是 type=4 树+grid,本期可暂留 picker(后续项)。
  • 8093 重启 smoke + 浏览器验收菜单维护:多级树 / 添加修改删除保存 / 上级菜单为树选择框。
  • 旁注:运行时左侧导航菜单(MenuService.buildTree)同样硬 2 级,属独立潜在问题,本期不在范围,单列后续。

四、执行顺序

  1. 确认 dialogid→type 映射在转换期可得(读 BatchConvertCli)。
  2. 改动 B(TDD:先写测试 → 改 UiTypeMapper → 绿)。
  3. 重转 + 重导,核验 4611e954 PARENTID 变 input-tree/tree-select。
  4. 改动 A(接入 b38737be,废弃手写 CRUD),导入/核验。
  5. 8093 重启 + 浏览器端到端验收三点。