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

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)