1.优化中奖后只推送一帧中奖记录消息

This commit is contained in:
2026-05-25 16:46:47 +08:00
parent 21caa6d548
commit c10908b4da
4 changed files with 111 additions and 5 deletions

View File

@@ -823,12 +823,25 @@
#### 7.1.3 推送频率与触发规则(当前实现)
- `period.tick`**每秒一次**(用于倒计时、状态同步;**不含**赔率全表)。
- `period.tick`**仅在 `status ∈ {betting, locked}` 时每秒推送**(用于倒计时、状态同步;**不含**赔率全表)。
- **派彩静默期**`status=payouting`(开奖到派彩宽限期结束)期间**完全不推**,避免覆盖前端的中奖动画/弹窗。中奖玩家依靠同时触发的 `period.opened` / `period.payout` / `jackpot.hit` / `wallet.changed(biz_type=payout)` 完成展示。
- **边界帧(每期仅一次)**
- `status=finished`:派彩宽限期结束、本期进入收尾时推送一帧,告知前端可以清理本期 UI。
- `status=void`:本期被作废时推送一帧作为通知。
- **恢复推送**:下一期创建并进入 `betting` 后,按新 `period_no` 重新开始每秒推送。
- 服务端去重:边界帧通过 Redis Key `dfw:v1:ws:tick:boundary:{period_no}:{status}`TTL 300s保证同一期号同一状态只推一次。
- `user.streak`:每期结算更新用户连胜后按用户推送(未中奖也会推送,`current_streak` 可能归零)。
- `admin.live.snapshot`**每秒一次**(后台实时对局页全量快照)。
- `admin.live.snapshot`**每秒一次**(后台实时对局页全量快照;不受派彩静默期影响)。
- `period.opened` / `period.payout` / `admin.live.opened`:按开奖流程阶段触发(事件触发型,非固定频率)。
- `wallet.changed`:仅在余额发生变更时推送(如下注扣款、充值入账、派彩入账)。
- `jackpot.hit`**仅在本期存在中大奖命中用户时推送**;无命中不推送。
- **载荷字段**`period_id` / `period_no` / `result_number` / `hits[]` / `server_time`
- `hits[]` 数组每项字段:
- `user_id`int中奖用户 ID
- `nickname`string用户昵称**优先取 `user.nickname`,为空时 fallback 到 `user.username`,再为空则使用 `用户{user_id}`**,供前端弹窗/横幅通知直接展示)
- `period_no`string
- `total_win`string本期该用户的命中大奖派彩合计金额字符串
- `result_number`int
### 7.1A 后台连接方式(管理端联调)