# EIP3 源码预核查报告(PoC Day 0 提前完成部分) > 日期:2026-06-10 | 范围:本地 `framework/` 全量源码静态检查 > 目的:在连客户库之前,把 PoC 方案中可静态验证的工作量假设落到实证。 > 结论先行:**全部 6 项核查结果均有利于路线 A',其中 2 项显著好于决策报告的假设。** ## 核查结果总表 | # | 核查项 | 结果 | 对 PoC 的影响 | |---|--------|------|--------------| | 1 | 服务端 Vaadin 污染面 | 全 framework 仅 2 个文件(`WfRestConstroller`、`kaoqin/UserSelectWindow`),均不在 PoC 路径 | WS1 无前端解耦工作 | | 2 | OSGi 耦合点 | 唯一入口 `SpringBeanOsgiServices`(72 行服务定位器) | `ApplicationContext.getBean()` 等价替换,WS1 步骤 3 改为 0.5 天 | | 3 | Spring JDBC 废弃 API | **`SimpleJdbcTemplate` 零使用**;实际使用:`JdbcTemplate`×21、`SqlRowSet`×15、其余零星——全部在 Spring 6 中原样保留 | **WS1 步骤 6 风险解除**,只剩 dbcp→HikariCP 与 `com.dsasp.server.db/META-INF/spring/db.xml` 一处事务 XML 改 Java Config | | 4 | javax→jakarta 改造面 | dataDic+common+core 三模块仅 6 处 `javax.servlet`;`javax.script`×17 在 JDK17 原样可用 | 机械替换,半天内 | | 5 | UI 脚本与 Vaadin 的真实耦合形态 | **高度集中、有现成抽象层**(见下文详述) | S3 facade 从「设计假设」升级为「有直接证据的方案」 | | 6 | 流程定义与业务模板位置 | 源码中无 `.bpmn` 文件、业务模板不在源码——均在客户库(`ACT_GE_BYTEARRAY` / `VIEW_TEMPLATE`);源码仅 7 个平台自带模板 XML | PoC 方案 2.1/2.2 的库上盘点**不可省略**,WS4 需从库导出流程定义 | ## 核查 5 详述:UI 脚本耦合面(本次最重要的发现) 决策报告把「Groovy 脚本与 Vaadin 深度耦合」列为最大技术债,并假设 S3 类脚本需要逐个评估。静态核查显示实际耦合面**远比假设收敛**: **(a) 调用点集中。** client 侧执行脚本的代码共 13 个文件,其中 valueChange 联动只经过 4 个 Listener(`DefaultVFVChangeListener`、`MasterSubVFVChangeListener`、`EditGridVFVChangeListener`、`TableItemSelectedListener`),其余是下拉框/选择字段的数据源过滤(`ExComboBox`、`AbstractSelectField` 等)。 **(b) 绑定契约只有 4 个变量。** 以 `DefaultVFVChangeListener.valueChange()` 为例,注入脚本的全部上下文是: ```java map.put("group", getFieldGroup()); // Vaadin FieldGroup —— 唯一的 UI 句柄 map.put("po", getSelectObject()); // 业务对象 map.put("event", event); // ValueChangeEvent(新旧值) map.put(OBJ_VARIABLE, this); // 监听器自身 ``` 统一经 `FlowScriptBindings`(implements `javax.script.Bindings`,含 `ctx`=UserSession)传入 JSR-223 引擎。**没有第五个口子。** **(c) 平台已自带「准 facade」。** 脚本头部自动拼接 `DEFAULTFUNCTION`,提供的辅助函数全部委托给 `FormEngineUtil`: ```groovy getFieldValue(fieldId) // 读字段 bindField(fieldId, obj) // 写字段 setFieldReadOnly(fieldId, readOnly) // 只读控制 showConfirmDialog(msg, listener) // 确认框 ``` 即平台多年来一直在引导脚本作者通过这 4 个函数操作 UI,而不是裸用 Vaadin API。**facade 方案因此简化为:保持这 4 个函数签名不变,把 `FormEngineUtil` 的实现从「操作 FieldGroup」换成「生成 amis 事件动作指令下发前端」**。凡是只用辅助函数 + `po`/`event` 的脚本(预期是多数),迁移即换实现、脚本文本零修改或近零修改。 **(d) 剩余风险被精确限定。** 真正需要逐个处理的只剩两类:① 绕过辅助函数直接调 `group.getField(...)` 等 Vaadin API 的脚本(`DEFAULTIMPORTPACKAGE` 默认导入了 `Property/FieldGroup/Field/ClickEvent`,说明这类脚本存在);② `showConfirmDialog` 这类**同步等待用户输入再继续**的交互,在 amis 事件模型下要改写为回调链。库上分桶(PoC 方案 2.2)的 S3 判定特征据此更新为:「匹配 `group.` 直接调用或 `ConfirmDialogListener`」。 ## 对 PoC 方案的修订 1. **WS1 步骤 6 降级**:Spring JDBC 无废弃 API,改造项只剩连接池替换 + 1 个事务 XML;WS1 的 Day 预算可向对拍测试倾斜。 2. **WS3 的 S3 轨升级**:不再是「证明通路存在」的纸面验证,而是直接做 `FormEngineUtil` 的 amis 版最小实现(4 个函数 + 指令下发通路),用 1 个真实脚本跑通。 3. **分桶规则更新**(2.2 节):S3 判定特征改为「`group.` 直接调用 ∪ `ConfirmDialogListener` ∪ 动态创建 Vaadin 组件」;仅用辅助函数的脚本归入 S2。 4. **WS4 前置动作明确**:流程定义需从客户库 `ACT_GE_BYTEARRAY` 导出(源码中无 bpmn 文件),写入 D0 清单。 ## 仍然只能在客户库上验证的事项(PoC 不可跳过) - 业务模板与脚本的**真实数量与分桶占比**(源码只有 7 个平台模板,业务模板全在 `VIEW_TEMPLATE`) - `POJOServiceImpl` 1,346 行 SQL 拼装在 PG 真实数据上的对拍 - Activiti 流程定义中是否引用自定义 `activiti:class`(决定 Flowable 兼容层风险) - 运行中流程实例的续跑实测