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

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