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

61 lines
5.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 兼容层风险)
- 运行中流程实例的续跑实测