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>
135 lines
18 KiB
Markdown
135 lines
18 KiB
Markdown
# 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 预算认知对齐。 |