同步前后端联调与文档更新

This commit is contained in:
2026-04-02 09:25:05 +08:00
parent af43beadb0
commit 6964e26ec9
113 changed files with 4317 additions and 293 deletions

View File

@@ -1,6 +1,6 @@
# 核心流程
> 文档版本v1.0
> 最后更新2026-04-02
> 最后更新2026-04-02 08:28:05
## 1. 总流程
@@ -182,6 +182,29 @@ APP 当前主链是手机号验证码:
这保证了业务登录态和一局游戏运行态是分开的。
### 7.3 当前状态语义
- `launched`:已创建一局,客户端尚未正式开始
- `running`:客户端已开始本局
- `finished`:正常完成
- `failed`:超时或规则失败
- `cancelled`:主动退出或放弃恢复
补充约束:
- `cancelled``failed` 都不再作为 ongoing session 返回
- “放弃恢复”当前正式收口为 `finish(cancelled)`
- 同一局旧 `sessionToken``finish(cancelled)` 场景允许继续使用
### 7.4 幂等要求
- `start` 幂等:
- `launched` -> `running`
- 重复 `start` 不应报错
- `finish` 幂等:
- 第一次进入终态后,重复 `finish` 直接返回当前结果
- 这个约束同时服务小程序故障恢复和未来 APP 重试补报
## 8. 结果流程
### 8.1 当前接口
@@ -230,3 +253,4 @@ APP 当前主链是手机号验证码:
业务接口必须保持统一,终端差异只进入上下文,不进入对象模型分叉。