docs: 统一项目文档进 eip4-platform/docs + 新增进度路线总览
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:
2026-06-17 14:52:50 +08:00
parent 838669f124
commit 1b69f8b481
54 changed files with 7485 additions and 0 deletions

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