cursor/plans/测试_register_bet_win_6f8e8ea1.plan.md

name, overview, todos, isProject

name	overview	todos	isProject
测试 register bet win	设计一套不改代码的联调测试方案，覆盖 register、bet、win（含中间派奖+最终结算）主流程、幂等与关键校验。输出可直接执行的请求序列和验收点。	id content status collect-endpoints 整理 register/bet/win 的可调用入口与参数最小集合 completed id content status define-test-cases 设计主链路、幂等、参数异常三类用例 completed id content status prepare-request-templates 产出按执行顺序排列的请求模板与预期结果 completed	false

Register/Bet/Win 测试计划

目标

• 用最小链路验证 register -> bet -> win 的资金变更与返回口径。
• 覆盖 win 的两阶段结算（is_end=0 中间派奖、is_end=1 最终结算）。
• 覆盖关键风控点：幂等（重复 biz_id）、参数校验（round_id、is_end、金额）。

关键实现依据（用于制定用例）

• 接口入口与兼容关系：app/api/controller/WalletController.php
  • wallet/bet、wallet/win 为独立入口；wallet/update(type=bet|win) 复用同链路。
• 业务分发与资金处理：app/api/logic/WalletLogic.php
  • register 走 RegisterService::execute。
  • bet 按 biz_id 做幂等。
  • win：is_end=0 只累计待结算金额，is_end=1 才真正入账并清理缓存。
• 注册落账与 Lot 初始化：app/service/wallet/RegisterService.php
  • 注册会初始化钱包、统计行，并按 fee/bonus 创建 Deposit/Bonus Lot。
• 请求参数约束：app/validator/Wallet2Validator.php
  • bet/win 必传 round_id，is_end 仅支持 0/1。

测试范围与步骤

1. 准备阶段

• 选一个全新 uid（避免历史账干扰）。
• 固定 currency/source/organization，并准备唯一 biz_id 生成规则（例如带时间戳）。

2. 主链路测试（Happy Path）

• 调 wallet/update 发起 register（type=register，带 fee 与 bonus）。
• 调 wallet/wallet 查询余额基线。
• 调 wallet/bet（带 round_id）验证扣款与返回结构。
• 调 wallet/win 且 is_end=0：确认返回中 withdraw 临时增加（待结算展示），但不落最终账。
• 调 wallet/win 且 is_end=1：确认最终入账，并清理该 round_id 的待结算累计。

3. 幂等与异常场景

• 重放同一 bet.biz_id：应命中幂等，余额不重复变化。
• 重放同一 win.biz_id：应命中幂等，余额不重复变化。
• 缺失 round_id 调 bet/win：应返回参数错误。
• 传非法 is_end（如 2）：应返回参数错误。

4. 验收口径

• 余额变化符合顺序：下注优先扣 Bonus，再 Deposit，再 Withdraw。
• win 仅在最终结算时落地资金结果；中间派奖只累计。
• 重复请求无重复记账，返回语义稳定。

建议请求流（逻辑顺序图）

flowchart TD
    registerCall[register(update)] --> walletCheck1[wallet_query]
    walletCheck1 --> betCall[bet]
    betCall --> winMid[win_is_end_0]
    winMid --> walletCheck2[wallet_query]
    walletCheck2 --> winFinal[win_is_end_1]
    winFinal --> walletCheck3[wallet_query]
    walletCheck3 --> idemReplay[replay_same_biz_id]

交付物

• 一份可直接在 Postman/curl 执行的请求模板（含示例 body）。
• 一份对照清单：每一步的“预期返回 + 余额期望 + 幂等期望”。