完善多赛道联调与全局产品架构

backend/docs/接口清单.md

@@ -1,6 +1,6 @@
 # API 清单
-> 文档版本：v1.0
-> 最后更新：2026-04-02 09:01:17
+> 文档版本：v1.1
+> 最后更新：2026-04-02 11:05:32
 
 
 本文档只记录当前 backend 已实现接口，不写未来规划接口。
@@ -121,6 +121,12 @@
 - `ongoingSession`
 - `recentSession`
 
+`ongoingSession / recentSession` 当前会额外带：
+
+- `variantId`
+- `variantName`
+- `routeCode`
+
 ## 4. Event
 
 ### `GET /events/{eventPublicID}`
@@ -150,6 +156,8 @@
 - `event`
 - `release`
 - `resolvedRelease`
+- `play.assignmentMode`
+- `play.courseVariants`
 - `play.canLaunch`
 - `play.primaryAction`
 - `play.launchSource`
@@ -169,13 +177,21 @@
 请求体重点：
 
 - `releaseId`
+- `variantId`
 - `clientType`
 - `deviceKey`
 
+补充说明：
+
+- 如果当前 release 声明了 `play.courseVariants[]`
+- `launch` 会返回最终绑定的 `launch.variant`
+- 当前为兼容旧调用方，`assignmentMode=manual` 且未传 `variantId` 时，backend 会先回退到首个可选 variant
+
 返回重点：
 
 - `launch.source`
 - `launch.resolvedRelease`
+- `launch.variant`
 - `launch.config`
 - `launch.business.sessionId`
 - `launch.business.sessionToken`
@@ -228,6 +244,13 @@
 - `event`
 - `resolvedRelease`
 
+`session` 当前会额外带：
+
+- `assignmentMode`
+- `variantId`
+- `variantName`
+- `routeCode`
+
 ### `POST /sessions/{sessionPublicID}/start`
 
 鉴权：
@@ -312,6 +335,9 @@
 
 - `releaseId`
 - `configLabel`
+- `variantId`
+- `variantName`
+- `routeCode`
 
 ### `GET /me/results`