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>
11 KiB
通用模板(全类型)可用性 — 通盘盘点与收口计划
日期: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/ chorebf56595;提交前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);⏳ 待全量重转重导生效
- ✅ 日历 type5(2 页):转换器已加
convertCalendar→ amiscalendar(isCalendarTemplate查 type==5 分流,items→schedules,scheduleAction drawer)。 - ✅ 树 type3 声明式多级接端点:
currentTemplateId→source 指向/api/template/{templateId}/tree(TemplateTreeController),树选择框同源复用。机制覆盖全部 type=3。 - ✅ 组合 type6(20 页):
convertGroup改发service schemaApi:/api/page/schema/{tempid}+ amis 原生 mountOnEnter 懒加载——转换器侧解决,无需 eip4-web 前端改。
P1 — 已可用但有功能缺角(中等)
- 19 页缺 EDITFORM 映射:逐页溯查 eip3 XML 补
<button>的 EDITFORM,或为实体建 form 模板,重转。(缺源配置) - onselected/filter 脚本挂回(930+422 模板):需先改
s3_rewriter管线标注事件来源类型,再按类型挂 amis onEvent。属 rewriter 管线专项。
P2 — 打磨/另案(不阻断正常使用)
- 表单 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。
六、建议的下一步(待你拍板)
通用收口先做 P0 三项→ ✅ 已完成+提交(598f4f9)。下一步改为「全量重转重导 + 重启 live 验收」,让 P0 三项(+审批 A/B)在 883 运行库页生效。⚠️ 部署坑(见 §七):全量重导会覆盖 bespoke overlay(菜单 v5 / A1–A5 admin),须排除其 template_id 或重导后重跑各 overlay SQL。- P0 部署后 → P1 才是"模板真好用"的大头:①onselected/filter/enableButton 脚本挂回(930+422+259 模板,依赖 s3_rewriter 管线标注事件来源)②19 页缺 EDITFORM 映射。这两项体量与价值都大,是"所有类型通用模板正常使用"的实质剩余。
- 153 自定义维持既有终判,等 S1 评审会客户拍板后按"重写/降级/留旧"分批执行;framework 层若要先行 bespoke,逐页按 §四方法做(每页一个后端+schema 小工程)。
- 不再逐页零敲——以"按类型整类收口"推进。
七、收口落地与文档校准(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。