chore: 清理可再生 schema 产物 + gitignore 收口 + 菜单维护树计划/SQL

删除已跟踪的 batch_regression schema 产物(BatchConvertCli 可重生,体量大);.gitignore 屏蔽 tools/s3_rewriter/output/schema{,_out,_wsd}(各~20M)与 output 下重生副本分级清单.csv。补 2026-06-15 菜单维护树模式重建与树选择框修复计划 + menu_maintain 主子表 upsert SQL。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-16 14:09:00 +08:00
parent 598f4f9662
commit bf5659590f
4 changed files with 67 additions and 17399 deletions

View File

@@ -0,0 +1,54 @@
# 菜单维护改老系统模式 + 字段级树选择框修复 — 实施计划
日期: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 重启 + 浏览器端到端验收三点。