# 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/主子表/树/选择窗 + `` 段)→ 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 变更预告 + 停机窗口预约(商务口径按纪要第六节) --- **计划维护**:本计划随检查点①②③滚动修订;任何止损线触发即冻结当前阶段并升级决策层。