docs: 统一项目文档进 eip4-platform/docs + 新增进度路线总览
Some checks failed
ci / build-test-parity (push) Has been cancelled
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:
75
docs/决策与盘点/EIP3客户库盘点报告.md
Normal file
75
docs/决策与盘点/EIP3客户库盘点报告.md
Normal file
@@ -0,0 +1,75 @@
|
||||
# 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 盘点至此**全部完成**。
|
||||
Reference in New Issue
Block a user