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

11 KiB
Raw Permalink Blame History

通用模板(全类型)可用性 — 通盘盘点与收口计划

日期: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 — 已可用但有功能缺角(中等)

  1. 19 页缺 EDITFORM 映射:逐页溯查 eip3 XML 补 <button> 的 EDITFORM,或为实体建 form 模板,重转。(缺源配置)
  2. onselected/filter 脚本挂回(930+422 模板):需先改 s3_rewriter 管线标注事件来源类型,再按类型挂 amis onEvent。属 rewriter 管线专项。

P2 — 打磨/另案(不阻断正常使用)

  1. 表单 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。