- 从工作区根 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>
5.3 KiB
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 方案的修订
- WS1 步骤 6 降级:Spring JDBC 无废弃 API,改造项只剩连接池替换 + 1 个事务 XML;WS1 的 Day 预算可向对拍测试倾斜。
- WS3 的 S3 轨升级:不再是「证明通路存在」的纸面验证,而是直接做
FormEngineUtil的 amis 版最小实现(4 个函数 + 指令下发通路),用 1 个真实脚本跑通。 - 分桶规则更新(2.2 节):S3 判定特征改为「
group.直接调用 ∪ConfirmDialogListener∪ 动态创建 Vaadin 组件」;仅用辅助函数的脚本归入 S2。 - WS4 前置动作明确:流程定义需从客户库
ACT_GE_BYTEARRAY导出(源码中无 bpmn 文件),写入 D0 清单。
仍然只能在客户库上验证的事项(PoC 不可跳过)
- 业务模板与脚本的真实数量与分桶占比(源码只有 7 个平台模板,业务模板全在
VIEW_TEMPLATE) POJOServiceImpl1,346 行 SQL 拼装在 PG 真实数据上的对拍- Activiti 流程定义中是否引用自定义
activiti:class(决定 Flowable 兼容层风险) - 运行中流程实例的续跑实测