平台内置模块

这一页是平台（后端仓库 wujies-platform/）里有哪些模块的权威清单：每个模块负责什么、 哪些模块已经删除、以及"平台模块"和"应用"为什么不是一回事。

读之前先分清三类东西，混了就一定会找错仓库、改错地方：

口径以 wujies-platform/AGENTS.md §1「模块地图」为准；目录布局的逐条查证方式见 项目结构。

结论先看复制标题链接

• 平台后端是 wujies-platform/，反应堆根 pom.xml 的 <modules> 只有 4 个条目： wujies-admin、wujies-common、wujies-extend、wujies-modules。
• 全反应堆 pom.xml 共 38 个（含各层 parent），叶子模块 34 个。
• 业务应用不在平台里。平台对 cn.wujies.<app>.* 的 Java 引用为 0，新增一个业务应用不需要动平台一行。
• 平台上没有 *-api 契约模块（2026-09-30 起为 0 个）：实体 / BO / VO / Mapper 接口 与 Mapper XML / Service / controller / open / listener / task 全在插件仓库自己的目录里。
• 模块名一律是 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-platform/ 且带 pom.xml → 平台模块，改它要重建 wujies-admin.jar；
• 路径里出现 wujies/wujies-plugins/wujies-<app>/ → 应用，改它走打包 + 上架/升级， 平台一行都不用动。

两者的类加载关系决定了改法的边界：平台模块的类由宿主类加载器加载，插件由每插件独立的类加载器加载， 插件子上下文以宿主为 parent —— 所以插件能注入宿主，宿主不能注入插件，宿主侧要拿插件服务只能走 PluginServiceProvider 或定位器代理。细节见 插件运行时 与 必须遵守的不变量。

已删除 / 已归档的模块复制标题链接

下面这些名字在旧文档、旧提交信息与源码注释里都出现过，现在都不存在。 最容易犯的一类错是把 wujies-platform/docs/removed/** 下的源码当成"平台模块"： 它们不在任何 <modules> 里、不参与编译。

门户 / 开放端点的下落复制标题链接

wujies-portal / wujies-openapi 归档后，宿主侧只保留了三处端点，都在 wujies-system：

应用专属的端点不在这里 —— 它们已经搬进各自的插件（/portal/mall/**、/open/exam/**、 /portal/follow/** …），插件没装时那些路由根本不存在，不会留下"能路由、一调就报没装"的空壳。 搬与不搬的分界线见 从宿主模块抽成应用； 全部 /open/** 清单见 开放接口清单。

平台模块在应用登记表里的身份复制标题链接

app_info 是"应用"的唯一事实来源，平台自带的顶层菜单也在这里登记 —— 脚本是 wujies-platform/script/sql/update/app_market_register_modules.sql（7 行）。 两个字段正交，不要混着读：

• install_mode：system（平台自带，不可卸载、不进市场、没有版本包）/ optional（可选应用，可安装、可停用）；
• audience：platform（平台管理员）/ tenant（B 端租户管理员）/ member（C 端用户），逗号分隔。

所以「系统管理 = system + platform」，而可选应用是「optional + tenant」—— install_mode 决定能不能卸载、进不进市场，audience 决定谁看得见。

系统应用没有版本包，因此不存在"安装"这个动作，也不会有 app_install 记录； 市场列表按 install_mode != 'system' 排除，且不允许上下架与删除。 字段定义见 数据模型，市场侧的口径见 在应用市场里找应用。

定时任务：宿主只提供支持，任务在应用里复制标题链接

所以"平台里有个定时任务模块"是旧说法：平台侧没有任务实现，只有客户端与开关。 不部署调度中心（或 1Panel 安装表单里把调度中心地址留空）时，这些任务一条都不会执行， 包括订单自动取消/自动收货、优惠券状态刷新、会员积分过期、统计刷新等 —— 那是"没装"，不是故障。 另外任务定义还要在 SnailJob 控制台导入，排查见 故障排查， 任务执行记录见 任务中心与日志。

部署形态：这些模块怎么落成可安装的包复制标题链接

deploy/tools/build-1panel.ps1 把上面的模块拼成 4 个 1Panel 应用包 （模板在 deploy/1panel/apps/**，docker context 在 deploy/docker/**）：

主包只含「前端 nginx + 后端」两个容器；MySQL / Redis / RabbitMQ 安装时从 1Panel 应用商店选 或填外部地址；对象存储不在包里。构建命令与表单填写见 后端部署， 两个版本的差异见 多部署与目录服务，版本形态开关见 目录中心化与版本形态。

怎么自己核验这一页复制标题链接

以下命令都在工作区根执行（wujies-platform/ 与 wujies/ 的上一层）：

# 1) 反应堆根只有 4 个聚合条目
Select-String -Path wujies-platform\pom.xml -Pattern '<module>'

# 2) 全反应堆 pom 数（含各层 parent）→ 38
(Get-ChildItem wujies-platform -Recurse -Filter pom.xml |
   Where-Object FullName -notmatch '\\target\\').Count

# 3) 契约模块数量 → 0（空结果）
Get-ChildItem wujies-platform -Recurse -Directory -Filter '*-api' |
   Where-Object FullName -notmatch '\\target\\'

# 4) 已删模块：目录不存在（空结果）
Get-ChildItem wujies-platform -Recurse -Directory |
   Where-Object Name -in 'wujies-job','wujies-demo','wujies-generator'

# 5) 哪些是应用（平台里没有它们）：一行一条 appCode=jarFileName
Get-Content wujies-platform\plugins-dist\active-plugins.txt
Select-String -Path wujies\wujies-plugins\pom.xml -Pattern '<module>'

# 6) 宿主侧没有任务实现（唯一命中落在 PluginRuntimeManager 的注释里）
Get-ChildItem wujies-platform -Recurse -Include *.java |
   Where-Object FullName -notmatch '\\target\\|\\docs\\removed\\' |
   Select-String '@JobExecutor'

wujies-common/ 的 27 个子模块逐个列出、以及各模块的详细说明，见 仓库目录。

相关阅读复制标题链接

• 应用生态 —— 应用清单与形态，数据来自各插件目录的 app.json
• 核心概念 —— 三个仓库、自包含应用、Mapper XML 的归属
• 仓库目录 —— 每个文件该放哪
• 应用市场模块 —— wujies-app-market 内部的包分工
• 插件运行时 —— 插件如何被加载、卸载与热替换
• 应用生命周期 —— 安装、升级、停用、卸载各阶段做了什么
• 多部署与目录服务 —— 官方版 / 用户版与四个安装包
• 数据模型 —— app_info 等目录表与安装实例表的结构
• 配置项索引 —— 模块相关的配置项在哪