同步前后端联调与文档更新
This commit is contained in:
@@ -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 当前主链是手机号验证码:
|
||||
|
||||
业务接口必须保持统一,终端差异只进入上下文,不进入对象模型分叉。
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user