Files
eip4-platform/docs/决策与盘点/EIP3客户库盘点报告.md
zhengwr 1b69f8b481
Some checks failed
ci / build-test-parity (push) Has been cancelled
docs: 统一项目文档进 eip4-platform/docs + 新增进度路线总览
- 从工作区根 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>
2026-06-17 14:53:29 +08:00

6.0 KiB
Raw Blame History

EIP3 客户库盘点报告(PoC Day 0 库上盘点)

日期:2026-06-10 | 数据源:192.168.20.68:5435 / schema eip3(测试副本,只读查询) 本报告完成 PoC 执行方案 2.1/2.2 的全部库上盘点项,并回答「触发重新决策条件 3(Groovy 占比)」是否命中。

一、规模总览

项 数量 备注
数据库 PostgreSQL 9.4.26 本身已 EOL(2020-02 停止支持),见第五节
eip3 schema 表 1,183 建筑行业 PM/OA/HR 域(项目、合同、劳务分包、考勤…)
sys_entity 实体 1,166 sys_entityattribute 属性 20,019
view_template 模板 1,516 其中 153 个带 engineclass(硬编码 Java 视图)
流程定义 act_re_procdef 1,509 引擎 schema 版本实测 5.13-SNAPSHOT(评估报告写 5.14)
运行中执行 / 任务 9,382 / 9,320 历史流程实例 26,748 —— 「运行中实例续跑」是真命脉

二、模板与脚本分桶(核心结果)

含实质脚本的模板 724 个,脚本共 1,427 条(中位 198 字符,P90 966,最长 22,474)。按 PoC 方案 2.2 规则自动分桶:

桶 脚本条数 占比 模板数(按最差脚本归桶)
S1 纯服务端/行级表达式 553 38.8% 186
S2 辅助函数联动 259 18.1% 116
S3 直接调 Vaadin API 615 43.1% 422

形式上命中警戒线(方案设定 S3 > 30% 须上报重估)。但对 615 条 S3 做模式频率深钻后,结论需要修正:

S3 内部结构:88% 是「轻度 S3」,模式高度收敛

Top API 调用(615 条 S3 内):getField().addButton×100、getValue×68、getContainerDataSource×61、setFilter×56、removeAllItems×29、group.setReadOnly×27、getDisplay×27、setVisible×21、setCaption×16…… 全部是对字段句柄的读写/显隐/数据源过滤,语义上与 S2 同类,只是绕过了辅助函数直接写 group.getField(...) 链式调用。

真正困难的只有三类,合计 约 76 条(占全部脚本 5.3%):

  • 动态创建 Vaadin 组件(new Window/Button/ComboBox...):68 条
  • showConfirmDialog 同步确认框:7 条
  • UI.getCurrent:1 条

修正后的结论

警戒线按「真困难脚本」口径未触发(5.3% ≪ 30%),裁决不变;但工期假设要正面修正:

  1. facade 动词表从 4 个函数扩到约 15–20 个:补 addButton/getValue/getContainerDataSource(→数据源过滤)/removeAllItems/setReadOnly/setVisible/setCaption/setEnabled/setRequired/Notification.show(→amis toast) 等。这些都是「字段句柄 → amis 事件动作指令」的机械映射,且 88% 的 S3 可经正则级自动改写(group.getField("X").setVisible(v) → setFieldVisible("X",v))转回 S2 形态。
  2. 约 70–80 条硬 S3 需人工逐个处理(动态组件改 amis dialog/service 组件、确认框改回调链),按平均 0.5 人日/条计 ≈ 0.5–1 人月,计入 P4 阶段预算。
  3. S1 里大量 enableButton(...) / item['X'] 行级按钮控制脚本,amis 有更优的声明式对应物(visibleOn/disabledOn 表达式),转换器可直接降维处理。

三、BPMN 流程:意外的干净(WS4 风险大幅下降)

对全部 1,509 个 BPMN 定义扫描:

  • activiti:class(自定义 Java ServiceTask):0 个
  • activiti:delegateExpression:0 个
  • scriptTask:仅 5 个

即流程定义是纯标准 BPMN + 用户任务,没有任何嵌入引擎的自定义 Java 扩展。PoC 方案 6 节担心的「兼容层加载不了自定义类」风险实测不存在。Flowable 迁移的剩余验证点只剩:运行中 9,382 个执行的就地升级实测、5 个 scriptTask 的脚本内容核对,以及 5.13-SNAPSHOT(非正式发布版 schema)的兼容层行为。

四、新增工作项:153 个 engineclass 定制视图(评估报告未量化)

153 个模板的 engineclass 指向硬编码 Vaadin 视图类(UserManageView、ProcessMonitorComponentNew、各类 PDF 预览/考勤打卡/报表视图等)。它们不是低代码模板,转换器管不了,迁移只有三条路:逐个用 React/amis 自定义组件重写、降级为标准模板、或留在旧系统过渡。按平均 2–4 人日/个估算 ≈ 1.5–3 人月,这是评估报告 10–14 人月之外未计入的增量,必须进入 P4 预算或明确划入「旧系统过渡清单」。

五、PG 9.4 问题:修正「数据库不动」的表述

客户库是 PostgreSQL 9.4.26(2020 年 EOL)。新技术栈(Spring Boot 3 / JDBC 驱动、Flowable 7、可能的 univer 等)对 PG 9.4 的支持均不可假设。「绞杀者模式数据库不动」应修正为:「业务数据零搬迁,但需一次 PG 9.4 → 15+ 的同构大版本升级(pg_dump/restore 或逻辑复制)」——这是新增的一次性运维动作,建议作为 P1 前置项排期,并在 PoC 环境中直接用 PG 15 恢复副本来顺带验证兼容性。

六、对决策与 PoC 方案的影响汇总

发现 影响
S3 形式占比 43%,但真困难仅 5.3% 裁决 A' 不变;facade 动词表扩容至 ~20 个 + 正则自动改写器进入 P4 范围
BPMN 零自定义扩展 WS4 从「风险验证」降级为「操作验证」,A' 的 Flowable 优势坐实
153 个 engineclass 定制视图 新增 1.5–3 人月或划入旧系统过渡清单;总工期相应上修
PG 9.4 EOL 「数据库不动」改为「数据不动 + PG 升级到 15+」,P1 前置
引擎实为 5.13-SNAPSHOT WS4 验证时按 5.13 schema 实测兼容层,非 5.14
运行中实例 9,382 个 WS4 的实例续跑实测必须用真实副本做,不可用空库

总工期修正:原路线图 10–14 人月(Node 版)→ A' 版本估 9–13 人月(后端移植省 1–2 人月,定制视图加 1.5–3 人月,facade 扩容加 0.5–1 人月,互相抵消后与原估算同量级)。PoC 的 7 天计划不变,Day 0 盘点至此全部完成。