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

5.3 KiB
Raw Blame History

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() 为例,注入脚本的全部上下文是:

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:

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 兼容层风险)
  • 运行中流程实例的续跑实测