CashPlay产品协作 / 奖励与任务
代码快照 7cfbab0
CASHPLAY · REWARD FLOW ATLAS

奖励从哪里来，
最后到哪里去。

把游戏、任务、转盘、集卡和提现连起来。
先看主链路，再查触发条件、刷新规则与联动验收点。

05底部页面
09任务指标
08资源类型
阅读口径以下数值来自当前代码与 JSON，属于演示配置。本地已联动 ≠ 已接服务端；金币兑美元、真实广告/游戏回调及真实出款仍待接入。查看边界 →
01 / OVERVIEW

一张图，看懂主要去向

点击资源筛选链路；点击左侧入口，展开完整规则。奖励数字以当前配置为准。

实线：本地可触发　虚线：待接结算
关注资源
APP 入口 / 可点击完成什么 · 如何流转获得什么 / 到账点
金币余额 → 等待兑换

界面显示每 3 小时自动兑换。
倒计时已实现，汇率与结算尚未实现。

⇢
美元余额 → 选择档位

直接现金奖励会增加余额。
金币需待服务端兑换后才能进入这里。

→
提现 ↗

选择渠道 → 邮箱验证 → 模拟待处理订单。
余额校验、扣款、真实出款待接。

查看兑换示例 →
全部两条现金路径：直接获得美元，或金币待兑换。代币、票、钥匙、骨头、卡片与星星各有用途，不能直接提现。
02 / ENTRY DIRECTORY

每个入口，具体做什么

覆盖底部 5 个页面，以及首页 4 个快捷入口的子页面。

03 / DAILY CHALLENGE METRICS

寻宝内的「每日挑战」：预埋 9 类

这是任务指标，不是 9 种玩法。当前 JSON 启用 4 类；另 5 类有本地累计逻辑，尚未配置到每日列表。

4 类已配置 / 5 类预埋
任务类型 / metric什么事件累计当前每日目标 → 奖励配置状态
任务达到目标后需点击领取；进度封顶，已领取任务不再累计。当地次日重置每日挑战进度与领取状态。destination 控制“去完成”的导航，metric 控制实际统计口径，两者独立。
一次事件，可以推进多个任务

挑战游戏 crown 新过 10 关 → 游戏关卡指标 +10 → 同游戏寻宝宝箱 +1 钥匙 → 钥匙指标 +1。领取挑战奖励时，才增加挑战任务数、游戏任务数、金币及代币。

完成任务 ≠ 过关 ≠ 在线时长

这 3 类事件分开统计。只过关不会自动发代币；卡包第二项虽然使用播放图标，当前实际是“游戏 10 分钟”，并非看剧。小狗梦想进度目前独立，不会自动推进这里。

04 / TIME & RESET

哪些等次日，哪些可以接着做

当前使用设备本地日期；正式服务端时区、日界线与季结算顺序仍需统一。

玩法当前刷新规则保留 / 清空
05 / CASH OUT

最终提现：花的是美元余额

卡包、代币和金币都不能直接在提现页面支付。这里的“价格”和“面额”是两个不同的金额。

当前为模拟订单
TWO BALANCES · ONE DESTINATION

金币先待兑换，
美元再选提现档位。

寻宝、每日挑战、每日奖励、转盘、集卡和小狗梦想可以直接增加美元余额。金币目前只累加在“待兑换金币”；3 小时倒计时结束，不会自动发钱。

面额 $1.00←配置价格 $0.937% OFF

这是当前演示优惠档位，不是金币兑美元的汇率。未配置“多少金币 = 1 美元”。

查看当前提现档位

仅展示 JSON 中的价格，不会提交订单。

配置所需现金

正式接口应校验并扣除对应余额；当前客户端不会校验余额是否足够，也不会扣款。

01选择渠道与档位

PayPal / Cash App / Venmo
及 6 个卡券渠道

02填写收件邮箱

本地格式校验
修改邮箱会使旧验证码失效

03验证邮箱

60 秒可重发 / 5 分钟有效
当前无真实邮件发送

04确认兑换

生成本地 pending 记录
待接余额冻结与订单幂等

05提现历史

查看订单状态展示
实际出款与失败退款待接

06 / QA CHECKLIST

联动验收，可以逐条对照

“本地回归”是当前可测行为；“接口验收”是待实现项。勾选只记录已核对，不表示自动测试通过。

勾选保存在当前浏览器；CSV 导出全部条目与核对状态。接口验收项仅为交接建议，未定义最终接口协议。

07 / IMPLEMENTATION NOTES

配置依据与后端边界

这是一份当前实现快照。具体数值与行为以对应版本代码为准，后续改配置后需同步更新本页。

配置可以调整什么

  • assets/config/settings/home.json：首页任务、游戏展示、快捷入口。
  • assets/config/settings/shortcuts.json：每日奖励、寻宝、9 类任务、卡包、转盘、季规则。
  • assets/config/settings/challenge.json：阶段目标、票数、奖励、骰子权重。
  • assets/config/settings/events.json：活动游戏、骨头目标、结算比例。
  • assets/config/settings/cashout.json：提现渠道、面额、价格、费用、验证码时间。
  • assets/config/mock/shortcuts.json：首批模拟结果、后续寻宝批次及季名称。

金额 cash / *Minor 使用美分整数：20 = $0.20；金币使用整数，与美元不是同一个单位。

后端需要接管的关键动作

  • 核验游戏关卡、时长、任务完成与广告奖励回调；按 gameId 分发进度。
  • 领取、抽奖、开包、兑换、活动结算由服务端返回结果；以事件 ID / 领取 ID 保证幂等。
  • 统一钱包流水、任务增量、库存变化与扣费；客户端只展示确认后的快照。
  • 明确时区、跨日、跨季与离线重放；当前状态在内存中，重启会恢复 mock。
  • 补充金币结算公式、提现余额校验/冻结/扣款、订单状态及失败退款。

这些是接口交接建议，当前仓库没有对应的正式 API 契约。

代码追踪入口

lib/shortcuts/shortcut_controller.dart
lib/challenge/challenge_controller.dart
lib/events/events_controller.dart
lib/home/home_screen.dart
lib/cashout/cashout_controller.dart
lib/cashout/order_details_sheet.dart

每日指标共享 _advanceMetric；金币入口经 _grant / creditExternalReward。正式接入须防止同一奖励被多个回调重复计入。

产品背景与当前差异

CashPlay 原始需求文档 ↗
活动需求文档 ↗

本页逐项核对的是代码，并不代表所有本地实现已得到需求确认。小狗梦想阶段即时切换、集卡与活动共享模拟周期、每日奖励钥匙如何分配到宝箱，以及金币结算方式，应在接口设计时确认。

可见的美元图标不等于现金发奖；首页游戏收益文案是展示值。随机结果、验证码、历史记录和初始余额均含演示数据。