中国 帮助

数据库表

本页整理应用市场相关的全部数据表。表结构以 DDL 为准,字段含义参考 wujiesappmarket 的实体类;两者不一致处以 DDL 为准(已知的不一致在第 12 张表和 app_version 的索引上,各自小节里都写明了)。 建

数据库表
封面

> 本文整理自平台文档 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_idbigint NOT NULL主键,应用 ID
app_codevarchar(64) NOT NULL唯一,应用编码;包内 app.json、落位目录名、app_schema_history.app_code 都用它
app_namevarchar(64) NOT NULL应用名称
app_typevarchar(16) NOT NULL DEFAULT 'module'形态:module 内置 / plugin 插件 / deploy 部署型
install_modevarchar(16) NOT NULL DEFAULT 'optional'system 平台自带(不可卸载、不进市场)/ optional 可选应用。由 app_market_app_model.sql 补列
audiencevarchar(64) NOT NULL DEFAULT 'tenant'可见范围:platform / tenant / member,逗号分隔。由 app_market_app_model.sql 补列
home_pathvarchar(200) DEFAULT NULL入口路由(如 /gallery)。系统应用必填;已安装应用留空则从菜单树推导。由 app_market_home_path.sql 补列
category_idbigint DEFAULT NULL分类 ID → app_category.category_id
official_flagchar(1) NOT NULL DEFAULT '0'是否官方(0 否 1 是)
latest_versionvarchar(32) DEFAULT NULL最新版本号(冗余展示字段)
install_countint NOT NULL DEFAULT 0安装量
ratingdecimal(3,2) NOT NULL DEFAULT 0.00评分
statuschar(1) NOT NULL DEFAULT '0'状态:0 草稿 / 1 已上架 / 2 已下架
del_flagchar(1) NOT NULL DEFAULT '0'逻辑删除:0 存在 / 1 删除
sort_numint NOT NULL DEFAULT 0排序
create_time / update_timedatetime DEFAULT NULL创建 / 更新时间

其余展示类字段:summary、`desc

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-7d5d764f5b9f-guide.svg)

章节导览
THE END

喜欢就支持以下吧

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

回到内容