ok

plans/Plan-ffd1b7b6.plan.md

@@ -0,0 +1,106 @@
+<!-- ffd1b7b6-16e7-4f41-9f8b-a22ab65c6a00 -->
+---
+todos:
+  - id: "ddl"
+    content: "patch_wallet_phase_game_stat.sql + InitDB 分片建表"
+    status: pending
+  - id: "model-service"
+    content: "WalletPhaseGameStatModel + WalletPhaseGameStatService（inc + 首充标记）"
+    status: pending
+  - id: "wire-logic"
+    content: "WalletLogic bet/win/首充同事务挂载写入"
+    status: pending
+isProject: false
+---
+# 充值前后游戏统计表（精简版）
+
+## 目标
+
+一张表回答四个数：**充值前下注、充值前派奖、充值后下注、充值后派奖**。RTP 读时算，不存库。钱包怎么通知 activity **后面再说**。
+
+---
+
+## 表结构
+
+**表名**：`wallet_phase_game_stat`  
+**分片**：与 `wallet_stat` 一致，`wallet_{db}.wallet_phase_game_stat_{table}`  
+**主键**：`(uid, currency)`
+
+```sql
+CREATE TABLE `wallet_phase_game_stat_{t}` (
+  `uid` BIGINT NOT NULL,
+  `currency` CHAR(5) NOT NULL DEFAULT 'rp',
+  `first_recharge_at` DATETIME NULL COMMENT '首充时间，NULL=尚未充值',
+  `pre_bet_amount` BIGINT UNSIGNED NOT NULL DEFAULT 0 COMMENT '充值前累计下注，*1000',
+  `pre_win_amount` BIGINT UNSIGNED NOT NULL DEFAULT 0 COMMENT '充值前累计派奖，*1000',
+  `post_bet_amount` BIGINT UNSIGNED NOT NULL DEFAULT 0 COMMENT '充值后累计下注，*1000',
+  `post_win_amount` BIGINT UNSIGNED NOT NULL DEFAULT 0 COMMENT '充值后累计派奖，*1000',
+  `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+  PRIMARY KEY (`uid`, `currency`)
+) COMMENT='用户充值前后游戏统计';
+```
+
+**刻意不做的字段**（需要时再加）：
+
+- 笔数 `*_count`
+- `post_valid_bet_amount` / FS 分项
+- `first_recharge_order_no`
+- `last_bet_at` 等时间戳
+
+---
+
+## 阶段判定
+
+**边界 = 是否已首充**，看 `first_recharge_at` 或 `RechargeExchangeService::isRecharge(uid)`：
+
+- 未首充 → 累加 `pre_*`
+- 已首充 → 累加 `post_*`
+
+---
+
+## 写入口径
+
+与 [`WalletLogic`](slot-wallet/app/api/logic/WalletLogic.php) 现有路径对齐，**仅在 biz_id 幂等通过、新写入流水时**同事务累加：
+
+| 动作 | 未首充 | 已首充 |
+|------|--------|--------|
+| 试玩下注 `executeTrialBet` | `pre_bet += fee` | — |
+| 试玩派奖 `executeTrialWin` | `pre_win += fee` | — |
+| 真金下注 `BetService` / FS代付 | — | `post_bet += fee` |
+| 真金派奖 `WinService`（`is_end=1`） | — | `post_win += fee` |
+| 首充 commit | 写 `first_recharge_at` | — |
+
+中间派奖（`is_end=0`）不写。
+
+---
+
+## RTP
+
+读时计算，不入库：
+
+```
+pre_rtp  = pre_win_amount  / pre_bet_amount   (bet=0 → null)
+post_rtp = post_win_amount / post_bet_amount
+```
+
+---
+
+## 代码落点
+
+| 文件 | 内容 |
+|------|------|
+| `slot-wallet/db/patch_wallet_phase_game_stat.sql` | DDL |
+| `slot-wallet/app/model/multi/WalletPhaseGameStatModel.php` | 分片 + `inc` |
+| `slot-wallet/app/service/wallet/WalletPhaseGameStatService.php` | 判定阶段、累加、首充标记 |
+| `WalletLogic::bet()` / `win()` / 首充 | 同事务调用 |
+
+**本轮不改**：`TrialValidBetNotifyService`、activity、MQ。
+
+---
+
+## 验收
+
+1. 首充前只涨 `pre_*`，首充后只涨 `post_*`
+2. 幂等重入不重计
+3. 四个金额 + 两个 RTP 可查询