> 本文整理自平台文档 docs/wujies/5.x/platform/architecture/index.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-56f66f3e4352-cover.svg)
> 这一页回答"分成几块、谁依赖谁、为什么这么分"。它不列目录(那是 > [仓库目录](/docs/wujies/5.x/platform/architecture/repo-layout) 的事),也不列硬约束(那是 > [必须遵守的不变量](/docs/wujies/5.x/platform/plugin/basics/invariants) 的事)。 > > 全文的技术断言都给了落点(路径 / 类名 / 配置键 / 建表脚本)。结构变了请重读文件系统再改这一页, > 不要凭记忆补。
一句话
把上游 RuoYi-Vue-Plus 的"一套系统服务一个客户"形态改造成 平台 + 应用:平台提供多租户底座 与应用市场机制,业务能力做成可后装、不重启、从市场拉下来直接跑的应用;宿主前端退化成一层壳, 业务页面由应用在运行期交付。
术语:平台 / 宿主 / 宿主前端 / 应用
| 说法 | 指什么 | 判据 |
|---|---|---|
| 平台(后端) | wujies-platform/,Java / Spring Boot + SQL 脚本 | 有 pom.xml;产物 wujies-admin.jar |
| 宿主 | 运行插件的那一个 JVM 进程 —— 就是平台后端 | 插件子上下文的 parent 就是它 |
| 宿主前端 | wujies-admin/,Vue 3 / Vite | 有 vite.config.ts / src/;package.json 的 name 是 wujies-admin |
| 应用 | plugins/wujies-<app>-plugin/,一个应用一个目录 | 含 app.json、migrations/、src/main/java/cn/wujies/<app>/ |
"宿主"与"平台后端"是同一份进程的两个视角:讲类加载器与 Spring 父子上下文时叫宿主, 讲多租户底座与市场机制时叫平台。两者不是两个进程。
本项目源自上游 RuoYi-Vue-Plus,但自己的模块名、包名一律是 wujies-* / cn.wujies.*。 源码或旧文档里出现上游的旧前缀与旧包名,那是历史遗留 —— 改的时候换成 wujies-* / cn.wujies.*。
一、三类仓库
| 仓库 | 内容 | 默认分支 |
|---|---|---|
wujies-platform | 后端(Java / Spring Boot)+ 平台 SQL 脚本 | feature/app-market |
wujies-<code>-plugin(12 个) | 一个应用一个仓库:后端模块 + app.json + migrations/ + frontend/ 前端工程(npm)+ 打包脚本 | master |
wujies-admin | 宿主前端(Vue 3 / Vite) | feature/app-market |
三者没有共同 git 根,各自分支、各自提交、各自推送 —— 加一个应用经常要跨仓库提交两到三次。 目录级细节见 [仓库目录](/docs/wujies/5.x/platform/architecture/repo-layout)。
⚠️ wujies-admin 这一个名字指两处不同地方(历史上已经因此误导过排查):
| 写法 | 实际指 | 判据 |
|---|---|---|
wujies-platform/wujies-admin/ | 后端启动模块(Java) | 有 pom.xml / src/main / Dockerfile;产物 wujies-admin.jar |
工作区顶层的 wujies-admin/ | 宿主前端仓库(Vue 3 / Vite) | 有 vite.config.ts / src/;package.json 的 name = wujies-admin;app-market-dist/ 在它下面 |
记法:路径里出现 src/plugins/、src/views/、app-market-dist/ → 说的是顶层的 wujies-admin/; 出现 src/main/resources/、wujies-admin.jar、mvn -pl wujies-admin → 说的是 wujies-platform/wujies-admin/。
二、三者各负责什么
| 平台(宿主) | 应用(插件) | 宿主前端(wujies-admin/) | |
|---|---|---|---|
| 用户与权限 | 用户 / 角色 / 部门 / 岗位 / 租户 / 菜单的授权 | 只声明自己的权限标识(app.json 的 menus[].perms) | 按登录返回的菜单树渲染侧边栏 |
| 数据 | 平台表(sys_* / app_* …),并保护它们不被误删 | 自己的业务表,建表语句放 migrations/ | — |
| 加载与隔离 | 类加载器、子 Spring 上下文、独立的 PluginHandlerMapping、宿主拦截器链 | 只写普通 Spring 代码 | — |
| 生命周期 | 部署 / 安装 / 升级 / 卸载 / 停用的编排与任务记录(app_install_task) | 无感 | 装完 / 升级 / 停用后调 refreshMenus() 刷新菜单树 |
| 前端页面 | 一层壳:布局、登录、工作台 | 自己的视图,产出独立 ESM | 远程应用装载器 + 静态路由兜底 |
| 包安全 | 产物白名单 + 签名校验(app-market.security.mode,当前 enforce) | 发布时签名 | — |
关键类是单向的,别记反:
component = remote:<appCode>/<视图键> 只是视图键,入口 JS 由运行期问后端得到: AppRuntimeController 的 GET /app/runtime/remote-apps。见 [前端远程应用](/docs/wujies/5.x/platform/architecture/remote-app)。
- 插件能注入宿主,宿主不能注入插件(插件子上下文以宿主为 parent)。
- 宿主前端在构建期不可能知道租户装了哪些应用。菜单里的
三、为什么前端必须先改造
后端把业务做成插件还不够 —— 起点约束在前端。改造前,页面是构建期用 glob 静态打进来的 (今天仍是这条,见 wujies-admin/src/store/modules/permission.ts 第 16 行):
const modules = import.meta.glob('./../../views/**/*.vue');
于是 sys_menu.component 只能指向构建时已存在的 .vue 文件,第三方页面在物理上无法热加载。 所以"应用外置"必须先把前端运行时改出来:让菜单能指向一份运行期才知道在哪的独立 ESM。
宿主前端为此做了两件事:
1. wujies-admin/src/plugins/appmarket/ 里的装载器(loader.ts / bootstrap.ts / runtime.ts / menuRefresh.ts / appAvailability.ts)在运行期问后端要入口并执行; 2. 不靠菜单驱动的页面(详情页、编辑页这类静态路由)也收藏到同一条路: wujies-admin/src/router/index.ts 里大量使用 createRemoteViewComponent('<视图键>', '<appCode>'), 否则菜单能点开、手打 URL 却打不开。
四、契约随插件走:平台里没有 *-api 模块
这是决定整个仓库结构的一条约定,也是最容易照着旧文档写错的一条。
现状:平台里 wujies-modules/*-api 数量为 0;平台对 cn.wujies.<app>.* 的 Java 引用为 0 (只允许出现在注释里)。每个应用自包含:
| 内容 | 位置 |
|---|---|
| 实体 / BO / VO / 枚举 | `plugins/wujies-<app>-plugin/src/main/java/cn/wujies/<app> |
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-56f66f3e4352-guide.svg)


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