mini-prog/b2f.md

b2f

说明：

• 只写事实和请求
• 每条固定包含：时间、谁提的、当前事实、需要对方确认什么、是否已解决

---

待确认

B2F-001

• 时间：2026-04-01
• 谁提的：backend
• 当前事实：
  • backend 当前主链已经可联调：
  • POST /auth/login/wechat-mini
  • GET /me/entry-home
  • GET /events/{eventPublicID}/play
  • POST /events/{eventPublicID}/launch
  • POST /sessions/{sessionPublicID}/start
  • POST /sessions/{sessionPublicID}/finish
  • GET /sessions/{sessionPublicID}/result
  • 当前建议统一使用 demo 入口：
  • eventPublicID = evt_demo_001
  • channelCode = mini-demo
  • channelType = wechat_mini
• 需要对方确认什么：
  • frontend 是否按这组 demo 数据作为当前唯一联调入口
• 是否已解决：否

B2F-002

• 时间：2026-04-01
• 谁提的：backend
• 当前事实：
  • 进入游戏的正式流程必须以 launch 返回值为准
  • backend 当前约定字段：
  • launch.resolvedRelease.releaseId
  • launch.resolvedRelease.manifestUrl
  • launch.resolvedRelease.manifestChecksumSha256
  • launch.config.configUrl
  • launch.config.configLabel
  • launch.config.releaseId
  • launch.config.routeCode
  • launch.business.sessionId
  • launch.business.sessionToken
  • launch.business.sessionTokenExpiresAt
• 需要对方确认什么：
  • frontend 是否确认正式流程只消费上述字段，不再自行推断 release URL
• 是否已解决：否

B2F-003

• 时间：2026-04-01
• 谁提的：backend
• 当前事实：
  • backend 准备把“放弃恢复”收口为 finish(cancelled) 语义
  • 当前语义尚未最终拍板
• 需要对方确认什么：
  • frontend 是否可以先预埋“放弃恢复”调用位，但在语义确认前不默认启用
• 是否已解决：否

---

已确认

B2F-004

• 时间：2026-04-01
• 谁提的：backend
• 当前事实：
  • 正式联调时不应回退到本地样例配置路径
  • 不应直接读取根目录 event/*.json
  • 应只认 launch 返回的 manifestUrl
• 需要对方确认什么：
  • 无
• 是否已解决：是

B2F-005

• 时间：2026-04-01
• 谁提的：backend
• 当前事实：
  • 接口说明优先看 workbench 里的中文 API 列表
  • 深入字段说明再看 接口清单
• 需要对方确认什么：
  • 无
• 是否已解决：是

---

阻塞

B2F-006

• 时间：2026-04-01
• 谁提的：backend
• 当前事实：
  • 如果 frontend 再出现 manifest 加载失败，backend 仅靠一句“加载失败”无法定位
• 需要对方确认什么：
  • 如再出现此类问题，请一次性提供：
  • eventPublicID
  • releaseId
  • manifestUrl
  • 页面报错文案
  • 控制台日志
  • 网络请求日志
• 是否已解决：否

---

已完成

B2F-007

• 时间：2026-04-01
• 谁提的：backend
• 当前事实：
  • backend 已修复 publish build 只写 DB、不上传 OSS 的问题
  • 新发布的 demo release manifest 已可正常访问
  • 当前可用 release：
  • eventPublicID = evt_demo_001
  • releaseId = rel_e7dd953743c5c0d2
  • manifestUrl = https://oss-mbh5.colormaprun.com/gotomars/event/releases/evt_demo_001/rel_e7dd953743c5c0d2/manifest.json
• 需要对方确认什么：
  • 无
• 是否已解决：是

B2F-008

• 时间：2026-04-01
• 谁提的：backend
• 当前事实：
  • backend workbench 已支持中文 API 列表
  • 当前可用于日常联调：
  • POST /dev/bootstrap-demo
  • GET /dev/workbench
• 需要对方确认什么：
  • 无
• 是否已解决：是

---

下一步

B2F-009

• 时间：2026-04-01
• 谁提的：backend
• 当前事实：
  • backend 下一步会优先处理 P0：
  • 固定 finished / failed / cancelled
  • 明确“放弃恢复”是否落 cancelled
  • 收稳 start / finish 幂等
• 需要对方确认什么：
  • frontend 当前优先配合：
  • 用最新 demo release 回归 play -> launch -> map load
  • 确认正式流程只认 launch 返回的 manifestUrl
  • 预埋“放弃恢复”调用位
• 是否已解决：否