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>
141 lines
10 KiB
Markdown
141 lines
10 KiB
Markdown
# 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/`。
|