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

57 lines
5.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
> ✅ **已完成·归档候选(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 重启 + 浏览器端到端验收三点。