6.5 KiB
6.5 KiB
todos:
- id: "wallet-strip-mq" content: "wallet bet/win/FreeSpinBetService 移除 trial MQ 发布；bet 响应增加 is_fs_paid_bet" status: pending
- id: "pwa-mq-publisher" content: "PWA 新增 TrialRewardMqPublisher + MQKeyManager 常量（对齐 TrialRewardMQ）" status: pending
- id: "pwa-notify-service" content: "PWA 新增 TrialRewardNotifyService（valid_bet / fs_consume / task_completed + 共享配置与 Redis 去重）" status: pending
- id: "pwa-hook-wallet" content: "WalletService::bet/win 成功后调用 NotifyService；WalletEntity 补充 is_fs_paid_bet / wallet_created_at" status: pending
- id: "verify-flow" content: "docker 内验证四条验收场景；跑 slot-backend 门禁" status: pending isProject: false
Trial MQ 从 wallet 迁到 PWA
你的三点反馈（代码核对结论）
1. 下注金额 PWA 知道，代付留 wallet —— 同意
- PWA 所有厂商下注均经
WalletService::bet，请求里已有fee、biz_id、round_id、game_category、vendor_game_id。 - FS 代付判定（
TrialFreeSpinRedisService）和executeFreeSpinPaidBet继续留 wallet。 - PWA 只需 wallet 在 bet 响应里多回一个是否 FS 代付标记（如
is_fs_paid_bet: true），即可决定：- FS 代付 →
valid_bet_amount = fee发 MQ - 常规下注且非试玩期 →
valid_bet_amount = fee发 MQ（PWA 侧用 fee，不再依赖 wallet 内部 withdraw/deposit 拆分） - 试玩期纯体验金下注 → 不发 MQ
- FS 代付 →
说明：wallet 内部
valid_bet原口径是withdraw + deposit（不含 bonus 部分）。若业务接受「充值后用 fee 计入解锁流水」，PWA 可直接用 fee，无需 wallet 扩展拆分字段。若以后要精确排除 bonus 扣款，再让 wallet 回valid_bet_amount即可。
2. grantTrial 的 task_completed 留 wallet —— 可接受，但当前无调用
全仓库 没有任何服务 调 type=trial_grant / grantTrial()。
TrialTaskCompletedMqService 在 wallet 里实际只有 一条活路径：
WalletLogic::win()试玩期派奖成功后 →notifyIfBalanceReached
grantTrial() 里的 MQ 是预留死代码（需求文档里的绑手机/绑邮箱补发体验金，尚未接入）。
3. 注册流程不走 grantTrial —— 你说得对
注册实际路径：
sequenceDiagram
participant Console as slot_console
participant Wallet as slot_wallet
Console->>Wallet: POST /api/wallet/update type=register
Wallet->>Wallet: WalletLogic.register + RegisterService
Note over Wallet: 写 frozen_bonus，不发 trial MQ
UserRegisterEventService::reward() 只发 type=register，不调 grantTrial。
register() 也不发 task_completed MQ。
因此：充值前 $50 门槛任务，目前是靠 试玩期 win 派奖 后 wallet 发 MQ 触发的，不是注册时触发。
目标架构
flowchart LR
Provider --> PWA
PWA -->|"HTTP bet/win fee+game_context"| Wallet
Wallet -->|"余额 + is_fs_paid_bet"| PWA
PWA -->|"trial_valid_bet / fs_consume / task_completed"| ActivityMQ
ActivityMQ --> Activity
wallet 移除（游戏路径）
TrialValidBetNotifyService在bet()的调用TrialFreeSpinBetService内的TYPE_FS_CONSUMEMQ 发布TrialTaskCompletedMqService在win()试玩期的调用
wallet 保留
- FS Redis 代付判定与
executeFreeSpinPaidBet grantTrial()内 MQ（死代码，待绑手机/绑邮箱接入时生效）
PWA 新增
TrialRewardMqPublisher（exchange/queue 对齐slot\foundation\Constants\MQ\TrialRewardMQ）TrialRewardNotifyService：在WalletService::bet/win钱包调用成功后投递 MQ- bet +
!isTrialPhase（PWA 用UserRechargeStatusService判断）→trial_valid_bet_accumulate - bet +
is_fs_paid_bet（wallet 响应）→trial_valid_bet_accumulate（全额 fee）+trial_fs_consume - win + 试玩期 + 余额达标 →
trial_task_completed（Redis 48h 去重逻辑从 wallet 迁过来，读共享 Redis 配置）
- bet +
activity 不变
TrialRewardEventRouter消费格式不变
关键改动文件
| 仓库 | 文件 | 动作 |
|---|---|---|
| slot-wallet | app/api/logic/WalletLogic.php |
bet/win 删 MQ；bet 响应加 is_fs_paid_bet |
| slot-wallet | app/service/trial/TrialFreeSpinBetService.php |
删 fs_consume MQ，保留 Redis consume |
| slot-wallet | app/entity/WalletEntity.php |
可选加 is_fs_paid_bet 字段 |
| slot-pwa | app/service/MQKeyManagerService.php |
加 EXCHANGE_TRIAL_REWARD / QUEUE_TRIAL_REWARD |
| slot-pwa | app/service/mq/TrialRewardMqPublisher.php |
新建 |
| slot-pwa | app/service/trial/TrialRewardNotifyService.php |
新建（valid_bet / fs_consume / task_completed） |
| slot-pwa | app/service/trial/TrialRewardShareConfigService.php |
从 wallet 迁共享 Redis 配置读取 |
| slot-pwa | app/service/WalletService.php |
bet/win 成功后调 NotifyService |
试玩期判定（PWA 侧）
与 wallet 对齐，不依赖 isTrialPhase HTTP 字段：
!UserRechargeStatusService::hasRecharged(uid)- 且 wallet 返回的
wallet_created_at在validity_hours内（需 PWAWalletEntity增加该字段或 bet/win 时顺带读 wallet 接口）
本阶段明确不做
- 不改
grantTrial/ 绑手机绑邮箱（无调用方） - 不改
slot-pay的first_deposit/deposit_accumulateMQ - 不迁 FS Redis 逻辑到 PWA
- 不在 wallet 侧继续发游戏相关 trial MQ
验收
- 试玩期下注：wallet 扣 frozen_bonus，无 trial MQ
- 充值后常规下注：PWA 发
trial_valid_bet_accumulate，activityvalid_bet_amount累加 - FS 代付下注：wallet 不扣余额，PWA 发
fs_consume+valid_bet_accumulate - 试玩期 win 余额达 $50：PWA 发
trial_task_completed（48h 去重） - 注册
type=register：行为不变，仍无 trial MQ