docs: 统一项目文档进 eip4-platform/docs + 新增进度路线总览
Some checks failed
ci / build-test-parity (push) Has been cancelled

- 从工作区根 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>
This commit is contained in:
2026-06-17 14:52:50 +08:00
parent 838669f124
commit 1b69f8b481
54 changed files with 7485 additions and 0 deletions

View File

@@ -0,0 +1,60 @@
# 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 兼容层风险)
- 运行中流程实例的续跑实测