> 本文整理自平台文档 docs/wujies/5.x/platform/ecosystem/platform-modules.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-dbedc514610c-cover.svg)
这一页是平台(后端仓库 wujies-platform/)里有哪些模块的权威清单:每个模块负责什么、 哪些模块已经删除、以及"平台模块"和"应用"为什么不是一回事。
读之前先分清三类东西,混了就一定会找错仓库、改错地方:
| 你想找的 | 在哪 | 看哪一页 |
|---|---|---|
| 平台自己的 Maven 模块(系统管理、工作流、应用市场…) | wujies-platform/ | 本页 |
| 业务应用(商城 / 图床 / 考试…) | wujies/plugins/wujies-<code>-plugin/ | [应用生态](/docs/wujies/5.x/platform/ecosystem/) |
| 某个具体文件该放哪 | 三个仓库各自的目录约定 | [仓库目录](/docs/wujies/5.x/platform/architecture/repo-layout) |
口径以 wujies-platform/AGENTS.md §1「模块地图」为准;目录布局的逐条查证方式见 [项目结构](/docs/wujies/5.x/introduction/structure)。
结论先看
本项目一律不用;在源码或旧文档里看到它们,那是历史遗留,不要照着写。
- 平台后端是
wujies-platform/,反应堆根pom.xml的<modules>只有 4 个条目: - 全反应堆
pom.xml共 39 个(含各层 parent),叶子模块 35 个。 - 业务应用不在平台里。平台对
cn.wujies.<app>.*的 Java 引用为 0,新增一个业务应用不需要动平台一行。 - 平台上没有
*-api契约模块(2026-09-30 起为 0 个):实体 / BO / VO / Mapper 接口 - 模块名一律是
wujies-*。本项目源自上游 RuoYi-Vue-Plus,但上游那套模块名(前缀、包名、目录名)
模块地图
wujies-platform/ 39 个 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/ 业务模块,5 个
│ ├── wujies-market-core/ ★ 上架判据内核:目录契约与服务 + 包摘要/签名/白名单 + 路由扫描器
│ │ 平台与中心上架服务**共用**这一份字节码(2026-10-30 拆出)
│ ├── 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-market-core | 上架判据内核:目录契约与服务、包摘要与签名、路由扫描、清单校验与菜单计划。平台与中心上架服务共用这一份字节码 | catalog/(IAppCatalogService + LocalAppCatalogService + AppCatalogApiController + CatalogApiContract)、security/(PackageDigest / PackageSecurityInspector / PackageSignerMain / PackageKeys)、route/(三个扫描器)、service/(AppManifestValidator / AppMenuPlanner)、util/EngineConstraint |
wujies-app-market | 应用市场安装侧的全部机制(上架端 2026-11-01 已移出平台) | catalog/(@Primary 的 RemoteAppCatalogService,没配中心地址时回落到内核的本地实现)、plugin/(PluginRuntimeManager / PluginMapperRegistrar / PluginHandlerMapping)、security/(SignatureReadinessService)、controller/(5 个:/app/install、/app/market、/app/runtime、/app/workbench、/app/dev) |
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 |
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-dbedc514610c-guide.svg)


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