推进活动列表第一刀与联调回归

2026-04-03 19:33:16 +08:00
parent b09c21c814
commit 527b4c78a9
34 changed files with 3094 additions and 224 deletions
--- a/backend/README.md
+++ b/backend/README.md
@@ -1,6 +1,6 @@
 # Backend
-> 文档版本：v1.17
-> 最后更新：2026-04-03 16:16:38
+> 文档版本：v1.22
+> 最后更新：2026-04-03 18:56:46


 这套后端现在已经能支撑一条完整主链：
@@ -14,6 +14,22 @@
 - 真正进入游戏时客户端消费的是 `manifest_url`
 - `session` 会固化当时实际绑定的 `release`

+当前还要明确一条业务规则：
+
+- 玩家进入游戏，必须基于“已发布 release”
+- `event` 默认绑定、活动草稿配置、未发布 presentation / content bundle 都不能直接作为玩家正式进入依据
+- 当前 `currentPresentation` / `currentContentBundle` 在玩家链路里表示的是：
+  - 当前已发布 release 实际绑定的展示版本摘要
+  - 当前已发布 release 实际绑定的内容包摘要
+- 它们不是 event 草稿默认值摘要
+- 当前 `play.canLaunch` 和 `launch` 也已按同一套规则收口：
+  - 只有当当前发布 release 同时具备：
+    - `manifest`
+    - `runtime`
+    - `presentation`
+    - `content bundle`
+    时，玩家才允许正式进入
+
 当前 workbench 里新增的“当前 Launch 实际配置摘要”仅用于调试：

 - 它会由 backend 代读当前 launch 对应的 manifest
@@ -35,6 +51,51 @@
 - backend 会临时保留最近 200 条日志，供 workbench 查看与清空
 - 这块只用于联调排查，不替代正式生产日志体系

+当前 demo 真实输入第一刀也已经接入：
+
+- workbench 的玩法切换会自动填入 backend 内置的：
+  - `presentation schema`
+  - `content manifest`
+- 这些 demo 资源通过 backend 提供的 dev 路由读取：
+  - `GET /dev/demo-assets/presentations/{demoKey}`
+  - `GET /dev/demo-assets/content-manifests/{demoKey}`
+
+当前 workbench 的 `Bootstrap` 语义也已经拆开：
+
+- `Bootstrap Demo（只准备数据）`
+  - 只准备 demo 测试数据，不额外重新发布当前玩法
+- `Bootstrap + 发布当前玩法`
+  - 先准备 demo，再对当前选中的玩法执行一遍“发布活动配置（自动补 Runtime）”
+- 这两条路由只服务联调，不进入正式客户端发布链
+- 当前联调样例文案也已从 `Demo ...` 收口为中文活动样例，便于前端和总控直接对口排查
+
+当前活动卡片列表最小产品化第一刀也已经进入 backend：
+
+- `/cards`
+- `/home`
+- `/me/entry-home`
+
+这三处当前已统一补齐最小活动卡片摘要字段：
+
+- `summary`
+- `status`
+- `statusCode`
+- `timeWindow`
+- `ctaText`
+- `isDefaultExperience`
+- `eventType`
+- `currentPresentation`
+- `currentContentBundle`
+
+当前口径：
+
+- 卡片摘要与详情页继续共用同一套“当前发布 release 摘要”语义
+- `currentPresentation / currentContentBundle` 仍表示：
+  - 当前已发布 release 实际绑定的展示版本摘要
+  - 当前已发布 release 实际绑定的内容包摘要
+- `isDefaultExperience` 当前由卡片显式字段控制
+- `timeWindow / ctaText` 当前先按后端派生规则提供，允许后续继续演进
+
 ## 文档导航

 - [文档索引](D:/dev/cmr-mini/backend/docs/README.md)
--- a/backend/docs/开发说明.md
+++ b/backend/docs/开发说明.md
@@ -1,6 +1,6 @@
 # 开发说明
-> 文档版本：v1.20
-> 最后更新：2026-04-03 16:16:38
+> 文档版本：v1.25
+> 最后更新：2026-04-03 18:56:46


 ## 1. 环境变量
@@ -45,6 +45,13 @@ cd D:\dev\cmr-mini\backend
  - `Bootstrap Demo`
  - `Use Classic Demo / Use Score-O Demo / Use Manual Variant Demo`
  - `整条链一键验收`
+- 当前玩法切换除了切 `event / release / source / build`，还会自动切换：
+  - `presentation schema`
+  - `content manifest`
+  - `asset manifest`
+- 这些 demo 资源现在由 backend 提供，避免继续在 workbench 里保留 `example.com` 占位地址：
+  - `GET /dev/demo-assets/presentations/{demoKey}`
+  - `GET /dev/demo-assets/content-manifests/{demoKey}`
 - 如果 frontend 需要把页面侧调试日志直接打到 backend，优先使用：
  - `POST /dev/client-logs`
  - 然后在 workbench 的 `前端调试日志` 面板里查看
@@ -67,6 +74,54 @@ cd D:\dev\cmr-mini\backend
  - backend 当前只在内存里保留最近 200 条
  - 适合前端把关键事实直接打进来，避免只靠截图和口头描述
  - 不替代正式生产日志体系
+- `Bootstrap Demo` 准备出的联调文案也已换成中文样例：
+  - `领秀城公园顺序赛`
+  - `领秀城公园积分赛`
+  - `领秀城公园多赛道挑战`
+
+## 4. 活动卡片列表最小摘要
+
+当前 backend 已为以下入口统一补齐活动卡片最小摘要字段：
+
+- `/cards`
+- `/home`
+- `/me/entry-home`
+
+当前字段集：
+
+- `title`
+- `subtitle`
+- `summary`
+- `status`
+- `statusCode`
+- `timeWindow`
+- `ctaText`
+- `coverUrl`
+- `isDefaultExperience`
+- `eventType`
+- `currentPresentation`
+- `currentContentBundle`
+
+当前派生规则：
+
+- `summary`
+  - 无值时回退为：`当前暂无活动摘要`
+- `status`
+  - `running` -> `进行中`
+  - `upcoming` -> `即将开始`
+  - `ended` -> `已结束`
+  - 其余 -> `状态待确认`
+- `timeWindow`
+  - 由 `cards.starts_at / ends_at` 派生
+  - 缺失时回退为：`时间待公布`
+- `ctaText`
+  - 默认体验活动：`进入体验`
+  - 进行中：`进入活动`
+  - 已结束：`查看回顾`
+  - 其余：`查看详情`
+- `currentPresentation / currentContentBundle`
+  - 当前继续表示已发布 release 实际绑定摘要
+  - 不是 event 草稿默认值

 默认会设置：

@@ -100,13 +155,26 @@ cd D:\dev\cmr-mini\backend

 当前推荐顺序：

-1. `Bootstrap Demo`
+1. `Bootstrap Demo（只准备数据）`
 2. 选择一种玩法入口：
   - `Use Classic Demo`
   - `Use Score-O Demo`
   - `Use Manual Variant Demo`
-3. `一键补齐 Runtime 并发布`
-4. `一键标准回归`
+3. 如果只是想看发布过程，点 `Bootstrap + 发布当前玩法`
+4. 如果想只测发布链，点 `一键补齐 Runtime 并发布`
+5. 如果想直接验整条链，点 `一键标准回归`
+
+当前这几个按钮的职责已经拆开：
+
+- `Bootstrap Demo（只准备数据）`
+  - 只负责准备 demo event / source / build / release / runtime 等测试数据
+  - 不会基于当前玩法再额外重新发布一版
+- `Bootstrap + 发布当前玩法`
+  - 会先执行一遍 `Bootstrap Demo`
+  - 然后对当前选中的玩法执行“发布活动配置（自动补 Runtime）”
+- `一键补齐 Runtime 并发布`
+  - 不再隐式 bootstrap
+  - 只基于当前已选玩法和当前表单上下文执行发布链

 当前这条一键链会自动完成：

@@ -220,6 +288,48 @@ dev 环境下，frontend 可直接把关键调试事实发到 backend：

 ## 3. 当前开发约定

+### 3.0 玩家进入规则
+
+当前要明确一条玩家链路规则：
+
+- 玩家进入游戏，必须基于“已发布 release”
+- 不能基于：
+  - event 草稿默认绑定
+  - 未发布 presentation
+  - 未发布 content bundle
+  - 未发布 runtime
+
+当前接口中的：
+
+- `currentPresentation`
+- `currentContentBundle`
+
+在玩家链路里表示的是：
+
+- 当前已发布 release 上实际绑定的展示版本摘要
+- 当前已发布 release 上实际绑定的内容包摘要
+
+不是：
+
+- event 草稿默认值摘要
+
+所以如果当前 release 还没绑定这些对象，玩家页看到空值是正常行为。前端页面应优先：
+
+- 用 `play.canLaunch` 判定是否允许进入
+- 把空值解释成“当前未发布或当前发布未绑定”
+
+当前 `canLaunch` 已按正式进入规则收紧：
+
+- 只有当当前 event 满足以下条件时，`play.canLaunch = true`
+  - event `status = active`
+  - 已存在当前发布 release
+  - 当前发布 release 有 `manifest`
+  - 当前发布 release 已绑定 `runtime`
+  - 当前发布 release 已绑定 `presentation`
+  - 当前发布 release 已绑定 `content bundle`
+
+当前 `POST /events/{eventPublicID}/launch` 也已与 `canLaunch` 保持同一套前置条件。
+
 ### 3.1 开发阶段先不用 Redis

 当前第一版全部依赖：
--- a/backend/docs/接口清单.md
+++ b/backend/docs/接口清单.md
@@ -1,6 +1,6 @@
 # API 清单
-> 文档版本：v1.9
-> 最后更新：2026-04-03 16:16:38
+> 文档版本：v1.12
+> 最后更新：2026-04-03 22:34:08


 本文档只记录当前 backend 已实现接口，不写未来规划接口。
@@ -95,12 +95,23 @@
 用途：

 - 返回入口首页卡片
+- 当前卡片摘要字段已统一补齐：
+  - `summary`
+  - `status`
+  - `statusCode`
+  - `timeWindow`
+  - `ctaText`
+  - `isDefaultExperience`
+  - `eventType`
+  - `currentPresentation`
+  - `currentContentBundle`

 ### `GET /cards`

 用途：

 - 只返回卡片列表
+- 当前与 `/home` 使用同一套卡片摘要语义

 ### `GET /me/entry-home`

@@ -111,6 +122,7 @@
 用途：

 - 首页聚合接口
+- 当前 `cards` 也已统一使用活动卡片最小摘要字段

 返回重点：

@@ -179,6 +191,15 @@
 - `play.ongoingSession`
 - `play.recentSession`

+当前 `play.canLaunch=true` 的最小前置条件为：
+
+- event `status = active`
+- 当前已发布 release 存在
+- 当前已发布 release 有 `manifest`
+- 当前已发布 release 已绑定 `runtime`
+- 当前已发布 release 已绑定 `presentation`
+- 当前已发布 release 已绑定 `content bundle`
+
 当前摘要字段最少包括：

 - `currentPresentation.presentationId`
@@ -210,6 +231,12 @@
 - 如果当前 release 声明了 `play.courseVariants[]`
 - `launch` 会返回最终绑定的 `launch.variant`
 - 当前为兼容旧调用方，`assignmentMode=manual` 且未传 `variantId` 时，backend 会先回退到首个可选 variant
+- 当前 `launch` 与 `play.canLaunch` 使用同一套前置条件
+- 若当前发布 release 缺少：
+  - `runtime`
+  - `presentation`
+  - `content bundle`
+  之一，`launch` 会直接返回 `409`

 返回重点：

@@ -530,6 +557,38 @@
  - `playfield.kind`
  - `game.mode`

+### `GET /dev/demo-assets/presentations/{demoKey}`
+
+环境：
+
+- 仅 non-production
+
+用途：
+
+- 返回联调用的示例展示定义 schema
+- 给 workbench 的玩法切换自动填充真实 `presentation schema` 资源地址
+
+路径参数：
+
+- `demoKey`
+  - 当前支持：`classic`、`score-o`、`manual-variant`
+
+### `GET /dev/demo-assets/content-manifests/{demoKey}`
+
+环境：
+
+- 仅 non-production
+
+用途：
+
+- 返回联调用的示例内容 manifest
+- 给 workbench 的玩法切换自动填充真实 `content manifest` 资源地址
+
+路径参数：
+
+- `demoKey`
+  - 当前支持：`classic`、`score-o`、`manual-variant`
+
 补充说明：

 - 只用于 workbench 联调排查
@@ -1357,3 +1416,36 @@
 - 查看单个运行绑定详情


+### `GET /home`
+
+用途：
+
+- 返回入口首页摘要
+- 当前卡片摘要字段已统一补齐：
+  - `summary`
+  - `status`
+  - `statusCode`
+  - `timeWindow`
+  - `ctaText`
+  - `isDefaultExperience`
+  - `eventType`
+  - `currentPresentation`
+  - `currentContentBundle`
+
+### `GET /cards`
+
+用途：
+
+- 按入口返回活动卡片列表
+- 当前与 `/home` 使用同一套卡片摘要语义
+
+### `GET /me/entry-home`
+
+鉴权：
+
+- Bearer token
+
+用途：
+
+- 返回“我的首页”聚合
+- 当前 `cards` 也已统一使用活动卡片最小摘要字段
--- a/backend/docs/数据模型.md
+++ b/backend/docs/数据模型.md
@@ -1,8 +1,8 @@
 # 数据模型
-> 文档版本：v1.3
-> 最后更新：2026-04-03 12:36:15
+> 文档版本：v1.4
+> 最后更新：2026-04-03 22:34:08

-当前 migration 共 10 版。
+当前 migration 共 11 版。

 ## 1. 迁移清单

@@ -16,6 +16,7 @@
 - [0008_production_skeleton.sql](D:/dev/cmr-mini/backend/migrations/0008_production_skeleton.sql)
 - [0009_event_ops_phase2.sql](D:/dev/cmr-mini/backend/migrations/0009_event_ops_phase2.sql)
 - [0010_event_default_bindings.sql](D:/dev/cmr-mini/backend/migrations/0010_event_default_bindings.sql)
+- [0011_card_summary.sql](D:/dev/cmr-mini/backend/migrations/0011_card_summary.sql)

 ## 2. 表分组

@@ -78,6 +79,16 @@
 - 支撑首页卡片
 - 运营入口聚合
 - tenant/channel 维度展示控制
+- 默认体验活动标记
+
+当前补充字段：
+
+- `cards.is_default_experience`
+
+当前说明：
+
+- 活动卡片列表第一刀先通过卡片显式字段承接“默认体验活动 / 普通活动”区分
+- `timeWindow / ctaText / status` 当前先由 backend 摘要层派生，不再额外新增对象层级

 ### 2.5 运行态

--- a/backend/docs/核心流程.md
+++ b/backend/docs/核心流程.md
@@ -1,6 +1,6 @@
 # 核心流程
-> 文档版本：v1.2
-> 最后更新：2026-04-03 11:22:50
+> 文档版本：v1.3
+> 最后更新：2026-04-03 18:16:19


 ## 1. 总流程
@@ -104,6 +104,17 @@ APP 当前主链是手机号验证码：
 - 是否有 ongoing session
 - 当前推荐动作是什么

+补充规则：
+
+- `play.canLaunch` 不是“有 event 就能进”
+- 它当前表示“当前发布 release 已完整可启动”
+- 最小要求为：
+  - 已发布 release 存在
+  - manifest 存在
+  - runtime 已绑定
+  - presentation 已绑定
+  - content bundle 已绑定
+
 当前聚合接口：

 - `GET /events/{eventPublicID}/play`
--- a/backend/internal/httpapi/handlers/dev_handler.go
+++ b/backend/internal/httpapi/handlers/dev_handler.go
--- a/backend/internal/httpapi/router.go
+++ b/backend/internal/httpapi/router.go
@@ -109,6 +109,8 @@ func NewRouter(
 		mux.HandleFunc("GET /dev/client-logs", devHandler.ListClientLogs)
 		mux.HandleFunc("DELETE /dev/client-logs", devHandler.ClearClientLogs)
 		mux.HandleFunc("GET /dev/manifest-summary", devHandler.ManifestSummary)
+		mux.HandleFunc("GET /dev/demo-assets/presentations/{demoKey}", devHandler.DemoPresentationSchema)
+		mux.HandleFunc("GET /dev/demo-assets/content-manifests/{demoKey}", devHandler.DemoContentManifest)
 		mux.HandleFunc("GET /dev/config/local-files", configHandler.ListLocalFiles)
 		mux.HandleFunc("POST /dev/events/{eventPublicID}/config-sources/import-local", configHandler.ImportLocal)
 		mux.HandleFunc("POST /dev/config-builds/preview", configHandler.BuildPreview)
--- a/backend/internal/service/event_play_service.go
+++ b/backend/internal/service/event_play_service.go
@@ -129,7 +129,7 @@ func (s *EventPlayService) GetEventPlay(ctx context.Context, input EventPlayInpu
 		}
 	}

-	canLaunch := event.Status == "active" && event.CurrentReleaseID != nil && event.ManifestURL != nil
+	canLaunch, launchReason := evaluateEventLaunchReadiness(event)
 	result.Play.CanLaunch = canLaunch
 	if canLaunch {
 		result.Play.LaunchSource = LaunchSourceEventCurrentRelease
@@ -141,13 +141,13 @@ func (s *EventPlayService) GetEventPlay(ctx context.Context, input EventPlayInpu
 		result.Play.Reason = "user has an ongoing session for this event"
 	case canLaunch:
 		result.Play.PrimaryAction = "start"
-		result.Play.Reason = "event is active and launchable"
+		result.Play.Reason = launchReason
 	case result.Play.RecentSession != nil:
 		result.Play.PrimaryAction = "review_last_result"
-		result.Play.Reason = "event is not launchable, but user has previous session history"
+		result.Play.Reason = launchReason + ", but user has previous session history"
 	default:
 		result.Play.PrimaryAction = "unavailable"
-		result.Play.Reason = "event is not launchable"
+		result.Play.Reason = launchReason
 	}

 	return result, nil
--- a/backend/internal/service/event_service.go
+++ b/backend/internal/service/event_service.go
@@ -152,11 +152,8 @@ func (s *EventService) LaunchEvent(ctx context.Context, input LaunchEventInput)
 	if event == nil {
 		return nil, apperr.New(http.StatusNotFound, "event_not_found", "event not found")
 	}
-	if event.Status != "active" {
-		return nil, apperr.New(http.StatusConflict, "event_not_launchable", "event is not active")
-	}
-	if event.CurrentReleaseID == nil || event.CurrentReleasePubID == nil || event.ConfigLabel == nil || event.ManifestURL == nil {
-		return nil, apperr.New(http.StatusConflict, "event_release_missing", "event does not have a published release")
+	if canLaunch, reason := evaluateEventLaunchReadiness(event); !canLaunch {
+		return nil, launchReadinessError(reason)
 	}
 	if input.ReleaseID != "" && input.ReleaseID != *event.CurrentReleasePubID {
 		return nil, apperr.New(http.StatusConflict, "release_not_launchable", "requested release is not the current published release")
--- a/backend/internal/service/home_service.go
+++ b/backend/internal/service/home_service.go
@@ -24,17 +24,27 @@ type ListCardsInput struct {
 }

 type CardResult struct {
-	ID              string  `json:"id"`
-	Type            string  `json:"type"`
-	Title           string  `json:"title"`
-	Subtitle        *string `json:"subtitle,omitempty"`
-	CoverURL        *string `json:"coverUrl,omitempty"`
-	DisplaySlot     string  `json:"displaySlot"`
-	DisplayPriority int     `json:"displayPriority"`
-	Event           *struct {
+	ID                   string                    `json:"id"`
+	Type                 string                    `json:"type"`
+	Title                string                    `json:"title"`
+	Subtitle             *string                   `json:"subtitle,omitempty"`
+	Summary              *string                   `json:"summary,omitempty"`
+	CoverURL             *string                   `json:"coverUrl,omitempty"`
+	DisplaySlot          string                    `json:"displaySlot"`
+	DisplayPriority      int                       `json:"displayPriority"`
+	Status               string                    `json:"status"`
+	StatusCode           string                    `json:"statusCode"`
+	TimeWindow           string                    `json:"timeWindow"`
+	CTAText              string                    `json:"ctaText"`
+	IsDefaultExperience  bool                      `json:"isDefaultExperience"`
+	EventType            *string                   `json:"eventType,omitempty"`
+	CurrentPresentation  *PresentationSummaryView  `json:"currentPresentation,omitempty"`
+	CurrentContentBundle *ContentBundleSummaryView `json:"currentContentBundle,omitempty"`
+	Event                *struct {
 		ID          string  `json:"id"`
 		DisplayName string  `json:"displayName"`
 		Summary     *string `json:"summary,omitempty"`
+		Status      *string `json:"status,omitempty"`
 	} `json:"event,omitempty"`
 	HTMLURL *string `json:"htmlUrl,omitempty"`
 }
@@ -128,23 +138,35 @@ func normalizeSlot(slot string) string {
 func mapCards(cards []postgres.Card) []CardResult {
 	results := make([]CardResult, 0, len(cards))
 	for _, card := range cards {
+		statusCode, statusText := deriveCardStatus(card)
 		item := CardResult{
-			ID:              card.PublicID,
-			Type:            card.CardType,
-			Title:           card.Title,
-			Subtitle:        card.Subtitle,
-			CoverURL:        card.CoverURL,
-			DisplaySlot:     card.DisplaySlot,
-			DisplayPriority: card.DisplayPriority,
-			HTMLURL:         card.HTMLURL,
+			ID:                   card.PublicID,
+			Type:                 card.CardType,
+			Title:                fallbackCardTitle(card.Title),
+			Subtitle:             card.Subtitle,
+			Summary:              fallbackCardSummary(card.EventSummary),
+			CoverURL:             card.CoverURL,
+			DisplaySlot:          card.DisplaySlot,
+			DisplayPriority:      card.DisplayPriority,
+			Status:               statusText,
+			StatusCode:           statusCode,
+			TimeWindow:           deriveCardTimeWindow(card),
+			CTAText:              deriveCardCTAText(card, statusCode),
+			IsDefaultExperience:  card.IsDefaultExperience,
+			EventType:            deriveCardEventType(card),
+			CurrentPresentation:  buildCardPresentationSummary(card),
+			CurrentContentBundle: buildCardContentBundleSummary(card),
+			HTMLURL:              card.HTMLURL,
 		}
 		if card.EventPublicID != nil || card.EventDisplayName != nil {
 			item.Event = &struct {
 				ID          string  `json:"id"`
 				DisplayName string  `json:"displayName"`
 				Summary     *string `json:"summary,omitempty"`
+				Status      *string `json:"status,omitempty"`
 			}{
 				Summary: card.EventSummary,
+				Status:  card.EventStatus,
 			}
 			if card.EventPublicID != nil {
 				item.Event.ID = *card.EventPublicID
@@ -157,3 +179,134 @@ func mapCards(cards []postgres.Card) []CardResult {
 	}
 	return results
 }
+
+func fallbackCardTitle(title string) string {
+	title = strings.TrimSpace(title)
+	if title == "" {
+		return "未命名活动"
+	}
+	return title
+}
+
+func fallbackCardSummary(summary *string) *string {
+	if summary != nil && strings.TrimSpace(*summary) != "" {
+		return summary
+	}
+	text := "当前暂无活动摘要"
+	return &text
+}
+
+func deriveCardStatus(card postgres.Card) (string, string) {
+	if card.EventStatus == nil {
+		return "pending", "状态待确认"
+	}
+	switch strings.TrimSpace(*card.EventStatus) {
+	case "active":
+		if card.EventCurrentReleasePubID == nil {
+			return "upcoming", "即将开始"
+		}
+		if card.EventRuntimeBindingID == nil || card.EventPresentationID == nil || card.EventContentBundleID == nil {
+			return "upcoming", "即将开始"
+		}
+		return "running", "进行中"
+	case "archived", "disabled", "inactive":
+		return "ended", "已结束"
+	default:
+		return "pending", "状态待确认"
+	}
+}
+
+func deriveCardTimeWindow(card postgres.Card) string {
+	if card.StartsAt == nil && card.EndsAt == nil {
+		return "时间待公布"
+	}
+	const layout = "01-02 15:04"
+	switch {
+	case card.StartsAt != nil && card.EndsAt != nil:
+		return card.StartsAt.Local().Format(layout) + " - " + card.EndsAt.Local().Format(layout)
+	case card.StartsAt != nil:
+		return "开始于 " + card.StartsAt.Local().Format(layout)
+	default:
+		return "截止至 " + card.EndsAt.Local().Format(layout)
+	}
+}
+
+func deriveCardCTAText(card postgres.Card, statusCode string) string {
+	if card.IsDefaultExperience {
+		return "进入体验"
+	}
+	switch statusCode {
+	case "running":
+		return "进入活动"
+	case "ended":
+		return "查看回顾"
+	default:
+		return "查看详情"
+	}
+}
+
+func deriveCardEventType(card postgres.Card) *string {
+	if card.EventReleasePayloadJSON != nil {
+		payload, err := decodeJSONObject(*card.EventReleasePayloadJSON)
+		if err == nil {
+			if game, ok := payload["game"].(map[string]any); ok {
+				if rawMode, ok := game["mode"].(string); ok {
+					switch strings.TrimSpace(rawMode) {
+					case "classic-sequential":
+						text := "顺序赛"
+						return &text
+					case "score-o":
+						text := "积分赛"
+						return &text
+					}
+				}
+			}
+			if plan := resolveVariantPlan(card.EventReleasePayloadJSON); plan.AssignmentMode != nil && *plan.AssignmentMode == AssignmentModeManual {
+				text := "多赛道"
+				return &text
+			}
+		}
+	}
+	if card.IsDefaultExperience {
+		text := "体验活动"
+		return &text
+	}
+	return nil
+}
+
+func buildCardPresentationSummary(card postgres.Card) *PresentationSummaryView {
+	if card.EventPresentationID == nil {
+		return nil
+	}
+	summary := &PresentationSummaryView{
+		PresentationID:   *card.EventPresentationID,
+		Name:             card.EventPresentationName,
+		PresentationType: card.EventPresentationType,
+	}
+	if card.EventPresentationSchemaJSON != nil && strings.TrimSpace(*card.EventPresentationSchemaJSON) != "" {
+		if schema, err := decodeJSONObject(*card.EventPresentationSchemaJSON); err == nil {
+			summary.TemplateKey = readStringField(schema, "templateKey")
+			summary.Version = readStringField(schema, "version")
+		}
+	}
+	return summary
+}
+
+func buildCardContentBundleSummary(card postgres.Card) *ContentBundleSummaryView {
+	if card.EventContentBundleID == nil {
+		return nil
+	}
+	summary := &ContentBundleSummaryView{
+		ContentBundleID: *card.EventContentBundleID,
+		Name:            card.EventContentBundleName,
+		EntryURL:        card.EventContentEntryURL,
+		AssetRootURL:    card.EventContentAssetRootURL,
+	}
+	if card.EventContentMetadataJSON != nil && strings.TrimSpace(*card.EventContentMetadataJSON) != "" {
+		if metadata, err := decodeJSONObject(*card.EventContentMetadataJSON); err == nil {
+			summary.BundleType = readStringField(metadata, "bundleType")
+			summary.Version = readStringField(metadata, "version")
+		}
+	}
+	return summary
+}
--- a/backend/internal/service/launch_rules.go
+++ b/backend/internal/service/launch_rules.go
@@ -0,0 +1,56 @@
+package service
+
+import (
+	"net/http"
+
+	"cmr-backend/internal/apperr"
+	"cmr-backend/internal/store/postgres"
+)
+
+const (
+	launchReadyReasonOK                  = "event is active and launchable"
+	launchReadyReasonNotActive           = "event is not active"
+	launchReadyReasonReleaseMissing      = "event does not have a published release"
+	launchReadyReasonRuntimeMissing      = "current published release is missing runtime binding"
+	launchReadyReasonPresentationMissing = "current published release is missing presentation binding"
+	launchReadyReasonContentMissing      = "current published release is missing content bundle binding"
+)
+
+func evaluateEventLaunchReadiness(event *postgres.Event) (bool, string) {
+	if event == nil {
+		return false, launchReadyReasonReleaseMissing
+	}
+	if event.Status != "active" {
+		return false, launchReadyReasonNotActive
+	}
+	if event.CurrentReleaseID == nil || event.CurrentReleasePubID == nil || event.ConfigLabel == nil || event.ManifestURL == nil {
+		return false, launchReadyReasonReleaseMissing
+	}
+	if buildRuntimeSummaryFromEvent(event) == nil {
+		return false, launchReadyReasonRuntimeMissing
+	}
+	if buildPresentationSummaryFromEvent(event) == nil {
+		return false, launchReadyReasonPresentationMissing
+	}
+	if buildContentBundleSummaryFromEvent(event) == nil {
+		return false, launchReadyReasonContentMissing
+	}
+	return true, launchReadyReasonOK
+}
+
+func launchReadinessError(reason string) error {
+	switch reason {
+	case launchReadyReasonNotActive:
+		return apperr.New(http.StatusConflict, "event_not_launchable", reason)
+	case launchReadyReasonReleaseMissing:
+		return apperr.New(http.StatusConflict, "event_release_missing", reason)
+	case launchReadyReasonRuntimeMissing:
+		return apperr.New(http.StatusConflict, "event_release_runtime_missing", reason)
+	case launchReadyReasonPresentationMissing:
+		return apperr.New(http.StatusConflict, "event_release_presentation_missing", reason)
+	case launchReadyReasonContentMissing:
+		return apperr.New(http.StatusConflict, "event_release_content_bundle_missing", reason)
+	default:
+		return apperr.New(http.StatusConflict, "event_not_launchable", reason)
+	}
+}
--- a/backend/internal/store/postgres/card_store.go
+++ b/backend/internal/store/postgres/card_store.go
@@ -7,19 +7,37 @@ import (
 )

 type Card struct {
-	ID               string
-	PublicID         string
-	CardType         string
-	Title            string
-	Subtitle         *string
-	CoverURL         *string
-	DisplaySlot      string
-	DisplayPriority  int
-	EntryChannelID   *string
-	EventPublicID    *string
-	EventDisplayName *string
-	EventSummary     *string
-	HTMLURL          *string
+	ID                          string
+	PublicID                    string
+	CardType                    string
+	Title                       string
+	Subtitle                    *string
+	CoverURL                    *string
+	DisplaySlot                 string
+	DisplayPriority             int
+	IsDefaultExperience         bool
+	StartsAt                    *time.Time
+	EndsAt                      *time.Time
+	EntryChannelID              *string
+	EventPublicID               *string
+	EventDisplayName            *string
+	EventSummary                *string
+	EventStatus                 *string
+	EventCurrentReleasePubID    *string
+	EventConfigLabel            *string
+	EventRouteCode              *string
+	EventReleasePayloadJSON     *string
+	EventRuntimeBindingID       *string
+	EventPresentationID         *string
+	EventPresentationName       *string
+	EventPresentationType       *string
+	EventPresentationSchemaJSON *string
+	EventContentBundleID        *string
+	EventContentBundleName      *string
+	EventContentEntryURL        *string
+	EventContentAssetRootURL    *string
+	EventContentMetadataJSON    *string
+	HTMLURL                     *string
 }

 func (s *Store) ListCardsForEntry(ctx context.Context, tenantID string, entryChannelID *string, slot string, now time.Time, limit int) ([]Card, error) {
@@ -40,13 +58,35 @@ func (s *Store) ListCardsForEntry(ctx context.Context, tenantID string, entryCha
 			c.cover_url,
 			c.display_slot,
 			c.display_priority,
+			c.is_default_experience,
+			c.starts_at,
+			c.ends_at,
 			c.entry_channel_id,
 			e.event_public_id,
 			e.display_name,
 			e.summary,
+			e.status,
+			er.release_public_id,
+			er.config_label,
+			er.route_code,
+			er.payload_jsonb::text,
+			mrb.runtime_binding_public_id,
+			ep.presentation_public_id,
+			ep.name,
+			ep.presentation_type,
+			ep.schema_jsonb::text,
+			cb.content_bundle_public_id,
+			cb.name,
+			cb.entry_url,
+			cb.asset_root_url,
+			cb.metadata_jsonb::text,
 			c.html_url
 		FROM cards c
 		LEFT JOIN events e ON e.id = c.event_id
+		LEFT JOIN event_releases er ON er.id = e.current_release_id
+		LEFT JOIN map_runtime_bindings mrb ON mrb.id = er.runtime_binding_id
+		LEFT JOIN event_presentations ep ON ep.id = er.presentation_id
+		LEFT JOIN content_bundles cb ON cb.id = er.content_bundle_id
 		WHERE c.tenant_id = $1
 		  AND ($2::uuid IS NULL OR c.entry_channel_id = $2 OR c.entry_channel_id IS NULL)
 		  AND c.display_slot = $3
@@ -76,10 +116,28 @@ func (s *Store) ListCardsForEntry(ctx context.Context, tenantID string, entryCha
 			&card.CoverURL,
 			&card.DisplaySlot,
 			&card.DisplayPriority,
+			&card.IsDefaultExperience,
+			&card.StartsAt,
+			&card.EndsAt,
 			&card.EntryChannelID,
 			&card.EventPublicID,
 			&card.EventDisplayName,
 			&card.EventSummary,
+			&card.EventStatus,
+			&card.EventCurrentReleasePubID,
+			&card.EventConfigLabel,
+			&card.EventRouteCode,
+			&card.EventReleasePayloadJSON,
+			&card.EventRuntimeBindingID,
+			&card.EventPresentationID,
+			&card.EventPresentationName,
+			&card.EventPresentationType,
+			&card.EventPresentationSchemaJSON,
+			&card.EventContentBundleID,
+			&card.EventContentBundleName,
+			&card.EventContentEntryURL,
+			&card.EventContentAssetRootURL,
+			&card.EventContentMetadataJSON,
 			&card.HTMLURL,
 		); err != nil {
 			return nil, fmt.Errorf("scan card: %w", err)
--- a/backend/internal/store/postgres/dev_store.go
+++ b/backend/internal/store/postgres/dev_store.go
@@ -31,6 +31,11 @@ type DemoBootstrapSummary struct {
 	VariantManualEventID   string `json:"variantManualEventId"`
 	VariantManualRelease   string `json:"variantManualReleaseId"`
 	VariantManualCardID    string `json:"variantManualCardId"`
+	VariantManualSourceID  string `json:"variantManualSourceId"`
+	VariantManualBuildID   string `json:"variantManualBuildId"`
+	VariantManualCourseSet string `json:"variantManualCourseSetId"`
+	VariantManualVariantID string `json:"variantManualCourseVariantId"`
+	VariantManualRuntimeID string `json:"variantManualRuntimeBindingId"`
 	CleanedSessionCount    int64  `json:"cleanedSessionCount"`
 }

@@ -44,7 +49,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 	var tenantID string
 	if err := tx.QueryRow(ctx, `
 		INSERT INTO tenants (tenant_code, name, status)
-		VALUES ('tenant_demo', 'Demo Tenant', 'active')
+		VALUES ('tenant_demo', '联调租户', 'active')
 		ON CONFLICT (tenant_code) DO UPDATE SET
 			name = EXCLUDED.name,
 			status = EXCLUDED.status
@@ -58,7 +63,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 		INSERT INTO entry_channels (
 			tenant_id, channel_code, channel_type, platform_app_id, display_name, status, is_default
 		)
-		VALUES ($1, 'mini-demo', 'wechat_mini', 'wx-demo-appid', 'Demo Mini Channel', 'active', true)
+		VALUES ($1, 'mini-demo', 'wechat_mini', 'wx-demo-appid', '小程序联调入口', 'active', true)
 		ON CONFLICT (tenant_id, channel_code) DO UPDATE SET
 			channel_type = EXCLUDED.channel_type,
 			platform_app_id = EXCLUDED.platform_app_id,
@@ -75,7 +80,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 		INSERT INTO events (
 			tenant_id, event_public_id, slug, display_name, summary, status
 		)
-		VALUES ($1, 'evt_demo_001', 'demo-city-run', 'Demo City Run', 'Launch flow demo event', 'active')
+		VALUES ($1, 'evt_demo_001', 'city-park-classic', '领秀城公园顺序赛', '顺序赛联调样例活动', 'active')
 		ON CONFLICT (event_public_id) DO UPDATE SET
 			tenant_id = EXCLUDED.tenant_id,
 			slug = EXCLUDED.slug,
@@ -106,7 +111,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 			'rel_demo_001',
 			$1,
 			1,
-			'Demo Config v1',
+			'顺序赛联调配置 v1',
 			'https://oss-mbh5.colormaprun.com/gotomars/event/releases/evt_demo_001/rel_e7dd953743c5c0d2/manifest.json',
 			'demo-checksum-001',
 			'route-demo-001',
@@ -132,7 +137,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 		return nil, fmt.Errorf("attach demo release: %w", err)
 	}

-	sourceNotes := "demo source config imported from local event sample"
+	sourceNotes := "顺序赛联调 source 配置"
 	source, err := s.UpsertEventConfigSource(ctx, tx, UpsertEventConfigSourceParams{
 		EventID:         eventID,
 		SourceVersionNo: 1,
@@ -144,7 +149,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 		Source: map[string]any{
 			"app": map[string]any{
 				"id":    "sample-classic-001",
-				"title": "顺序赛示例",
+				"title": "领秀城公园顺序赛",
 			},
 			"branding": map[string]any{
 				"tenantCode":   "tenant_demo",
@@ -173,7 +178,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 		return nil, fmt.Errorf("ensure demo event config source: %w", err)
 	}

-	buildLog := "demo build generated from sample classic-sequential.json"
+	buildLog := "顺序赛联调 build 产物"
 	build, err := s.UpsertEventConfigBuild(ctx, tx, UpsertEventConfigBuildParams{
 		EventID:     eventID,
 		SourceID:    source.ID,
@@ -186,7 +191,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 			"version":       "2026.04.01",
 			"app": map[string]any{
 				"id":    "sample-classic-001",
-				"title": "顺序赛示例",
+				"title": "领秀城公园顺序赛",
 			},
 			"map": map[string]any{
 				"tiles":   "https://oss-mbh5.colormaprun.com/gotomars/map/lxcb-001/tiles/",
@@ -296,20 +301,26 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 			event_id,
 			display_slot,
 			display_priority,
-			status
+			status,
+			is_default_experience,
+			starts_at,
+			ends_at
 		)
 		VALUES (
 			'card_demo_001',
 			$1,
 			$2,
 			'event',
-			'Demo City Run',
-			'今日推荐路线',
+			'领秀城公园顺序赛',
+			'顺序赛推荐入口',
 			'https://oss-mbh5.colormaprun.com/gotomars/assets/demo-cover.jpg',
 			$3,
 			'home_primary',
 			100,
-			'active'
+			'active',
+			true,
+			NOW() - INTERVAL '1 day',
+			NOW() + INTERVAL '30 day'
 		)
 		ON CONFLICT (card_public_id) DO UPDATE SET
 			tenant_id = EXCLUDED.tenant_id,
@@ -321,7 +332,10 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 			event_id = EXCLUDED.event_id,
 			display_slot = EXCLUDED.display_slot,
 			display_priority = EXCLUDED.display_priority,
-			status = EXCLUDED.status
+			status = EXCLUDED.status,
+			is_default_experience = EXCLUDED.is_default_experience,
+			starts_at = EXCLUDED.starts_at,
+			ends_at = EXCLUDED.ends_at
 		RETURNING card_public_id
 	`, tenantID, channelID, eventID).Scan(&cardPublicID); err != nil {
 		return nil, fmt.Errorf("ensure demo card: %w", err)
@@ -333,7 +347,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 			place_public_id, code, name, region, status
 		)
 		VALUES (
-			'place_demo_001', 'place-demo-001', 'Demo Park', 'Shanghai', 'active'
+			'place_demo_001', 'place-demo-001', '领秀城公园', 'Shanghai', 'active'
 		)
 		ON CONFLICT (code) DO UPDATE SET
 			name = EXCLUDED.name,
@@ -350,7 +364,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 			map_asset_public_id, place_id, code, name, map_type, status
 		)
 		VALUES (
-			'mapasset_demo_001', $1, 'mapasset-demo-001', 'Demo Asset Map', 'standard', 'active'
+			'mapasset_demo_001', $1, 'mapasset-demo-001', '领秀城公园基础底图', 'standard', 'active'
 		)
 		ON CONFLICT (code) DO UPDATE SET
 			place_id = EXCLUDED.place_id,
@@ -429,7 +443,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 			course_set_public_id, place_id, map_asset_id, code, mode, name, status
 		)
 		VALUES (
-			'cset_demo_001', $1, $2, 'cset-demo-001', 'classic-sequential', 'Demo Course Set', 'active'
+			'cset_demo_001', $1, $2, 'cset-demo-001', 'classic-sequential', '顺序赛标准赛道', 'active'
 		)
 		ON CONFLICT (code) DO UPDATE SET
 			place_id = EXCLUDED.place_id,
@@ -448,7 +462,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 			course_variant_public_id, course_set_id, source_id, name, route_code, mode, control_count, status, is_default
 		)
 		VALUES (
-			'cvariant_demo_001', $1, $2, 'Demo Variant A', 'route-demo-a', 'classic-sequential', 8, 'active', true
+			'cvariant_demo_001', $1, $2, '顺序赛 A 线', 'route-demo-a', 'classic-sequential', 8, 'active', true
 		)
 		ON CONFLICT (course_variant_public_id) DO UPDATE SET
 			course_set_id = EXCLUDED.course_set_id,
@@ -470,7 +484,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 			course_variant_public_id, course_set_id, source_id, name, route_code, mode, control_count, status, is_default
 		)
 		VALUES (
-			'cvariant_demo_002', $1, $2, 'Demo Variant B', 'route-demo-b', 'classic-sequential', 10, 'active', false
+			'cvariant_demo_002', $1, $2, '顺序赛 B 线', 'route-demo-b', 'classic-sequential', 10, 'active', false
 		)
 		ON CONFLICT (course_variant_public_id) DO UPDATE SET
 			course_set_id = EXCLUDED.course_set_id,
@@ -500,7 +514,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 			runtime_binding_public_id, event_id, place_id, map_asset_id, tile_release_id, course_set_id, course_variant_id, status, notes
 		)
 		VALUES (
-			'runtime_demo_001', $1, $2, $3, $4, $5, $6, 'active', 'demo runtime binding'
+			'runtime_demo_001', $1, $2, $3, $4, $5, $6, 'active', '顺序赛联调运行绑定'
 		)
 		ON CONFLICT (runtime_binding_public_id) DO UPDATE SET
 			event_id = EXCLUDED.event_id,
@@ -521,7 +535,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 		INSERT INTO events (
 			tenant_id, event_public_id, slug, display_name, summary, status
 		)
-		VALUES ($1, 'evt_demo_variant_manual_001', 'demo-variant-manual-run', 'Demo Variant Manual Run', 'Manual 多赛道联调活动', 'active')
+		VALUES ($1, 'evt_demo_variant_manual_001', 'city-park-manual-variant', '领秀城公园多赛道挑战', '手动多赛道联调样例活动', 'active')
 		ON CONFLICT (event_public_id) DO UPDATE SET
 			tenant_id = EXCLUDED.tenant_id,
 			slug = EXCLUDED.slug,
@@ -553,7 +567,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 			'rel_demo_variant_manual_001',
 			$1,
 			1,
-			'Demo Variant Manual Config v1',
+			'多赛道联调配置 v1',
 			'https://oss-mbh5.colormaprun.com/gotomars/event/releases/evt_demo_001/rel_e7dd953743c5c0d2/manifest.json',
 			'demo-variant-checksum-001',
 			'route-variant-a',
@@ -614,20 +628,26 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 			event_id,
 			display_slot,
 			display_priority,
-			status
+			status,
+			is_default_experience,
+			starts_at,
+			ends_at
 		)
 		VALUES (
 			'card_demo_variant_manual_001',
 			$1,
 			$2,
 			'event',
-			'Demo Variant Manual Run',
-			'多赛道手动选择联调',
+			'领秀城公园多赛道挑战',
+			'手动选择赛道入口',
 			'https://oss-mbh5.colormaprun.com/gotomars/assets/demo-cover.jpg',
 			$3,
 			'home_primary',
 			95,
-			'active'
+			'active',
+			false,
+			NOW() - INTERVAL '1 day',
+			NOW() + INTERVAL '30 day'
 		)
 		ON CONFLICT (card_public_id) DO UPDATE SET
 			tenant_id = EXCLUDED.tenant_id,
@@ -639,18 +659,242 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 			event_id = EXCLUDED.event_id,
 			display_slot = EXCLUDED.display_slot,
 			display_priority = EXCLUDED.display_priority,
-			status = EXCLUDED.status
+			status = EXCLUDED.status,
+			is_default_experience = EXCLUDED.is_default_experience,
+			starts_at = EXCLUDED.starts_at,
+			ends_at = EXCLUDED.ends_at
 		RETURNING card_public_id
 	`, tenantID, channelID, manualEventID).Scan(&manualCardPublicID); err != nil {
 		return nil, fmt.Errorf("ensure variant manual demo card: %w", err)
 	}

+	manualSourceNotes := "多赛道联调 source 配置"
+	manualSource, err := s.UpsertEventConfigSource(ctx, tx, UpsertEventConfigSourceParams{
+		EventID:         manualEventID,
+		SourceVersionNo: 1,
+		SourceKind:      "event_bundle",
+		SchemaID:        "event-source",
+		SchemaVersion:   "1",
+		Status:          "active",
+		Notes:           &manualSourceNotes,
+		Source: map[string]any{
+			"schemaVersion": "1",
+			"app": map[string]any{
+				"id":    "sample-variant-manual-001",
+				"title": "领秀城公园多赛道挑战",
+			},
+			"branding": map[string]any{
+				"tenantCode":   "tenant_demo",
+				"entryChannel": "mini-demo",
+			},
+			"map": map[string]any{
+				"tiles":   "../map/lxcb-001/tiles/",
+				"mapmeta": "../map/lxcb-001/tiles/meta.json",
+			},
+			"playfield": map[string]any{
+				"kind": "course",
+				"source": map[string]any{
+					"type": "kml",
+					"url":  "../kml/lxcb-001/10/c01.kml",
+				},
+			},
+			"game": map[string]any{
+				"mode": "classic-sequential",
+			},
+			"play": map[string]any{
+				"assignmentMode": "manual",
+				"courseVariants": []map[string]any{
+					{
+						"id":          "variant_a",
+						"name":        "A 线",
+						"description": "短线体验版（c01.kml）",
+						"routeCode":   "route-variant-a",
+						"selectable":  true,
+					},
+					{
+						"id":          "variant_b",
+						"name":        "B 线",
+						"description": "长线挑战版（c02.kml）",
+						"routeCode":   "route-variant-b",
+						"selectable":  true,
+					},
+				},
+			},
+			"content": map[string]any{
+				"h5Template": "content-h5-test-template.html",
+			},
+		},
+	})
+	if err != nil {
+		return nil, fmt.Errorf("ensure variant manual demo event config source: %w", err)
+	}
+
+	manualBuildLog := "多赛道联调 build 产物"
+	manualBuild, err := s.UpsertEventConfigBuild(ctx, tx, UpsertEventConfigBuildParams{
+		EventID:     manualEventID,
+		SourceID:    manualSource.ID,
+		BuildNo:     1,
+		BuildStatus: "success",
+		BuildLog:    &manualBuildLog,
+		Manifest: map[string]any{
+			"schemaVersion": "1",
+			"releaseId":     "rel_demo_variant_manual_001",
+			"version":       "2026.04.01",
+			"app": map[string]any{
+				"id":    "sample-variant-manual-001",
+				"title": "领秀城公园多赛道挑战",
+			},
+			"map": map[string]any{
+				"tiles":   "https://oss-mbh5.colormaprun.com/gotomars/map/lxcb-001/tiles/",
+				"mapmeta": "https://oss-mbh5.colormaprun.com/gotomars/map/lxcb-001/tiles/meta.json",
+			},
+			"playfield": map[string]any{
+				"kind": "course",
+				"source": map[string]any{
+					"type": "kml",
+					"url":  "https://oss-mbh5.colormaprun.com/gotomars/kml/lxcb-001/10/c01.kml",
+				},
+			},
+			"game": map[string]any{
+				"mode": "classic-sequential",
+			},
+			"play": map[string]any{
+				"assignmentMode": "manual",
+				"courseVariants": []map[string]any{
+					{
+						"id":          "variant_a",
+						"name":        "A 线",
+						"description": "短线体验版（c01.kml）",
+						"routeCode":   "route-variant-a",
+						"selectable":  true,
+					},
+					{
+						"id":          "variant_b",
+						"name":        "B 线",
+						"description": "长线挑战版（c02.kml）",
+						"routeCode":   "route-variant-b",
+						"selectable":  true,
+					},
+				},
+			},
+			"assets": map[string]any{
+				"contentHtml": "https://oss-mbh5.colormaprun.com/gotomars/event/content-h5-test-template.html",
+			},
+		},
+		AssetIndex: []map[string]any{
+			{"assetType": "manifest", "assetKey": "manifest"},
+			{"assetType": "mapmeta", "assetKey": "mapmeta"},
+			{"assetType": "playfield", "assetKey": "playfield-kml"},
+			{"assetType": "content_html", "assetKey": "content-html"},
+		},
+	})
+	if err != nil {
+		return nil, fmt.Errorf("ensure variant manual demo event config build: %w", err)
+	}
+
+	if err := s.AttachBuildToRelease(ctx, tx, manualReleaseRow.ID, manualBuild.ID); err != nil {
+		return nil, fmt.Errorf("attach variant manual demo build to release: %w", err)
+	}
+
+	var manualCourseSetID, manualCourseSetPublicID string
+	if err := tx.QueryRow(ctx, `
+		INSERT INTO course_sets (
+			course_set_public_id, place_id, map_asset_id, code, mode, name, status
+		)
+		VALUES (
+			'cset_demo_variant_manual_001', $1, $2, 'cset-demo-variant-manual-001', 'classic-sequential', '多赛道挑战赛道集', 'active'
+		)
+		ON CONFLICT (code) DO UPDATE SET
+			place_id = EXCLUDED.place_id,
+			map_asset_id = EXCLUDED.map_asset_id,
+			mode = EXCLUDED.mode,
+			name = EXCLUDED.name,
+			status = EXCLUDED.status
+		RETURNING id, course_set_public_id
+	`, placeID, mapAssetID).Scan(&manualCourseSetID, &manualCourseSetPublicID); err != nil {
+		return nil, fmt.Errorf("ensure variant manual demo course set: %w", err)
+	}
+
+	var manualVariantAID string
+	if err := tx.QueryRow(ctx, `
+		INSERT INTO course_variants (
+			course_variant_public_id, course_set_id, source_id, name, route_code, mode, control_count, status, is_default
+		)
+		VALUES (
+			'cvariant_demo_variant_manual_a', $1, $2, '多赛道 A 线', 'route-variant-a', 'classic-sequential', 8, 'active', false
+		)
+		ON CONFLICT (course_variant_public_id) DO UPDATE SET
+			course_set_id = EXCLUDED.course_set_id,
+			source_id = EXCLUDED.source_id,
+			name = EXCLUDED.name,
+			route_code = EXCLUDED.route_code,
+			mode = EXCLUDED.mode,
+			control_count = EXCLUDED.control_count,
+			status = EXCLUDED.status,
+			is_default = EXCLUDED.is_default
+		RETURNING id
+	`, manualCourseSetID, courseSourceID).Scan(&manualVariantAID); err != nil {
+		return nil, fmt.Errorf("ensure variant manual demo variant a: %w", err)
+	}
+
+	var manualVariantBID, manualVariantBPublicID string
+	if err := tx.QueryRow(ctx, `
+		INSERT INTO course_variants (
+			course_variant_public_id, course_set_id, source_id, name, route_code, mode, control_count, status, is_default
+		)
+		VALUES (
+			'cvariant_demo_variant_manual_b', $1, $2, '多赛道 B 线', 'route-variant-b', 'classic-sequential', 10, 'active', true
+		)
+		ON CONFLICT (course_variant_public_id) DO UPDATE SET
+			course_set_id = EXCLUDED.course_set_id,
+			source_id = EXCLUDED.source_id,
+			name = EXCLUDED.name,
+			route_code = EXCLUDED.route_code,
+			mode = EXCLUDED.mode,
+			control_count = EXCLUDED.control_count,
+			status = EXCLUDED.status,
+			is_default = EXCLUDED.is_default
+		RETURNING id, course_variant_public_id
+	`, manualCourseSetID, courseSourceVariantBID).Scan(&manualVariantBID, &manualVariantBPublicID); err != nil {
+		return nil, fmt.Errorf("ensure variant manual demo variant b: %w", err)
+	}
+
+	if _, err := tx.Exec(ctx, `
+		UPDATE course_sets
+		SET current_variant_id = $2
+		WHERE id = $1
+	`, manualCourseSetID, manualVariantBID); err != nil {
+		return nil, fmt.Errorf("attach variant manual demo course variant: %w", err)
+	}
+
+	var manualRuntimeBindingID, manualRuntimeBindingPublicID string
+	if err := tx.QueryRow(ctx, `
+		INSERT INTO map_runtime_bindings (
+			runtime_binding_public_id, event_id, place_id, map_asset_id, tile_release_id, course_set_id, course_variant_id, status, notes
+		)
+		VALUES (
+			'runtime_demo_variant_manual_001', $1, $2, $3, $4, $5, $6, 'active', '多赛道联调运行绑定'
+		)
+		ON CONFLICT (runtime_binding_public_id) DO UPDATE SET
+			event_id = EXCLUDED.event_id,
+			place_id = EXCLUDED.place_id,
+			map_asset_id = EXCLUDED.map_asset_id,
+			tile_release_id = EXCLUDED.tile_release_id,
+			course_set_id = EXCLUDED.course_set_id,
+			course_variant_id = EXCLUDED.course_variant_id,
+			status = EXCLUDED.status,
+			notes = EXCLUDED.notes
+		RETURNING id, runtime_binding_public_id
+	`, manualEventID, placeID, mapAssetID, tileReleaseID, manualCourseSetID, manualVariantBID).Scan(&manualRuntimeBindingID, &manualRuntimeBindingPublicID); err != nil {
+		return nil, fmt.Errorf("ensure variant manual demo runtime binding: %w", err)
+	}
+
 	var scoreOEventID string
 	if err := tx.QueryRow(ctx, `
 		INSERT INTO events (
 			tenant_id, event_public_id, slug, display_name, summary, status
 		)
-		VALUES ($1, 'evt_demo_score_o_001', 'demo-score-o-run', 'Demo Score-O Run', '积分赛联调活动', 'active')
+		VALUES ($1, 'evt_demo_score_o_001', 'city-park-score-o', '领秀城公园积分赛', '积分赛联调样例活动', 'active')
 		ON CONFLICT (event_public_id) DO UPDATE SET
 			tenant_id = EXCLUDED.tenant_id,
 			slug = EXCLUDED.slug,
@@ -681,7 +925,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 			'rel_demo_score_o_001',
 			$1,
 			1,
-			'Demo Score-O Config v1',
+			'积分赛联调配置 v1',
 			'https://oss-mbh5.colormaprun.com/gotomars/event/score-o.json',
 			'demo-score-o-checksum-001',
 			'route-score-o-001',
@@ -707,7 +951,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 		return nil, fmt.Errorf("attach score-o demo release: %w", err)
 	}

-	scoreOSourceNotes := "demo source config imported from local event sample score-o"
+	scoreOSourceNotes := "积分赛联调 source 配置"
 	scoreOSource, err := s.UpsertEventConfigSource(ctx, tx, UpsertEventConfigSourceParams{
 		EventID:         scoreOEventID,
 		SourceVersionNo: 1,
@@ -720,7 +964,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 			"schemaVersion": "1",
 			"app": map[string]any{
 				"id":    "sample-score-o-001",
-				"title": "积分赛示例",
+				"title": "领秀城公园积分赛",
 			},
 			"branding": map[string]any{
 				"tenantCode":   "tenant_demo",
@@ -749,7 +993,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 		return nil, fmt.Errorf("ensure score-o demo event config source: %w", err)
 	}

-	scoreOBuildLog := "demo build generated from sample score-o.json"
+	scoreOBuildLog := "积分赛联调 build 产物"
 	scoreOBuild, err := s.UpsertEventConfigBuild(ctx, tx, UpsertEventConfigBuildParams{
 		EventID:     scoreOEventID,
 		SourceID:    scoreOSource.ID,
@@ -762,7 +1006,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 			"version":       "2026.04.01",
 			"app": map[string]any{
 				"id":    "sample-score-o-001",
-				"title": "积分赛示例",
+				"title": "领秀城公园积分赛",
 			},
 			"map": map[string]any{
 				"tiles":   "https://oss-mbh5.colormaprun.com/gotomars/map/lxcb-001/tiles/",
@@ -810,20 +1054,26 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 			event_id,
 			display_slot,
 			display_priority,
-			status
+			status,
+			is_default_experience,
+			starts_at,
+			ends_at
 		)
 		VALUES (
 			'card_demo_score_o_001',
 			$1,
 			$2,
 			'event',
-			'Demo Score-O Run',
-			'积分赛联调入口',
+			'领秀城公园积分赛',
+			'积分赛推荐入口',
 			'https://oss-mbh5.colormaprun.com/gotomars/assets/demo-cover.jpg',
 			$3,
 			'home_primary',
 			98,
-			'active'
+			'active',
+			false,
+			NOW() - INTERVAL '1 day',
+			NOW() + INTERVAL '30 day'
 		)
 		ON CONFLICT (card_public_id) DO UPDATE SET
 			tenant_id = EXCLUDED.tenant_id,
@@ -835,7 +1085,10 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 			event_id = EXCLUDED.event_id,
 			display_slot = EXCLUDED.display_slot,
 			display_priority = EXCLUDED.display_priority,
-			status = EXCLUDED.status
+			status = EXCLUDED.status,
+			is_default_experience = EXCLUDED.is_default_experience,
+			starts_at = EXCLUDED.starts_at,
+			ends_at = EXCLUDED.ends_at
 		RETURNING card_public_id
 	`, tenantID, channelID, scoreOEventID).Scan(&scoreOCardPublicID); err != nil {
 		return nil, fmt.Errorf("ensure score-o demo card: %w", err)
@@ -847,7 +1100,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 			course_set_public_id, place_id, map_asset_id, code, mode, name, status
 		)
 		VALUES (
-			'cset_demo_score_o_001', $1, $2, 'cset-demo-score-o-001', 'score-o', 'Demo Score-O Course Set', 'active'
+			'cset_demo_score_o_001', $1, $2, 'cset-demo-score-o-001', 'score-o', '积分赛标准赛道', 'active'
 		)
 		ON CONFLICT (code) DO UPDATE SET
 			place_id = EXCLUDED.place_id,
@@ -866,7 +1119,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 			course_variant_public_id, course_set_id, source_id, name, route_code, mode, control_count, status, is_default
 		)
 		VALUES (
-			'cvariant_demo_score_o_001', $1, $2, 'Demo Score-O Variant', 'route-score-o-001', 'score-o', 10, 'active', true
+			'cvariant_demo_score_o_001', $1, $2, '积分赛主赛道', 'route-score-o-001', 'score-o', 10, 'active', true
 		)
 		ON CONFLICT (course_variant_public_id) DO UPDATE SET
 			course_set_id = EXCLUDED.course_set_id,
@@ -896,7 +1149,7 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 			runtime_binding_public_id, event_id, place_id, map_asset_id, tile_release_id, course_set_id, course_variant_id, status, notes
 		)
 		VALUES (
-			'runtime_demo_score_o_001', $1, $2, $3, $4, $5, $6, 'active', 'demo score-o runtime binding'
+			'runtime_demo_score_o_001', $1, $2, $3, $4, $5, $6, 'active', '积分赛联调运行绑定'
 		)
 		ON CONFLICT (runtime_binding_public_id) DO UPDATE SET
 			event_id = EXCLUDED.event_id,
@@ -959,6 +1212,11 @@ func (s *Store) EnsureDemoData(ctx context.Context) (*DemoBootstrapSummary, erro
 		VariantManualEventID:   "evt_demo_variant_manual_001",
 		VariantManualRelease:   manualReleaseRow.PublicID,
 		VariantManualCardID:    manualCardPublicID,
+		VariantManualSourceID:  manualSource.ID,
+		VariantManualBuildID:   manualBuild.ID,
+		VariantManualCourseSet: manualCourseSetPublicID,
+		VariantManualVariantID: manualVariantBPublicID,
+		VariantManualRuntimeID: manualRuntimeBindingPublicID,
 		CleanedSessionCount:    cleanedSessionCount,
 	}, nil
 }
--- a/backend/migrations/0011_card_summary.sql
+++ b/backend/migrations/0011_card_summary.sql
@@ -0,0 +1,6 @@
+BEGIN;
+
+ALTER TABLE cards
+ADD COLUMN is_default_experience BOOLEAN NOT NULL DEFAULT false;
+
+COMMIT;