zhangyan/cmr-mini
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
6964e26ec9be8f593b31719f76443905df56bae8
cmr-mini/b2f.md

6.5 KiB
Raw Blame History

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 标具体接口和返回值
  • 是否已解决：否
Reference in New Issue View Git Blame Copy Permalink