Files
eip4-platform/docs/通用模板全类型可用性-通盘盘点与收口计划-2026-06-16.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

118 lines
11 KiB
Markdown
Raw Permalink 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-16
触发:用户要求「停下来通盘考虑,保证**所有类型**的旧模板(不光 tree)**没有自定义模板**的功能都能正常使用——新架构(转换器+设计器);自定义的走 bespoke」。
方法:精读 `转换器覆盖度审计-2026-06-13` / `EIP4-架构与缺口现状-2026-06-13` / `归档/CRUD-QA-发现与剩余-2026-06-14` / `M0交付/153定制视图处置清单v1` + 全库 `view_template` 实测分布,合成一张通盘视图。
> **状态校准(2026-06-16 晚)**:本计划 §三 的 **P0 三项(日历 type5 / 树 type3 接端点 / 组合 type6)转换器源码已全部实现并提交**(eip4-platform main `598f4f9`,连同审批 `33fda45` / 引用列显名 `cd133aa` / chore `bf56595`;提交前 `mvn test` 绿)。**但下文 §二 矩阵里 type3/5/6 的"未接/占位/语义错"描述的是 _运行库(883 页)现状_——在「全量重转重导 + 重启」之前仍成立**。即:源码已修 ✅,运行库待部署 ⏳。详见末尾「§七 收口落地与校准」。
---
## 一、唯一分水岭:`view_template.engineclass`
全库 1516 个模板,按 `engineclass` 一刀切成两个互斥宇宙(实测分布坐实):
| 宇宙 | 判据 | 数量 | 归属 |
|---|---|---|---|
| **通用模板** | `engineclass IS NULL OR ''` | **1363** | 转换器 + 设计器(本计划范围) |
| **自定义模板** | `engineclass` 为 Java 视图类 | **153** | bespoke 重写 = **F3**(已有终判,见 §四) |
153 恰好对齐既有「F3 153 重写」。**所以"保证所有类型通用模板正常使用" = 收口下面 §二 矩阵里 1363 个通用模板的每类残留缺口。** 自定义 153 不在通用转换范围,永远不靠转换器跑对(§四)。
---
## 二、通用模板(1363)按类型覆盖矩阵 + 残留缺口
`type` 含义来自老 `TemplateType.java`。「通用数」为 engineclass 空的计数。
| type | 含义 | 通用数 | 转换器现状 | 残留缺口(仅通用部分) | 处置 |
|---|---|---|---|---|---|
| **1** | 列表 GRID | 744 | ✅ 主链路 OK(过滤/分页/引用列 id→名/picker/枚举/日期均已修) | ①onselected/filter 脚本挂回(依赖 rewriter 管线,未做)②19 页缺 EDITFORM 映射(缺源配置,非代码 bug) | P1 / P1 |
| **3** | 树 | 44 | ✅ 源码已接(⏳待重导) | 声明式多级树仍走 `selectservice` 占位、未接端点——**此为运行库现状**;转换器源码已修:`currentTemplateId`→source 指向 `/api/template/{templateId}/tree`,树选择框同源(`598f4f9`)。重转重导后 53 页生效 | ✅源码/⏳部署 |
| **4** | 树+表 TreeGrid | 35 | ✅ 三轮已修(树高/子树聚合/按钮/删除)+ 本次修「选不中(virtualThreshold)/双请求(去冗余onEvent)」 | 通用部分基本完整;自定义 engineclass 的(视图/功能管理)不在此列,归 §四 | ✅ |
| **5** | 日历 CALENDAR | 2 | ✅ 源码已修(⏳待重导) | 运行库现仍是普通 crud 表格;转换器已加 `isCalendarTemplate`(查 type==5)分流 `convertCalendar`→amis `calendar`(items→schedules,scheduleAction drawer)(`598f4f9`) | ✅源码/⏳部署 |
| **6** | 组合 GROUP | 18 | ✅ 源码已修(⏳待重导) | 运行库现仍 tabs 占位;转换器 `convertGroup` 改发 `service+schemaApi:/api/page/schema/{tempid}`+amis 原生 mountOnEnter 懒加载(`598f4f9`)——**转换器侧解决,无需 eip4-web 前端改**(优于本计划原设想的"前端接线") | ✅源码/⏳部署 |
| **7** | 表单 EDITFORM | 61(编辑表单 view_page 1241) | ✅ 大幅推进(A0-A3 已修控件/多 tab/全量迁移;A1 子表列递归) | width/colspan 像素布局(875+,后置);SelectDialog ~97% 无 dialogid 降级 select | P2 |
| **100** | 列表选择框 | 116 | ⚠️ 冗余死页 | 入库但菜单关联=0;运行时选择由 `/api/picker/{dialogid}/list` 承接、**不读这些 schema** → 待决策停转 or 留 F4 | 决策项 |
| **101** | 树选择框 | 10 | ⚠️ 冗余死页 | 同上 | 决策项 |
| **200** | 报表 REPORT | 333 | ✅ A 类表格 ~324 可渲染 | B 类图表 `ischart=true` **4 条**降级纯表格(ECharts 未平移);C 类 JOR 套打 **45** 版式丢失(待 univer/Web 打印);数据源 VIEW_/VM_ 视图 dev 缺 | 另案 |
> 旁注(口径):EditGrid/MasterSub/Calendar 等「高级结构」在 `view_template` **根节点** 0 存量;真实存量在编辑表单(view_page)子表里,已由 A1 子表列递归覆盖。TwinColSelect/PasswordField 真丢失控件全 0 存量,判定不做。
---
## 三、收口计划:让"所有类型通用模板正常使用"(按客户正常使用回报排序)
### P0 — 让"整类不可用/占位"的通用类型真正可用 ✅ 转换器源码已全部完成+提交(`598f4f9`);⏳ 待全量重转重导生效
1. ✅ **日历 type5(2 页)**:转换器已加 `convertCalendar` → amis `calendar`(`isCalendarTemplate` 查 type==5 分流,items→schedules,scheduleAction drawer)。
2. ✅ **树 type3 声明式多级接端点**:`currentTemplateId`→source 指向 `/api/template/{templateId}/tree`(`TemplateTreeController`),树选择框同源复用。机制覆盖全部 type=3。
3. ✅ **组合 type6(20 页)**:`convertGroup` 改发 `service schemaApi:/api/page/schema/{tempid}` + amis 原生 mountOnEnter 懒加载——**转换器侧解决,无需 eip4-web 前端改**。
### P1 — 已可用但有功能缺角(中等)
4. **19 页缺 EDITFORM 映射**:逐页溯查 eip3 XML 补 `<button>` 的 EDITFORM,或为实体建 form 模板,重转。(缺源配置)
5. **onselected/filter 脚本挂回(930+422 模板)**:需先改 `s3_rewriter` 管线标注事件来源类型,再按类型挂 amis onEvent。属 rewriter 管线专项。
### P2 — 打磨/另案(不阻断正常使用)
6. 表单 width/colspan 像素布局;报表 B 图表(amis chart)/ C 类 JOR 套打(univer/Web 打印);选择框 100/101 死页停转决策。
### 部署
- 以上通用修复**改转换器源码 → mvn 测试 → 全量重转(BatchConvertCli) → 重导(SchemaImportCli) → 重启/验收**。
- 本次 tree 修复(virtualThreshold + 去 onEvent + 107 页运行库补丁)已 live;**待并入下一次全量重转**,使 `转换产物` 与运行库一致(当前为避 883 页回归面,先补了运行库)。
---
## 四、自定义模板 153(F3)— 不在通用范围,走 bespoke
既有权威终判:`docs/M0交付/153定制视图处置清单v1.md` §8(全见源码版):
| 处置 | 数量 | 工时 | 说明 |
|---|---|---|---|
| 重写(React/amis custom 渲染器) | 23 | 75.0 人日 | 唯一硬成本(甘特调度族 / iframe图片族 / 工作流审批族) |
| 降级(amis 标准模板替代,功能等价优先) | 97 | 76.25 人日 | |
| 留旧(EIP3 长期过渡) | 30 | 7.5 人日 | |
| 废弃 | 3 | 0 | |
| **合计** | **153** | **158.75 人日 ≈ 7.56 人月** | |
- **卡点**:超 3 人月止损线 → **S1 止损评审会**客户三选一(分期 / 引第三方甘特调度组件 / 扩预算)。技术线推不动,属商务/客户决策。
- **本次 tree 调查命中的 framework 层自定义页**(功能管理 `UserFunDesignComponent` / 视图管理 `UserPageDesignComponent` / 数据权限配置 `DataFilterConfigView` / 岗位管理 / 部门编制 …)**均属这 153**,老组件源码在 `framework/com.dsasp.client.*` 可忠实还原。定制方法 = 读老组件 → 建后端端点 → bespoke amis schema overlay(SQL,同菜单 v5)→ 重导后重跑。**但忠实定制每页需后端小工程**(如功能管理的 ENTITYTYPE→模板过滤,新系统无现成端点)。
- **重要分辨**:功能管理/视图管理/实体分类枚举/功能模板下载/定时任务定义 是**老开发态模板设计工具**,新架构已用转换器+设计器取代,忠实重写价值低(建议归"降级/留旧");数据权限配置/岗位管理/部门编制 是客户**实际在用**的管理,值得 bespoke。这与终判的"重写23/降级97/留旧30"一致——具体每页归类见终判清单。
---
## 五、本次会话已落地(tree 维度,属 §二 type3/4 通用收口的一部分)
- 转换器 `convertTreeGrid`/`convertTree`:加 `virtualThreshold:100000`(修虚拟列表致"选不中")+ 去冗余 `onEvent.change reload`(修双请求)。111 测试绿。
- 运行库 107 含树页批量补丁(live 生效);菜单维护 SQL 升 v5。
- live 验收:菜单/功能/视图/新闻收藏 选中粘住 + 单请求。
- 详见 memory `eip4-amis-tree-select-virtuallist`。
---
## 六、建议的下一步(待你拍板)
1. ~~通用收口先做 P0 三项~~ → **✅ 已完成+提交(`598f4f9`)。下一步改为「全量重转重导 + 重启 live 验收」**,让 P0 三项(+审批 A/B)在 883 运行库页生效。⚠️ 部署坑(见 §七):全量重导会覆盖 bespoke overlay(菜单 v5 / A1–A5 admin),须排除其 template_id 或重导后重跑各 overlay SQL。
2. **P0 部署后 → P1 才是"模板真好用"的大头**:①onselected/filter/enableButton 脚本挂回(930+422+259 模板,依赖 s3_rewriter 管线标注事件来源)②19 页缺 EDITFORM 映射。这两项体量与价值都大,是"所有类型通用模板正常使用"的实质剩余。
3. **153 自定义**维持既有终判,等 S1 评审会客户拍板后按"重写/降级/留旧"分批执行;framework 层若要先行 bespoke,逐页按 §四方法做(每页一个后端+schema 小工程)。
4. 不再逐页零敲——以"按类型整类收口"推进。
---
## 七、收口落地与文档校准(2026-06-16 晚)
**P0 三项转换器源码已实现并提交**(eip4-platform main,无远程/未 push):
| commit | 内容 |
|---|---|
| `cd133aa` | fix(metadata) 引用列 id→显名一致化(`UserColumnResolver.resolveFormRecord/joinUserDisplayNames` + Picker/FormDefaults CHAR trim)——须最先提交,审批依赖此方法 |
| `33fda45` | feat(approval) WfTemplate 数据驱动审批 + ApprovalDrawer + load/action 保真层执行 |
| `598f4f9` | feat(converter) **P0 三项**:日历 type5 `convertCalendar` / 树 type3 接 `/api/template/{id}/tree` / 组合 type6 `convertGroup` 真加载 |
| `bf56595` | chore 删可再生 batch_regression 产物(−17399 行)+ gitignore 屏蔽 59MB schema 产物 + 菜单维护树计划/SQL |
提交前 `mvn -pl platform-converter,platform-flow-gateway,flowable-service test` exit 0 绿。提交顺序由编译耦合定:`ApprovalController` 调 metadata 模块 `UserColumnResolver.resolveFormRecord`,故 metadata 必先。
**校准要点**:
- §二/§三 原把 type3/5/6 标为"待做 P0"——**源码已修,描述的"未接/占位/语义错"是运行库现状**,重转重导后消除。
- type6 实际走**转换器侧**(`service+schemaApi`),优于原计划设想的 eip4-web 前端接线,无需前端改。
- **唯一阻碍 P0 + 审批 A/B 全站生效的是部署**:重建 flowable-service jar + 8093 app jar(审批 B 新端点)+ 全量重转重导(⚠️ 保护 bespoke overlay)+ 重启。
- 详见 memory `eip4-generic-vs-custom-templates-plan` / `eip4-wftemplate-driven-approval`。