> 本文整理自平台文档 docs/wujies/1.x/reference/database.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-7d5d764f5b9f-cover.svg)
本页整理应用市场相关的全部数据表。表结构以 DDL 为准,字段含义参考 wujies-app-market 的实体类;两者不一致处以 DDL 为准(已知的不一致在第 12 张表和 app_version 的索引上,各自小节里都写明了)。
建表脚本来源
| 脚本 | 作用 |
|---|---|
script/sql/update/app_market.sql | 应用市场 M1 增量建表脚本,11 张表全在这里 |
script/sql/update/app_market_app_model.sql | 给 app_info 补 install_mode / audience |
script/sql/update/app_market_home_path.sql | 给 app_info 补 home_path |
script/sql/update/fix_app_version_unique_index.sql | 重建 app_version 的唯一索引 |
script/sql/update/app_market_schema_history_fix.sql | 修正 app_schema_history 的唯一键,见下文 |
script/sql/update/app_market_task_center.sql | 「应用任务」菜单,不建表 |
script/sql/update/app_market_menu_restructure.sql 等菜单类脚本 | 不建表,只整理 sys_menu |
script/sql/update/platform_align_collation.sql | 把上述表统一到 utf8mb4_0900_ai_ci,不改结构 |
全部 CREATE TABLE 都是 IF NOT EXISTS,重复执行安全,也不删任何已有表与数据。
三种数据,别混
| 表名 | 类别 | 是否按租户隔离 | 用途 |
|---|---|---|---|
app_info | 目录 | 否(tenant.excludes) | 应用主表:编码、名称、类型、可见范围、上架状态 |
app_version | 目录 | 否 | 应用版本:清单原文、安装包地址与校验和、签名 |
app_category | 目录 | 否 | 应用分类树 |
app_plan | 目录 | 否 | 应用套餐与价格(M3 计费,当前未见实现) |
app_dependency | 目录 | 否 | 应用间依赖声明 |
app_version_menu | 目录 | 否 | 版本 ↔ sys_menu 归属映射(菜单归属的权威记录) |
app_install | 安装实例 | 是 | 本租户对某应用的安装实例与状态 → 每部署各一份 |
app_install_task | 安装实例 | 是 | 安装/升级/卸载任务的进度与日志 |
app_subscription | 安装实例 | 是 | 应用订阅(M3 计费,当前未见实现) |
app_audit_log | 安装实例 | 是 | 应用操作审计(当前未见实现) |
app_schema_history | 迁移记录 | 是(写入 tenant_id,但判据不带租户) | 迁移脚本执行账本 → 每部署各一份 |
合计 11 张表:目录 6、安装实例 4、迁移记录 1。
两点需要说清楚:
之后,安装侧只通过 IAppCatalogService 读目录。所以「目录表在本地库」只是 local 模式的 事实,不是架构约束,详见 [应用市场](/docs/wujies/1.x/advanced/app-market) 与 [目录与版本形态](/docs/wujies/1.x/advanced/catalog-and-edition)。
- 「按租户隔离」不等于「表里有
tenant_id列」。app_schema_history有 - 目录与安装实例混在同一套表里,但可以搬到中心服务:
app-market.catalog.mode=remote
1. wujies-platform/wujies-admin/src/main/resources/application.yml 的 tenant.excludes 里要包含 app_info / app_version / app_category / app_version_menu / app_dependency / app_plan 这六张全局表;带 tenant_id 的 app_install / app_install_task / app_subscription / app_audit_log / app_schema_history 不要加进去。 2. app_schema_history 的唯一键必须以 (app_code, script) 为准,存量部署跑 app_market_schema_history_fix.sql(见下文第 13 节)。
所有表的公共约定:主键是 bigint 雪花 ID(MyBatis-Plus idType=ASSIGN_ID,应用侧赋值, 不是自增);审计列与 RuoYi 规范一致(create_dept / create_by / create_time / update_by / update_time);引擎 InnoDB,字符集 utf8mb4。
---
1. app_info —— 应用主表
用途:应用市场的目录主表,一行一个应用;平台方维护,全局一份。
| 字段 | 类型 | 说明 |
|---|---|---|
app_id | bigint NOT NULL | 主键,应用 ID |
app_code | varchar(64) NOT NULL | 唯一,应用编码;包内 app.json、落位目录名、app_schema_history.app_code 都用它 |
app_name | varchar(64) NOT NULL | 应用名称 |
app_type | varchar(16) NOT NULL DEFAULT 'module' | 形态:module 内置 / plugin 插件 / deploy 部署型 |
install_mode | varchar(16) NOT NULL DEFAULT 'optional' | system 平台自带(不可卸载、不进市场)/ optional 可选应用。由 app_market_app_model.sql 补列 |
audience | varchar(64) NOT NULL DEFAULT 'tenant' | 可见范围:platform / tenant / member,逗号分隔。由 app_market_app_model.sql 补列 |
home_path | varchar(200) DEFAULT NULL | 入口路由(如 /gallery)。系统应用必填;已安装应用留空则从菜单树推导。由 app_market_home_path.sql 补列 |
category_id | bigint DEFAULT NULL | 分类 ID → app_category.category_id |
official_flag | char(1) NOT NULL DEFAULT '0' | 是否官方(0 否 1 是) |
latest_version | varchar(32) DEFAULT NULL | 最新版本号(冗余展示字段) |
install_count | int NOT NULL DEFAULT 0 | 安装量 |
rating | decimal(3,2) NOT NULL DEFAULT 0.00 | 评分 |
status | char(1) NOT NULL DEFAULT '0' | 状态:0 草稿 / 1 已上架 / 2 已下架 |
del_flag | char(1) NOT NULL DEFAULT '0' | 逻辑删除:0 存在 / 1 删除 |
sort_num | int NOT NULL DEFAULT 0 | 排序 |
create_time / update_time | datetime DEFAULT NULL | 创建 / 更新时间 |
其余展示类字段:summary、`desc
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-7d5d764f5b9f-guide.svg)


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