> 本文整理自平台文档 docs/wujies/5.x/platform/architecture/app-market-module.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-3e6ce0bd7a7c-cover.svg)
wujies-platform/wujies-modules/wujies-app-market/ 是「应用外置」整套机制的落点: 安装编排、插件运行时、生命周期都在这一个模块里;目录数据与包安全的判据已经抽成共享内核 wujies-platform/wujies-modules/wujies-market-core/,平台与独立的上架中心共用同一份字节码。
这一页只回答三个问题:
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 全在插件自己的 > plugins/wujies-<app>-plugin/ 里。见 [必须遵守的不变量](/docs/wujies/5.x/platform/plugin/basics/invariants)。
一、三种数据,别混
| 类别 | 表 | 应处位置 | 怎么认出来 |
|---|---|---|---|
| 目录 | app_info、app_version、app_category、app_version_route、app_plan(预留) | 中心上架服务一份(私有仓库 wujies-market,库 wujies_market 只建这四张表);平台上只有「目录所有者」那台部署才填数据 | 不带 tenant_id,且已列入 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/5.x/platform/reference/database) |
另有两处要单独交代:
script/sql/app_market_schema.sql 里,但 domain/ 与 mapper/ 下没有任何对应 Java:属预留。
app_version_menu—— 版本 → 菜单的归属映射,「菜单归属保护」与「彻底删除」都读它app_dependency、app_subscription、app_audit_log、app_plan—— DDL 都在
这三类分不清的代价是具体的:目录是所有租户共享的数据,安装实例按租户隔离, 把两类表混进同一套隔离规则,要么市场页被租户条件过滤空,要么安装记录跨租户可见。
安装侧只允许通过 IAppCatalogService 读目录(wujies-market-core/.../catalog/IAppCatalogService.java, 11 个读方法 + 5 个 require* 默认方法), 不要直接注入 AppInfoMapper / AppVersionMapper。实现有两个:内核里的 LocalAppCatalogService 直连本库;平台侧的 RemoteAppCatalogService 标 @Primary、 总是装配,每次读的时候判断有没有生效的中心地址(sys_config 的 appmarket.catalogBaseUrl 优先,其次 app-market.catalog.base-url),有就走中心、没有就回落本地实现。
目录由中心上架服务维护,平台侧已经没有上架端(2026-11-01 删掉控制器、页面、路由与菜单种子)。 判断标准是一句话:这段代码属于「装应用」吗? 是 → 必须走目录接口。
> Mapper 一共 9 个,分两处:wujies-market-core/mapper/ 下 4 个(app_info、app_version、 > app_category、app_version_route),wujies-app-market/mapper/ 下 5 个(app_install、 > app_install_task、app_version_menu、app_schema_history、app_route_index)。 > 目录侧的实体(AppInfo、AppVersion、AppCategory、AppVersionRoute、AppManifest、AppMenuPlan) > 也都在内核的 domain/ 下;wujies-app-market/domain/ 里另有 AppMenuSyncResult 这类非表模型。 > 逐字段说明见 [数据库表](/docs/wujies/5.x/platform/reference/database)。
二、包地图
每个包只做一件事,改动前先确认自己进的是哪个包。
| 包 | 职责 | 代表类 |
|---|---|---|
catalog/ | 目录访问入口的平台侧:远端实现 + 中心地址设置(接口与本地实现在内核 wujies-market-core/catalog/,另有 AppCatalogApiController 对外供目录) | RemoteAppCatalogService、CatalogCenterSettings;内核:IAppCatalogService、LocalAppCatalogService、CatalogApiContract |
plugin/ | 插件运行时:类加载器、子上下文、独立路由、Mapper 与 Converter 的运行期注册、路由墓碑落库、运行期开发台 | PluginClassLoader、PluginApplicationContext、PluginHandlerMapping、PluginRuntimeManager、PluginMapperRegistrar、PluginConverterRegistrar、PluginEventRelay、PluginContextRegistry、AppRouteIndexRecorder |
security/ | 签名就绪度自检(摘要规范化、白名单 + 验签、离线签名工具都在内核 wujies-market-core/security/) | SignatureReadinessService;内核:PackageDigest、PackageSecurityInspector、PackageSignerMain、PackageKeys |
service/ | 生命周期编排与各项落地服务 | IAppInstallService(实现 service/impl/AppInstallServiceImpl)、AppPackageDeployService、AppPurgeService、AppMigrationService、AppMenuSyncServiceImpl、AppMenuOwnershipProvider、AppMenuTreeExpander、AppRouteHintResolver、AppRouteIndexService、CatalogRouteIndexSyncService、AppDependencyChecker、AppDependencyResolver、AppMenuFilterImpl、AppMenuGrantServiceImpl、AppMenuCache;内核:AppMenuPlanner、AppManifestValidator |
spi/ | 安装器扩展点与生命周期监听 | AppInstaller、AppInstallContext、AppLifecycleListener、AppExtensionPoint、AppHealth;实现见 spi/impl/ModuleAppInstaller、spi/impl/PluginAppInstaller |
state/ | 安装状态机(8 个状态、合法迁移、对外可见性) | `AppLifecyc |
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-3e6ce0bd7a7c-guide.svg)


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