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

10 KiB
Raw Blame History

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