> 本文整理自平台文档 docs/wujies/1.x/ecosystem/platform-modules.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-c48df9fda44f-cover.svg)
这一页是平台(后端仓库 wujies-platform/)里有哪些模块的权威清单:每个模块负责什么、 哪些模块已经删除、以及"平台模块"和"应用"为什么不是一回事。
读之前先分清三类东西,混了就一定会找错仓库、改错地方:
| 你想找的 | 在哪 | 看哪一页 |
|---|---|---|
| 平台自己的 Maven 模块(系统管理、工作流、应用市场…) | wujies-platform/ | 本页 |
| 业务应用(商城 / 图床 / 考试…) | wujies/wujies-plugins/ | [应用生态](/docs/wujies/1.x/ecosystem/) |
| 某个具体文件该放哪 | 三个仓库各自的目录约定 | [仓库目录](/docs/wujies/1.x/design/repo-layout) |
口径以 wujies-platform/AGENTS.md §1「模块地图」为准;目录布局的逐条查证方式见 [项目结构](/docs/wujies/1.x/guide/structure)。
结论先看
本项目一律不用;在源码或旧文档里看到它们,那是历史遗留,不要照着写。
- 平台后端是
wujies-platform/,反应堆根pom.xml的<modules>只有 4 个条目: - 全反应堆
pom.xml共 38 个(含各层 parent),叶子模块 34 个。 - 业务应用不在平台里。平台对
cn.wujies.<app>.*的 Java 引用为 0,新增一个业务应用不需要动平台一行。 - 平台上没有
*-api契约模块(2026-09-30 起为 0 个):实体 / BO / VO / Mapper 接口 - 模块名一律是
wujies-*。本项目源自上游 RuoYi-Vue-Plus,但上游那套模块名(前缀、包名、目录名)
模块地图
wujies-platform/ 38 个 pom.xml(含各层 parent)
├── wujies-admin/ 启动模块:PluginClassPathLoader 在这里,Spring 之前执行;产物 wujies-admin.jar
├── wujies-common/ 基础设施,27 个子模块
│ ├── wujies-common-core/ 宿主反查插件与菜单归属的 SPI:PluginServiceProvider / MenuOwnershipProvider / AppRouteHintProvider
│ ├── wujies-common-web/ GlobalExceptionHandler(异常 → 前端的唯一出口)
│ ├── wujies-common-plugin-sdk/ 宿主向插件暴露的能力契约(Platform*Api / FollowRelationApi / *ServiceLocator)
│ ├── wujies-common-job/ SnailJob 客户端与开关(本模块里没有任何任务实现)
│ ├── wujies-common-mybatis/ MyBatis-Plus 集成(BaseMapperPlus 等)
│ └── … tenant / satoken / security / redis / oss / sse / websocket / rabbitmq / excel / doc …
├── wujies-modules/ 业务模块,4 个
│ ├── wujies-app-market/ ★ 应用市场:目录 + 插件运行时 + 上架端 + 包安全
│ ├── wujies-system/ 系统管理 + 监控 + 少数宿主侧门户/开放端点
│ ├── wujies-workflow/ 工作流(warm-flow)
│ └── wujies-plugin-probe/ 插件运行时探针(验证外置 jar 能否被宿主装配)
└── wujies-extend/ 旁挂服务:独立进程、独立 jar,都不在启动模块的依赖链上
├── wujies-monitor-admin/ 服务监控中心(Spring Boot Admin,控制台 /admin)
└── wujies-snailjob-server/ 定时任务调度中心(SnailJob 服务端 + 控制台 /snail-job)
| 模块 | 负责什么 | 关键落点 |
|---|---|---|
wujies-admin | 启动模块,打包产物就是整个宿主 | PluginClassPathLoader(启动期按 plugins-dist/active-plugins.txt 挂插件 jar) |
wujies-common-core | 宿主侧 SPI 契约 | PluginServiceProvider、MenuOwnershipProvider、AppRouteHintProvider |
wujies-common-web | 异常 → 前端的唯一出口 | GlobalExceptionHandler |
wujies-common-plugin-sdk | 插件唯一应依赖的宿主入口 | Platform*Api、FollowRelationApi、各应用的 *ServiceLocator |
wujies-common-job | SnailJob 客户端与开关 | SnailJobConfig(snail-job.enabled=true 时装配) |
wujies-app-market | 应用市场的全部机制 | catalog/(IAppCatalogService + Local/Remote)、plugin/(PluginRuntimeManager / PluginMapperRegistrar / PluginHandlerMapping)、security/(签名 + 产物白名单)、edition/(official / client) |
wujies-system | 系统管理与监控;另有 3 个宿主侧端点 | controller/system/、controller/monitor/,以及 OpenWebsiteConfigController / OpenMessageController / PortalUserProfileController |
wujies-workflow | 工作流 | 引擎是 warm-flow |
wujies-plugin-probe | 探针:用最小 jar 验证外置产物能被装配。不得被 wujies-admin 依赖(它必须在编译期不在宿主 classpath 上,否则测不出真实情况) | 自带 mapper XML 与定时任务的最小样本 |
wujies-monitor-admin | 服务监控中心 | 独立进程,无数据库,控制台 /admin |
wujies-snailjob-server | 定时任务调度中心 | 独立进程与独立库(script/sql/ry_job.sql),控制台 /snail-job,执行器端口 17888 |
各模块内部的包分工,另见 [应用市场模块](/docs/wujies/1.x/advanced/app-market) 与 [插件运行时](/docs/wujies/1.x/advanced/plugin-runtime)。
平台模块 ≠ 应用 ≠ 插件
| 类别 | 位置 | 分发方式 | 例子 |
|---|---|---|---|
| 平台模块 | wujies-platform/wujies-modules/** | 跟着 wujies-admin.jar 一起编译发布 | wujies-system、wujies-workflow |
| 旁挂服务 | wujies-platform/wujies-extend/** | 各自一个 jar,可装可不装 | wujies-snailjob-server、wujies-monitor-admin |
| 应用(插件) | wujies/wujies-plugins/wujies-<app>/ | 打成应用包上架,租户按需安装 | mall / gallery / exam / member… |
| 宿主前端 | plus-ui/(它的 package.json 里 name 写的是 wujies-admin,那只是名字不是位置) | 与后端一起打成前端产物 | `plus-ui/src/pl |
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-c48df9fda44f-guide.svg)


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