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

76 lines
6.0 KiB
Markdown
Raw Permalink 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 | 数据源:192.168.20.68:5435 / schema `eip3`(测试副本,只读查询)
> 本报告完成 PoC 执行方案 2.1/2.2 的全部库上盘点项,并回答「触发重新决策条件 3(Groovy 占比)」是否命中。
## 一、规模总览
| 项 | 数量 | 备注 |
|----|------|------|
| 数据库 | PostgreSQL **9.4.26** | **本身已 EOL(2020-02 停止支持)**,见第五节 |
| eip3 schema 表 | 1,183 | 建筑行业 PM/OA/HR 域(项目、合同、劳务分包、考勤…) |
| sys_entity 实体 | 1,166 | sys_entityattribute 属性 20,019 |
| view_template 模板 | 1,516 | 其中 **153 个带 engineclass(硬编码 Java 视图)** |
| 流程定义 act_re_procdef | 1,509 | 引擎 schema 版本实测 **5.13-SNAPSHOT**(评估报告写 5.14) |
| 运行中执行 / 任务 | 9,382 / 9,320 | 历史流程实例 26,748 —— **「运行中实例续跑」是真命脉** |
## 二、模板与脚本分桶(核心结果)
含实质脚本的模板 **724** 个,脚本共 **1,427** 条(中位 198 字符,P90 966,最长 22,474)。按 PoC 方案 2.2 规则自动分桶:
| 桶 | 脚本条数 | 占比 | 模板数(按最差脚本归桶) |
|----|---------|------|------------------------|
| S1 纯服务端/行级表达式 | 553 | 38.8% | 186 |
| S2 辅助函数联动 | 259 | 18.1% | 116 |
| S3 直接调 Vaadin API | 615 | **43.1%** | 422 |
**形式上命中警戒线**(方案设定 S3 > 30% 须上报重估)。但对 615 条 S3 做模式频率深钻后,结论需要修正:
### S3 内部结构:88% 是「轻度 S3」,模式高度收敛
Top API 调用(615 条 S3 内):`getField().addButton`×100、`getValue`×68、`getContainerDataSource`×61、`setFilter`×56、`removeAllItems`×29、`group.setReadOnly`×27、`getDisplay`×27、`setVisible`×21、`setCaption`×16…… 全部是**对字段句柄的读写/显隐/数据源过滤**,语义上与 S2 同类,只是绕过了辅助函数直接写 `group.getField(...)` 链式调用。
真正困难的只有三类,合计 **约 76 条(占全部脚本 5.3%)**:
- 动态创建 Vaadin 组件(`new Window/Button/ComboBox...`):68 条
- `showConfirmDialog` 同步确认框:7 条
- `UI.getCurrent`:1 条
### 修正后的结论
警戒线按「真困难脚本」口径**未触发**(5.3% ≪ 30%),裁决不变;但工期假设要正面修正:
1. **facade 动词表从 4 个函数扩到约 15–20 个**:补 `addButton/getValue/getContainerDataSource(→数据源过滤)/removeAllItems/setReadOnly/setVisible/setCaption/setEnabled/setRequired/Notification.show(→amis toast)` 等。这些都是「字段句柄 → amis 事件动作指令」的机械映射,且 88% 的 S3 可经**正则级自动改写**(`group.getField("X").setVisible(v)` → `setFieldVisible("X",v)`)转回 S2 形态。
2. **约 70–80 条硬 S3 需人工逐个处理**(动态组件改 amis dialog/service 组件、确认框改回调链),按平均 0.5 人日/条计 ≈ **0.5–1 人月**,计入 P4 阶段预算。
3. S1 里大量 `enableButton(...)` / `item['X']` 行级按钮控制脚本,amis 有更优的声明式对应物(`visibleOn`/`disabledOn` 表达式),转换器可直接降维处理。
## 三、BPMN 流程:意外的干净(WS4 风险大幅下降)
对全部 1,509 个 BPMN 定义扫描:
- `activiti:class`(自定义 Java ServiceTask):**0 个**
- `activiti:delegateExpression`:**0 个**
- `scriptTask`:仅 **5 个**
即流程定义是**纯标准 BPMN + 用户任务**,没有任何嵌入引擎的自定义 Java 扩展。PoC 方案 6 节担心的「兼容层加载不了自定义类」风险**实测不存在**。Flowable 迁移的剩余验证点只剩:运行中 9,382 个执行的就地升级实测、5 个 scriptTask 的脚本内容核对,以及 5.13-SNAPSHOT(非正式发布版 schema)的兼容层行为。
## 四、新增工作项:153 个 engineclass 定制视图(评估报告未量化)
153 个模板的 `engineclass` 指向硬编码 Vaadin 视图类(`UserManageView`、`ProcessMonitorComponentNew`、各类 PDF 预览/考勤打卡/报表视图等)。它们**不是低代码模板,转换器管不了**,迁移只有三条路:逐个用 React/amis 自定义组件重写、降级为标准模板、或留在旧系统过渡。按平均 2–4 人日/个估算 ≈ **1.5–3 人月**,这是评估报告 10–14 人月之外未计入的增量,必须进入 P4 预算或明确划入「旧系统过渡清单」。
## 五、PG 9.4 问题:修正「数据库不动」的表述
客户库是 PostgreSQL 9.4.26(2020 年 EOL)。新技术栈(Spring Boot 3 / JDBC 驱动、Flowable 7、可能的 univer 等)对 PG 9.4 的支持均不可假设。「绞杀者模式数据库不动」应修正为:**「业务数据零搬迁,但需一次 PG 9.4 → 15+ 的同构大版本升级(pg_dump/restore 或逻辑复制)」**——这是新增的一次性运维动作,建议作为 P1 前置项排期,并在 PoC 环境中直接用 PG 15 恢复副本来顺带验证兼容性。
## 六、对决策与 PoC 方案的影响汇总
| 发现 | 影响 |
|------|------|
| S3 形式占比 43%,但真困难仅 5.3% | 裁决 A' 不变;facade 动词表扩容至 ~20 个 + 正则自动改写器进入 P4 范围 |
| BPMN 零自定义扩展 | WS4 从「风险验证」降级为「操作验证」,A' 的 Flowable 优势坐实 |
| 153 个 engineclass 定制视图 | **新增 1.5–3 人月**或划入旧系统过渡清单;总工期相应上修 |
| PG 9.4 EOL | 「数据库不动」改为「数据不动 + PG 升级到 15+」,P1 前置 |
| 引擎实为 5.13-SNAPSHOT | WS4 验证时按 5.13 schema 实测兼容层,非 5.14 |
| 运行中实例 9,382 个 | WS4 的实例续跑实测必须用真实副本做,不可用空库 |
**总工期修正**:原路线图 10–14 人月(Node 版)→ A' 版本估 9–13 人月(后端移植省 1–2 人月,定制视图加 1.5–3 人月,facade 扩容加 0.5–1 人月,互相抵消后与原估算同量级)。PoC 的 7 天计划不变,Day 0 盘点至此**全部完成**。