6 lines
9.4 KiB
JSON
6 lines
9.4 KiB
JSON
{"role":"user","message":{"content":[{"type":"text","text":"<user_query>\n请在仓库 /Users/ray/Documents/project/www/ray/slot-wallet 里做中等深入只读探索，目标：找出 bonus/deposit 任务、打码进度、任务详情 在 PRD/README/doc 中的定义与字段口径。重点查看 README.md、doc/wallet.md 及相关文档。请返回：1) 关键规则与字段定义；2) 建议返回给玩家的最小字段集合；3) 涉及的文件路径列表。\n</user_query>"}]}}
|
||
{"role":"assistant","message":{"content":[{"type":"text","text":"正在阅读 PRD、README 与相关文档，梳理 bonus/deposit 任务、打码进度与任务详情的定义与字段口径。\n\n[REDACTED]"},{"type":"tool_use","name":"updateCurrentStep","input":{"current_step":"Exploring PRD and wallet docs","final_summary":"","completed_subtitle":""}},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/ray/slot-wallet/README.md","limit":200}},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/ray/slot-wallet/doc/wallet.md","limit":400}},{"type":"tool_use","name":"Grep","input":{"path":"/Users/ray/Documents/project/www/ray/slot-wallet","pattern":"打码|任务|bonus|deposit|wagering|turnover|progress","glob":"*.md","-i":true}}]}}
|
||
{"role":"assistant","message":{"content":[{"type":"text","text":"继续读取 `doc/wallet.md` 的数据模型（§18）、状态定义（§19）、前端展示建议（§21）及 DDL 附录。\n\n[REDACTED]"},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/ray/slot-wallet/doc/wallet.md","offset":400,"limit":450}},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/ray/slot-wallet/.cursor/rules/slot-wallet-prd-and-money.mdc"}},{"type":"tool_use","name":"Grep","input":{"path":"/Users/ray/Documents/project/www/ray/slot-wallet/doc/wallet.md","pattern":"wager_task|task|required_wager|current_wager|PendingConversion"}}]}}
|
||
{"role":"assistant","message":{"content":[{"type":"text","text":"[REDACTED]"},{"type":"tool_use","name":"Grep","input":{"path":"/Users/ray/Documents/project/www/ray/slot-wallet/doc/wallet.md","pattern":"Deposit.*解锁|unlock|解锁"}},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/ray/slot-wallet/README.md","offset":196,"limit":120}}]}}
|
||
{"role":"assistant","message":{"content":[{"type":"text","text":"[REDACTED]"},{"type":"tool_use","name":"updateCurrentStep","input":{"completed_subtitle":"Summarized PRD fields and docs","current_step":"Summarized PRD fields and docs","final_summary":"已从 `doc/wallet.md`（§3.2、§6–§7、§10.2–§13、§18–§21、§19.2）、README §6、`slot-wallet-prd-and-money.mdc` 及 `doc/win.md` 提炼任务/打码口径与前端建议；并列出相关文件绝对路径。"}}]}}
|
||
{"role":"assistant","message":{"content":[{"type":"text","text":"## 1）关键规则与字段口径（以 PRD 为准）\n\n### 任务类型与边界\n- **Deposit Unlock Task（充值解锁任务）**：每笔充值一条；记录该笔的**解锁要求**与**有效投注进度**；完成后把该 Deposit Lot **当前 `remaining_amount`** 转入 Withdrawable（不是原始充值额）。不过期。**仅**消耗对应 Locked Deposit Lot 的下注才算有效推进。 \n 顺序：**按充值时间** `created_at ASC, id ASC`；前面 Deposit 未完成时，后面的可处于 **`Waiting`**，不参与下注消耗与打码累计（获准后变为 `Active`）。 \n 见：`/Users/ray/Documents/project/www/ray/slot-wallet/doc/wallet.md` **§7.1、§6.3、§19.2、§20.1**。\n\n- **Bonus Conversion Task（Bonus 转化任务）**：每笔奖励领取一条 Bonus Lot；记录**转化要求**与**有效投注进度**；完成后把该 Bonus Lot **当前 `remaining_amount`** 转入 Withdrawable。默认不过期。不同 Bonus Lot **不共享、不合并**进度。 \n 见：同文件 **§7.2、§6.4、§4.3**。\n\n- **系统级原则（与两类任务都相关）**：Deposit 与 Bonus 任务**独立**；**Deposit 下注只推进 Deposit 任务**；**Bonus 下注只推进对应 Bonus 任务**；**Withdrawable 出资的下注不推进**任一类任务。 \n 见：**§3.2**；工程速查：`/Users/ray/Documents/project/www/ray/slot-wallet/.cursor/rules/slot-wallet-prd-and-money.mdc`。\n\n### 「打码进度」在 PRD 中的含义\n- 落在 Lot 上：字段 **`required_wager`（所需有效投注额）**、**`current_wager`（当前已完成有效投注额）**。 \n- 一次下注若拆到多个 Bonus Lot，**每个 Lot 只给自己累加** `current_wager`；累加额可按**有效投注贡献比例**折算（PRD 举例 100% / 20%）。 \n 见：**§6.3–§6.4 示例表、§10.2、§18.2、典型流程 §20.3（推进 `current_wager`）**。\n\n- **与 Round 的关系**：流水门槛达到后，可能进入 **`PendingConversion`**：**流水已达标，但须等本局 Round 最终结算**后再做解锁/转化落账；不得用单次中间派奖替代 Round 结论。 \n 见：**§7.1–§7.2 状态表、§13.1、§19.2 `PendingConversion`、§12 与 `doc/win.md`**。\n\n### Lot / 任务相关状态（对展示与详情很重要）\n- **`Waiting`(1)**：排队/未到顺序，**不参与**下注消耗与任务进度。 \n- **`Active`(2)**：进行中，可消耗、可累积进度。 \n- **`PendingConversion`(3)**：流水达标，等 Round 最终结算后再解锁/转化。 \n- **`Completed`(4)**、**`PlayedOut`(5，仅 Bonus）**、`Cancelled`、`Reversed`。 \n 见：**§19.2 Fund Lot Status**。\n\n### 与钱包聚合展示的对应（玩家看到的「四类余额」）\n- **`deposit_balance`** ≈ Locked Deposit；**`frozen_bonus`** ≈ Bonus Credits；**`withdraw_balance`** ≈ Withdrawable；真账与争议以 **`wallet_fund_lot` + 流水** 为准。 \n 见：README **`/Users/ray/Documents/project/www/ray/slot-wallet/README.md` §6.2–§6.3**；PRD **§5、§18.1–§18.2**。\n\n### `wallet_fund_lot` 侧建议字段（任务详情数据源）\nPRD **§18.2**：`id`、`uid`、`currency`、`lot_no`、`lot_type`（1=Deposit，2=Bonus）、`source_type`/`source_id`、`original_amount`/`remaining_amount`、`wager_multiplier`/`required_wager`/`current_wager`、`consume_priority_at`、`expires_at`、`status`、`completed_at`、`version`。 \nDDL 注释在附录 A（与 **`required_wager` / `current_wager` / `status`** 枚举一致）。\n\n### 后台配置与「倍数」语义（口径补充）\nPRD **§22**：如 `deposit_wager_multiplier`、`bonus_wager_multiplier`、`game_wager_contribution_rate` 等——影响倍数与**有效投注**折算口径（与 §10.2 一致）。\n\n---\n\n## 2）建议返回给玩家的「最小」字段集合\n\n在 PRD **§21** 已给出Bonus任务页的展示骨架：**剩余奖励额度 + 流水进度「当前 / 要求」**。在此基础上，为满足两类任务与一个列表里区分任务，建议**最小可读集合**：\n\n| 用途 | 建议字段 |\n|------|----------|\n| 区分任务 | `task_kind` 或等价：`lot_type`（deposit_locked / bonus） |\n| 金额展示 | `currency`；对该 Lot：**`remaining_amount`**（本条任务关联的「未转化/未解锁余额」语境） |\n| 打码进度 | **`current_wager`**、**`required_wager`**（或派生：`progress_pct` / `remaining_wager`，二选一足够） |\n| 状态与文案 | **`status`**（至少能区分：`Waiting`/`Active`/`PendingConversion`/ Bonus 独有 `PlayedOut`/可取消场景的 `Cancelled`） |\n| 文案/UX | **`pending_settlement`** 布尔或沿用状态：§21.4 「流水已完成，等待游戏局结算」对应 **`PendingConversion`** |\n\n可选（仍属「小而有用」）：`expires_at` 或 **`no_expiry` 话术**（PRD 默认 Bonus 不过期）、`lot_id`（用于取消 Bonus、跳转详情）、`source_label`/`promotion_name`（若产品要在列表里区分来源，PRD 未强制）。\n\n---\n\n## 3）涉及的文件路径列表（绝对路径）\n\n| 文件 | 作用 |\n|------|------|\n| `/Users/ray/Documents/project/www/ray/slot-wallet/doc/wallet.md` | **主 PRD**：任务定义（§7）、打码字段（§6、§10.2、§18.2）、状态（§19.2）、转化/PlayedOut（§13–§14）、前端展示（§21）、配置（§22）、附录 DDL |\n| `/Users/ray/Documents/project/www/ray/slot-wallet/doc/win.md` | Round 最终结算后与任务/Bonus 转化、派奖归属的时序与规则补充 |\n| `/Users/ray/Documents/project/www/ray/slot-wallet/README.md` | 聚合字段与 Lot/Funding/Round 入口索引（§6.2–§6.3）；工程与高风险范围 |\n| `/Users/ray/Documents/project/www/ray/slot-wallet/.cursor/rules/slot-wallet-prd-and-money.mdc` | Deposit/Bonus 任务独立、下注推进规则、真账口径的精简版 |\n| `/Users/ray/Documents/project/www/ray/slot-wallet/doc/feature_task.md` | **历史「打码」表调整说明**（`wager_task` 相关列如 `muti_desc`/`brief`），可作实现对照但**产品语义仍以 wallet.md 为准** |\n| `/Users/ray/Documents/project/www/ray/slot-wallet/doc/feature_task_2026_0311.md` | 同上，后续打码脚本/表字段变更的补充说明 |\n| `/Users/ray/Documents/project/www/ray/slot-wallet/doc/register-bet-win-test.md` | 注册/下注联调示例（余额与扣款顺序），非任务口径主文档 |\n\n若你还希望把「API 字段名」定成与 **`WalletFundLotModel`** 完全一致，需要在 Agent 模式下再对照模型与表字段映射；Ask 模式下以上均以 **PRD/README 文档口径**为准。\n\n[REDACTED]"}]}} |