PURPUR 用户任务中心（Reward Center）需求文档
一、概述
任务中心是什么、发给谁、任务怎么算、奖励从哪来。
1.1 三个任务
Reward Center 是面向用户的任务中心，里面三个 tab，对应三类任务：
| Tab | 任务 | 用户做什么 | 拿什么 |
|---|---|---|---|
| Welcome | 新手任务，6 个，一次性 | 完成 6 个入门动作（完善资料、进厅、关注、上麦、送礼、首充） | 每个任务一份奖励（装扮或礼物），每个账号只领一次 |
| Daily rewards | 每日任务，2 个，每天重置 | 每天在厅内送礼；每天充值 | 每天各一份奖励；同一任务连续两天及以上完成，奖励换成盲盒 |
| Box rewards | 盒子任务，按轮次 | 先送盒子礼物解锁档位，再单笔充值 | 按档位返还金币 |
1.2 下发范围
- 下发给全量用户，不区分新老用户，三个 tab 都对所有用户展示。后台每个任务有单独的显示开关。
- Welcome 的每个任务每个账号只能领一次奖励。
- 三个 tab 都不做红点。
- 入口沿用现有：用户中心的 Reward Center 卡片、语聊厅里的任务挂件。
1.3 时间口径
- 每日任务按 GMT+8 自然日统计，每天 00:00（GMT+8）重置任务和奖励。页面上直接写明：Tasks and rewards reset daily at 00:00 (GMT+8)。
- 页面里出现的到期时间都按 GMT+8。
1.4 任务怎么计算
Welcome（新手任务）
| 任务（页面标题） | 完成条件 | 进度显示 | 默认奖励 |
|---|---|---|---|
| Complete your profile | 资料完整度达到 100% | 百分比，如 60%、100% | 头像框 Avatar frame |
| Stay in a room for 1 min | 在任意语聊厅内累计停留 60 秒 | x / 60 s | 麦克风框 Mic frame |
| Follow a room host | 在语聊厅里关注 1 位主播 | x / 1 | 座位框 Seat frame |
| Speak on the mic | 上麦并开麦 1 次 | x / 1 | 免费礼物 ×1 |
| Send a gift in a room | 在语聊厅送出任意礼物 1 次（含免费礼物） | x / 1 | 入场特效 1 小时 |
| Make your first top-up | 首次充值成功（任意金额） | x / 1 | 入场特效 3 天 |
完成后不自动发放，需要在页面点 Claim 领取。
Daily rewards（每日任务）
| 任务（页面标题） | 完成条件 | 当天奖励 | 领取期限 |
|---|---|---|---|
| Send a gift in a room | 当天在语聊厅送出任意付费礼物 | 昨天没完成同一任务：普通奖励（头像框，1 天） 昨天也完成了：连续奖励（盲盒，开出 1 天装扮） | 可领到第二天 24:00（GMT+8），过期作废 |
| Top up any amount | 当天任意金额充值成功 |
- 送礼和充值各自独立计算连续天数，互不影响。
- 断签（前一天没完成）后，当天奖励回到普通奖励；再连续完成两天又变回盲盒。
- 盲盒在领取时开出，开出的装扮从盲盒奖池里随机。
Box rewards（盒子任务）
- 轮次：每一轮从 0 开始，累计本轮送出的盒子礼物金币数。只算礼物面板 Box gifts tab 里的礼物。
- 档位：299、499、2,000、5,000、10,000、20,000、50,000、100,000。送礼累计达到哪一档，就解锁这一档以及以下所有档位的奖励。
- 结算：每一笔充值成功都会结算本轮。只看这一笔，多笔不合并。
- 充值金额在已解锁的档位内：返还这笔充值所在档位的金币；
- 充值金额超过最高已解锁档：返还最高已解锁档的金币；
- 也就是：返还金币 ＝ 送礼档位和充值档位里低的那一档对应的金币；任一边不到 299 就没有奖励。
- 清零：结算后本轮送礼清零，开始新一轮，不管这一笔有没有拿到奖励。在钱包页等任务中心以外的地方充值，也会结算并清零。
- 领取：返还的金币进入待领，24 小时内领取，过期作废；几轮的待领可以一次领完。
| 本轮送礼 | 单笔充值 | 返还金币 | 说明 |
|---|---|---|---|
| 2,600 | 2,000 | 100 | 两边都在 2,000 档 |
| 2,600 | 499 | 24 | 充值只到 499 档，按低的算 |
| 2,600 | 10,000 | 100 | 送礼只解锁到 2,000 档，按低的算 |
| 180 | 2,000 | 0 | 送礼没到 299，本轮照样清零 |
1.5 奖励配置
- Welcome、Daily rewards 的奖励在后台配置，每个奖励配三项：奖励类型、奖励数量、奖励 ID（装扮 ID、礼物 ID、盲盒 ID）。
- Box rewards 的奖励固定是金币，不走奖励配置，后台只按档位配返还金币数，默认按档位金额的 5% 向下取整：14、24、100、250、500、1,000、2,500、5,000。
- 三个任务各有一个前端显示开关。详见第三部分。
待确认
- 三个框（头像框、麦克风框、座位框）的有效时长。演示里先写 7 days，后台默认填 168 小时。
- 厅内停留 1 分钟按累计算还是单次连续算。本文档按累计写。
- 资料完整度的计算口径是否沿用资料页现有的完整度。
- Welcome 6 个全部领完后，Welcome tab 是否隐藏；进入任务中心默认停在哪个 tab（本文档按「有没领完的新手任务停在 Welcome，否则停在 Daily rewards」写）。
- 盲盒奖池（能开出哪些装扮、概率）在哪里配置。后台本页只填盲盒 ID。
- Box：在钱包页等任务中心以外的地方充值，也会结算并清零本轮，需要和需求方确认。
- 显示开关关掉以后，已经拿到但还没领的奖励是否保留领取入口。
- Box 活动是否需要配置开始和结束时间。目前只有显示开关。
二、页面交互：Welcome
截图里的状态可以在演示 demo 右侧控制台切换。
W1任务列表（1 个已领、1 个可领、4 个未完成）
- 【Tab】
- Welcome、Daily rewards、Box rewards，不做红点。
- 【标题】
- Welcome to Purpur；副标题 6 one-time tasks. 6 welcome gifts.
- 【任务卡】
- 奖励图、任务名、奖励名、进度条。顺序固定；第一个可领取的卡片高亮，没有可领取时高亮第一个未完成的。
- 【进度】
- 完善资料显示资料完整度百分比；厅内停留显示秒数 x / 60 s；其他显示 x / 1。
- 【按钮】三种状态
- Go：未完成，点击去完成。完善资料→资料编辑；停留、关注、上麦→语聊厅；送礼→语聊厅并打开礼物面板；首充→充值。
- Claim：已完成未领取，点击领取并弹出领取弹窗。
- Claimed：已领取，置灰不可点，奖励图右下角打勾。
W2领取弹窗
- 【标题】
- Reward received
- 【奖励素材】
- 奖励 ID 对应的素材。
- 【奖励内容】
- 奖励名称。
- 【时长或数量】
- 装扮显示有效时长（7 days、1 hour 等），礼物显示数量（×1）。取后台的奖励数量。
- 【按钮】
- Done 关闭。免费礼物显示 Send gift，点击去语聊厅并打开礼物面板的免费礼物。
W36 个全部领完
- 【标题】
- You're all set.；副标题 All 6 rewards collected.
- 【任务卡】
- 全部 Claimed。
- 【待确认】
- 全部领完后 Welcome tab 是否隐藏。
二、页面交互：Daily rewards
两张任务卡结构一样：标题、时间轴、提示语、两行奖励。
D1昨天、今天都没做
- 【标题行】
- Daily rewards；右侧 Rules，点击打开规则弹窗（D6）。
- 【说明】
- Two rewards every day. Keep going for mystery frames.
下一行写重置时间：Tasks and rewards reset daily at 00:00 (GMT+8) - 【任务卡】
- 固定两张：Send a gift in a room、Top up any amount，各自独立计算。
- 【时间轴】Yesterday／Today／Tomorrow
- Yesterday：完成显示 ✓；没完成显示空圈；断签（前天完成、昨天没完成）显示 ✕ 和红字。
- Today：显示任务图标，完成后变 ✓，左侧连线点亮。
- Tomorrow：显示盲盒，今天完成后点亮，表示明天再做能拿盲盒。
- 【提示语】按状态四选一
- 今天已完成：Do it again tomorrow for a mystery box.
- 昨天完成、今天没做：Keep it going. Today's reward is a mystery box.
- 断签：Missed yesterday. Back to a frame today.
- 其他：Do it 2 days in a row for a mystery box.
- 【奖励行】
- 固定两行，行首 Yesterday、Today 和时间轴对应；只显示奖励图和奖励名。
- 【按钮】
- Go：今天没做，点击去完成（送礼→语聊厅礼物面板；充值→充值）。Claim：可领取。Claimed：已领取。昨天那行没完成或已过期时，Claim 置灰。
D2可领取（送礼昨天、今天都做了；充值只有今天做了）
- 【Yesterday 行】
- 昨天完成拿到的奖励，可领到今天 24:00（GMT+8），过期后置灰。
- 【Today 行】
- 今天完成后即可领取。送礼昨天也做了，所以今天的奖励是 Mystery frame box。
- 【充值卡】
- 昨天没充值，Yesterday 行 Claim 置灰；今天充值了，Today 行是普通奖励 Avatar frame。
- 【领取】
- 装扮点 Claim 直接领取并弹出领取弹窗（同 W2，时长 1 day）；盲盒点 Claim 打开盲盒弹窗（D4）。
D3断签（前天做了，昨天没做）
- 【时间轴】
- Yesterday 显示 ✕，文字变红。
- 【提示语】
- Missed yesterday. Back to a frame today.
- 【Yesterday 行】
- 置灰，显示昨天做了本来能拿到的奖励。
- 【Today 行】
- 回到普通奖励 Avatar frame，按钮 Go。
D4盲盒弹窗
- 【标题】
- Avatar frame box；副标题 A surprise frame for 1 day
- 【奖池】
- 展示能开出的稀有度：Rare、Epic、Legendary。
- 【期限】
- 昨天的盲盒：Expires tonight at 00:00 (GMT+8)；今天的：Available through tomorrow。
- 【按钮】
- Open now 开盒，播放开盒动画后出结果（D5）。直接关掉弹窗不消耗盲盒，期限内可以再开。
D5开盒结果
- 【结果】
- 开出的装扮名、类型和时长（1-day avatar frame）、稀有度。
- 【按钮】
- Wear now：立即佩戴并跳到用户中心。Done：关闭。
D6规则弹窗（Rules）
- 【标题】
- How rewards work
- 【内容】四段
- Two rewards a day：送礼、充值各一份奖励。
- Two days in a row：昨天也做了，今天拿盲盒；否则拿头像框。
- Frames last 1 day：头像框和盲盒开出的框都是 1 天。
- Claim by tomorrow：每份奖励可领到第二天 24:00（GMT+8）。
二、页面交互：Box rewards
一张卡讲完一轮：第 1 步送礼，第 2 步充值，下面是钱包同款的充值格子，每格挂这一档的返还金币和解锁状态。
B1本轮送了 180，一档都没解锁
- 【标题行】
- Box gift bonus；右侧 Rules，点击打开规则弹窗（B7）。
- 【说明】
- Send box gifts first, then top up for a bonus.
- 【卡片顶部】
- 左边 This round，充值结算后的新一轮显示 New round；右边 ↻ Starts over after each top-up。
- 【第 1 步】Send box gifts
- 只显示本轮送出的盒子礼物金币数，不显示进度条和差额。达到 299 后打勾。Send gifts 按钮常亮，点击去语聊厅并打开礼物面板的 Box gifts tab。
- 【第 2 步】Top up once
- 说明 Each bonus unlocks when your box gifts reach that amount.
Top up 按钮常亮，点击拉起商店弹窗，默认选中最高已解锁档；一档都没解锁时选 299。 - 【充值格子】
- 8 个档位，样式同钱包。点击任意格子拉起商店弹窗并选中这一档。
一档都没解锁时，全部置灰，显示锁和这一档的返还金币。
B2本轮送了 2,600，解锁到 2,000 档
- 【已解锁档】
- 送礼达到的档位及以下：金色 +X bonus。最高已解锁档紫框打勾，作为推荐档。
- 【更高的档】
- 金色写这一笔实际能拿到的奖励，也就是最高已解锁档的 +100；下面一行灰字带锁，写这一档本来的奖励（如 +250），送礼达到这一档后解锁。
B3商店弹窗
- 【触发】
- 点 Top up 或点任意充值格子。
- 【内容】
- 上线接真实商店，展示选中的充值商品和购买按钮。商店里不展示任何任务信息。
- 【购买后】
- 回到 Box rewards，按规则结算本轮（B4）。
B4充值 2,000 之后：奖励待领，新一轮
- 【结算】
- 充值成功后结算本轮，返还金币进入待领，Toast 提示 Top-up complete. +100 coins ready to claim.
- 【待领】
- 和其他奖励一样：金币图标＋金币数＋Claim。几轮的待领合并成一行，Claim 一次领完。点图标或金币数打开明细（B5）。
- 【新一轮】
- 送礼清零，卡片顶部显示 New round，所有格子回到未解锁。
- 【没奖励的充值】
- 充值不到 299，或本轮一档都没解锁：没有待领，但本轮照样清零。
B5待领明细
- 【每一笔】
- 本轮送礼金额、这一笔充值金额、返还金币、剩余时间（Expires in hh:mm:ss）。
- 【按钮】
- Claim N coins，一次领完。
- 【过期】
- 每一笔各自 24 小时，过期后自动消失。
B6领取成功
- 【内容】
- Reward claimed；Added to your balance ＋领取的金币数。
- 【按钮】
- Done 关闭，待领那一行消失。
B7规则弹窗（Rules）
- 【标题】
- How rewards work，写法同 Daily rewards 的规则弹窗。
- 【内容】四段
- Send box gifts first：只算 Box gifts tab 的礼物；每档奖励在送礼达到这一档时解锁。
- Then top up once：只算单笔充值；充得比已解锁档多，拿最高已解锁档的奖励。
- Starts over after each top-up：每次充值都结束本轮，没有奖励也一样，送礼从 0 重新算。
- Claim within 24 hours：不同轮次的奖励可以一起领。
三、后台配置
一个页面配完三个任务，只配显示开关和奖励。打开静态页
A1用户任务中心配置
- 【显示开关】
- 三个任务各一个。关掉后前端不展示对应 tab；三个都关掉时，任务中心入口也不展示。
- 【新手任务】
- 6 个任务固定，完成条件不在后台改；每个任务配一个奖励。
- 【每日任务】
- 送礼、充值各配两个奖励：
普通奖励：前一天没完成同一任务时发放；
连续奖励：前一天也完成了同一任务时发放。 - 【奖励字段】
- 奖励类型：装扮、礼物、金币、盲盒。
- 奖励数量：装扮填有效时长，单位小时；礼物、金币、盲盒填个数。
- 奖励 ID：装扮 ID、礼物 ID 或盲盒 ID，前端用它取素材和名称。
- 【盒子任务】
- 8 个档位金额固定，只配每档返还金币；默认按档位金额的 5% 向下取整。
- 【保存】
- 保存后对之后发放的奖励生效，已经发出去的奖励不变。