推进活动系统最小成品闭环与游客体验

backend/docs/资源对象与目录方案.md

@@ -1,6 +1,6 @@
 # 资源对象与目录方案
-> 文档版本：v1.0
-> 最后更新：2026-04-02 08:28:05
+> 文档版本：v1.3
+> 最后更新：2026-04-07 13:13:19
 
 
 本文档用于把“地图复用、KML 复用、内容资源复用、配置发布”统一收成一套后端可执行方案。
@@ -13,6 +13,20 @@
 - 让 `release` 能稳定追溯当时到底用了哪一份地图、哪一份 KML、哪一套资源包
 - 让同一套资源对象既能服务小程序，也能服务未来 APP
 
+当前补充约束：
+
+- 正式资源目录只认 `OSS / CDN`
+- 本地 `tmp/` 仅作为临时收件箱，不参与正式发布源
+- backend 当前已开始提供运维入口第一期：
+  - `POST /admin/ops/tile-releases/import`
+  - `POST /admin/ops/course-sets/import-kml-batch`
+- backend 当前也已开始提供运维入口第二期：
+  - `POST /admin/assets/upload`
+  - `POST /admin/assets/register-link`
+  - `GET /admin/assets`
+  - `GET /admin/assets/{assetPublicID}`
+- 当前目标是把“上传文件”和“登记外链”统一收口到同一套资源模型，不要求运维自己关心底层存储实现。
+
 ---
 
 ## 1. 设计结论
@@ -379,6 +393,10 @@ build / publish 时，Go 中间层应做装配：
 
 ```text
 gotomars/maps/{mapCode}/{version}/...
+gotomars/kml/{placeCode}/{version}/route01.kml
+gotomars/kml/{placeCode}/{version}/route02.kml
+gotomars/kml/{placeCode}/{version}/route03.kml
+gotomars/kml/{placeCode}/{version}/route04.kml
 gotomars/playfields/{playfieldCode}/{version}/...
 gotomars/resource-packs/{packCode}/{version}/...
 gotomars/game-modes/{modeCode}/{version}/mode.json
@@ -394,6 +412,16 @@ gotomars/event-releases/{eventPublicID}/{releasePublicID}/asset-index.json
 - 同一个 map / KML 修复时不会污染所有旧 release
 - APP 与小程序可共用相同资源版本，不必重复发两套发布目录
 
+补充约束：
+
+- 正式资源目录只认 `OSS / CDN`，不认仓库本地目录
+- `tmp/` 只作为临时收件箱，不作为任何正式发布源
+- 当前 manual 多赛道 demo 已切到：
+  - `gotomars/kml/lxcb-001/2026-04-07/route01.kml`
+  - `gotomars/kml/lxcb-001/2026-04-07/route02.kml`
+  - `gotomars/kml/lxcb-001/2026-04-07/route03.kml`
+  - `gotomars/kml/lxcb-001/2026-04-07/route04.kml`
+
 ---
 
 ## 8. 数据库建模建议