中国 帮助

平台内置模块

这一页是平台(后端仓库 wujiesplatform/)里有哪些模块的权威清单:每个模块负责什么、 哪些模块已经删除、以及"平台模块"和"应用"为什么不是一回事。 读之前先分清三类东西,混了就一定会找错仓库、改错地方: 你想找的 在

平台内置模块
封面

> 本文整理自平台文档 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-jobSnailJob 客户端与开关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)

章节导览
THE END

喜欢就支持以下吧

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

回到内容