Etusivu Tutki Apua
Kirjaudu sisään
zhangyan
/
mini-prog
1
0
Fork 0
Tiedostot Ongelmat 0 Pull-pyynnöt 0 Wiki
Puu: 6964e26ec9
Branchit Tagit
mini-prog
/
b2f.md

b2f.md 6.5 KB
Historia Raaka

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 标具体接口和返回值
  • 是否已解决：否