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 盘点至此**全部完成**。
|
||||
128
docs/决策与盘点/EIP3工程化实施计划.md
Normal file
128
docs/决策与盘点/EIP3工程化实施计划.md
Normal file
@@ -0,0 +1,128 @@
|
||||
# EIP3 → EIP4(路线 A')工程化实施计划
|
||||
|
||||
> 版本 v1.0(2026-06-10)| 依据:《架构决策会纪要》全部决议 + PoC 实测 + 报表迁移方案
|
||||
> 性质:已批准立项的执行计划。预算口径 13–19 人月(对外承诺 15–18),团队 4 人核心 + 0.5 兼职
|
||||
> 假设开工日 2026-07-01(实际以立项前置项关闭为准),日历周期:**工程化约 6 个月 + 切流并行期 6–9 个月**
|
||||
|
||||
---
|
||||
|
||||
## 〇、总览:一张图
|
||||
|
||||
```
|
||||
2026-07 08 09 10 11 12 2027-H1
|
||||
├─ M0 启动周×2 ─┤
|
||||
├─── P0' PG升级演练 ───┤
|
||||
├────── P1 元数据服务 + 逐行对拍框架 ──────┤
|
||||
├────── P2 组织/权限/数据权限 ──────┤
|
||||
├─── P3 Flowable 服务 ───┤
|
||||
├──────────── P4 amis/转换/定制视图/报表 ────────────┤
|
||||
├─ P5 MCP/AI ─┤
|
||||
【检查点①P1完】 【检查点②首功能切流】【检查点③首客户上线】
|
||||
├─────── 切流并行期(按功能点灰度,6–9 个月)───────→
|
||||
```
|
||||
|
||||
**与从零开始的区别**:本计划不是从零起步。PoC 产出的 `eip4-poc` 工程(引擎移植 + REST + 转换器 + 元数据 API)直接升级为正式工程 `eip4-platform` 的底座;`flowable5-poc`/`flowable-poc` 是现成的升级工具链;对拍/盘点脚本在 `eip4-poc/tools/`。**约 15–20% 的 P1/P3 工作量已在 PoC 中预付。**
|
||||
|
||||
---
|
||||
|
||||
## 一、M0 启动周(第 1–2 周,全员)
|
||||
|
||||
决策会规定的强制前置,完成前任何阶段不得宣布「通过」:
|
||||
|
||||
| # | 任务 | 负责 | 通过标准 |
|
||||
|---|------|------|---------|
|
||||
| C1 | **逐行对拍框架**:旧系统 SQL 录制切面 + 结果集逐行 diff | 后端架构(老员工) | ≥20 代表性实体逐行一致率 100%;若旧系统环境不可得,改生产流量旁路录制方案并报批 |
|
||||
| C2 | 数据权限最小真实现替换桩 | 后端 | ≥3 个行级过滤实体进对拍样本 |
|
||||
| C3 | Top10 高频实体基础压测 | 后端+架构 | 出 P95 延迟基线文档 |
|
||||
| C4 | S3 脚本正则改写器原型实测 | 后端 | 自动化率 ≥80% 锁 P4 预算;<80% 重估 |
|
||||
| C5 | amis 6.13.0 fork 构建预演 | 前端 | 公司环境独立构建产物可替换 CDN 运行;失败触发止损 S2 |
|
||||
| — | 老员工知识转移启动:PoC 坑位记录整编为《迁移手册》v1 | 老员工+架构 | 手册过评审,backup 人选确定 |
|
||||
| — | 153 定制视图处置清单(重写/降级/留旧三分) | 项目负责人 | 决策会开放项,2 周限期 |
|
||||
| — | JOR 报表布局客户环境清点 | 交付 | 报表方案 C 类预算锁定 |
|
||||
| — | 关闭决策会开放项 1/3(5435 副本书面确认、合同 UI 条款核查) | 项目负责人/商务 | 书面记录 |
|
||||
|
||||
## 二、阶段计划
|
||||
|
||||
### P0' — PG 9.4→15 升级演练(M0 起并行,0.5–1 人月)
|
||||
- 全库(1,183 表)兼容性扫描 → 拷贝库完整 dump/restore 演练 → 实测耗时定停机窗口 → 恢复演练(红线 1)
|
||||
- 产出:《PG 升级 Runbook》(含回退点);与 Flowable 升级**分窗执行**(决策会已拍板)
|
||||
- 注意:客户生产升级动作排在切流期,此阶段只做演练与 Runbook
|
||||
|
||||
### P1 — 元数据服务工程化(月 1–2.5,3–4 人月)
|
||||
- `eip4-poc` → `eip4-platform`:包结构正规化、横切服务接口保留、配置中心化
|
||||
- **逐行对拍框架为本阶段一级交付物**(C1 扩展到全实体抽样)
|
||||
- 服务流引擎(FlowExcuteService)移植 + 79 个报表服务流 REST 化(`/api/flow/{id}`,报表方案 D 类)
|
||||
- 补 JUnit 回归测试套件(决策会治理条款:移植代码门禁=对拍,新代码门禁=评审+单测)
|
||||
- **检查点①(P1 末):决策会复审 C1–C5,决定是否解除「有条件立项」限定**
|
||||
|
||||
### P2 — 组织/权限/数据权限(月 2–4,3–4 人月,决策会上调段)
|
||||
- 组织机构/用户/角色/功能权限自 EIP3 移植;**数据行级权限(DataPrivilegeService 真实现)是本阶段成败手**(CTO 风险 R1:建筑行业项目/组织/分包商多维隔离)
|
||||
- 带权限过滤的对拍样本扩容;登录/会话(UserSession→Spring Security 适配)
|
||||
- 文件服务、消息、系统日志真实现替换全部桩
|
||||
|
||||
### P3 — Flowable 独立服务(月 3.5–5,1.5–2.5 人月)
|
||||
- 三个表达式 handler bean 从 `com.dsasp.server.wf` 移植(candidateUsersHandler×4,761 引用等,PoC 已验证注册机制)
|
||||
- 升级工具链产品化:版本串规范化 + 两步升级(5.23→6.8)+ 全量备份校验,整合进《Flowable 升级 Runbook》
|
||||
- 待办/已办/发起/审批 REST API + 与元数据服务的事件回写
|
||||
- 5 个 scriptTask 逐个核对;挂起/委托/会签语义对拍
|
||||
|
||||
### P4 — 前端与迁移工具链(月 2.5–6,4–6 人月,最大不确定段)
|
||||
并行四条线:
|
||||
1. **批量转换**:转换器扩展(EDITFORM/主子表/树/选择窗 + `<report>` 段)→ 1,516 模板批量转换 → 校验+渲染双闸 → 人工抽检分级
|
||||
2. **脚本迁移**:facade 动词表扩到 ~20 个 + S3 正则改写器(C4 已定标)→ 全量 1,427 条脚本处理 → 硬 S3(~76 条)人工改写
|
||||
3. **定制视图**:153 个按 M0 处置清单执行(重写部分外包 React,降级部分走转换器,留旧部分登记过渡清单)
|
||||
4. **报表**:A 类 333 个走转换器;B 类图表平移;C 类 JOR 替换(univer + Web 打印,按 M0 清点结果)
|
||||
- amis-editor 二开为自有设计器(可视化改 schema)排本阶段后半,优先级低于批量转换
|
||||
- **检查点②:首批功能点(只读类)切流**
|
||||
|
||||
### P5 — MCP/AI 工具层(月 5–6,0.5–1 人月)
|
||||
- PoC 的 meta API + validate-schema 升级为正式 MCP Server(工具面:实体 CRUD、页面 schema 读写、服务流调用、校验)
|
||||
- 提示词工程:组件子集 schema 裁剪(929KB 不能整体进上下文)、校验-重试管线
|
||||
- **在存量复杂场景重测 AI 成功率**(决策会商务红线:拿到数据前不对外承诺)
|
||||
|
||||
### 切流并行期(月 6 起,6–9 个月,交付团队主导)
|
||||
- 按決策会五节执行:功能点粒度、只读→写入→带审批的顺序、七条红线逐条过、客户签字矩阵
|
||||
- PG 升级与 Flowable 升级在此期间分两个停机窗口实施(各自走变更四要素)
|
||||
- 旧系统退役以「运行中实例自然消化 + 客户最高决策层签字」为终点
|
||||
|
||||
## 三、人员与分工
|
||||
|
||||
| 角色 | 人数 | 主责 | 备注 |
|
||||
|------|------|------|------|
|
||||
| 后端架构(熟 EIP3 老员工) | 1 | P1/P3、对拍框架、迁移手册 | 单点风险,backup 强制 |
|
||||
| 后端工程师 | 1–2 | P2 权限、横切服务、服务流 | Spring Boot 3 技能 |
|
||||
| 前端工程师 | 1 | P4 转换器目标端、amis 主题、editor 二开 | amis 是 schema 配置活,后端可补位 |
|
||||
| 外包 React(按需) | 按 153 清单定 | 定制视图重写部分 | 集中采购,不养全职 |
|
||||
| 架构/AI(兼职) | 0.5 | C3 压测、P5 MCP、门禁守护 | |
|
||||
|
||||
## 四、质量门禁(每阶段出口必查)
|
||||
|
||||
1. **对拍门禁**:移植代码以「逐行对拍通过」为完成定义;报表合计列纳入对拍样本
|
||||
2. **双闸门禁**:所有进库页面 schema 必须过「官方 schema 校验 + 运行时渲染冒烟」
|
||||
3. **测试门禁**:新写代码(权限/转换器/MCP)评审 + 单测;回归套件随 P1 建立
|
||||
4. **变更四要素**:任何不可逆变更——已验证恢复的备份/演练耗时/实测回退点/客户书面批准
|
||||
5. **七条切流红线**(决策会纪要第五节)逐功能点核查,不接受例外
|
||||
|
||||
## 五、风险雷达与止损(沿用决策会,标注本计划责任段)
|
||||
|
||||
| 风险 | 影响段 | 监控信号 | 止损 |
|
||||
|------|--------|---------|------|
|
||||
| 数据权限复杂度超预期(R1) | P2 | P2 进度偏差 >50% | S1:暂停重审 |
|
||||
| 性能回归(R2) | 切流期 | P95 超基线 | 功能点回退 |
|
||||
| 老员工单点(R3) | 全程 | — | backup + 手册 |
|
||||
| S3 自动化率不达标 | P4 | C4 <80% | 保守口径重估 |
|
||||
| amis fork 不可行 | P4 | C5 失败 | S2:lowcode-engine / ProComponents 薄渲染器备选(已有评估) |
|
||||
| 153 视图工时爆炸 | P4 | 处置清单工时 >3 人月 | S1 + 扩大「留旧过渡」比例 |
|
||||
| JOR 布局存量超预期 | P4 | M0 清点 | 报表 C 类预算重锁 |
|
||||
|
||||
## 六、近两周行动清单(开工即做)
|
||||
|
||||
1. ☐ 立项书签发 + 5435 副本书面确认(开放项 1)
|
||||
2. ☐ M0 九项任务排人(见第一节表)
|
||||
3. ☐ `eip4-poc` → `eip4-platform` 仓库迁移 + CI 搭建(编译+单测+对拍冒烟流水线)
|
||||
4. ☐ 旧系统可运行环境确认(C1 的前置,决策会第一优先开放项)
|
||||
5. ☐ 客户沟通包初稿:换代说明 + UI 变更预告 + 停机窗口预约(商务口径按纪要第六节)
|
||||
|
||||
---
|
||||
|
||||
**计划维护**:本计划随检查点①②③滚动修订;任何止损线触发即冻结当前阶段并升级决策层。
|
||||
94
docs/决策与盘点/EIP3报表迁移方案.md
Normal file
94
docs/决策与盘点/EIP3报表迁移方案.md
Normal file
@@ -0,0 +1,94 @@
|
||||
# EIP3 报表系统迁移方案
|
||||
|
||||
> 日期:2026-06-10 | 依据:framework 源码考古 + 客户库实测(192.168.20.68:5435/eip3 只读)
|
||||
> 定位:《架构决策会纪要》P4 阶段的报表专项附件;评估报告表 4 中「报表→中匹配度」一格的展开
|
||||
|
||||
---
|
||||
|
||||
## 一、旧报表系统的真实形态(考古结论,全部有实证)
|
||||
|
||||
旧系统的"报表"不是一个引擎,是**三层混合体**,迁移难度差异极大:
|
||||
|
||||
```
|
||||
337 个声明式报表模板 (view_template, type=200, 根元素 <report>)
|
||||
├─ 数据层:selectservice 数据服务流(全库去重 79 个)→ 服务流引擎出数据
|
||||
└─ 渲染层(三条路):
|
||||
a. 表格式报表 333 个 → ReportTemplateComponent / ReportPowerTableFormat
|
||||
(Vaadin 表格自渲染,含合计列 issumcolumn / 金额列 ismoney 等特性)
|
||||
b. ECharts 图表 4 个(ischart="true")→ tools/echart.jsp?flowid=
|
||||
(服务流出数据,JSP 里拼 ECharts option —— 渲染端已经是 ECharts)
|
||||
c. 复杂版式/套打 → tools/reportviewer.jsp?xmluuid= → JOR(杰表)引擎
|
||||
(927 个 Java 文件内嵌源码 + jatoolsPrinter ActiveX 打印控件 .cab)
|
||||
```
|
||||
|
||||
**五个关键事实**:
|
||||
|
||||
1. **337 个报表模板是声明式元数据**,结构与 GRID 模板(crud)近乎同构:`<report><display><field…/><search selectservice=…>`,全部含脚本(337/337,归入既有脚本分桶流程);其中仅 6 个带 engineclass 定制类。
|
||||
2. **取数与展示已经分离**:报表数据全部经 `selectservice` 服务流获取(79 个去重服务流,view_template_service 表 320 行关联)。**取数逻辑是纯后端 Java 资产,与 Vaadin 零耦合**。
|
||||
3. **图表路径已经是 ECharts**(echart.jsp 实测引用 echarts.min.js、服务流出数据拼 option)。
|
||||
4. **JOR 引擎自有集成面只有 4 个类**(ReportComponent/ReportPowerTableFormat/ReportResources/Activator),引擎以 servlet `/tools/jatoolsreport` + JSP taglib 方式暴露;布局模板是**部署期 classpath 资源文件**(仓库内仅 demo,生产布局在客户部署包中,数量待盘点)。
|
||||
5. **打印链路已经死亡**:xmlviewer.jsp 实测嵌入 `<OBJECT CLASSID=… jatoolsPrinter.cab>` —— **IE ActiveX 控件**。IE 已退役,该打印路径在现代浏览器本来就不可用(客户现状即为带病运行或 IE 兼容模式硬撑)。
|
||||
|
||||
---
|
||||
|
||||
## 二、迁移方案:按四类分治
|
||||
|
||||
### A 类:333 个表格式报表 →「扩展现有转换器」(主体工作,性价比最高)
|
||||
|
||||
`<report>` 与 `<crud>` 同构,**扩展 PoC 已验证的 TemplateToAmisConverter** 即可:
|
||||
|
||||
| 旧特性 | amis 对应 | 备注 |
|
||||
|--------|----------|------|
|
||||
| display/field | crud columns | 与 GRID 转换完全相同 |
|
||||
| `issumcolumn="true"` | 列 `summaryFields` / footer 合计行 | amis crud 原生支持 |
|
||||
| `ismoney="true"` | 列 `type: number` + 千分位格式 | WS5 截图已实测此渲染 |
|
||||
| search/field + uitype | filter 表单 | 与 GRID 转换相同(含 NumberField→input-number 等映射表补项) |
|
||||
| `selectservice="XXX"` | `api: /api/flow/XXX`(服务流 REST 包装) | 见 D 节 |
|
||||
| isTitle/isDescribe(标题/说明行) | crud 顶部 tpl 区 | 少量人工核对 |
|
||||
|
||||
**工作量估算:转换器扩展约 0.5 人月**(report 段规则 + 合计/金额特性 + 对拍抽检),并入 P4。
|
||||
|
||||
### B 类:ECharts 图表(4 个 + echart.jsp 模式)→「option 平移」(近零成本)
|
||||
|
||||
amis 的 `chart` 组件就是 ECharts 包装。迁移 = 把 JSP 里内联的 option 模板移到 amis chart 的 `config`,数据源从 JSP 服务端取数改为 `api` 指向服务流 REST。**预计 2–3 人日**。
|
||||
|
||||
### C 类:JOR 复杂版式与套打 →「不迁移引擎,按场景替换」
|
||||
|
||||
**决议建议:JOR 引擎(927 文件)与 ActiveX 打印控件直接淘汰,不做任何移植**。理由:打印链路在现代浏览器已不可用;引擎是嵌入的第三方陈旧源码(含 BeanShell),安全与维护负债远超价值。替换分两个场景:
|
||||
|
||||
1. **查看/导出类复杂版式**(中国式格线报表、月报汇总):
|
||||
- 首选 **univer**(决策报告风险对策已点名)做在线表格呈现与导出;
|
||||
- 数据加工不愁:月报类已有结构化业务表支撑(pm_mreport* 13 张表实测在库),服务流出数据 → univer/Excel 导出。
|
||||
2. **套打/打印类**(单据格式打印):
|
||||
- 首选**浏览器原生打印 + print CSS**(amis 页面可直接 `window.print` 定制样式);
|
||||
- 版式要求高的用 **hiprint** 类开源 Web 打印或服务端渲染 PDF(openhtmltopdf)输出,避免任何浏览器控件依赖。
|
||||
|
||||
**前置盘点(P0 补充项)**:JOR 生产布局文件在客户部署包中、仓库不可见——需在客户环境执行一次「classpath 报表模板文件清点」,按数量定 C 类工作量。**在盘点结果出来前,C 类按 1–2 人月预留**;若清点发现实际在用的 JOR 版式很少(ActiveX 已死多年,存在"早已没人用"的可能),可压缩到 0.5 人月。
|
||||
|
||||
### D 类:报表数据服务流 REST 化(核心资产复用,A' 路线红利)
|
||||
|
||||
79 个 selectservice 服务流是报表系统真正的核心资产(全部取数/加工逻辑)。它们运行在服务流引擎(FlowExcuteService,纯 Java)上,**A' 路线后端留在 JVM,服务流引擎随 P1/P2 整体移植,报表只需在其上包一层统一 REST**(`/api/flow/{flowId}`,含参数透传与权限上下文)——这正是 PoC 中 echart.jsp 第 25 行 `flowService.excute(map, UserSession.get(), flowid)` 的 REST 化。**约 0.5 人月,且被 A/B 两类共享**。
|
||||
|
||||
---
|
||||
|
||||
## 三、工作量与排期归并
|
||||
|
||||
| 项 | 人月 | 归并阶段 |
|
||||
|----|------|---------|
|
||||
| 服务流 REST 化(共享底座) | 0.5 | P1/P2 顺带 |
|
||||
| A 类转换器扩展 + 333 模板批量转换与抽检 | 0.5–1 | P4 |
|
||||
| B 类图表平移 | ~0.1 | P4 |
|
||||
| C 类 JOR 替换(按盘点定,先预留) | 0.5–2 | P4 末批 |
|
||||
| **合计** | **1.5–3.5 人月** | 与决策会 P4「4–6 人月」中原预留的报表缺口一致,**不突破已批排期** |
|
||||
|
||||
## 四、风险与红线衔接
|
||||
|
||||
1. **JOR 布局存量是开放变量**——P0 客户环境清点前不锁定 C 类预算(对齐决策会止损线 S1 的精神)。
|
||||
2. **合计行/金额列的数值正确性必须进对拍**——表格式报表的 issumcolumn 合计结果纳入 C1 逐行对拍样本(报表算错数比页面难看严重得多)。
|
||||
3. **打印习惯变更需客户沟通**——ActiveX 套打 → 浏览器打印是操作习惯变化,纳入决策会「UI 形态变更」客户沟通条款(开放项 3)一并确认。
|
||||
4. **337 个报表模板全部含脚本**——已天然落入既有 S1/S2/S3 脚本分桶与 facade 流程,无需新增机制。
|
||||
5. 6 个 engineclass 定制报表视图并入「153 定制视图处置清单」统一决策(重写/降级/留旧)。
|
||||
|
||||
## 五、一句话结论
|
||||
|
||||
**报表迁移没有想象中可怕**:333 个表格式报表与已验证的 crud 转换器同构、图表本来就是 ECharts、取数逻辑(79 个服务流)随 Java 后端整体复用;真正要"换"的只有 JOR 复杂版式与已死的 ActiveX 打印,且替换方案(univer + Web 打印)在决策报告中已有预案。总投入 1.5–3.5 人月,不突破决策会已批的 P4 预算。
|
||||
140
docs/决策与盘点/EIP3架构决策会纪要.md
Normal file
140
docs/决策与盘点/EIP3架构决策会纪要.md
Normal file
@@ -0,0 +1,140 @@
|
||||
# EIP3 重构架构决策会纪要(D7 决策会)
|
||||
|
||||
> 日期:2026-06-10 | 形式:三方独立评审 + 主持人合议
|
||||
> 与会角色:管理层/商务(总经理视角)、技术负责人(CTO 视角)、交付总监/风控
|
||||
> 输入材料:评估报告、架构决策报告、PoC 执行方案、源码预核查报告、客户库盘点报告、
|
||||
> eip4-poc / flowable-poc / flowable5-poc 三个可运行工程及全部实测记录
|
||||
|
||||
---
|
||||
|
||||
## 会议结论(一句话)
|
||||
|
||||
**三方一致:有条件同意立项。** 路线 A'(amis + Java/Spring Boot 自研元数据后端 + Flowable)架构裁决确认生效,批准进入工程化阶段;**生产切流的启动以本纪要第四、五节的补验项与红线条款落地为前置门禁**。
|
||||
|
||||
三方独立裁决均为「有条件同意(ACCEPT-WITH-RESERVATIONS)」,无否决票。三方共同评价:PoC 证据质量高、可复现、边界诚实标注;技术不确定性已实证消除;附带条件全部属于「把技术可行翻译成生产可切流」的治理范畴,而非对架构方向的异议。
|
||||
|
||||
---
|
||||
|
||||
## 一、对 PoC 证据的合议认定
|
||||
|
||||
**采信**:核心引擎零修改编译、全量 1,166 实体一致性扫描、写路径/主子表语义保真、存量脚本零修改执行、amis 渲染实测、Flowable 两步升级与运行中实例续跑、AI 闭环 3/3——以上全部经评审人独立核对源码与产物,无一证伪。
|
||||
|
||||
**两处表述更正(经主持人复核)**:
|
||||
|
||||
1. **「99.1% 一致性」必须改称「计数级一致性」**。实测方法是「引擎 total vs 直连 count(*)」,不是 PoC 方案 3.2 定义的「结果集逐行一致」。逐行对拍需旧系统运行环境录制 SQL,已列为工程化第一优先补验项。今后所有对外材料统一表述为:「计数级一致性 99.1%(0 计数不一致),逐行对拍待工程化阶段补全」。
|
||||
2. **OSGi 替换类行数表述澄清**:原版服务定位器 72 行(framework 实测)、新替换实现 43 行(eip4-poc 实测),两数字均属实,此前文档表述有混淆。
|
||||
|
||||
**合议确认的 PoC 系统性边界**(非缺陷,是 PoC 性质所致,工程化必须显性还原):
|
||||
横切服务全部打桩(数据权限未验真)、性能/并发零覆盖、153 个 engineclass 定制视图仅盘点未实操、AI 闭环是全新简单场景非存量复杂场景。
|
||||
|
||||
---
|
||||
|
||||
## 二、决议一:立项与排期
|
||||
|
||||
**批准工程化立项。** 排期采纳 CTO 修正案(对 PoC 单人快跑速度统一施加工程化系数,显性还原被打桩/被推迟的工作):
|
||||
|
||||
| 阶段 | 内容 | 修正人月 | 关键说明 |
|
||||
|------|------|---------|---------|
|
||||
| P0' | PG 9.4→15 升级演练(前置,单列) | 0.5–1 | 全库兼容性扫描 + 恢复演练 |
|
||||
| P1 | 元数据服务工程化 + **逐行对拍框架** | 3–4 | 省下的引擎时间投回真对拍 |
|
||||
| P2 | 组织/权限/数据权限真实现 | 3–4(上调) | 数据权限是最可能爆雷段 |
|
||||
| P3 | Flowable 服务 + 3 个 handler bean 移植 | 1.5–2.5 | 升级运维脚本含版本串规范化 |
|
||||
| P4 | amis 二开 + 批量转换 + 153 定制视图 | 4–6(显著上调) | 最大不确定段,见决议三 |
|
||||
| P5 | MCP/AI 工具层 | 0.5–1 | WS5 实证,可信乐观点 |
|
||||
|
||||
**合计 13–19 人月,对外承诺口径取 15–18 人月。** 里程碑付款按 P1/P2+P3/P4/P5 四笔,以「对拍通过 + 客户 UAT 签字」为付款触发,不以代码完成为触发。
|
||||
|
||||
**人员配置**:4 人核心(熟引擎老员工 1 + Spring Boot 后端 1–2 + 前端 1)+ 架构/AI 0.5 兼职。React 不招全职:amis 主体是 schema 配置活,由后端补位;153 定制视图中决定重写的部分集中外包。**熟引擎老员工为单点风险,立项决议含知识转移 + backup 人选硬要求**,PoC 坑位记录两周内整编成正式迁移手册。
|
||||
|
||||
---
|
||||
|
||||
## 三、决议二:amis fork 预算(管理层拍板事项 A)
|
||||
|
||||
**接受「永久 fork + 终身自维护」的预算认知,按以下三条入账:**
|
||||
|
||||
1. 按 **0.5 人/年(取上限)** 编入运维常态预算,科目定性为「前端渲染器自维护保险费」,独立于项目交付预算,不得挪用;
|
||||
2. **立项即执行「fork 可行性预演」**:真 fork amis 6.13.0、在公司环境独立构建通过一次,买下「fork 能力的期权」——预演失败即触发止损线 2;
|
||||
3. 合同与立项书写明该编制由 N 客户摊薄;客户数收敛至 1–2 时触发 TCO 重算(止损线 4)。
|
||||
|
||||
---
|
||||
|
||||
## 四、决议三:工程化第一周必须补验清单(CTO 条款)
|
||||
|
||||
以下五项为 P1 启动后第一周的强制任务,完成前不得宣布任何阶段「通过」:
|
||||
|
||||
| # | 补验项 | 来源 | 通过标准 |
|
||||
|---|--------|------|---------|
|
||||
| C1 | **逐行对拍框架**:旧系统 SQL 录制切面 + 新引擎结果集逐行 diff | CTO-CRITICAL | ≥20 个代表性实体(含主子表/字典翻译/数据权限/深分页)逐行一致率 100% |
|
||||
| C2 | 数据权限最小真实现替换桩,并纳入对拍样本 | CTO-MAJOR | ≥3 个走行级过滤的实体对拍通过 |
|
||||
| C3 | Top 10 高频实体基础压测 + 慢查询采样 | CTO-MAJOR | 设定 P95 延迟基线 |
|
||||
| C4 | S3 脚本正则改写器原型在真实脚本上实测自动化率 | CEO-质疑2 | 自动化率 ≥80% 锁定 P4 预算;<80% 按保守口径重估 |
|
||||
| C5 | amis fork 可行性预演(独立构建通过) | CEO-条款 | 构建产物可替换 CDN 版本运行 |
|
||||
|
||||
**第一周第一个要回答的问题**(CTO 开放项):旧系统是否还有可运行环境供 SQL 录制?若不可得,C1 基准的替代方案(生产流量旁路录制)需另行设计并报批。
|
||||
|
||||
---
|
||||
|
||||
## 五、决议四:切流治理与红线条款(风控条款)
|
||||
|
||||
### 切流策略
|
||||
- **粒度**:按「功能点」(一个 view_template + 其实体读写 + 关联流程定义)灰度,绝不按客户/部门整体切;
|
||||
- **排序**:只读查询类 → 写入不走审批类 → 带运行中审批类(最后);153 个 engineclass 视图一律末批或划入旧系统长期过渡清单;
|
||||
- **并行期** 6–9 个月,由运行中流程自然消化驱动,**禁止为下线赶工强制迁移运行中实例**;
|
||||
- **写路径切流单元**切流前做单表级快照 + 数据修复脚本预案(回退≠简单切回,数据已双写)。
|
||||
|
||||
### 变更管理(风控认定的 CRITICAL 治理缺口,本决议补齐)
|
||||
任何不可逆变更(Flowable schema 改写 / PG 大版本升级)执行的**四要素缺一不可**:
|
||||
已通过恢复演练的全量物理备份 → 同版本同数据量拷贝库全流程演练(实测耗时定停机窗口)→ 已定义且实测的回退点 → 客户书面批准。
|
||||
**PG 升级与 Flowable 升级分两个独立窗口执行,分别设回退点**(会议当场拍板,回应风控开放项 2)。
|
||||
|
||||
### 七条切流红线(任一不满足自动暂停,不接受下不为例)
|
||||
1. 备份-恢复红线(恢复演练通过,非备份成功)
|
||||
2. 对拍红线(该功能在该客户真实数据上新旧对拍通过)
|
||||
3. 元数据台账红线(55 孤儿 + 9 漂移逐条定性闭合并经客户书面确认)
|
||||
4. 运行中实例红线(续跑+挂起语义在生产数据复现;禁止强制迁移/截断)
|
||||
5. 回退可执行红线(书面+已演练)
|
||||
6. 客户签字红线(功能点=业务负责人签;不可逆变更=客户 IT+业务双签;旧系统下线=客户最高决策层签)
|
||||
7. fork 预算红线(本纪要第三节即为管理层书面确认,此条已闭合 ✅)
|
||||
|
||||
---
|
||||
|
||||
## 六、决议五:商务条款(管理层条款 B)
|
||||
|
||||
1. **报价模型**:一次性交付 + 年度运维两段式。一次性段含引擎移植分摊 + 客户定制视图按实际用量计费;运维段含 fork 保险费分摊 + PG/补丁维护。对客户讲清「零授权费 ≠ 零运维费」。
|
||||
2. **存量客户口径**:「平台底层换代,业务数据零搬迁、运行中审批不中断、已配置内容继续可用,需安排一次数据库升级停机窗口」——前三句有 PoC 实测背书,最后一句必须如实告知。
|
||||
3. **AI 能力口径(红线)**:可作差异化卖点,表述限「AI 辅助、人工复核」。**严禁在报价/合同中承诺「AI 全自动开发/人力大幅下降」**——3/3 样本是全新简单场景,P5 须在存量复杂场景重测拿到数据后再定对外承诺。
|
||||
4. 153 定制视图的处置归属与计费,须在 P1 付款节点前与客户逐个书面确认。
|
||||
5. 元数据漂移(55+9)的清洗成本归属写入合同附则(管理层开放项采纳)。
|
||||
|
||||
---
|
||||
|
||||
## 七、止损条件(合并管理层 4 条 + 沿用决策报告触发条件)
|
||||
|
||||
| # | 止损线 | 动作 |
|
||||
|---|--------|------|
|
||||
| S1 | 任一阶段实际人月超预算 50% 且无收敛 | 暂停,重审 153 视图与 S3 脚本真实工作量 |
|
||||
| S2 | fork 可行性预演失败 | 暂停,回退评估路线 A 或其他渲染层 |
|
||||
| S3 | 首客户上线 3 个月内发生平台缺陷致生产数据事故,或 amis 出现公司无法自修的阻断性 bug | 暂停向第二客户复制 |
|
||||
| S4 | 交付模式收敛为 1–2 锁定客户 | 重算 TCO,重启选型评估 |
|
||||
| S5–S9 | 沿用《架构决策报告》第四节触发条件 1–5 | 按原文执行 |
|
||||
|
||||
---
|
||||
|
||||
## 八、开放项与责任人
|
||||
|
||||
| 开放项 | 提出方 | 责任人 | 期限 |
|
||||
|--------|--------|--------|------|
|
||||
| 确认 192.168.20.68:5435 为隔离测试副本(PoC 写测试合规性背书) | 风控 | 项目负责人 | 立项前书面确认 |
|
||||
| 旧系统可运行环境可得性(C1 基准) | CTO | 技术负责人 | P1 第一周 |
|
||||
| 客户合同是否含「UI 形态可变更」条款 | 风控 | 商务 | 首客户切流方案前 |
|
||||
| 153 视图「重写/降级/留旧」处置清单 | CTO/CEO | 项目负责人 | 立项后 2 周 |
|
||||
| 单客户复制成本模型(第二客户报价依据) | CEO | 商务+技术 | P4 结束前 |
|
||||
| amis 上游若复活(出 7.0 稳定版)的跟进决策机制 | CEO | 技术负责人 | 运维预算年审附带 |
|
||||
|
||||
---
|
||||
|
||||
## 九、决议生效
|
||||
|
||||
本纪要经三方评审意见合议形成。**立项决议即时生效**;工程化阶段按第二节排期启动;生产切流以第四、五节为前置门禁。下一次决策检查点:**P1 结束(逐行对拍框架交付)**,届时复审 C1–C5 补验结果,决定是否解除「有条件」限定。
|
||||
|
||||
**附**:三方完整评审意见已存档于本次会议记录;PoC 全部工件清单见 `eip4-poc/README.md`;扫描与迁移脚本已归档 `eip4-poc/tools/`。
|
||||
135
docs/决策与盘点/EIP3架构决策报告.md
Normal file
135
docs/决策与盘点/EIP3架构决策报告.md
Normal file
@@ -0,0 +1,135 @@
|
||||
# EIP3 重构架构路线最终决策报告
|
||||
|
||||
## 一句话裁决
|
||||
|
||||
**采纳「路线 A' = amis 前端 + Java/Spring Boot 自研元数据后端」作为主路线**(即在报告原路线 A 的基础上,把后端语言从 Node.js/NestJS 改回 JVM,保留并升级既有 Spring 服务端资产);路线 B(NocoBase 二开)降为「仅当 A'/A 的 PoC 失败、且 NocoBase 给出书面 OEM 转售授权」时启用的备选,原路线 A(amis + NestJS)不再作为独立首选。
|
||||
|
||||
裁决一句话逻辑:**amis 的官方 JSON Schema 闭环(重构首要目标的唯一确定性载体)只对前端有要求,对后端语言中立;而 EIP3 最核心、风险最高的资产(POJOCRUDService 动态建表引擎、数据权限织入、JVM 内执行的 Groovy 脚本、Activiti→Flowable 迁移)全部在 JVM 上保真度最高、迁移成本最低、且团队技能匹配。把后端钉死在 Node 是报告里一个未经技术论证、且与团队画像冲突的选择。**
|
||||
|
||||
---
|
||||
|
||||
## 一、加权决策矩阵
|
||||
|
||||
### 权重设定(按本次重构目标定权)
|
||||
|
||||
| 维度 | 权重 | 定权理由 |
|
||||
|---|---|---|
|
||||
| AI Agent 友好度 | **0.35** | 报告白纸黑字的「重构首要目标」,必须权重最高 |
|
||||
| 技术与迁移风险 | **0.30** | EIP3 在客户生产环境活跃运行,迁移翻车即数据事故;「真实表零迁移+审批迁移」是命脉 |
|
||||
| 总拥有成本与商务模式 | **0.20** | 集成商多客户复制模式下,授权条款有放大效应,直接决定能否赚钱 |
|
||||
| 团队技能与长期演进 | **0.15** | 决定 10 年维护可持续性,但可通过招聘/外包部分缓冲,权重次之 |
|
||||
|
||||
### 各维度评分(A、B 沿用四视角原始分;A' 由本裁决基于源码实证与四视角逻辑推导给出,并标注调整依据)
|
||||
|
||||
| 维度(权重) | 路线 A (amis+NestJS) | 路线 B (NocoBase) | **路线 A' (amis+Java/Spring Boot)** |
|
||||
|---|---|---|---|
|
||||
| AI 友好度 (0.35) | 8.5 | 6.0 | **8.5**(与 A 同:AI 闭环属前端 Schema + REST 契约层,与后端语言正交;Spring 侧有 springdoc-openapi、Spring AI MCP、JSON Schema 校验库,能力等价,仅 MCP TS 生态略成熟,扣分忽略不计) |
|
||||
| 技术与迁移风险 (0.30) | 7.0 | 3.5 | **8.5**(显著高于 A:服务端可做「同语言、同 SQL 方言对拍测试」,POJOCRUDService 行为等价性验证成本全场最低;纯服务端 Groovy 零翻译续跑;Flowable 同栈嵌入少一层集成面。扣分项为 Spring3.1/JDK6→Boot3/JDK17 跨度大、javax→jakarta) |
|
||||
| TCO & 商务 (0.20) | 8.0 | 3.5 | **8.5**(略高于 A:Apache 2.0 + 自有 IP 零授权费的优势与 A 相同;但 A' 省掉「招 1-2 名后端 React/Node 工程师」的成本,团队即战力,乐观工期 4-6 人月 vs A 的 P1-P3,一次性 TCO 更低) |
|
||||
| 团队技能与长期演进 (0.15) | 7.0 | 4.5 | **8.0**(高于 A:后端不转栈,团队对最核心资产「动态 SQL 引擎/数据权限织入」保持内行;前端 amis fork 风险与 A 相同,故未给满分) |
|
||||
|
||||
### 加权总分
|
||||
|
||||
| 路线 | 计算 | **加权总分** |
|
||||
|---|---|---|
|
||||
| **A' (amis + Java/Spring Boot)** | 8.5×0.35 + 8.5×0.30 + 8.5×0.20 + 8.0×0.15 | **8.43** |
|
||||
| A (amis + NestJS) | 8.5×0.35 + 7.0×0.30 + 8.0×0.20 + 7.0×0.15 | **7.73** |
|
||||
| B (NocoBase 二开) | 6.0×0.35 + 3.5×0.30 + 3.5×0.20 + 4.5×0.15 | **4.53** |
|
||||
|
||||
**结论:A' (8.43) > A (7.73) > B (4.53)。** A' 与 A 在首要目标(AI 友好度)上完全打平,A' 的优势全部来自「后端不跨语言重写」带来的迁移风险下降、TCO 下降、团队匹配上升——这正是把后端从 Node 改回 Java 的全部收益。B 在除 AI 现成度外的所有维度上结构性落后,且 AI 现成度的优势又被「无官方公开校验 Schema」抵消(见下)。
|
||||
|
||||
---
|
||||
|
||||
## 二、正面回应三类关键质疑
|
||||
|
||||
### 2.1 事实核查中被推翻 / 部分推翻的报告论断
|
||||
|
||||
**(a) 「NocoBase = AGPL+商业双授权」——已过时,必须修正。**
|
||||
事实:NocoBase 于 2026-02(v2.0.3)将核心改为 **Apache-2.0 + 自定义补充条款**,AGPL 传染性对新版本消除。报告中「AGPL 影响报价模型」「二开交付需开放源码」的法律顾虑已不成立。
|
||||
**但这不利好 B、反而暴露了更硬的红线**:补充条款 7.3/7.4 明文禁止「向公众转售/提供基于本软件的低代码/AI 平台 SaaS/PaaS」,7.5/7.6 规定「交付物若授予客户配置权限,客户须各自购买商业授权」。**EIP3 的本质就是交付「带数据字典动态建表的低代码平台能力」给客户继续配置**——这恰好落在禁止条款的字面射程内。因此:协议从 AGPL 改 Apache **降低了源码开放风险,却抬高了「平台级转售」的合同定性风险**,对 B 是中性偏负,对 A/A'(amis 纯 Apache-2.0 无此约束)是相对利好。报告必须把表述更新为「Apache-2.0+补充协议」,并把这条红线列为 B 的拍板前置门禁。
|
||||
|
||||
**(b) 「amis 持续发版、活跃」——不成立,且是现在进行时的硬风险。**
|
||||
事实:最后稳定版 6.13.0 停在 2025-08-12(距今 10 个月),默认分支 2026-03-18 后近 3 个月零提交,1711 open issues,7.0 难产,核心贡献者 bus factor≈1。**这是对 A/A' 共同的、最严重的削弱**:选 amis 必须按「未来自行长期 fork 维护一个冻结的大型 React 渲染器」编列预算,不能假设上游会修 bug / 适配新 React。
|
||||
**但杀伤力取决于组织预期而非技术本身**:amis 渲染器本体成熟(50+ 控件、schema.json 929KB/301 定义可用),EIP3 自己就在 EOL 的 Vaadin 7 上稳定跑了 7 年——该组织本就接受「冻结栈」模式。对一个「只用现成控件、不追新」的企业内部系统,冻结在 6.13 可运行多年。**这把「致命」降级为「重大但可管理」,前提是决策层明确接受 fork 维护编制。**
|
||||
|
||||
**(c) 「社区 LLM 生成 amis 已成熟」——不成立。** 只有零散博客与周边工具,无成熟开源管线。意味着 A/A' 的提示词工程、组件级 schema 裁剪(929KB 全量不能直接塞 LLM 上下文)、校验-重试管线都需自研。报告 P5 给 0.5-1 人月明显低估,应上修。
|
||||
|
||||
**(d) Flowable 兼容 Activiti 5.14——确认属实(confirmed)。** 这是全场最稳的一块:v5 兼容层延续到 8.0.0,运行中实例可就地升级、逐定义灰度切流。**此结论对 A' 是最大加分**:Flowable 是 Java,可与 Spring Boot 同进程内嵌或同栈独立 REST 服务,迁移工具链在 JVM 内最成熟,比 Node 后端跨语言调用少一层集成面。对 B 则相反:NocoBase 自有 trigger+node 引擎非 BPMN、无导入路径,存量流程必须人工重建模、历史实例基本弃置。
|
||||
|
||||
**(e) Frappe 排除——确认成立(confirmed)。** PG 在 Frappe 仍是 beta/experimental,v15/v16 官方明确无转正计划。Frappe 正式出局,无需再议。
|
||||
|
||||
### 2.2 对抗辩护中「未被化解」的攻击——逐条认领
|
||||
|
||||
| 攻击点 | 是否被化解 | 裁决处理 |
|
||||
|---|---|---|
|
||||
| **amis 上游停摆 vs 生态红利预期**(针对 A/A') | **未被化解** | 这是唯一「条件致命」缺陷。无纯技术解,只能靠组织自觉接受 fork 编制。**已计入裁决:把它列为拍板前置认知对齐项 + 触发重新决策条件 #1。** |
|
||||
| **长期 TCO 中「每年 1-2 人 fork 维护编制」**(针对 A/A') | **难以消除** | 诚实承认。对策仅为「可被多客户摊薄」。A' 比 A 略优,因为后端维护由内行团队承担、不额外背 Node 技能债。 |
|
||||
| **NocoBase「平台级转售」合同灰区**(针对 B) | **未被化解(除非签 OEM)** | 这是 B 的条件致命缺陷。**裁决:未拿到 NocoBase 书面 OEM/转售授权前,B 不得拍板。** |
|
||||
| **NocoBase 外部数据源无 DDL → 零迁移承诺破产**(针对 B) | **半解(自写数据源插件=更深 fork)** | 技术上最接近致命。EIP3 命脉「SYS_ENTITY 元数据驱动真实表 DDL」在 NocoBase 外部源上不存在;自写插件复刻=拆东墙补西墙,加重 fork 漂移。**这是 B 在迁移风险维度仅得 3.5 的根因,裁决予以确认。** |
|
||||
| **NocoBase 审批非 BPMN vs 已定 Flowable 原则**(针对 B) | **可解但崩估算** | 弃用 NocoBase 审批外挂 Flowable,则 Professional 版核心卖点作废、审批 UI 全自研,6-8 人月估算崩塌。 |
|
||||
| **A' 的 Spring3.1/JDK6→Boot3/JDK17 跨度可能局部退化为重写** | **待 PoC 证伪** | 诚实标注(见第六节)。javax→jakarta、OSGi classloader 黑魔法可能渗入业务代码。**这是 A' 唯一需 PoC 实证的真实弱点。** |
|
||||
|
||||
### 2.3 「Java 团队却选 Node 后端」——这个矛盾点是本裁决推翻原路线 A 的核心
|
||||
|
||||
报告为 amis 配 NestJS **未给出任何技术必然性论证**。经辩护律师的源码实证:约 476 个 server 端 Java 文件中**仅 3 个 import Vaadin**;POJOCRUDServiceImpl(610 行实现)是纯 Spring `@Service/@Transactional`,依赖项全是同语言可搬的内部服务。这说明:
|
||||
|
||||
1. **「低代码生态在 JS 系」是排除 Go/Rust 全栈自研的理由,被错误外溢到了后端选型。** 前端选 amis(JS 系)是对的;后端跟着转 Node 是无依据的滑坡。amis 官方设计就是「厚前端薄后端」,对后端只要求 REST/JSON——Spring Boot + amis 是国内成熟常见组合。
|
||||
2. **选 Node 把「跨语言重写」的全部成本凭空引入**:事务模型、连接池、动态 DDL、并发模型全不同,「只移植不重设计」在跨运行时下是伪命题。选 Java 则同一范围降级为「去 OSGi 化 + Spring 升级」,每步可与旧实现做同 SQL 对拍,行为等价性验证成本全场最低。
|
||||
3. **「最大技术债」Groovy 的最优解在 JVM 而非翻译**:脚本经 JSR-223 在 JVM 服务端执行。后端留 Java 则纯服务端脚本(流程、校验)**零翻译续跑**,仅 UI 绑定脚本需把 FieldGroup 等换成面向 amis 事件上下文的兼容 facade(一次性框架工程)。Node 路线则 100% 脚本必须 Groovy→JS 逐个翻译并回归,客户生产在跑,翻错即事故。
|
||||
4. **团队画像**:团队是 Java 背景,路线 A 已自认需补 1-2 名 React 工程师;若后端再转 NestJS,则**前后端双线技能断层**,团队对自己最核心的资产(动态 SQL 引擎、数据权限织入)交付后反成外行。
|
||||
|
||||
**结论:把后端钉死在 Node 没有技术必然性,且在迁移风险、TCO、团队三个维度同时劣于 Java。这是本裁决用 A' 替代 A 的全部依据。**
|
||||
|
||||
---
|
||||
|
||||
## 三、执行建议:是否仍需 PoC,证伪条件是什么
|
||||
|
||||
**仍需 PoC,但从「双路线 2 天」升级为「三路线、分轨证伪、约 1 周」。** 同一典型功能固定为报告建议的 **「主子表 + 审批 + 联动脚本」**,三轨并行:
|
||||
|
||||
| 轨道 | PoC 必做内容 | **证伪条件(出现即推翻本裁决)** |
|
||||
|---|---|---|
|
||||
| **A'(主裁决,重点验证)** | 将 POJOCRUDService + 数据权限切到 Spring Boot 3 / JDK17,跑通 1 个实体的 CRUD + REST/JSON Schema 门面;挑 1 个纯服务端 Groovy 脚本与 1 个 UI 绑定脚本做迁移验证 | **若发现服务端代码深度依赖 OSGi classloader 黑魔法或废弃 Spring API,致「升级」实质退化为「重写」,且工期逼近 Node 重写** → A' 的「干净起点」优势消失,回退到 A(Node 重写的「全新干净起点」反成优势) |
|
||||
| **A(对照)** | 同一实体在 NestJS 上实现元数据 CRUD + amis 页面 schema.json 机器校验闭环 | 若 A' 被证伪,A 接棒为主路线(AI 闭环已验证可行) |
|
||||
| **B(商业+技术双证伪)** | ① 技术:在 NocoBase 上**挂接一张 EIP3 已有物理表并尝试加字段**(直接验证外部源 DDL 缺口);② 商业:**并行向 NocoBase 索取覆盖「平台级转售+客户继续配置」的书面 OEM 报价与条款** | **只要满足任一**:挂接表无法经 NocoBase 加字段(DDL 缺口证实)/ NocoBase 拒绝给 OEM 或要价改变项目经济性 / 官方 Skills+MCP 无法以低错误率自主生成「主子表+审批+联动脚本」→ **B 永久出局** |
|
||||
|
||||
**什么样的整体结果会翻转本裁决:**
|
||||
- A' 轨证伪(Spring 升级=重写)**且** A 轨 AI 闭环跑通 → 改选 **A**(首要目标仍达成,只是放弃后端保真度收益)。
|
||||
- A' 与 A 两轨都因 amis 停摆 / 二开成本失控而不达标,**且** B 的 OEM 谈成、DDL 缺口可接受(接受一次全量数据迁移)→ 才考虑 **B**。
|
||||
- 三轨皆不达标 → 触发「换其他 Apache 协议渲染层(如重新评估 Corteza/Vue 系)」的二次选型,不在本裁决射程内。
|
||||
|
||||
**PoC 检查单必须额外纳入**(来自核查与辩护):amis 上游活跃度复核、amis fork 维护年成本测算、Groovy 存量按「纯服务端 / UI 绑定」分桶量化、NocoBase 书面 OEM 条款。
|
||||
|
||||
---
|
||||
|
||||
## 四、触发重新决策的条件(命中任一即重启评估)
|
||||
|
||||
1. **amis 上游活跃度复核结论恶化**:若 PoC 期再次核查发现 amis 不仅停滞而是明确弃维护(如官方公告归档、issue 全面关闭),**且**决策层不接受「永久 fork + 终身自维护前端渲染器」的预算编制 → A/A' 前端根基动摇,须重评其他 Apache 协议渲染层。
|
||||
2. **A' 服务端升级被 PoC 证伪**:Spring3.1→Boot3 升级实测退化为重写(OSGi classloader 渗透 / javax→jakarta 改造量爆炸)→ 由 A' 回退到 A(Node 干净重写)。
|
||||
3. **Groovy 脚本盘点数量/性质越界**:P0 盘点若发现 UI 绑定脚本占比远超预期(如 >70%)且大量依赖 Vaadin 运行时对象的不可表达副作用 → facade 方案失效,翻译成本失控,需重估前端事件模型甚至重谈整体工期。
|
||||
4. **NocoBase OEM/授权谈判结果**:仅当 A'/A 两轨均失败、B 被迫复活时——若 NocoBase 拒绝书面 OEM、或每客户授权(Professional $8,000 起)使多客户报价模型不成立 → B 直接否决。
|
||||
5. **客户数预期发生结构性变化**:若公司实际交付从「多客户项目制」收敛为「仅服务 1-2 个锁定客户」→ B 的每客户授权费失去放大效应,TCO 维度结论可能反转,须重算矩阵(此为 B 唯一可能翻盘的商业前提)。
|
||||
|
||||
---
|
||||
|
||||
## 五、与已定架构原则的一致性确认
|
||||
|
||||
本裁决与报告「确定原则」完全兼容,且 A' 比原 A 更顺:
|
||||
- **绞杀者模式新旧并行切流** → A' 第一步「给现有 Spring 服务加 REST/JSON Schema 门面」即天然的绞杀者 facade,切流粒度可比 A 更细、每步可回退。
|
||||
- **PostgreSQL 主库** → A' 自研 Java 元数据服务直接复用 SYS_ENTITY 与既有 PG 物理表,「真实表零迁移」在 A' 上真实成立(这是 B 做不到的)。
|
||||
- **Flowable 独立工作流服务** → A' 同为 JVM,集成面最小,原则落地最自然。
|
||||
- **页面与实体定义统一 JSON Schema** → 前端 amis 官方 schema.json + 后端 springdoc/JSON Schema 校验库,双闭环统一,与后端语言无关。
|
||||
|
||||
---
|
||||
|
||||
## 六、诚实标注:本裁决依据不足 / 仍有不确定性的部分
|
||||
|
||||
1. **A' 的服务端升级成本是「乐观推断」,未经实测。** 「4-6 人月、可对拍测试」建立在「仅 3 个文件 import Vaadin、POJOCRUDService 是纯 Spring」的源码核查上,但 Spring3.1/JDK6→Boot3/JDK17 的 javax→jakarta、AOP/事务语义差异、OSGi 类加载是否渗入业务代码**均未验证**。这是本裁决最大的不确定点,PoC 轨道 A' 就是为证伪它而设。若它被证伪,主路线应即时切回 A。
|
||||
2. **amis「冻结仍可用」的判断依赖组织风险偏好,非客观结论。** 「EIP3 在 Vaadin 7 上跑了 7 年 = 组织接受冻结栈」是类比推理,不等于管理层愿意为前端 fork 长期编列预算。这一项必须在拍板前与决策层正面对齐,而非由架构层替其决定。
|
||||
3. **A' 的 AI 友好度给 8.5(与 A 持平)含一处乐观成分。** MCP 的 TypeScript SDK 与 amis 官方工具链生态确实比 Spring AI MCP 成熟,存在「成熟度时间差」。判断这是时间差而非能力缺口、可被薄适配层吸收——但此结论未经实测,若 Spring 侧 MCP 落地遇阻,A' 在首要维度可能比 A 低 0.5-1 分(不改变排序,但缩小与 A 的差距)。
|
||||
4. **四视角原始分中 A/B 的部分打分基于「报告事实」,而部分报告事实已被核查推翻**(如授权模式、amis 活跃度)。本裁决已在能识别处做了修正(如 B 的授权风险重新定性、amis fork 成本计入 A/A'),但四视角评分者当时是否已知最新事实无法逐项追溯,故 A/B 原始分存在「基于过时前提」的残余误差,A' 分数为本裁决推导、误差同源。
|
||||
5. **NocoBase 的真实存续性与 OEM 谈判结果完全未知。** 「无融资 bootstrapped、年营收约 145 万美元」既可解读为「健康盈利」也可解读为「无资本缓冲」,10 年企业级维保承诺能否兑现无法判定。由于 B 已非主路线,此不确定性不影响裁决,但一旦 B 复活必须前置尽调。
|
||||
6. **Groovy 存量规模在 P0 盘点前是开放变量。** 「纯服务端脚本零翻译」的收益大小取决于服务端/UI 绑定脚本的真实比例,盘点前无法量化 A' 相对 A 在 Groovy 维度的确切优势幅度——本裁决给 A' 迁移风险 8.5 已部分依赖「服务端脚本占相当比例」这一未证假设。
|
||||
|
||||
---
|
||||
|
||||
**交付物结论**:主路线 **A'(amis + Java/Spring Boot 自研后端)**,加权 8.43,领先 A(7.73)与 B(4.53)。立即执行三轨 PoC(A' 重点、A 对照、B 商业+DDL 双证伪),以第三节证伪条件为准;命中第四节任一条件即重启决策。报告须先行修正「NocoBase=AGPL 双授权」与「amis 持续活跃」两处过时事实,再提交决策层做 fork 预算认知对齐。
|
||||
60
docs/决策与盘点/EIP3源码预核查报告.md
Normal file
60
docs/决策与盘点/EIP3源码预核查报告.md
Normal 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 兼容层风险)
|
||||
- 运行中流程实例的续跑实测
|
||||
229
docs/决策与盘点/EIP3路线A-PoC执行方案.md
Normal file
229
docs/决策与盘点/EIP3路线A-PoC执行方案.md
Normal file
@@ -0,0 +1,229 @@
|
||||
# EIP3 路线 A'(amis + Java/Spring Boot)PoC 详细执行方案
|
||||
|
||||
> 版本:v1.0(2026-06-10)
|
||||
> 前置文档:《EIP3重构评估报告.docx》《EIP3架构决策报告.md》
|
||||
> PoC 性质:**证伪型验证**,不是预研。每个工作流都有明确的「出现即推翻裁决」的中止条件。
|
||||
> 时间盒:**7 个工作日**,超时即按当时证据强制决策,不延期。
|
||||
|
||||
---
|
||||
|
||||
## 0. PoC 要回答的四个问题
|
||||
|
||||
| # | 问题 | 对应裁决中的不确定点 |
|
||||
|---|------|---------------------|
|
||||
| Q1 | Spring 3.1/JDK6 → Spring Boot 3/JDK17 是「升级移植」还是会退化为「重写」? | 决策报告第六节第 1 条(最大不确定点) |
|
||||
| Q2 | amis 对「主子表 + 联动」的还原度是否达标?schema.json 校验闭环是否真实可用? | A/A' 共同前提 |
|
||||
| Q3 | Groovy 脚本「纯服务端零翻译 + UI 绑定走 facade」的分级方案是否成立? | 决策报告第六节第 6 条 |
|
||||
| Q4 | Activiti 5.14 流程定义 + 运行中历史实例能否在 Flowable 上平滑续跑? | 事实核查已 confirmed,PoC 做实操复核 |
|
||||
|
||||
## 0.1 本次源码预核查结论(2026-06-10,已实测)
|
||||
|
||||
PoC 方案中的工作量判断基于以下对 `framework/` 的实际检查,不是推测:
|
||||
|
||||
- `POJOCRUDServiceImpl.java`(610 行,`com.dsasp.server.dataDic`):**零 Vaadin 依赖**,import 只有 JDK、Spring(`@Service/@Transactional/@Autowired`)和内部服务接口。
|
||||
- `POJOServiceImpl.java`(1,346 行,SQL 拼装引擎):同模块,待 PoC 中逐项核对。
|
||||
- **唯一 OSGi 耦合点** `SpringBeanOsgiServices`(`com.dsasp.server.common`,72 行):本质是遍历 bundle 注册服务按名取 bean 的服务定位器,Spring Boot 下可用 `ApplicationContext.getBean(name)` 直接等价替换。
|
||||
- 服务端 import Vaadin 的文件全 framework 仅 2 个:`com.dsasp.server.app/.../WfRestConstroller.java`、`com.dsasp.server.kaoqin/.../UserSelectWindow.java`,均不在 PoC 路径上。
|
||||
- javax.* 使用(dataDic+common+core 三模块):`javax.script` 17 处(JSR-223,JDK17 原样可用)、`javax.servlet` 6 处(→jakarta,机械替换)、其余忽略。
|
||||
- `com.dsasp.server.dataDic.binding.ScriptingEnginesManager`:已是标准 `javax.script.Bindings` + 编译缓存模式,**脚本引擎本身与 Vaadin 无关**——Vaadin 对象是 client 侧调用时塞进 Bindings 的,这正是 facade 方案的依据。
|
||||
|
||||
---
|
||||
|
||||
## 1. 范围、人员与原则
|
||||
|
||||
**验证功能**:从生产库选一个真实的「主子表 + 审批流 + 字段联动脚本」功能(P-0 盘点后定,候选优先级:含 1 个 valueChange 联动 + 1 个服务端校验脚本 + 走审批的单据类功能)。
|
||||
|
||||
**人员**(2.5 人 × 7 天):
|
||||
- 后端 1 名(熟 EIP3 的老员工,负责 WS1/WS3/WS4)
|
||||
- 前端 1 名(React 背景,负责 WS2,可外部支援)
|
||||
- 架构/AI 0.5 名(负责 WS5、对拍测试设计、最终评分)
|
||||
|
||||
**原则**:
|
||||
1. PoC 代码按一次性看待,但**三样产物必须可复用**:XML→amis 转换映射表、SQL 对拍测试框架、Groovy 脚本分桶盘点结果。
|
||||
2. 一切以「对拍」为准:新服务的正确性不靠人工目测,靠与旧系统输出逐字节比对。
|
||||
3. 不做美化、不做性能优化、不接真实权限——横切服务一律打桩(stub),只验证打桩点的接口形状是否可保留。
|
||||
|
||||
---
|
||||
|
||||
## 2. P-0 前置准备(Day 0,半天~1 天)
|
||||
|
||||
> **✅ 2026-06-10 已完成**:2.1/2.2 的库上盘点已对客户库测试副本(192.168.20.68:5435/eip3)执行完毕,结果见《EIP3客户库盘点报告.md》。要点:1,516 模板 / 1,427 条脚本,S3 形式占比 43% 但真困难仅 5.3%(facade 动词表扩到 ~20 个可覆盖 88% 的 S3);1,509 个 BPMN **零** `activiti:class` 自定义扩展;新增工作项:153 个 engineclass 定制视图(1.5–3 人月)、PG 9.4→15+ 升级前置。引擎实测 5.13-SNAPSHOT(非 5.14)。
|
||||
|
||||
### 2.1 生产库盘点(连客户库只读副本执行)
|
||||
|
||||
```sql
|
||||
-- ① 模板类型分布
|
||||
SELECT TYPE, COUNT(*) FROM VIEW_TEMPLATE GROUP BY TYPE ORDER BY 2 DESC;
|
||||
|
||||
-- ② 含脚本的模板数(XML 里有 <script)
|
||||
SELECT TYPE, COUNT(*) FROM VIEW_TEMPLATE
|
||||
WHERE TEMPLATE_XML LIKE '%<script%' GROUP BY TYPE;
|
||||
|
||||
-- ③ 实体规模
|
||||
SELECT COUNT(*) FROM SYS_ENTITY;
|
||||
SELECT COUNT(*) FROM SYS_ENTITYATTRIBUTE;
|
||||
```
|
||||
|
||||
> 字段名以实际表结构为准;若 XML 存于 CLOB,②改为导出后用脚本统计。
|
||||
|
||||
### 2.2 Groovy 脚本分桶(裁决的关键开放变量)
|
||||
|
||||
导出全部模板 XML,写一个一次性脚本按以下规则分桶并出报告:
|
||||
|
||||
| 桶 | 判定特征(脚本文本匹配) | 处理策略 |
|
||||
|----|------------------------|---------|
|
||||
| S1 纯服务端 | 不含 `FieldGroup`、`com.vaadin`、`getField`、`setVisible` 等 UI 词汇 | A' 下零翻译续跑 |
|
||||
| S2 简单 UI 联动 | 仅使用平台辅助函数(`getFieldValue`/`bindField`/`setFieldReadOnly`)+ `po`/`event`,或 setValue/setVisible/过滤数据源 | facade 换实现,脚本近零修改(见预核查报告核查 5) |
|
||||
| S3 复杂 UI 绑定 | 匹配 `group.` 直接调用 Vaadin API ∪ `ConfirmDialogListener`(同步等待用户输入)∪ 动态创建 Vaadin 组件 | 逐个评估:改回调链 / 下沉后端 / 人工翻译 |
|
||||
|
||||
**输出**:S1/S2/S3 数量与占比。**触发线**:S3 占比 > 30% 或 (S2+S3) > 70% → 按决策报告第四节条件 3 上报,重估工期。
|
||||
|
||||
### 2.3 环境
|
||||
|
||||
- JDK 17(Temurin)、Spring Boot 3.3.x、Maven/Gradle 新工程 `eip4-poc/`
|
||||
- PostgreSQL 15+:恢复一份**脱敏的客户库子集**(含 SYS_ENTITY、SYS_ENTITYATTRIBUTE、VIEW_TEMPLATE、选定功能的业务表、ACT_* 全套 Activiti 表)。注意:① 客户库实为 **PG 9.4.26(EOL)**,PoC 环境直接用 PG 15 恢复,顺带验证 9.4→15 升级兼容性(这已成为 P1 前置项);② 流程定义与业务模板**只存在于库中**(源码无 .bpmn 文件),WS4 用的流程从 `ACT_GE_BYTEARRAY` 导出,引擎 schema 实测 5.13-SNAPSHOT
|
||||
- 前端:Node 20 + `amis@6.13.0`(**锁版本**,下载 `https://unpkg.com/amis@6.13.0/schema.json` 入库存档)
|
||||
- 旧系统一套可运行环境(对拍基准)
|
||||
|
||||
---
|
||||
|
||||
## 3. WS1:元数据引擎移植(Q1,核心证伪轨)
|
||||
|
||||
**负责**:后端 | **工期**:Day 1–4 | **这是整个 PoC 的成败手**
|
||||
|
||||
### 3.1 移植清单(按依赖顺序)
|
||||
|
||||
| 步骤 | 内容 | 预核查依据 |
|
||||
|------|------|-----------|
|
||||
| 1 | 新建 `eip4-poc-metadata` Spring Boot 3 模块;拷入 `com.dsasp.server.common` 中 dataDic 相关接口与 bean(`POJOCRUDService`、`POJOService`、`GeneralPOJO`、`POJOInfo`、`DisplayType` 等) | 接口层无 OSGi 依赖 |
|
||||
| 2 | 拷入 `com.dsasp.server.dataDic` 全模块(17 个 Java 文件):`POJOCRUDServiceImpl`(610行)、`POJOServiceImpl`(1346行)、`Entity`/`POInfo`/`GeneralPO`、`binding/ScriptingEnginesManager` | 已确认纯 Spring |
|
||||
| 3 | 替换 `SpringBeanOsgiServices.getBeanByName()` → 注入 `ApplicationContext` 的 `getBean(name)`;删除 `BundleListener` 逻辑 | 72 行服务定位器,等价替换 |
|
||||
| 4 | 横切依赖打桩:`DataPrivilegeService`(返回「不过滤」)、`SystemLogManager`(打日志)、`FileService`(空实现)、`LoggedInUser`/`UserSession`(固定测试用户)。**接口签名原样保留**——P2 阶段移植真实现时直接替换 | POJOCRUDServiceImpl import 列表已确认就这几个 |
|
||||
| 5 | `javax.servlet` → `jakarta.servlet`(全 PoC 范围约 6 处);`javax.script` 不动 | 实测统计 |
|
||||
| 6 | Spring JDBC 3.1 → 6.x:~~`SimpleJdbcTemplate` 改写~~(预核查实测零使用,全部为 `JdbcTemplate`×21/`SqlRowSet`×15 等 Spring 6 保留 API);改造项只剩 commons-dbcp → HikariCP + `com.dsasp.server.db/META-INF/spring/db.xml` 事务配置转 Java Config | 预核查已降级,省出的时间投给 3.2 对拍 |
|
||||
| 7 | 数据源指向 PG 脱敏库,跑通:读 SYS_ENTITY → 动态建一张新表 → CRUD → 分页查询 | |
|
||||
|
||||
### 3.2 SQL 对拍测试(本 PoC 的质量核心)
|
||||
|
||||
1. 在**旧系统**的 `POJOServiceImpl` 关键出口(SQL 即将交给 JdbcTemplate 处)加日志切面,录制选定实体的全部操作 SQL + 参数 + 结果集行数,存为基准文件。
|
||||
2. 新服务以同一元数据执行同一操作序列,输出同格式文件。
|
||||
3. `diff` 两份文件:**SQL 文本允许空白差异,语义必须一致;结果集必须逐行一致。**
|
||||
4. 操作序列至少覆盖:新增实体建表、单表 CRUD、主子表级联保存、分页+排序+查询条件组合、含数据字典翻译的查询。
|
||||
|
||||
> **✅ WS1 实测进展(2026-06-10,Day 1–2)**:`eip4-poc` 工程已搭建并对客户库副本跑通。
|
||||
> 核心引擎(POJOCRUDServiceImpl 610 行 + POJOServiceImpl 1,346 行)**零修改编译**;
|
||||
> Spring API 断点仅 `queryForInt/queryForLong` 7 处;OSGi 解耦 = 1 个 72 行替换类。
|
||||
> **全量 1,166 实体一致性扫描 0 计数不一致(99.1% 通过,超 95% 线)**;
|
||||
> 写路径(动态建表 + INSERT/UPDATE/DELETE + 校验)8/8 通过。
|
||||
> **3.3 的三个证伪条件均未触发,WS1 实质通过。** 详见 `eip4-poc/README.md`。
|
||||
|
||||
### 3.3 WS1 证伪条件(出现即停,回退路线 A)
|
||||
|
||||
- [ ] 发现业务代码深度依赖 OSGi classloader 行为(如按 bundle 反射加载类、动态导出 package),替换面 > 移植代码量的 30%
|
||||
- [ ] Spring JDBC 升级触发连锁改写(如大量使用已删除 API、事务语义不等价且无法对拍通过)
|
||||
- [ ] Day 4 结束时对拍测试通过率 < 80%,且剩余差异无收敛趋势
|
||||
|
||||
---
|
||||
|
||||
## 4. WS2:REST + JSON Schema 门面 + amis 主子表还原(Q2)
|
||||
|
||||
**负责**:前端 + 后端配合 | **工期**:Day 2–5(与 WS1 部分并行,依赖 WS1 步骤 7)
|
||||
|
||||
### 4.1 任务
|
||||
|
||||
1. 在 `eip4-poc-metadata` 上加 REST 层:`GET/POST /api/entity/{name}`(列表/分页/CRUD),响应格式直接做成 **amis CRUD 约定格式**(`{status, msg, data: {items, total}}`),省一层适配。
|
||||
2. 加 `springdoc-openapi`,确认 OpenAPI 文档自动生成(AI 友好度的后端半边)。
|
||||
3. 手写选定功能的 amis schema:`crud`(列/查询区/工具栏按钮,对照模板 XML 的 display/search/button)+ 主子表(行展开或 form 内 `input-table`)。
|
||||
4. **校验闭环**:用 ajv(draft-07)加载存档的 `schema.json`,对手写及 AI 生成的页面 schema 做机器校验,记录误报/漏报。
|
||||
5. 产出 **XML→amis 映射表**:模板 XML 每个元素/属性 → amis schema 对应物 → 映射难度标记(自动转/半自动/人工),这是 P4 批量转换器的种子。
|
||||
|
||||
### 4.2 还原度评分卡(对照旧系统逐项打分:0 不可用 / 1 有差距 / 2 等价)
|
||||
|
||||
| 项 | 旧系统行为 | 得分 |
|
||||
|----|-----------|------|
|
||||
| 列表列渲染(含字典翻译、格式化) | | |
|
||||
| 查询区(含默认值、联动过滤) | | |
|
||||
| 主子表级联编辑与保存 | | |
|
||||
| 工具栏按钮 + 权限位 | | |
|
||||
| 表单校验(对照「校验器」配置) | | |
|
||||
| 分页/排序/列宽 | | |
|
||||
|
||||
**证伪条件**:总分 < 满分 60%,或出现「无 amis 对应物且自定义组件工作量 > 3 人日」的必需交互 ≥ 2 项。
|
||||
|
||||
---
|
||||
|
||||
## 5. WS3:Groovy 脚本双轨验证(Q3)
|
||||
|
||||
**负责**:后端 | **工期**:Day 4–5
|
||||
|
||||
1. **S1 轨(零翻译)**:取选定功能的 1 个纯服务端脚本(校验/计算类),在新服务的 `ScriptingEnginesManager`(JSR-223 + Groovy 4.x)上原样执行,对拍输出。预期:除 Groovy 2→4 语法边角(如 `@TypeChecked` 行为、JDK 内部 API)外零修改。
|
||||
2. **S2 轨(声明式翻译)**:取 1 个真实 valueChange 联动脚本,翻译为 amis `onEvent` + 表达式,旧新行为录屏对照。
|
||||
3. **S3 轨(facade 最小实现)**:预核查已确认平台自带「准 facade」——脚本经 `DEFAULTFUNCTION` 注入的 4 个辅助函数(`getFieldValue`/`bindField`/`setFieldReadOnly`/`showConfirmDialog`)全部委托 `FormEngineUtil`,且绑定契约只有 `group`/`po`/`event`/`obj` 四个变量。本轨直接做 `FormEngineUtil` 的 amis 版最小实现:保持 4 个函数签名不变,实现改为「生成 amis 事件动作指令下发前端」,用 1 个真实脚本跑通。重点验证 `showConfirmDialog` 类同步交互改回调链的可行性。
|
||||
|
||||
**证伪条件**:S1 脚本在 Groovy 4 上需要实质性改写(不只是边角语法);或 facade 指令通路在 amis 事件模型上无法表达「脚本中途读取用户输入再继续」类交互(同步阻塞语义)——此时 S3 全量降级为人工翻译,需带回 2.2 的占比数据重估工期。
|
||||
|
||||
---
|
||||
|
||||
## 6. WS4:Flowable 迁移实操(Q4)
|
||||
|
||||
**负责**:后端 | **工期**:Day 5–6
|
||||
|
||||
1. Flowable 7.x 开源版独立部署(Docker + PG,启用 REST API)。
|
||||
2. 将脱敏库的 ACT_* 表整体指给 Flowable,启用 `flowable5-compatibility`,验证:
|
||||
- 存量流程定义可见、可发起新实例
|
||||
- **运行中的旧实例**可继续办理至结束
|
||||
- 历史查询(已办/待办)数据完整
|
||||
3. 新服务通过 REST 完成一次「发起 → 审批 → 回写业务表」闭环(审批结果回写用事件/回调,验证与元数据服务的集成面)。
|
||||
|
||||
**证伪条件**:运行中实例续跑失败且无官方解法;或选定流程用到 Activiti 5 专有扩展(自定义 ServiceTask 类)无法在兼容层加载——后者需盘点全部流程定义中的 `activiti:class` 引用再评估。
|
||||
|
||||
---
|
||||
|
||||
## 7. WS5:AI 闭环冒烟(半天,Day 6)
|
||||
|
||||
**负责**:架构 | 目的:给「AI 友好度 8.5 分」找实证,不追求完整 MCP Server。
|
||||
|
||||
1. 写一个最小 MCP Server(或直接给 Claude Code 提供 OpenAPI 文档 + schema.json + 映射表作为上下文)。
|
||||
2. 任务:「新增一个实体(含 5 个字段)+ 生成其管理列表页」。
|
||||
3. 记录:成功率(3 次尝试)、人工干预次数、ajv 校验拦截了多少无效生成。
|
||||
4. 关注点:929KB 的 schema.json 不能整体进上下文——验证「按组件子集裁剪 schema」的可行性,为 P5 的提示词工程定基调。
|
||||
|
||||
---
|
||||
|
||||
## 8. 日程总表
|
||||
|
||||
| 日 | 后端 | 前端 | 架构 |
|
||||
|----|------|------|------|
|
||||
| D0 | 盘点 SQL + 脚本分桶 | 环境/amis 跑通 demo | 选定典型功能、对拍方案设计 |
|
||||
| D1 | WS1 步骤1–3(工程+拷代码+去OSGi) | 研究模板 XML 结构 | — |
|
||||
| D2 | WS1 步骤4–6(打桩+jakarta+JDBC升级) | WS2.3 手写 amis schema | — |
|
||||
| D3 | WS1 步骤7 + 旧系统 SQL 录制 | WS2.1/2.2 REST 对接 | 对拍框架就位 |
|
||||
| D4 | WS1 对拍修差异;WS3 S1 轨 | WS2.4 校验闭环 | — |
|
||||
| D5 | WS3 S2/S3 轨 | WS2.5 映射表 + 评分卡 | WS4 Flowable 部署 |
|
||||
| D6 | WS4 兼容性验证 | 还原度终评 | WS5 AI 冒烟 |
|
||||
| D7 | 缓冲 + 报告 | 缓冲 + 报告 | 汇总评分、决策会材料 |
|
||||
|
||||
---
|
||||
|
||||
## 9. 决策会评分与裁决规则(D7)
|
||||
|
||||
| 工作流 | 通过标准 | 证伪后果 |
|
||||
|--------|---------|---------|
|
||||
| WS1 | 对拍 ≥ 95% 通过;OSGi/Spring 改造量在移植范围 30% 以内 | **回退路线 A(NestJS 重写后端)**,前端结论沿用 |
|
||||
| WS2 | 还原度 ≥ 60%;校验闭环可用 | A 与 A' 同时受损 → 触发前端二次选型 |
|
||||
| WS3 | S1 零翻译成立;facade 通路证明存在 | S3 全量人工翻译,按分桶占比重估工期,可能上调 2–4 人月 |
|
||||
| WS4 | 存量实例续跑成功 | 改为「老流程旧系统跑完、新流程 Flowable」双轨过渡 |
|
||||
| WS5 | 3 次尝试 ≥ 2 次成功 | 不否决路线,但 P5 工期上修并前置提示词工程 |
|
||||
|
||||
**全局规则**:WS1 与 WS2 任一证伪 → 当场按决策报告第三节的回退矩阵改道,不二次延期 PoC。
|
||||
|
||||
---
|
||||
|
||||
## 10. 交付物清单
|
||||
|
||||
1. PoC 决策会报告(评分卡 + 录屏 + 对拍 diff 报告)
|
||||
2. Groovy 脚本分桶盘点报告(S1/S2/S3 数量、占比、Top 风险脚本清单)
|
||||
3. XML→amis 映射表 v0(P4 转换器的输入)
|
||||
4. SQL 对拍测试框架(P1 阶段持续使用)
|
||||
5. `eip4-poc` 代码仓库(标注哪些可进正式工程、哪些抛弃)
|
||||
6. amis 6.13.0 + schema.json 锁定存档与 fork 维护成本测算备忘(供管理层做 fork 预算对齐)
|
||||
BIN
docs/决策与盘点/EIP3重构评估报告.docx
Normal file
BIN
docs/决策与盘点/EIP3重构评估报告.docx
Normal file
Binary file not shown.
120
docs/决策与盘点/EIP4前端与收尾实施计划.md
Normal file
120
docs/决策与盘点/EIP4前端与收尾实施计划.md
Normal file
@@ -0,0 +1,120 @@
|
||||
# EIP4 前端与收尾实施计划(F 阶段)
|
||||
|
||||
> 日期:2026-06-11
|
||||
> 性质:P4 收口后的后续开发计划,接力《EIP3工程化实施计划.md》(PoC→P4 已全部完成)
|
||||
> 现状基线:只读切流端到端链路已闭合(见 `docs/P1/P4收口简报.md`);本计划覆盖前端成品化、写路径、脚本收尾、低代码工具链与模块化/升级架构
|
||||
> 已拍板:原型缺失场景由 Claude Code 自行设计实现,不再走 claude-design(2026-06-11)
|
||||
|
||||
---
|
||||
|
||||
## 一、现状基线(一段话)
|
||||
|
||||
PoC/M0/P0'/P1/P2/P3/P4 全部技术阶段完成:元数据/权限/组织/流程后端移植并对拍通过,1,516 模板批量转换闸一 98.2%(1,489 产物入 SYS_PAGE_SCHEMA),1,427 条脚本全量产出(自动化率 81.2%),Flowable 升级链可用,eip4-web 具备登录/待办/页面渲染三页脚手架。本地开发库 eip4dev 已建成(2.7GB,dev profile,8093),5435 收敛为对拍真值/性能基线/刷新源。剩余技术工作全部在前端成品化与三类收尾上;非技术依赖(S1 决策、检查点评审、商务开放项)单列第七节。
|
||||
|
||||
## 二、阶段总览
|
||||
|
||||
| 阶段 | 主题 | 核心出口判据 | 门控 |
|
||||
|------|------|--------------|------|
|
||||
| F1 | 应用壳 + 只读完整体验 | 全量 1,489 schema 页可浏览,壳层成品 | 无(可立即开工) |
|
||||
| F2 | 写路径闭环 + 脚本三缺口 | 首个模块(oa)真实可用 | 无 |
|
||||
| F3 | 153 重写 + 报表四类 | 重判清单交付(重写23/降级97/留旧30/废弃3) | **S1 止损评审会三选一** |
|
||||
| F4 | 低代码工具链 L1→L3 | 设计器存盘走标准/overlay 双层协议 | 无(架构已拍板) |
|
||||
|
||||
F1/F2 串行为主;F4-L1(editor 二开)可与 F2 并行;F3 随 S1 决策落地后插入。
|
||||
|
||||
## 三、F1:应用壳 + 只读完整体验
|
||||
|
||||
目标:支撑检查点②只读切流的「产品级」前端。
|
||||
|
||||
1. **壳层直接迁移 claude-design 原型**(评审结论:75 分,沿用不重设计):
|
||||
- 迁移源:`claude-design-设计输入包/EIP4架构原型/eip4/{frame,ui,app}.jsx`
|
||||
- 迁移件:顶栏/三级侧栏/多 Tab 工作区/全局搜索(frame.jsx)、Icon/Dialog/Drawer/Toast/分页等基础组件(ui.jsx)、CSS 变量主题四维可调(app.jsx)、工作台首页与待办中心(screens-home.jsx)
|
||||
- 业务页(M1/M2/M7 等)原型仅作视觉基准,落地一律走 amis schema,不照搬 React 原生写法
|
||||
2. **schema 页全量接入**:菜单树(按权限裁剪)→ /api/page/schema/{id} 全量可达;937 个依赖 picker 的模板验证选择窗链路
|
||||
3. **framework 系统管理页**:用户/角色/菜单/数据权限维护界面(后端能力 P2 已有,纯前端补齐)
|
||||
4. **原型缺失场景自行设计**(已拍板不走 claude-design):用户-角色-菜单三维权限分配页、数据字典管理、消息中心;遵守 amis 边界(列冻结/日历多事件不可用,见设计输入包 02 约束)
|
||||
|
||||
出口判据:真实账号登录 → 菜单全量可浏览 → 任一 schema 页渲染取数(行级权限生效)→ 待办跳转业务页,playwright 回归全绿。
|
||||
|
||||
## 四、F2:写路径闭环 + 脚本三缺口
|
||||
|
||||
目标:第一个模块端到端真实可用(建议 oa 先行,见第五节顺序)。
|
||||
|
||||
1. **CRUD 写闭环**:amis form 提交 → 元数据写路径(含校验/数据权限写侧判定)→ 审批办理动作 → 附件上传(P2 横切件已真实现,FTP→本地盘口径)
|
||||
2. **脚本三缺口**(与写路径同期,因脚本联动多发生在表单编辑场景):
|
||||
- **WS3 函数库回迁**:GetServicesFunction 等约 2,600 行 Groovy 函数库目前仅 findCount 最小桩(迁移手册 §111);612 条 S3 中仅 296 条 facade-only 可直接跑,全量可用以此为前置
|
||||
- **115 份人工作业单**(PARTIAL 30 + HARD 85,`tools/s3_rewriter/output/manual_workpackage/`):盘点口径 0.5–1 人月,上界 2.8 人月
|
||||
- **FULL_AUTO 批量回归**:497 条目前仅 6 条集成挑样 + 2 模板端到端,需批量跑一遍
|
||||
3. ProjectSwitchService 桩真实现(P2 遗留唯一桩)
|
||||
4. **前端产品化工作线(2026-06-11 补充显式化,此前被折叠在后端任务里)**:
|
||||
- 审批办理 UI(办理/驳回/转办/意见/流程轨迹时间线)——oa 端到端前置
|
||||
- 表单写体验闭环(后端校验错误→amis 行内展示/附件控件/保存反馈/403 友好提示)
|
||||
- 选择窗完整化(type101 树形/多选/搜索回填,937 模板依赖)
|
||||
- 系统管理写操作 + 用户组-角色-菜单三维分配页
|
||||
- 消息中心与工作台通知(API+UI)
|
||||
- 后续:报表体验验证修缮(F3)、amis-editor 二开与 L2/L3(F4)、移动端(F5,原型 mobile.jsx 已有设计)
|
||||
- **2026-06-12 用户拍板:移动端(F5)后置不做适配;优先级=UI 基本操作全面正常(F2-17 操作级巡检清单)**
|
||||
|
||||
出口判据:oa 模块新建→审批→归档全链路真实数据闭环(含办理 UI,非仅 API);脚本批量回归报告产出。
|
||||
|
||||
## 五、模块推进顺序与「完成」定义
|
||||
|
||||
策略:**只读横向铺开(F1 一次性全模块),写路径按模块纵向推进**。
|
||||
|
||||
写路径顺序及理由:
|
||||
1. **oa**——审批/待办最通用,P3 流程链路已通,最先形成完整体验
|
||||
2. **pm**——客户核心业务;性能优先实体 PM_CONTRACTBALANCE/PM_PAYMENTAPPLY 在此,索引/参数化改造同期做
|
||||
3. **hr**——HR_ATTENDLOG 等大表多(923ms 问题实体),与流式改造合并
|
||||
4. **dm**——最后
|
||||
|
||||
模块「完成」定义:该模块全部模板可用 + 脚本动作可重放 + 审批闭环 + 该模块 153 重写项交付。
|
||||
|
||||
## 六、模块化授权与升级架构(已拍板 2026-06-11)
|
||||
|
||||
> 6.1/6.2 已获认可,作为打包方式与 F4 设计器存盘协议的既定架构。
|
||||
|
||||
### 6.1 模块授权:全量打包 + 运行时授权裁剪
|
||||
|
||||
- 不回 OSGi 动态装卸;所有客户同一 jar,license/配置驱动模块开关
|
||||
- 三层一致裁剪:菜单不下发 / API 按模块前缀(HR_/PM_/OA_/DM_)拦截 403 / schema 接口不下发
|
||||
- 模块内功能级授权沿用已移植的角色-菜单权限 + SYS_FILTERRULE 体系(P2 对拍 100%),不新发明
|
||||
- 数据库全量建表不裁剪(未授权模块表空置),换取升级脚本对所有客户统一
|
||||
|
||||
### 6.2 升级:标准/overlay 双层 + 版本化 DDL
|
||||
|
||||
- 老 EIP3 教训:153 模板中 119 个带「五建/定制」,标准与定制混杂导致无法升级
|
||||
- **SYS_PAGE_SCHEMA 加来源标记:标准产物层 + 客户 overlay 层**;升级时标准层整体替换,overlay 保留并提示 diff;设计器改页 = 自动落 overlay
|
||||
- DDL 增量 Flyway 版本化(P1 DDL 生成器产出纳入版本链);平台版本与各模块 schema 版本分记,升级工具先做兼容检查(推广 Flowable Runbook 思路)
|
||||
|
||||
### 6.3 无定制代码功能的在线导入发布(方向成立,细化设计随 F4)
|
||||
|
||||
- **结论:可行**。无定制 Java 代码的功能 = 纯元数据资产包(实体定义+DDL+页面 schema+改写后脚本+流程 BPMN+菜单/权限配置),全部以 DB 行/Flowable 部署形态存在,理论上不停机导入发布——这是元数据驱动架构相对老 OSGi 热插拔的等价红利
|
||||
- **四个前置条件**:
|
||||
1. **缓存失效闭环**:~~须先修~~ **复核后确认 P1-4 已整体闭环**(迁移手册 §5.20:`PoInfoCacheInvalidator.evictByTable` 解决冷态 id_cache 问题,接入 MetaController + `POST /api/meta/evict/{table}` 运维出口,8086 实测不重启生效);在线发布只需导入器在发布动作里调用该失效出口,验收判据仍为「导入后无需重启生效」
|
||||
2. **DDL 只允许加法在线**:新建表/加列在线执行;改列/删列等破坏性变更一律走升级窗口(锁表与数据迁移风险)
|
||||
3. **脚本导入安全纪律**:包内 Groovy 随导入入服务端产物库,按 templateId/seq 引用执行(沿 P4-5 无注入面口径),禁止任何前端直传脚本文本路径;导入包建议签名+导入审核
|
||||
4. **落层与依赖校验**:导入包必须标记落「标准层」或「客户 overlay 层」(衔接 6.2);导入前校验依赖的实体/枚举/picker 存在性,导入事务原子可回滚;发布建议草稿→发布两态(SYS_PAGE_SCHEMA 已有 ETag,可扩 status)
|
||||
- 实装排期:包格式定义与导入器随 F4-L1 设计器一并做(设计器「另存为包」与「导入包」同一套协议)
|
||||
|
||||
## 七、F3 / F4 与外部依赖
|
||||
|
||||
### F3:153 重写 + 报表四类(门控:S1 评审会)
|
||||
|
||||
- 源码已定位(`/Users/zhengwr/workspace/EIP-3.0`,152/153 匹配),重判 7.56 人月、硬成本 3.57 逼近止损线
|
||||
- 评审会三选一:分期 / 第三方组件 / 扩预算——**这是唯一卡技术线的外部决策**
|
||||
|
||||
### F4:低代码工具链(L1→L3,设计器非切流前置)
|
||||
|
||||
- **L1 页面设计器**:amis-editor 二开(amis-fork 已在 workspace);二开点 = 数据源对接元数据实体、存盘走 6.2 双层协议、32 个 facade 动词的 onEvent 配置面板。可与 F2 并行
|
||||
- **L2 实体建模器**:可视化维护 SYS_ENTITY/属性/枚举/过滤规则(后端 P1 已有,纯界面)
|
||||
- **L3 流程设计器**:bpmn.js + Flowable 部署接口;短期新流程用 Flowable Modeler 顶
|
||||
|
||||
### 外部/人工依赖清单(不卡 F1/F2 开工)
|
||||
|
||||
S1 止损评审会(卡 F3)、检查点①②评审、商务开放项 1/3、JOR 文件系统侧清点、11 个引擎缺陷旧系统同病验证、58 个零引用视图老员工区分、27 空 XML 孤儿定性、EIP-3.0↔目标客户版本对应确认。
|
||||
|
||||
## 八、环境口径
|
||||
|
||||
- 日常开发:localhost:5433/**eip4dev**(dev profile,8093);`tools/local-devdb/build_devdb.sh` 一键重建
|
||||
- 5435(20.68)仅三用途:对拍真值基线 / 性能基线(3 巨表与 ACT_ 本地 schema-only,考勤/实名制/流程历史性能必须回 5435)/ eip4dev 刷新源
|
||||
- 连 5435 必须 `dbname=postgres¤tSchema=eip3`(ceshi 库是不完整副本,禁用)
|
||||
Reference in New Issue
Block a user