F2B 协作清单

文档版本：v1.0 最后更新：2026-04-02 08:28:05

说明：

本文件由前端维护，写给后端
只写“事实”和“请求”
不写长讨论稿
每条尽量包含：时间、提出方、当前事实、需要对方确认什么、状态

待确认

F2B-004

时间：2026-04-01
提出方：前端
当前事实：
- 前端当前依赖以下 launch 字段：
- resolvedRelease.manifestUrl
- resolvedRelease.releaseId
- business.sessionId
- business.sessionToken
- business.sessionTokenExpiresAt
需要对方确认什么：
- backend 后续如需调整这些字段名或层级，需先在 b2f.md 明确通知
状态：待确认

F2B-005

时间：2026-04-01
提出方：前端
当前事实：
- ongoing session 目前会影响：
- /me/entry-home
- /events/{eventPublicID}/play
- /sessions/{sessionPublicID}/result
需要对方确认什么：
- cancelled 后不再作为 ongoing 返回
- failed 后不再作为 ongoing 返回
- finished 后结果摘要与首页摘要口径一致
状态：待确认

已确认

F2B-C001

时间：2026-04-01
提出方：前端
当前事实：
- 正式联调时，前端以 backend launch 下发的 release/manifest 为准
- 不再回退到本地 event/*.json
需要对方确认什么：
- 无
状态：已确认

F2B-C002

时间：2026-04-01
提出方：前端
当前事实：
- 前后端协作文档改为双文件：
- f2b.md 由前端维护
- b2f.md 由后端维护
需要对方确认什么：
- 无
状态：已确认

F2B-C003

时间：2026-04-02
提出方：前端
当前事实：
- backend 已确认 session 三态正式语义：
- 正常完成 -> finished
- 超时或规则失败 -> failed
- 主动退出 / 放弃恢复 -> cancelled
- 前端已按这套语义继续联调
需要对方确认什么：
- 无
状态：已确认

F2B-C004

时间：2026-04-02
提出方：前端
当前事实：
- backend 已确认“放弃恢复”官方语义为 finish(cancelled)
- 旧 sessionToken 在该场景下允许继续调用
- 前端当前已正式启用该链路
需要对方确认什么：
- 无
状态：已确认

F2B-C005

时间：2026-04-02
提出方：前端
当前事实：
- backend 已确认 start / finish 按幂等处理
- 前端可继续按当前补报 / 重试逻辑联调
需要对方确认什么：
- 无
状态：已确认

阻塞

F2B-B001

时间：2026-04-01
提出方：前端
当前事实：
- 当前前端主链已基本可联调
- 目前没有新的 backend 阻塞项
需要对方确认什么：
- 无
状态：已解决

已完成

F2B-D001

时间：2026-04-01
提出方：前端
当前事实：
- 小程序已接通：
- 登录
- 首页聚合
- 活动页 play
- launch -> 地图页
- session start
- session finish
- session result
需要对方确认什么：
- 无
状态：已完成

F2B-D002

时间：2026-04-01
提出方：前端
当前事实：
- 小程序已接入故障恢复：
- 检测未正常结束对局
- 弹“继续恢复 / 放弃”
- 继续恢复时恢复本地运行时快照
- 放弃时清本地恢复，并上报 finish(cancelled)
需要对方确认什么：
- 无
状态：已完成

F2B-D003

时间：2026-04-01
提出方：前端
当前事实：
- evt_demo_001 当前 release manifest 已恢复可用
- 前端已能正常进入地图
需要对方确认什么：
- 无
状态：已完成

下一步

F2B-N001

时间：2026-04-02
提出方：前端
当前事实：
- session 生命周期关键语义已由 backend 确认
- 当前前端下一轮重点应转向主链回归与结果展示对齐
需要对方确认什么：
- 无
状态：前端执行中

F2B-N002

时间：2026-04-02
提出方：前端
当前事实：
- 心率 / 卡路里个体化能力已在前端预留
需要对方确认什么：
- 后续是否提供用户身体数据接口
状态：后续事项