docs: 统一项目文档进 eip4-platform/docs + 新增进度路线总览
Some checks failed
ci / build-test-parity (push) Has been cancelled
Some checks failed
ci / build-test-parity (push) Has been cancelled
- 从工作区根 docs/(非 git,未版本化)合并全部文档进版本控制,消除文档两头分裂
- 新增 README(状态总览+模块完成度+全文档索引)、项目进度与路线-总览-2026-06-17(A兼容/B新功能+关键路径+待拍板决策)
- 被取代的冲突状态/审计快照归入 归档/;对最易误导的两份("16视图已交付"实现交付报告、06-13架构快照)加"已归档"横幅
- 现行权威:engineclass移植backlog(46视图) + 用户管理Delta移植(方法论/交接) + 组件设计体系 + 通用模板收口 + 客户沟通
- 诚实口径:纵向模块仅用户管理 parity,横向引擎地基较全,余 153 定制视图(47 framework+106 业务)多为通用页已产·delta 未移植
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
117
docs/通用模板全类型可用性-通盘盘点与收口计划-2026-06-16.md
Normal file
117
docs/通用模板全类型可用性-通盘盘点与收口计划-2026-06-16.md
Normal file
@@ -0,0 +1,117 @@
|
||||
# 通用模板(全类型)可用性 — 通盘盘点与收口计划
|
||||
|
||||
日期: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`。
|
||||
Reference in New Issue
Block a user