同步前后端联调与文档更新

backend/docs/数据模型.md

@@ -1,9 +1,9 @@
 # 数据模型
 > 文档版本：v1.0
-> 最后更新：2026-04-02
+> 最后更新：2026-04-02 08:28:05
 
 
-当前 migration 共 5 版。
+当前 migration 共 6 版。
 
 ## 1. 迁移清单
 
@@ -12,6 +12,7 @@
 - [0003_home.sql](D:/dev/cmr-mini/backend/migrations/0003_home.sql)
 - [0004_results.sql](D:/dev/cmr-mini/backend/migrations/0004_results.sql)
 - [0005_config_pipeline.sql](D:/dev/cmr-mini/backend/migrations/0005_config_pipeline.sql)
+- [0006_resource_objects.sql](D:/dev/cmr-mini/backend/migrations/0006_resource_objects.sql)
 
 ## 2. 表分组
 
@@ -98,6 +99,21 @@
 - 保存构建后的 manifest 和 asset index
 - 保存正式 release 关联的资产清单
 
+### 2.7 共享资源对象
+
+- `maps`
+- `map_versions`
+- `playfields`
+- `playfield_versions`
+- `resource_packs`
+- `resource_pack_versions`
+
+职责：
+
+- 把地图、KML/赛场、内容资源包做成可复用对象
+- 支撑后台第一版按“资源对象 + 版本”管理
+- 给后续 event 引用组装和发布流程提供稳定边界
+
 ## 3. 当前最关键的关系
 
 ### `tenant -> entry_channel`
@@ -132,6 +148,18 @@
 - build 是构建态
 - release 是发布态
 
+### `map -> map_version`
+
+一张地图可有多个版本。
+
+### `playfield -> playfield_version`
+
+一份赛场/KML 可有多个版本。
+
+### `resource_pack -> resource_pack_version`
+
+一套内容/音频/主题资源可有多个版本。
+
 ## 4. 当前已落库但仍应注意的边界
 
 ### 4.1 不要把玩法细节塞回事件主表
@@ -173,3 +201,4 @@
 
 这些后面要按真正业务需要补 migration，不要先拍脑袋建大而全表。
 
+