> 本文整理自平台文档 docs/wujies/5.x/introduction/what-is-wujies.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-3b2bbce52f33-cover.svg)
有人问你「这是个框架还是带商城的 CMS」,或者你手上正有一个功能要决定写进宿主还是做成可卸载的应用,这页给你能拿去回答的依据。
一句话定性:底座留在宿主,业务能力做成可安装、可卸载、可单独升级的应用。这条边界落在工程结构上(不同仓库、不同构建、不同交付物),靠约定维持不了三个月。
三块代码,各归谁
| 一块 | 里面有什么 | 在哪个仓库 | 交付方式 |
|---|---|---|---|
| 宿主底座 | 用户、部门、角色、菜单、租户、字典、参数、日志、文件存储、缓存、鉴权、工作流 | wujies-platform/ | 随平台一个 fat jar |
| 平台自研扩展 | 应用市场与插件运行时(wujies-app-market)、上架判据内核(wujies-market-core)、号码认证、消息中心、地区、待办 | 同上 | 同上,改它要重建宿主 |
| 应用 | 商城、会员、支付、图床、考试、内容中心等垂直功能 | plugins/wujies-<code>-plugin/,一个应用一个仓库 | 签名的应用包,运行期装进任意部署 |
上游 RuoYi-Vue-Plus 的能力属于第一块,平台在第二块里加了自己的东西,逐项清单见[与上游 5.X 的差异](/docs/wujies/5.x/introduction/differences)。
划界的判据只有一句
这段代码是不是每个部署都必须有? 必须有的留在宿主;可能有的做成应用。
这句话决定了三件事跟着走:
- 菜单:底座菜单由平台初始化 SQL 种,应用菜单由那份应用的清单声明(
app.json的menus→AppMenuPlanner幂等 upsert),手写INSERT INTO sys_menu属于越界; - 表结构:底座表在
script/sql/platform_init.sql,应用表在应用包的migrations/*.sql; - 升级:改底座要重建并重启宿主,改应用只需要装一个新包。
判据落到代码上的效果,可以在工作区里直接验:平台源码里没有任何一条 import cn.wujies.<app>.*。
# 在 wujies-platform 下执行;排除 target 与 docs/removed 存档后应无输出
Get-ChildItem . -Recurse -Include *.java |
Where-Object { $_.FullName -notmatch '\\target\\' -and $_.FullName -notmatch '\\docs\\removed\\' } |
Select-String -Pattern '^import cn\.wujies\.(cms|gallery|exam|im|pay|quote|social|mall|member|enterprise|hello|finance|license)\.'
命中的字符串只会出现在注释、日志文案与测试断言里。这条约束带来的直接结果:新增一个业务应用不需要动平台一行代码。
一个应用包含四件东西
装一个应用等于交付一整套垂直功能,四件东西都在那个应用自己的仓库里:
| 件 | 位置 | 装上去之后发生什么 |
|---|---|---|
| 后端 jar | src/main/java/cn/wujies/<code>/** 与 resources/mapper/<code>/*.xml | 独立类加载器 + 独立 Spring 子上下文,路由挂进宿主拦截器链 |
| 前端产物 | frontend/(Vite 工程,构建出独立 ESM) | 落进 /remote-apps/<code>/,后台点菜单时运行期 import() |
| 迁移脚本 | migrations/*.sql | 安装、升级时按文件名顺序执行;同时是「彻底删除」时该 DROP 哪些表的唯一依据 |
| 清单 | app.json(code / version / type / assets / menus / dependencies) | 决定装什么、菜单长什么样、必须先装谁 |
四件东西里 appCode 出现的位置是同一个约定的四处:清单的 code、前端 defineRemoteApp({ appCode })、落位目录名、后端拼给前端的入口 URL。改一处不改其余三处,症状是菜单点不开且不报错。
当前十三个应用的分工、依赖顺序与许可档位都在[应用清单](/docs/wujies/5.x/plugins/),这页不重复那张表。要改应用的数量、版本、能力描述,改各仓的 app.json,别改文档。
只有一份代码
两条容易被误会的判断,写在这里是因为它们影响你怎么做部署决策。
档位是授权,不是部署形态。 社区版 / 专业版 / 企业版跑的是同一份代码、同一份构建产物。平台里已经没有 app-market.edition 这套双形态开关(official / client 两个形态、两套路由保护、两份构建在 2026-10-26 的减法里整块删除),代码里也不许出现 if (tier == PRO) 这类分支:档位差异只体现在那枚授权凭证的 apps 名单里,LicenseTier 枚举只用于出文案。买档位多送一个应用,是签发时往名单里多写一个编码,不用发版。细节见[授权与版本](/docs/wujies/5.x/license/)。
中心不是必需的。 应用目录(哪个应用有哪些版本、包在哪)默认由本部署自己持有。application.yml 的 app-market.catalog.base-url 与后台「系统管理 → 系统配置 → 应用中心」的 appmarket.catalogBaseUrl 这两层都留空时,这台部署没有任何中心可问,市场直接读本库 app_info,这就是单机自用的正常形态;AppCatalogApiController 的装配条件就是「这个地址为空」(@ConditionalOnExpression("'${app-market.catalog.base-url:}'.trim().isEmpty()"))。配上地址之后,安装侧改从中心上架服务读目录,本机只补开发台登记的草稿行。
一个已被整个推翻的旧结构
2026-09-30 之前的结构是「契约(实体 / BO / VO / Mapper 接口)放平台的 wujies-<app>-api 模块,实现放插件」。现在 wujies-platform/wujies-modules/ 下的模块只有五个:wujies-app-market、wujies-market-core、wujies-plugin-probe、wujies-system、wujies-workflow,*-api 的数量是 0,Mapper XML 也随插件 jar 走。
旧文档里「Mapper XML 必须留在 api 模块」那条同样不成立,照着走会走回头路。现行约束与它的原因见[必须遵守的不变量](/docs/wujies/5.x/platform/plugin/basics/invariants)。
什么情况下别用这套结构
这套改造付出了复杂度,只有下面几种情形值得:
- 一套代码要交付给多个客户,且客户之间要装的功能组合不同;
- 需要不停机地给线上环境加功能或升级某个模块;
- 要做应用市场或插件生态,第三方能独立发包、独立上架;
- 想把「平台」与「业务」的边界固化在工程结构上,而不是靠评审纪律维持。
反过来,两种情形请直接用上游:
- 一套系统服务一个客户、功能固定不扩展:类加载器隔离、子上下文管理、包签名校验这些机制对你纯属成本,用 RuoYi-Vue-Plus 更省事;
- 只想给自己项目多拆几个业务模块、并不打算分发:应用化买到的是分发与隔离,代码整洁是别的地方买来的。
还有一条要说在前面:clone 平台仓库就能改平台,但独立插件仓库要能构建,前提是把 wujies-plugins-parent 与 wujies-common-* 先 mvn install 进本地仓库,这批构件尚未发布到公共 Maven 仓库。各插件仓库 pom.xml 里那段注释写的就是这件事。
接下来
- [为什么这样设计](/docs/wujies/5.x/introduction/why-wujies):这三条判断怎么来的,代价是什么
- [核心概念](/docs/wujies/5.x/introduction/concepts):目录、安装实例、迁移记录这三类数据为什么要分清
- [项目结构](/docs/wujies/5.x/introduction/structure):仓库怎么摆、产物怎么进宿主
- [环境准备](/docs/wujies/5.x/introduction/prerequisites) → [快速开始](/docs/wujies/5.x/introduction/quickstart):先跑起来
- [我要写一个应用](/docs/wujies/5.x/platform/plugin/):清单 → 后端 → 前端 → 迁移 → 打包 → 上架
- [跟着 hello 读源码](/docs/wujies/5.x/platform/plugin/demo):不想读长文档就从可运行的范例入手
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-3b2bbce52f33-guide.svg)


评论区需要浏览器启用 JavaScript 才能加载。