中国 帮助

这个项目是什么

说清 Wujies 里宿主、平台自研模块与应用三块代码各自管什么,并给出「该不该把功能做成应用」的判据。

这个项目是什么
封面

> 本文整理自平台文档 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)\.'

命中的字符串只会出现在注释、日志文案与测试断言里。这条约束带来的直接结果:新增一个业务应用不需要动平台一行代码。

一个应用包含四件东西

装一个应用等于交付一整套垂直功能,四件东西都在那个应用自己的仓库里:

件位置装上去之后发生什么
后端 jarsrc/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)

章节导览
THE END

喜欢就支持以下吧

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

回到内容