# 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 盘点至此**全部完成**。