# 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/`。