SoybeanAdmin v3.0 计划

Author: honghuangdcCreated Aug 20, 2026Updated Sep 8, 2026

SoybeanAdmin v3.0 计划

核心差异

1. UI 组件库

  • v2: NaiveUI, Element Plus, Ant Design Vue独立仓库
  • v3: 核心 UI 使用 @soybeanjs/ui,并通过 UI 适配层支持接入 naive-ui / element-plus / antdv-next

2. 路由与页面缓存内核

  • v2: @elegant-router/vue
  • v3: ubean/client(从 ubean 提取的纯客户端内核,核心为 @ubean/vue),单实现、零双份维护;不再依赖 elegant-router

3. 构建工具

  • v2: 裸 Vite + 自定义脚本
  • v3: vite-plus(统一 dev / build / fmt / lint / test 入口)

4. 数据与接口

  • v2: ApiFox 在线 Mock
  • v3: 纯前端版本使用msw-openapi或者 Prism Mock(基于 openapi.json),ubean集成模式在 src/routes/ 直接编写内置接口

5. 后端对接

  • v2: mock 数据
  • v3: 对接真实后端(OpenAPI 类型生成 + @soybeanjs/fetch),无内置 Mock

6. 路由模式与页面目录

  • v2: 仅 file 模式,src/views/
  • v3: virtual / file / both 三种模式,src/pages/,布局自动扫描 src/layouts/,自动检测 404/loading/error.vue, 约定式"xx.reuse.ts"复用路由

7. 页面缓存与宏

  • v2: 组件 name 注入 + 自定义 tab store
  • v3: definePage({ name, path, layout, cache, meta, head }) + useCacheViews / resetRouteCache / getNamedPageWrapper

8. 全栈框架集成(新增)

  • v2: 无
  • v3: 可选集成ubean 元框架,获得 SSR / 文件式 API 路由 / 全栈能力(独立 SPA ↔ ubean 全栈可切换,共用同一路由内核)

9. 生态内部包

  • v2: 6 个 @sa/*
  • v3: 极简,复用 @soybeanjs/* + @ubean/*

10. 工程化

  • v2: 自定义脚本
  • v3: vite-plus 统一入口,@soybeanjs/cli 提交,引入 Vitest 单测 + Playwright E2E + GitHub Actions CI

详细方案见 v3方案