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

135 lines
18 KiB
Markdown
Raw 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 重构架构路线最终决策报告
## 一句话裁决
**采纳「路线 A' = amis 前端 + Java/Spring Boot 自研元数据后端」作为主路线**(即在报告原路线 A 的基础上,把后端语言从 Node.js/NestJS 改回 JVM,保留并升级既有 Spring 服务端资产);路线 B(NocoBase 二开)降为「仅当 A'/A 的 PoC 失败、且 NocoBase 给出书面 OEM 转售授权」时启用的备选,原路线 A(amis + NestJS)不再作为独立首选。
裁决一句话逻辑:**amis 的官方 JSON Schema 闭环(重构首要目标的唯一确定性载体)只对前端有要求,对后端语言中立;而 EIP3 最核心、风险最高的资产(POJOCRUDService 动态建表引擎、数据权限织入、JVM 内执行的 Groovy 脚本、Activiti→Flowable 迁移)全部在 JVM 上保真度最高、迁移成本最低、且团队技能匹配。把后端钉死在 Node 是报告里一个未经技术论证、且与团队画像冲突的选择。**
---
## 一、加权决策矩阵
### 权重设定(按本次重构目标定权)
| 维度 | 权重 | 定权理由 |
|---|---|---|
| AI Agent 友好度 | **0.35** | 报告白纸黑字的「重构首要目标」,必须权重最高 |
| 技术与迁移风险 | **0.30** | EIP3 在客户生产环境活跃运行,迁移翻车即数据事故;「真实表零迁移+审批迁移」是命脉 |
| 总拥有成本与商务模式 | **0.20** | 集成商多客户复制模式下,授权条款有放大效应,直接决定能否赚钱 |
| 团队技能与长期演进 | **0.15** | 决定 10 年维护可持续性,但可通过招聘/外包部分缓冲,权重次之 |
### 各维度评分(A、B 沿用四视角原始分;A' 由本裁决基于源码实证与四视角逻辑推导给出,并标注调整依据)
| 维度(权重) | 路线 A (amis+NestJS) | 路线 B (NocoBase) | **路线 A' (amis+Java/Spring Boot)** |
|---|---|---|---|
| AI 友好度 (0.35) | 8.5 | 6.0 | **8.5**(与 A 同:AI 闭环属前端 Schema + REST 契约层,与后端语言正交;Spring 侧有 springdoc-openapi、Spring AI MCP、JSON Schema 校验库,能力等价,仅 MCP TS 生态略成熟,扣分忽略不计) |
| 技术与迁移风险 (0.30) | 7.0 | 3.5 | **8.5**(显著高于 A:服务端可做「同语言、同 SQL 方言对拍测试」,POJOCRUDService 行为等价性验证成本全场最低;纯服务端 Groovy 零翻译续跑;Flowable 同栈嵌入少一层集成面。扣分项为 Spring3.1/JDK6→Boot3/JDK17 跨度大、javax→jakarta) |
| TCO & 商务 (0.20) | 8.0 | 3.5 | **8.5**(略高于 A:Apache 2.0 + 自有 IP 零授权费的优势与 A 相同;但 A' 省掉「招 1-2 名后端 React/Node 工程师」的成本,团队即战力,乐观工期 4-6 人月 vs A 的 P1-P3,一次性 TCO 更低) |
| 团队技能与长期演进 (0.15) | 7.0 | 4.5 | **8.0**(高于 A:后端不转栈,团队对最核心资产「动态 SQL 引擎/数据权限织入」保持内行;前端 amis fork 风险与 A 相同,故未给满分) |
### 加权总分
| 路线 | 计算 | **加权总分** |
|---|---|---|
| **A' (amis + Java/Spring Boot)** | 8.5×0.35 + 8.5×0.30 + 8.5×0.20 + 8.0×0.15 | **8.43** |
| A (amis + NestJS) | 8.5×0.35 + 7.0×0.30 + 8.0×0.20 + 7.0×0.15 | **7.73** |
| B (NocoBase 二开) | 6.0×0.35 + 3.5×0.30 + 3.5×0.20 + 4.5×0.15 | **4.53** |
**结论:A' (8.43) > A (7.73) > B (4.53)。** A' 与 A 在首要目标(AI 友好度)上完全打平,A' 的优势全部来自「后端不跨语言重写」带来的迁移风险下降、TCO 下降、团队匹配上升——这正是把后端从 Node 改回 Java 的全部收益。B 在除 AI 现成度外的所有维度上结构性落后,且 AI 现成度的优势又被「无官方公开校验 Schema」抵消(见下)。
---
## 二、正面回应三类关键质疑
### 2.1 事实核查中被推翻 / 部分推翻的报告论断
**(a) 「NocoBase = AGPL+商业双授权」——已过时,必须修正。**
事实:NocoBase 于 2026-02(v2.0.3)将核心改为 **Apache-2.0 + 自定义补充条款**,AGPL 传染性对新版本消除。报告中「AGPL 影响报价模型」「二开交付需开放源码」的法律顾虑已不成立。
**但这不利好 B、反而暴露了更硬的红线**:补充条款 7.3/7.4 明文禁止「向公众转售/提供基于本软件的低代码/AI 平台 SaaS/PaaS」,7.5/7.6 规定「交付物若授予客户配置权限,客户须各自购买商业授权」。**EIP3 的本质就是交付「带数据字典动态建表的低代码平台能力」给客户继续配置**——这恰好落在禁止条款的字面射程内。因此:协议从 AGPL 改 Apache **降低了源码开放风险,却抬高了「平台级转售」的合同定性风险**,对 B 是中性偏负,对 A/A'(amis 纯 Apache-2.0 无此约束)是相对利好。报告必须把表述更新为「Apache-2.0+补充协议」,并把这条红线列为 B 的拍板前置门禁。
**(b) 「amis 持续发版、活跃」——不成立,且是现在进行时的硬风险。**
事实:最后稳定版 6.13.0 停在 2025-08-12(距今 10 个月),默认分支 2026-03-18 后近 3 个月零提交,1711 open issues,7.0 难产,核心贡献者 bus factor≈1。**这是对 A/A' 共同的、最严重的削弱**:选 amis 必须按「未来自行长期 fork 维护一个冻结的大型 React 渲染器」编列预算,不能假设上游会修 bug / 适配新 React。
**但杀伤力取决于组织预期而非技术本身**:amis 渲染器本体成熟(50+ 控件、schema.json 929KB/301 定义可用),EIP3 自己就在 EOL 的 Vaadin 7 上稳定跑了 7 年——该组织本就接受「冻结栈」模式。对一个「只用现成控件、不追新」的企业内部系统,冻结在 6.13 可运行多年。**这把「致命」降级为「重大但可管理」,前提是决策层明确接受 fork 维护编制。**
**(c) 「社区 LLM 生成 amis 已成熟」——不成立。** 只有零散博客与周边工具,无成熟开源管线。意味着 A/A' 的提示词工程、组件级 schema 裁剪(929KB 全量不能直接塞 LLM 上下文)、校验-重试管线都需自研。报告 P5 给 0.5-1 人月明显低估,应上修。
**(d) Flowable 兼容 Activiti 5.14——确认属实(confirmed)。** 这是全场最稳的一块:v5 兼容层延续到 8.0.0,运行中实例可就地升级、逐定义灰度切流。**此结论对 A' 是最大加分**:Flowable 是 Java,可与 Spring Boot 同进程内嵌或同栈独立 REST 服务,迁移工具链在 JVM 内最成熟,比 Node 后端跨语言调用少一层集成面。对 B 则相反:NocoBase 自有 trigger+node 引擎非 BPMN、无导入路径,存量流程必须人工重建模、历史实例基本弃置。
**(e) Frappe 排除——确认成立(confirmed)。** PG 在 Frappe 仍是 beta/experimental,v15/v16 官方明确无转正计划。Frappe 正式出局,无需再议。
### 2.2 对抗辩护中「未被化解」的攻击——逐条认领
| 攻击点 | 是否被化解 | 裁决处理 |
|---|---|---|
| **amis 上游停摆 vs 生态红利预期**(针对 A/A') | **未被化解** | 这是唯一「条件致命」缺陷。无纯技术解,只能靠组织自觉接受 fork 编制。**已计入裁决:把它列为拍板前置认知对齐项 + 触发重新决策条件 #1。** |
| **长期 TCO 中「每年 1-2 人 fork 维护编制」**(针对 A/A') | **难以消除** | 诚实承认。对策仅为「可被多客户摊薄」。A' 比 A 略优,因为后端维护由内行团队承担、不额外背 Node 技能债。 |
| **NocoBase「平台级转售」合同灰区**(针对 B) | **未被化解(除非签 OEM)** | 这是 B 的条件致命缺陷。**裁决:未拿到 NocoBase 书面 OEM/转售授权前,B 不得拍板。** |
| **NocoBase 外部数据源无 DDL → 零迁移承诺破产**(针对 B) | **半解(自写数据源插件=更深 fork)** | 技术上最接近致命。EIP3 命脉「SYS_ENTITY 元数据驱动真实表 DDL」在 NocoBase 外部源上不存在;自写插件复刻=拆东墙补西墙,加重 fork 漂移。**这是 B 在迁移风险维度仅得 3.5 的根因,裁决予以确认。** |
| **NocoBase 审批非 BPMN vs 已定 Flowable 原则**(针对 B) | **可解但崩估算** | 弃用 NocoBase 审批外挂 Flowable,则 Professional 版核心卖点作废、审批 UI 全自研,6-8 人月估算崩塌。 |
| **A' 的 Spring3.1/JDK6→Boot3/JDK17 跨度可能局部退化为重写** | **待 PoC 证伪** | 诚实标注(见第六节)。javax→jakarta、OSGi classloader 黑魔法可能渗入业务代码。**这是 A' 唯一需 PoC 实证的真实弱点。** |
### 2.3 「Java 团队却选 Node 后端」——这个矛盾点是本裁决推翻原路线 A 的核心
报告为 amis 配 NestJS **未给出任何技术必然性论证**。经辩护律师的源码实证:约 476 个 server 端 Java 文件中**仅 3 个 import Vaadin**;POJOCRUDServiceImpl(610 行实现)是纯 Spring `@Service/@Transactional`,依赖项全是同语言可搬的内部服务。这说明:
1. **「低代码生态在 JS 系」是排除 Go/Rust 全栈自研的理由,被错误外溢到了后端选型。** 前端选 amis(JS 系)是对的;后端跟着转 Node 是无依据的滑坡。amis 官方设计就是「厚前端薄后端」,对后端只要求 REST/JSON——Spring Boot + amis 是国内成熟常见组合。
2. **选 Node 把「跨语言重写」的全部成本凭空引入**:事务模型、连接池、动态 DDL、并发模型全不同,「只移植不重设计」在跨运行时下是伪命题。选 Java 则同一范围降级为「去 OSGi 化 + Spring 升级」,每步可与旧实现做同 SQL 对拍,行为等价性验证成本全场最低。
3. **「最大技术债」Groovy 的最优解在 JVM 而非翻译**:脚本经 JSR-223 在 JVM 服务端执行。后端留 Java 则纯服务端脚本(流程、校验)**零翻译续跑**,仅 UI 绑定脚本需把 FieldGroup 等换成面向 amis 事件上下文的兼容 facade(一次性框架工程)。Node 路线则 100% 脚本必须 Groovy→JS 逐个翻译并回归,客户生产在跑,翻错即事故。
4. **团队画像**:团队是 Java 背景,路线 A 已自认需补 1-2 名 React 工程师;若后端再转 NestJS,则**前后端双线技能断层**,团队对自己最核心的资产(动态 SQL 引擎、数据权限织入)交付后反成外行。
**结论:把后端钉死在 Node 没有技术必然性,且在迁移风险、TCO、团队三个维度同时劣于 Java。这是本裁决用 A' 替代 A 的全部依据。**
---
## 三、执行建议:是否仍需 PoC,证伪条件是什么
**仍需 PoC,但从「双路线 2 天」升级为「三路线、分轨证伪、约 1 周」。** 同一典型功能固定为报告建议的 **「主子表 + 审批 + 联动脚本」**,三轨并行:
| 轨道 | PoC 必做内容 | **证伪条件(出现即推翻本裁决)** |
|---|---|---|
| **A'(主裁决,重点验证)** | 将 POJOCRUDService + 数据权限切到 Spring Boot 3 / JDK17,跑通 1 个实体的 CRUD + REST/JSON Schema 门面;挑 1 个纯服务端 Groovy 脚本与 1 个 UI 绑定脚本做迁移验证 | **若发现服务端代码深度依赖 OSGi classloader 黑魔法或废弃 Spring API,致「升级」实质退化为「重写」,且工期逼近 Node 重写** → A' 的「干净起点」优势消失,回退到 A(Node 重写的「全新干净起点」反成优势) |
| **A(对照)** | 同一实体在 NestJS 上实现元数据 CRUD + amis 页面 schema.json 机器校验闭环 | 若 A' 被证伪,A 接棒为主路线(AI 闭环已验证可行) |
| **B(商业+技术双证伪)** | ① 技术:在 NocoBase 上**挂接一张 EIP3 已有物理表并尝试加字段**(直接验证外部源 DDL 缺口);② 商业:**并行向 NocoBase 索取覆盖「平台级转售+客户继续配置」的书面 OEM 报价与条款** | **只要满足任一**:挂接表无法经 NocoBase 加字段(DDL 缺口证实)/ NocoBase 拒绝给 OEM 或要价改变项目经济性 / 官方 Skills+MCP 无法以低错误率自主生成「主子表+审批+联动脚本」→ **B 永久出局** |
**什么样的整体结果会翻转本裁决:**
- A' 轨证伪(Spring 升级=重写)**且** A 轨 AI 闭环跑通 → 改选 **A**(首要目标仍达成,只是放弃后端保真度收益)。
- A' 与 A 两轨都因 amis 停摆 / 二开成本失控而不达标,**且** B 的 OEM 谈成、DDL 缺口可接受(接受一次全量数据迁移)→ 才考虑 **B**。
- 三轨皆不达标 → 触发「换其他 Apache 协议渲染层(如重新评估 Corteza/Vue 系)」的二次选型,不在本裁决射程内。
**PoC 检查单必须额外纳入**(来自核查与辩护):amis 上游活跃度复核、amis fork 维护年成本测算、Groovy 存量按「纯服务端 / UI 绑定」分桶量化、NocoBase 书面 OEM 条款。
---
## 四、触发重新决策的条件(命中任一即重启评估)
1. **amis 上游活跃度复核结论恶化**:若 PoC 期再次核查发现 amis 不仅停滞而是明确弃维护(如官方公告归档、issue 全面关闭),**且**决策层不接受「永久 fork + 终身自维护前端渲染器」的预算编制 → A/A' 前端根基动摇,须重评其他 Apache 协议渲染层。
2. **A' 服务端升级被 PoC 证伪**:Spring3.1→Boot3 升级实测退化为重写(OSGi classloader 渗透 / javax→jakarta 改造量爆炸)→ 由 A' 回退到 A(Node 干净重写)。
3. **Groovy 脚本盘点数量/性质越界**:P0 盘点若发现 UI 绑定脚本占比远超预期(如 >70%)且大量依赖 Vaadin 运行时对象的不可表达副作用 → facade 方案失效,翻译成本失控,需重估前端事件模型甚至重谈整体工期。
4. **NocoBase OEM/授权谈判结果**:仅当 A'/A 两轨均失败、B 被迫复活时——若 NocoBase 拒绝书面 OEM、或每客户授权(Professional $8,000 起)使多客户报价模型不成立 → B 直接否决。
5. **客户数预期发生结构性变化**:若公司实际交付从「多客户项目制」收敛为「仅服务 1-2 个锁定客户」→ B 的每客户授权费失去放大效应,TCO 维度结论可能反转,须重算矩阵(此为 B 唯一可能翻盘的商业前提)。
---
## 五、与已定架构原则的一致性确认
本裁决与报告「确定原则」完全兼容,且 A' 比原 A 更顺:
- **绞杀者模式新旧并行切流** → A' 第一步「给现有 Spring 服务加 REST/JSON Schema 门面」即天然的绞杀者 facade,切流粒度可比 A 更细、每步可回退。
- **PostgreSQL 主库** → A' 自研 Java 元数据服务直接复用 SYS_ENTITY 与既有 PG 物理表,「真实表零迁移」在 A' 上真实成立(这是 B 做不到的)。
- **Flowable 独立工作流服务** → A' 同为 JVM,集成面最小,原则落地最自然。
- **页面与实体定义统一 JSON Schema** → 前端 amis 官方 schema.json + 后端 springdoc/JSON Schema 校验库,双闭环统一,与后端语言无关。
---
## 六、诚实标注:本裁决依据不足 / 仍有不确定性的部分
1. **A' 的服务端升级成本是「乐观推断」,未经实测。** 「4-6 人月、可对拍测试」建立在「仅 3 个文件 import Vaadin、POJOCRUDService 是纯 Spring」的源码核查上,但 Spring3.1/JDK6→Boot3/JDK17 的 javax→jakarta、AOP/事务语义差异、OSGi 类加载是否渗入业务代码**均未验证**。这是本裁决最大的不确定点,PoC 轨道 A' 就是为证伪它而设。若它被证伪,主路线应即时切回 A。
2. **amis「冻结仍可用」的判断依赖组织风险偏好,非客观结论。** 「EIP3 在 Vaadin 7 上跑了 7 年 = 组织接受冻结栈」是类比推理,不等于管理层愿意为前端 fork 长期编列预算。这一项必须在拍板前与决策层正面对齐,而非由架构层替其决定。
3. **A' 的 AI 友好度给 8.5(与 A 持平)含一处乐观成分。** MCP 的 TypeScript SDK 与 amis 官方工具链生态确实比 Spring AI MCP 成熟,存在「成熟度时间差」。判断这是时间差而非能力缺口、可被薄适配层吸收——但此结论未经实测,若 Spring 侧 MCP 落地遇阻,A' 在首要维度可能比 A 低 0.5-1 分(不改变排序,但缩小与 A 的差距)。
4. **四视角原始分中 A/B 的部分打分基于「报告事实」,而部分报告事实已被核查推翻**(如授权模式、amis 活跃度)。本裁决已在能识别处做了修正(如 B 的授权风险重新定性、amis fork 成本计入 A/A'),但四视角评分者当时是否已知最新事实无法逐项追溯,故 A/B 原始分存在「基于过时前提」的残余误差,A' 分数为本裁决推导、误差同源。
5. **NocoBase 的真实存续性与 OEM 谈判结果完全未知。** 「无融资 bootstrapped、年营收约 145 万美元」既可解读为「健康盈利」也可解读为「无资本缓冲」,10 年企业级维保承诺能否兑现无法判定。由于 B 已非主路线,此不确定性不影响裁决,但一旦 B 复活必须前置尽调。
6. **Groovy 存量规模在 P0 盘点前是开放变量。** 「纯服务端脚本零翻译」的收益大小取决于服务端/UI 绑定脚本的真实比例,盘点前无法量化 A' 相对 A 在 Groovy 维度的确切优势幅度——本裁决给 A' 迁移风险 8.5 已部分依赖「服务端脚本占相当比例」这一未证假设。
---
**交付物结论**:主路线 **A'(amis + Java/Spring Boot 自研后端)**,加权 8.43,领先 A(7.73)与 B(4.53)。立即执行三轨 PoC(A' 重点、A 对照、B 商业+DDL 双证伪),以第三节证伪条件为准;命中第四节任一条件即重启决策。报告须先行修正「NocoBase=AGPL 双授权」与「amis 持续活跃」两处过时事实,再提交决策层做 fork 预算认知对齐。