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

9.1 KiB
Raw Permalink Blame History

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 变更预告 + 停机窗口预约(商务口径按纪要第六节)

计划维护:本计划随检查点①②③滚动修订;任何止损线触发即冻结当前阶段并升级决策层。