> 本文整理自平台文档 docs/wujies/1.x/advanced/app-market.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-4252451b56fe-cover.svg)
wujies-platform/wujies-modules/wujies-app-market/ 是「应用外置」整套机制的落点: 目录数据、安装编排、插件运行时、包安全都在这一个模块里。
这一页只回答三个问题:
1. 数据该怎么分 —— 哪些表的真相只有一个、哪些必须在每个部署各存一份; 2. 动作由谁编排 —— 部署 / 安装 / 升级 / 停用 / 卸载分别落到哪个类; 3. 代码该进哪个包 —— catalog/、plugin/、service/、spi/ 各自的边界在哪。
具体的坑与推导不在这里:改代码前先扫 wujies-platform/AGENTS.md 的 §2「必须遵守的不变量」 与 §3「应用市场架构」,那一份是权威约束,本页是它的导读;每个深水区在本章都有专页(见文末)。
> wujies-modules/ 下没有 *-api 契约模块(2026-09-30 起数量为 0): > 实体 / BO / VO / Mapper 接口与 Mapper XML / Service / controller 全在插件自己的 > wujies/wujies-plugins/wujies-<app>/ 里。见 [必须遵守的不变量](/docs/wujies/1.x/plugin-dev/basics/invariants)。
一、三种数据,别混
| 类别 | 表 | 应处位置 | 怎么认出来 |
|---|---|---|---|
| 目录 | app_info、app_version、app_category、app_plan(预留) | 中心一份,平台方维护 | 不带 tenant_id,且已列入 security.tenant.excludes(wujies-platform/wujies-admin/src/main/resources/application.yml) |
| 安装实例 | app_install、app_install_task | 每个部署各一份 | 带 tenant_id,由多租户插件自动隔离 |
| 迁移记录 | app_schema_history | 每个部署各一份 | 带 tenant_id(只记「谁最先应用」),但去重判据不带租户,见 [数据库表](/docs/wujies/1.x/reference/database) |
另有两处要单独交代:
script/sql/update/app_market.sql 里,但 domain/ 与 mapper/ 下没有任何对应 Java:属预留。
app_version_menu—— 版本 → 菜单的归属映射,「菜单归属保护」与「彻底删除」都读它app_dependency、app_subscription、app_audit_log、app_plan—— DDL 都在
这三类分不清的代价是具体的:目录和安装实例混在一套表里,多部署一套系统就要同步一遍目录。
安装侧只允许通过 IAppCatalogService 读目录(catalog/IAppCatalogService.java,9 个方法), 不要直接注入 AppInfoMapper / AppVersionMapper。这样把目录搬到中心服务时只换实现 (LocalAppCatalogService → RemoteAppCatalogService),安装侧一行都不用改。
上架端 / 控制台是目录的所有者,它直接用 Mapper 是正常的。判断标准是一句话: 这段代码跑在别人的部署上吗? 跑在别人那里 → 必须走目录接口。
> mapper/ 下正好 7 个 Mapper,对应 app_info、app_version、app_category、app_install、 > app_install_task、app_version_menu、app_schema_history 这 7 张表;domain/ 下另有 > AppManifest(app.json 的模型)、AppMenuPlan、AppMenuSyncResult 三个非表模型。 > 逐字段说明见 [数据库表](/docs/wujies/1.x/reference/database)。
二、包地图
每个包只做一件事,改动前先确认自己进的是哪个包。
| 包 | 职责 | 代表类 |
|---|---|---|
catalog/ | 目录访问的唯一入口 + 服务间接口 | IAppCatalogService、LocalAppCatalogService、RemoteAppCatalogService、AppCatalogApiController、CatalogApiContract |
edition/ | 版本形态:官方版 / 用户版 | MarketEdition、MarketEditionGuardFilter、MarketEditionStartupCheck |
plugin/ | 插件运行时:类加载器、子上下文、独立路由、Mapper 与 Converter 的运行期注册 | PluginClassLoader、PluginApplicationContext、PluginHandlerMapping、PluginRuntimeManager、PluginMapperRegistrar、PluginConverterRegistrar、PluginEventRelay、PluginContextRegistry |
security/ | 包安全:摘要规范化、白名单 + 验签、离线签名工具、签名就绪度自检 | PackageDigest、PackageSecurityInspector、PackageSignerMain、PackageKeys、SignatureReadinessService |
service/ | 生命周期编排与各项落地服务 | IAppInstallService(实现 service/impl/AppInstallServiceImpl)、AppPackageDeployService、AppPurgeService、AppMigrationService、AppMenuPlanner、AppMenuSyncServiceImpl、AppMenuOwnershipProvider、AppMenuTreeExpander、AppManifestValidator、AppRouteHintResolver、AppMenuFilterImpl、AppMenuGrantServiceImpl、AppMenuCache、AppConsoleMenuResolver |
spi/ | 安装器扩展点与生命周期监听 | AppInstaller、AppInstallContext、AppLifecycleListener、AppExtensionPoint、AppHealth;实现见 spi/impl/ModuleAppInstaller、spi/impl/PluginAppInstaller |
state/ | 安装状态机(8 个状态、合法迁移、对外可见性) | AppLifecycleStateMachine |
support/ | 任务进度落库与卡死任务清扫 | AppTaskRecorder、AppTaskTimeoutSweeper |
controller/ | HTTP 入口,controller/ 下 9 个控制器 | AppMarketController(/app/market)、AppInstallController(/app/install)、AppConsoleController(/app/console)、AppVersionController(/app/version)、AppPackageController(/app/package)、AppCategoryController(/app/category)、AppRuntimeController(/app/runtime)、AppWorkbenchController(/app/workbench)、AppEditionController(/app/edition) |
domain/ mapper/ | 实体 + bo/ + vo/;mapper/ 是 MyBatis-Plus 的 Mapper 接口 | AppInfo、AppVersion、AppInstall、AppInstallTask、AppManifest 等 |
enums/ | 安装状态、任务状态、任务类型 | AppInstallStatus(8 个取值)、`AppT |
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-4252451b56fe-guide.svg)


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