mini-prog/b2f.md

b2f

文档版本：v1.0 最后更新：2026-04-02 09:01:17

说明：

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

---

待确认

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-02
• 谁提的：backend
• 当前事实：
  • backend 已确认 session 三态正式语义：
  • 正常完成 -> finished
  • 超时或规则失败 -> failed
  • 主动退出 / 放弃恢复 -> cancelled
• 需要对方确认什么：
  • frontend 按这套语义继续联调
• 是否已解决：是

B2F-004

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

B2F-005

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

B2F-006

• 时间：2026-04-02
• 谁提的：backend
• 当前事实：
  • backend 已确认“放弃恢复”官方语义为 POST /sessions/{sessionPublicID}/finish 且 status=cancelled
  • 同一局的旧 sessionToken 在该场景允许继续用于 finish(cancelled)
  • cancelled 和 failed 后都不会再作为 ongoingSession 返回
• 需要对方确认什么：
  • frontend 可正式把“放弃恢复”接到 finish(cancelled)
• 是否已解决：是

B2F-007

• 时间：2026-04-02
• 谁提的：backend
• 当前事实：
  • backend 已把 start / finish 收口成幂等处理
  • 重复 start：
  • launched -> 推进到 running
  • running / 终态 -> 直接返回当前 session
  • 重复 finish：
  • 已终态 -> 直接返回当前 session / result
• 需要对方确认什么：
  • frontend 继续按当前补报 / 重试逻辑联调
• 是否已解决：是

---

阻塞

B2F-008

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

---

已完成

B2F-009

• 时间：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-010

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

B2F-011

• 时间：2026-04-02
• 谁提的：backend
• 当前事实：
  • backend 已新增后台第一版资源对象接口：
  • /admin/maps
  • /admin/playfields
  • /admin/resource-packs
  • backend 已新增后台 event 组装接口：
  • /admin/events
  • /admin/events/{eventPublicID}/source
  • 这批接口主要服务后续后台配置运营，不影响当前小程序主链联调
• 需要对方确认什么：
  • 无
• 是否已解决：是

B2F-012

• 时间：2026-04-02
• 谁提的：backend
• 当前事实：
  • backend 已补后台运营闭环接口：
  • GET /admin/events/{eventPublicID}/pipeline
  • POST /admin/sources/{sourceID}/build
  • GET /admin/builds/{buildID}
  • POST /admin/builds/{buildID}/publish
  • 当前后台侧已经可以完成：
  • 资源对象录入
  • event source 组装
  • preview build
  • publish release
• 需要对方确认什么：
  • 无
• 是否已解决：是

B2F-013

• 时间：2026-04-02
• 谁提的：backend
• 当前事实：
  • backend 已补后台 rollback 接口：
  • POST /admin/events/{eventPublicID}/rollback
  • 当前后台侧已具备完整最小闭环：
  • 资源对象
  • event source 组装
  • build
  • publish
  • rollback
• 需要对方确认什么：
  • 无
• 是否已解决：是

---

下一步

B2F-014

• 时间：2026-04-02
• 谁提的：backend
• 当前事实：
  • session P0 已完成一轮收口
  • 当前最值得继续联调确认的是：
  • 放弃恢复 -> finish(cancelled)
  • failed / cancelled 后 ongoing 消失
  • 重复 start / finish 不再打断主链
• 需要对方确认什么：
  • frontend 当前优先配合：
  • 用当前 demo release 回归 play -> launch -> map load
  • 回归“继续恢复 / 放弃恢复”两条路径
  • 如发现状态口径不一致，直接在 f2b.md 标具体接口和返回值
• 是否已解决：否