1.优化websocket连接

2.修复游戏实施对局显示错误

docs/36字花-移动端接口设计草案.md

@@ -168,7 +168,7 @@
 ### 2.3 获取当前用户信息
 - **POST** `/api/user/profile`
 
-返回参数（金额类字段统一 2 位小数字符串，与 `/api/wallet/balanceSummary` 对齐）：
+返回参数（金额类字段统一 2 位小数字符串，与钱包展示口径一致）：
 
 **基础档案**
 - `uuid`：string（含义：用户对外唯一标识，10 位）
@@ -184,13 +184,13 @@
 - `create_time`：int（含义：注册时间戳）
 
 **资金与提现配额**
-- `coin` / `coin_balance`：string（含义：当前余额；两字段同值，便于与 `/api/wallet/balanceSummary` 平滑切换）
+- `coin` / `coin_balance`：string（含义：当前余额；两字段同值）
 - `frozen_balance`：string（含义：冻结余额；无冻结场景，固定 `0.00`）
 - `total_deposit_coin`：string（含义：累计充值）
 - `total_withdraw_coin`：string（含义：累计提现；受理后累加）
 - `bet_flow_coin`：string（含义：打码量/流水；开奖结算后按每注 `total_amount` 1:1 累加）
 - `max_withdrawable`：string（含义：**当前允许发起的单笔最大提现金额** = `min(coin_balance, max_withdraw_by_flow)`）
-- `withdraw_flow`：object（含义：打码量 / 提现配额诊断快照，结构与 `/api/wallet/balanceSummary.withdraw_flow` 一致，此处额外附 `pending_withdraw`）
+- `withdraw_flow`：object（含义：打码量 / 提现配额诊断快照，此处额外附 `pending_withdraw`）
   - `ratio`：string（打码量倍数；`0` 表示不限打码）
   - `net_deposit`：string（净充值 = max(0, 累计充值 − 累计提现)）
   - `required_bet_flow`：string（按门槛口径所需打码量，纯展示）
@@ -247,24 +247,10 @@
 - `version`：string（含义：字典版本号，前端可用于缓存比对）
 - `items`：同 `dictionary`（含义：36字花字典明细）
 
-### 3.3 获取最近开奖记录（近30期）
-- **POST** `/api/game/periodHistory`
-
-请求参数：
-- `limit`：int（可选，默认 30，含义：返回最近几期）
-
-返回参数：
-- `list`：array<object>
-  - `period_no`：string（含义：历史期号）
-  - `result_number`：int（含义：该期开奖结果）
-  - `open_time`：int（含义：开奖时间）
-
----
-
 ## 4. 下注与对局模块（game/bet）
 
 ### 4.1 获取当前期详情
-- **POST** `/api/game/currentStatus`（兼容旧路径 `/api/game/periodCurrent`）
+- **POST** `/api/game/periodCurrent`
 
 返回参数：
 - `runtime_enabled`：bool（含义：同 `lobbyInit.runtime_enabled`）
@@ -340,29 +326,12 @@
 
 ## 5. 钱包与资金模块（wallet/finance）
 
-### 5.1 获取钱包摘要
-- **POST** `/api/wallet/balanceSummary`
-
-返回参数：
-- `coin_balance`：string（含义：可用余额，等同于 `user.coin`）
-- `frozen_balance`：string（含义：冻结余额；当前系统无冻结场景，固定返回 `0.00`）
-- `withdrawable_balance`：string（含义：可提现余额；等同于 `coin_balance`，**单笔实际上限以 `max_withdrawable` 为准**）
-- `max_withdrawable`：string（含义：**当前允许发起的单笔最大提现金额** = min(`coin_balance`, 打码配额余量)；客户端直接用于"最大可提 XXX"提示与金额输入上限校验）
-- `total_deposit_coin`：string（含义：累计充值币额）
-- `total_withdraw_coin`：string（含义：累计提现币额；提现受理时累加）
-- `bet_flow_coin`：string（含义：打码量/流水；开奖结算后按每注 `total_amount` 1:1 累加）
-- `withdraw_flow`：object（含义：打码量 / 提现配额诊断快照，供前端展示说明与上限推导）
-  - `ratio`：string（含义：打码量倍数，来自 `game_config.withdraw_bet_flow_ratio`，默认 `1.00`；`0` 表示"不限打码"）
-  - `net_deposit`：string（含义：净充值 = max(0, 累计充值 - 累计提现)）
-  - `required_bet_flow`：string（含义：按门槛口径所需的打码量 = 净充值 × 倍数，纯展示）
-  - `remaining_bet_flow`：string（含义：按门槛口径还差多少打码量，纯展示；已达标为 `0.00`）
-  - `eligible`：bool（含义：是否满足整体门槛，纯展示，实际放行以 `max_withdrawable` 为准）
-  - `max_withdraw_by_flow`：string/null（含义：仅按打码量折算的单笔可提上限 = max(0, `bet_flow_coin` / `ratio` - `total_withdraw_coin`)；`ratio=0` 不限打码时返回 `null`）
-  - `flow_unlimited`：bool（含义：是否处于"不限打码"状态，`ratio=0` 时为 `true`）
-
-说明（打码量即提现配额模型）：
-- 每笔提现按 `withdraw_coin × ratio` 消耗打码配额；`total_withdraw_coin` 已累积历史消耗。
-- **单笔最大可提现 `max_withdrawable = min(coin_balance, max_withdraw_by_flow)`**；`ratio=0` 时退化为仅受余额约束。
+### 5.1 余额同步口径（已移除独立摘要接口）
+- 已移除 `/api/wallet/balanceSummary`。
+- 余额同步来源调整为：
+  - 下注返回 `placeBet.balance_after`
+  - WebSocket 推送 `wallet.changed`
+  - 充值/提现详情接口（如 `depositDetail` / `withdrawDetail`）作为业务单据维度核对
 - 倍数 `ratio` 由后台「游戏配置 → `withdraw_bet_flow_ratio`」维护，修改后对新请求立即生效。
 - 历史累计类字段（`total_deposit_coin` / `total_withdraw_coin` / `bet_flow_coin`）均为累加语义；若后续审核驳回，回冲逻辑由后台审核流程负责。
 
@@ -735,15 +704,14 @@
 
 ### 7.2 HTTP 兜底接口
 
-- **当前期状态**：`POST /api/game/currentStatus`（建议 1 秒/次兜底）
-- **开奖记录**：`POST /api/game/periodHistory`（建议 3~5 秒/次兜底）
-- **余额快照**：`POST /api/wallet/balanceSummary`（下注后主动刷新）
+- 本版本已移除以下兜底接口：`/api/game/currentStatus`、`/api/game/periodHistory`、`/api/wallet/balanceSummary`。
+- 状态与余额统一以 WebSocket 推送为主，HTTP 仅保留业务动作/详情查询接口（如 `placeBet`、`depositDetail`、`withdrawDetail`）。
 
 ### 7.3 一致性规则
 
 - 倒计时以服务端下发时间为准，不信任本地时钟累计。
-- 下注成功后以 `placeBet` 返回的 `balance_after` 为准，再调用钱包接口兜底。
-- WebSocket 断线后立即重连，并并发触发 `currentStatus + balanceSummary` 全量回补。
+- 下注成功后以 `placeBet` 返回的 `balance_after` 为准，并等待 `wallet.changed` 同步。
+- WebSocket 断线后立即重连并重新订阅主题，不再依赖 `currentStatus/periodHistory/balanceSummary` 回补。
 
 ---
 
@@ -755,8 +723,8 @@
 3. `POST /api/game/lobbyInit` 拉首页初始化（请求头带 `auth-token`）
 4. 建立 WebSocket（H5）连接，发送订阅消息监听状态流
 5. 用户下注调用 `POST /api/game/placeBet`
-6. 下单后调用 `POST /api/wallet/balanceSummary` 刷新余额（并等待 WebSocket 消息）
-7. 断线或页面回前台时，兜底调用 `currentStatus + periodHistory` 回补状态
+6. 下单后以 `placeBet.balance_after` 与 `wallet.changed` 同步余额
+7. 断线或页面回前台时，重连 WebSocket 并重新订阅主题回补实时状态
 
 ## 8.2 充值到下注到提现闭环
 1. 拉取档位：`POST /api/finance/depositTierList`（玩家选择一档，并记下该档 `channels[].code`）
@@ -765,7 +733,7 @@
    - 未来接真实第三方：将 `pay_url` 换为真网关，入账仅在支付平台 **异步通知** 中调用 `DepositSettlement::settle`（与当前 `depositMockNotify` 路径一致）
 3. 客户端可选轮询 `POST /api/finance/depositDetail` 兜底确认状态；入账成功后会收到 `wallet.changed`
 4. 下注：`POST /api/game/placeBet`
-5. 轮询余额：`POST /api/wallet/balanceSummary`
+5. 监听余额：`wallet.changed`（或按订单详情接口核对）
 6. 查询流水：`POST /api/wallet/recordList`
 7. 提现：`POST /api/finance/withdrawCreate`（即时冻结 `user.coin` 与写出 `withdraw` 流水） -> `POST /api/finance/withdrawDetail`
 
@@ -785,11 +753,11 @@ flowchart TD
   B --> C[连接 WebSocket 并订阅主题]
   C --> D{0-20秒下注期?}
   D -- 是 --> E[提交下注 /api/game/placeBet]
-  E --> F[刷新余额 /api/wallet/balanceSummary]
+  E --> F[等待 wallet.changed 同步余额]
   D -- 否 --> G[进入封盘与开奖阶段]
   G --> H[服务端算票与开奖]
   H --> I[WebSocket 推送状态变化]
-  I --> J[断线兜底 /api/game/currentStatus]
+  I --> J[断线重连并重新订阅]
   J --> C
 ```