167 lines
4.2 KiB
Markdown
167 lines
4.2 KiB
Markdown
# b2f
|
||
> 文档版本：v1.0
|
||
> 最后更新：2026-04-02
|
||
|
||
|
||
说明：
|
||
|
||
- 只写事实和请求
|
||
- 每条固定包含：时间、谁提的、当前事实、需要对方确认什么、是否已解决
|
||
|
||
---
|
||
|
||
## 待确认
|
||
|
||
### 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 列表
|
||
- 深入字段说明再看 [接口清单](D:/dev/cmr-mini/backend/docs/接口清单.md)
|
||
- 需要对方确认什么：
|
||
- 无
|
||
- 是否已解决：是
|
||
|
||
---
|
||
|
||
## 阻塞
|
||
|
||
### 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`
|
||
- 预埋“放弃恢复”调用位
|
||
- 是否已解决：否
|
||
|