PURPUR 用户任务中心（Reward Center）需求文档

v1.1　2026-10-19　页面文案为英文，文档内说明为中文；所有时间按 GMT+8
前端演示 demo后台配置静态页

一、概述

任务中心是什么、发给谁、任务怎么算、奖励从哪来。

1.1 三个任务

Reward Center 是面向用户的任务中心，里面三个 tab，对应三类任务：

Tab任务用户做什么拿什么
Welcome新手任务，6 个，一次性完成 6 个入门动作（完善资料、进厅、关注、上麦、送礼、首充）每个任务一份奖励（装扮或礼物），每个账号只领一次
Daily rewards每日任务，2 个，每天重置每天在厅内送礼；每天充值每天各一份奖励；同一任务连续两天及以上完成，奖励换成盲盒（1-day mystery frame，领取时随机发一个装扮）
Box rewards盒子任务，按轮次先送盒子礼物解锁档位，再单笔充值按档位返还金币

1.2 下发范围

1.3 时间口径

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（盒子任务）

本轮送礼单笔充值返还金币说明
2,6002,000100两边都在 2,000 档
2,60049924充值只到 499 档，按低的算
2,60010,000100送礼只解锁到 2,000 档，按低的算
1802,0000送礼没到 299，本轮照样清零

1.5 奖励配置

待确认
  1. 三个框（头像框、麦克风框、座位框）的有效时长。演示里先写 7 days，后台默认填 7 天。
  2. 厅内停留 1 分钟按累计算还是单次连续算。本文档按累计写。
  3. 资料完整度的计算口径是否沿用资料页现有的完整度。
  4. Welcome 6 个全部领完后，Welcome tab 是否隐藏；进入任务中心默认停在哪个 tab（本文档按「有没领完的新手任务停在 Welcome，否则停在 Daily rewards」写）。
  5. 连续奖励填了多个装扮 ID 时，是否等概率随机。本文档按等概率写。
  6. Box：在钱包页等任务中心以外的地方充值，也会结算并清零本轮，需要和需求方确认。
  7. 显示开关关掉以后，已经拿到但还没领的奖励是否保留领取入口。
  8. Box 活动是否需要配置开始和结束时间。目前只有显示开关。

二、页面交互：Welcome

样式以本文档截图为准。演示 demo 只用来看交互流程，还没有更新到这一版。

Welcome 任务列表

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领取弹窗（三个 tab 共用）

【使用范围】
Welcome、Daily rewards、Box rewards 领取奖励都弹这一个，不另做弹窗。
【标题】
Reward received
【奖励素材】
奖励 ID 对应的素材；金币用金币图。
【奖励内容】
奖励名称。
【时长或数量】
只写文字，不带图标。装扮显示有效时长（7 days、1 day 等），礼物显示数量（×1），金币显示 +N。取后台的奖励数量。
【按钮】
Done 关闭。免费礼物显示 Send gift，点击去语聊厅并打开礼物面板的免费礼物。
全部领完

W36 个全部领完

【标题】
You're all set.；副标题 All 6 rewards collected.
【任务卡】
全部 Claimed。
【待确认】
全部领完后 Welcome tab 是否隐藏。

二、页面交互：Daily rewards

两张任务卡结构一样：标题、时间轴、提示语、两行奖励。

当天未完成

D1昨天、今天都没做

【标题行】
Daily rewards；右侧 Rules，点击打开规则弹窗（D4）。
【说明】
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 2 days in a row for a mystery box.
【奖励行】
固定两行，样式和 Welcome 任务卡统一：奖励图；标题写奖励名和时长（1-day avatar frame／1-day mystery frame）；副标题只放时间标签 Yesterday／Today。
【按钮】
和 Welcome 同款。Go：今天没做，点击去完成（送礼→语聊厅礼物面板；充值→充值）。Claim：可领取。Claimed：已领取。昨天那行没完成或已过期时，Claim 置灰。
可领取

D2可领取（送礼昨天、今天都做了；充值只有今天做了）

【Yesterday 行】
昨天完成拿到的奖励，可领到今天 24:00（GMT+8），过期后置灰。
【Today 行】
今天完成后即可领取。送礼昨天也做了，所以今天的奖励是 1-day mystery frame。
【充值卡】
昨天没充值，Yesterday 行 Claim 置灰；今天充值了，Today 行是普通奖励 1-day avatar frame。
【领取】
1-day avatar frame 点 Claim 直接领取，弹领取弹窗（W2，时长 1 day）。1-day mystery frame 点 Claim 随机发一个装扮，弹同一个领取弹窗（D3）。
领取盲盒

D3领取 1-day mystery frame

【弹窗】
同 W2 的领取弹窗：抽中的装扮素材、装扮名称、时长 1 day。
【抽取】
从后台这一项配置的几个装扮 ID 里随机发一个。
【按钮】
Done 关闭。没有开盒动画，不展示奖池和稀有度。
规则弹窗

D4规则弹窗（Rules）

【样式】
只有纯文本，没有标题和小标题；四条编号，右上角 × 关闭。
【内容】
  1. Send a paid gift in a room, or top up any amount. Each one has its own reward.
  2. Did the same one yesterday? Today you get a mystery frame. If not, you get an avatar frame.
  3. All frames last 1 day.
  4. Each reward can be claimed until midnight after the next day (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，不随轮次变；右边 ↻ 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 个档位，样式同钱包；只写金币图标和数字，不写 coins。点击任意格子拉起商店弹窗并选中这一档。
每格写这一档自己的返还金币 +X bonus。没解锁的档置灰，下面一行带锁写送礼还差多少（档位减本轮已送，本图 299 档写 119 more）。
已解锁到 2,000

B2本轮送了 2,600，解锁到 2,000 档

【已解锁档】
送礼达到的档位及以下：金色 +X bonus。最高已解锁档紫框打勾，作为推荐档。
【没解锁的档】
置灰，写这一档自己的 +X bonus；下面一行带锁写送礼还差多少，如 5,000 档写 2,400 more。送礼达到这一档后解锁。
商店弹窗

B3商店弹窗

【触发】
点 Top up 或点任意充值格子。
【内容】
上线接真实商店，展示选中的充值商品和购买按钮。商店里不展示任何任务信息。
【购买后】
回到 Box rewards，按规则结算本轮（B4）。
充值后

B4充值 2,000 之后：奖励待领，新一轮

【结算】
充值成功后结算本轮，返还金币进入待领，Toast 提示 Top-up complete. +100 coins ready to claim.
【待领】
和 Welcome、Daily 的领奖行同款：金币图＋金币数＋Claim。几轮的待领合并成一行，Claim 一次领完。点图标或金币数打开明细（B5）。
【新一轮】
送礼清零，所有格子回到未解锁；卡片顶部照样写 This round。
【没奖励的充值】
充值不到 299，或本轮一档都没解锁：没有待领，但本轮照样清零。
待领明细

B5待领明细

【每一笔】
本轮送礼金额、这一笔充值金额、返还金币、剩余时间（Expires in hh:mm:ss）。
【按钮】
Claim N coins，一次领完。
【过期】
每一笔各自 24 小时，过期后自动消失。
领取成功

B6领取成功

【弹窗】
同 W2 的领取弹窗：Reward received，金币图，名称 Coins，下面写 +领取的金币数。
【按钮】
Done 关闭，待领那一行消失。
规则弹窗

B7规则弹窗（Rules）

【样式】
同 Daily rewards 的规则弹窗（D4）：纯文本，四条编号。
【内容】
  1. Only gifts from the Box gifts tab count. Each bonus unlocks when your box gifts reach that amount.
  2. Only a single top-up counts. Top up more than your unlocked amount? You get the highest unlocked bonus.
  3. Every top-up ends the round, even without a bonus. Box gifts count from 0 again.
  4. Bonuses from different rounds can be claimed together.

三、后台配置

一个页面配完三个任务，只配显示开关和奖励。打开静态页

后台配置页

A1用户任务中心配置

【显示开关】
三个任务各一个。关掉后前端不展示对应 tab；三个都关掉时，任务中心入口也不展示。
【新手任务】
6 个任务固定，完成条件不在后台改；每个任务配一个奖励。
【每日任务】
送礼、充值各配两个奖励：
普通奖励：前一天没完成同一任务时发放；
连续奖励：前一天也完成了同一任务时发放。奖励 ID 可以填多个装扮 ID，用英文逗号隔开，领取时随机发其中一个。
【奖励字段】
  • 奖励类型：装扮、礼物、金币。
  • 奖励数量：装扮填有效时长，单位天；礼物、金币填个数。
  • 奖励 ID：装扮 ID 或礼物 ID，前端用它取素材和名称。
【盒子任务】
8 个档位金额固定，只配每档返还金币；默认按档位金额的 5% 向下取整。
【保存】
保存后对之后发放的奖励生效，已经发出去的奖励不变。