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

141 lines
10 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 重构架构决策会纪要(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/`。