# T2F 协作清单
> 文档版本：v1.10
> 最后更新：2026-04-03 19:26:23

说明：

- 本文件由总控维护，写给前端线程
- 只写当前阶段实施说明，不写长讨论稿
- 正式架构与长期结论以 `doc/` 下文档为准

---

## 1. 当前目标

当前前端线程已完成：

- 活动运营域摘要接线第一刀
- 活动卡片列表最小产品化第一刀

当前进入：

**活动卡片列表最小产品化第一刀联调回归与小范围修复阶段**

本阶段目标：

- 在 backend 一键测试环境下回归活动列表页第一刀
- 验证卡片字段、分组、跳转与详情页链路稳定
- 只做小范围修复，不扩更多玩家侧新链
- 继续保持 runtime 主链稳定

---

## 2. 当前后端已完成能力

后端当前已完成：

- `GET /events/{eventPublicID}` 透出：
  - `currentPresentation`
  - `currentContentBundle`
- `GET /events/{eventPublicID}/play` 透出：
  - `currentPresentation`
  - `currentContentBundle`
- `POST /events/{eventPublicID}/launch` 透出：
  - `launch.presentation`
  - `launch.contentBundle`
- publish 在未显式传入：
  - `presentationId`
  - `contentBundleId`
  时，可按 event 当前 active 配置自动补齐
- runtime 主链继续保持稳定兼容：
  - `resolvedRelease`
  - `business`
  - `variant`
  - `runtime`
- backend 当前测试能力已升级：
  - `Bootstrap Demo`
  - `一键补齐 Runtime 并发布`
  - `一键标准回归`
  - `回归结果汇总`
  - `当前 Launch 实际配置摘要`
  - 分步日志 / 真实错误 / stack / 最后一次 curl / 预期判定
  - `POST /dev/client-logs`

---

## 3. 当前已完成

### 3.1 活动详情页

已开始展示：

- `currentPresentation`
  - `presentationId`
  - `templateKey`
  - `version`
- `currentContentBundle`
  - `bundleId`
  - `bundleType`
  - `version`

当前仍保持活动运营摘要展示，不做复杂运营样式。

### 3.2 活动准备页

已在当前 runtime 预览摘要旁边补活动运营摘要：

- 当前展示版本
- 当前内容包版本

仍然只做摘要，不重构准备页结构。

### 3.3 launch 会话快照

以下字段已收进当前会话快照：

- `launch.presentation`
- `launch.contentBundle`

这样后续结果页、历史页如果需要继续透出，就不需要重新拼接。

### 3.4 当前阶段仍不做

- 不下发复杂 `schema`
- 不消费完整 `EventPresentation` 结构
- 不把 `ContentBundle` 展开成资源明细
- 不重构首页、结果页、历史页已有结构
- 不做复杂运营化列表
- 不重做首页现有入口区

### 3.5 当前活动列表第一刀已完成

当前已落地：

1. 独立活动列表页：`/pages/events/events`
2. 最小卡片样式
3. 最小筛选：`全部 / 体验`
4. 从列表跳活动详情页
5. 首页补“活动列表”独立入口

当前第一刀最小字段已覆盖：

- `eventId`
- `title`
- `subtitle`
- `summary`
- `status`
- `timeWindow`
- `ctaText`
- `coverUrl`
- `isDefaultExperience`
- `currentPresentation`
- `currentContentBundle`

---

## 4. 当前阶段原则

- 玩家面对的是前端，前端页面必须保持干净、利落、人性化
- 先接新增摘要，不重构整条前端主链
- `resolvedRelease / business / variant` 旧字段继续保留
- runtime 主链已经稳定，不要为了活动运营摘要去动 runtime 主链
- 先做“看得见活动运营对象”，不先做复杂运营化样式
- 当前活动列表第一刀允许扩一个独立列表页，但不扩更多玩家侧新链
- 当前联调应优先复用 backend 一键测试环境，不再各自手工铺多份 demo 对象
- 当前联调应优先复用 backend 提供的结构化诊断链，不再依赖截图 + 口头描述排查

---

## 5. 当前待前端回写

请前端线程后续重点回写：

1. 列表字段是否足够支持当前最小卡片
2. `全部 / 体验` 分组是否符合当前产品预期
3. 卡片点击进入活动详情页是否稳定
4. 是否需要 backend 再补名称摘要、状态字段或默认值
5. 有没有因为活动列表接线影响到 runtime 稳定主链

---

## 6. 当前总控确认

1. 活动运营域摘要第一刀视为已完成
2. 前端当前进入联调回归与小范围修复阶段
3. 当前只接受字段修正、摘要打磨、一致性修复
4. 当前不继续扩更多玩家侧新链，不做复杂运营样式
5. 如果前端发现缺字段，再由总控统一回写给 backend
6. 当前前端下一步重点是配合 backend 的一键测试环境做稳定回归
7. 当前前端继续只做：
   - 联调回归
   - 小范围修复
   - 结构化日志补充
8. 当前活动列表第一刀已完成，暂不进入第二刀产品扩展

---

## 7. 一句话结论

当前前端最重要的事不是继续扩新页面，而是：

**把活动卡片列表最小产品化第一刀先稳住，并统一切到 backend 一键测试环境下做联调回归和小范围修复。**