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

backend/docs/核心流程.md

@@ -1,6 +1,6 @@
 # 核心流程
-> 文档版本：v1.0
-> 最后更新：2026-04-02 08:28:05
+> 文档版本：v1.1
+> 最后更新：2026-04-02 11:03:02
 
 
 ## 1. 总流程
@@ -100,6 +100,7 @@ APP 当前主链是手机号验证码：
 
 - 当前是否可启动
 - 当前会落到哪份 `release`
+- 当前是否存在多赛道 `variant` 编排
 - 是否有 ongoing session
 - 当前推荐动作是什么
 
@@ -112,12 +113,27 @@ APP 当前主链是手机号验证码：
 - `event`
 - `release`
 - `resolvedRelease`
+- `play.assignmentMode`
+- `play.courseVariants[]`
 - `play.canLaunch`
 - `play.primaryAction`
 - `play.launchSource`
 - `play.ongoingSession`
 - `play.recentSession`
 
+当前多赛道第一阶段约束：
+
+- `play.assignmentMode` 只先支持最小口径：
+  - `manual`
+  - `random`
+  - `server-assigned`
+- `play.courseVariants[]` 只先返回准备页必需字段：
+  - `id`
+  - `name`
+  - `description`
+  - `routeCode`
+  - `selectable`
+
 ## 6. Launch 流程
 
 ### 6.1 当前原则
@@ -135,6 +151,7 @@ APP 当前主链是手机号验证码：
 当前请求体支持：
 
 - `releaseId`
+- `variantId`
 - `clientType`
 - `deviceKey`
 
@@ -142,6 +159,7 @@ APP 当前主链是手机号验证码：
 
 - `launch.source`
 - `launch.resolvedRelease`
+- `launch.variant`
 - `launch.config`
 - `launch.business.sessionId`
 - `launch.business.sessionToken`
@@ -158,6 +176,14 @@ APP 当前主链是手机号验证码：
 - `launch.resolvedRelease.releaseId`
 - `launch.resolvedRelease.manifestUrl`
 - `launch.resolvedRelease.manifestChecksumSha256`
+- `launch.variant.id`
+- `launch.variant.assignmentMode`
+
+补充说明：
+
+- 如果活动声明了多赛道 variant，`launch` 会返回本局最终绑定的 `variant`
+- 前端可以发起选择，但最终绑定以后端 `launch` 返回为准
+- 故障恢复不重新分配 variant
 
 而不是再拿 `event` 自己去猜。
 
@@ -195,6 +221,11 @@ APP 当前主链是手机号验证码：
 - `cancelled` 和 `failed` 都不再作为 ongoing session 返回
 - “放弃恢复”当前正式收口为 `finish(cancelled)`
 - 同一局旧 `sessionToken` 在 `finish(cancelled)` 场景允许继续使用
+- 第一阶段若活动声明了多赛道，session 会固化：
+  - `assignmentMode`
+  - `variantId`
+  - `variantName`
+  - `routeCode`
 
 ### 7.4 幂等要求
 
@@ -232,6 +263,7 @@ APP 当前主链是手机号验证码：
 
 - 一个 event 未来可能发布新版本
 - 历史结果必须追溯到当时真实跑过的那份 release
+- 如果一场活动存在多个 variant，结果与历史摘要也必须能追溯本局 `variantId`
 
 ## 9. 当前最应该坚持的流程约束