Skip to main content

商店、购买与刷新

0. 本篇结论​

本篇是 WEN-13 / B2-A 文档整理稿，状态为 draft；原 producer_review_needed / canonical_candidate 审核事实保留，未取得新增产品批准。第 5 节规则、第 6 节参考图、第 7 节数据需求及第 12 节验收均为候选资料，不能解释为已上线功能或实现授权。来源、冲突及待裁定问题集中在商业化系统。

公共货币/道具表示、库存增减、奖励展示和防重复发放只引用经济系统及道具资源，本篇仅拥有业务触发条件。价格、消耗数量、概率、限购与次数尚未确认时不补默认值。

1. 功能定位​

商店向玩家提供用游戏货币、资源或广告机会购买商品的入口，并支持不同商店类型、格子数据、刷新次数和购买限制。

2. 范围​

In Scope：商店列表、商品格子、购买、刷新、免费次数、广告刷新/广告购买、红点提示、内购商品 ID 暴露。

Out of Scope：充值订单本身、礼包付费流程、抽奖卡池。

3. 玩家入口、解锁与提示​

入口位于大厅主界面或相关活动入口。商店是否开放、商店类型、格子数、免费刷新次数、广告刷新次数由配置和服务端状态共同决定。

4. 核心玩家流程​

  1. 玩家打开商店。
  2. 客户端请求商店列表或指定商店类型。
  3. 展示商品格子、价格、限购和免费次数。
  4. 玩家购买商品或刷新商店。
  5. 后端返回新格子、奖励和消耗变化。
  6. 客户端刷新模型、UI 和红点。

5. 核心规则​

本节统一为待审核候选；广告功能“暂未实装”是历史参考图说明，不能与购买候选混为当前行为。钻石充值栏位保留暂不开发标记，详见商业化系统 B2A-Q06～Q09。

5.1 商店商品通用规则​

  • SHOP-R-001：商品按 ShopType 分类。
  • SHOP-R-002：每个格子包含商品、价格、购买状态和刷新后的新数据。
  • SHOP-R-003：购买必须由后端校验货币、限购、广告状态和库存。
  • SHOP-R-004：刷新消耗、免费次数和广告次数必须按商店类型独立计算。

5.2 每日精品与刷新规则​

  • SHOP-R-005：每日精品商店固定展示 8 个商品格，第一个格子固定为钻石商品，不参与刷新。
  • SHOP-R-006：钻石商品首次免费领取；后续剩余次数通过广告领取，每日次数有限，次数未用完时应提示红点。
  • SHOP-R-007：普通道具商品按权重随机出现，可配置商品组、道具 ID、数量、价格、价格道具 ID、折扣、权重、是否固定和每日可购买次数。
  • SHOP-R-008：每日精品凌晨 0 点重置所有每日道具和购买状态，并显示距离重置的倒计时。
  • SHOP-R-009：刷新只刷新普通道具商品，重置原货架普通商品的购买状态；成功刷新后当日剩余刷新次数减一，次数为 0 时按钮灰化。
  • SHOP-R-010：商品购买后显示已售罄，图标灰化，点击无响应；钻石固定格按领取规则处理。

5.3 金币购买与钻石充值栏位​

  • SHOP-R-011：金币购买区域包含三个档位：每日首次免费/广告获得金币、小额钻石买金币、大额钻石买金币；获得数量可受膨胀系数影响。
  • SHOP-R-012：钻石充值栏位作为候选规则记录，但当前标记为暂不开发。

5.4 操作矩阵​

N/A。当前不在策划案正文中复述核心玩家流程；进入 PLAN 时，仅对状态变化、消耗/产出、奖励发放、跨系统反馈或失败反馈补齐操作矩阵。

6. UI 状态与交互​

6.1 界面图与交互说明​

以下图片为待评审参考图，已按图片锚点和附近文字绑定到页面/状态；状态均为 仅参考，最终布局、尺寸、按钮位置和视觉风格以制作人/UI 评审确认为准。

图 01：钻石​

商店、购买与刷新 - 钻石

  • 图状态：仅参考
  • 关联页面 / 状态：钻石
  • 关联交互 / 状态说明：商店系统模块；一；每日精品；道具列表；钻石；（1）；道具列表第一位固定是钻石道具

图 02：红点需求​

商店、购买与刷新 - 红点需求

  • 图状态：仅参考
  • 关联页面 / 状态：红点需求
  • 关联交互 / 状态说明：红点需求；商店；商店有可免费领取的钻石；主界面商店入口（红点）---免费钻石（红点）；无免费钻石可领取；商店有可免费领取的金币；主界面商店入口（红点）---免费金币（红点）；无免费金币可领取；商店有广告获得金币、钻石时；主界面商店入口（红点）---广告钻石（红点）---广告金币（红点）；广告获得金币、钻石次数用尽；【260616补】；广告功能暂未实装，等正式需求；商店整体图

图 03：红点需求​

商店、购买与刷新 - 红点需求

  • 图状态：仅参考
  • 关联页面 / 状态：红点需求
  • 关联交互 / 状态说明：红点需求；商店；商店有可免费领取的钻石；主界面商店入口（红点）---免费钻石（红点）；无免费钻石可领取；商店有可免费领取的金币；主界面商店入口（红点）---免费金币（红点）；无免费金币可领取；商店有广告获得金币、钻石时；主界面商店入口（红点）---广告钻石（红点）---广告金币（红点）；广告获得金币、钻石次数用尽；【260616补】；广告功能暂未实装，等正式需求；商店整体图

图 04：红点需求​

商店、购买与刷新 - 红点需求

  • 图状态：仅参考
  • 关联页面 / 状态：红点需求
  • 关联交互 / 状态说明：商店；商店有可免费领取的钻石；主界面商店入口（红点）---免费钻石（红点）；无免费钻石可领取；商店有可免费领取的金币；主界面商店入口（红点）---免费金币（红点）；无免费金币可领取；商店有广告获得金币、钻石时；主界面商店入口（红点）---广告钻石（红点）---广告金币（红点）；广告获得金币、钻石次数用尽；【260616补】；广告功能暂未实装，等正式需求；商店整体图；每日商店区域

图 05：红点需求​

商店、购买与刷新 - 红点需求

  • 图状态：仅参考
  • 关联页面 / 状态：红点需求
  • 关联交互 / 状态说明：红点需求；商店；商店有可免费领取的钻石；主界面商店入口（红点）---免费钻石（红点）；无免费钻石可领取；商店有可免费领取的金币；主界面商店入口（红点）---免费金币（红点）；无免费金币可领取；商店有广告获得金币、钻石时；主界面商店入口（红点）---广告钻石（红点）---广告金币（红点）；广告获得金币、钻石次数用尽；【260616补】；广告功能暂未实装，等正式需求；商店整体图

图 06：当一个商品被购买后，显示【已售罄】，整个商品图标灰化，点击无响应​

商店、购买与刷新 - 当一个商品被购买后，显示【已售罄】，整个商品图标灰化，点击无响应

  • 图状态：仅参考
  • 关联页面 / 状态：当一个商品被购买后，显示【已售罄】，整个商品图标灰化，点击无响应
  • 关联交互 / 状态说明：当一个商品被购买后，显示【已售罄】，整个商品图标灰化，点击无响应；显示类型；显示条件；常规；无；无；免费获得；根据配置此商品可以免费获取；点击直接获取；广告获得；根据配置此商品需要观看广告才能获取；观看一次广告获取

图 07：当一个商品被购买后，显示【已售罄】，整个商品图标灰化，点击无响应​

商店、购买与刷新 - 当一个商品被购买后，显示【已售罄】，整个商品图标灰化，点击无响应

  • 图状态：仅参考
  • 关联页面 / 状态：当一个商品被购买后，显示【已售罄】，整个商品图标灰化，点击无响应
  • 关联交互 / 状态说明：当一个商品被购买后，显示【已售罄】，整个商品图标灰化，点击无响应；显示类型；显示条件；常规；无；无；免费获得；根据配置此商品可以免费获取；点击直接获取；广告获得；根据配置此商品需要观看广告才能获取；观看一次广告获取

图 08：当一个商品被购买后，显示【已售罄】，整个商品图标灰化，点击无响应​

商店、购买与刷新 - 当一个商品被购买后，显示【已售罄】，整个商品图标灰化，点击无响应

  • 图状态：仅参考
  • 关联页面 / 状态：当一个商品被购买后，显示【已售罄】，整个商品图标灰化，点击无响应
  • 关联交互 / 状态说明：一些折扣商品，图标左上角显示【-X%】字样，代表折扣幅度（配置），价格为折扣后价格；除第一个钻石外，所有商品仅可购买一次；当一个商品被购买后，显示【已售罄】，整个商品图标灰化，点击无响应；显示类型；显示条件；常规；无；无

图 09：每个档位首次充值附赠的钻石显示在商品图标右上角，数量可配置​

商店、购买与刷新 - 每个档位首次充值附赠的钻石显示在商品图标右上角，数量可配置

  • 图状态：仅参考
  • 关联页面 / 状态：每个档位首次充值附赠的钻石显示在商品图标右上角，数量可配置
  • 关联交互 / 状态说明：此处展示不同价位的钻石充值档，档位显示价格、可获得钻石、附赠的钻石；按价格从低到高顺序排布；每个档位首次充值附赠的钻石显示在商品图标右上角，数量可配置；每个档位首次购买后，不再赠送钻石，商品右上角的附赠标签隐藏

图 10：当商品有折扣时，图标左上角显示折扣标签​

商店、购买与刷新 - 当商品有折扣时，图标左上角显示折扣标签

  • 图状态：仅参考
  • 关联页面 / 状态：当商品有折扣时，图标左上角显示折扣标签
  • 关联交互 / 状态说明：*；第二、三个栏位需要花费不同钻石（配置）购买；当商品有折扣时，图标左上角显示折扣标签；如果钻石不足，按钮上的数字显示红色，点击提示【钻石资源不足】

图 11：每日商店界面​

商店、购买与刷新 - 每日商店界面

  • 图状态：仅参考
  • 关联页面 / 状态：每日商店界面
  • 关联交互 / 状态说明：每日商店界面；显示每日商店标题；系统凌晨0点重置所有每日道具，此处显示距离重置时间的倒计时（精确到时分秒）；每天X次（配置）免费刷新次数，次数用尽显示广告刷新按钮；广告次数有限制（配置）；【260616补】；广告功能暂未实装，等正式需求

图 12：charge_config配置6档钻石充值​

商店、购买与刷新 - charge_config配置6档钻石充值

  • 图状态：仅参考
  • 关联页面 / 状态：charge_config配置6档钻石充值
  • 关联交互 / 状态说明：充值完毕后播放获得钻石动画，并飞往右上角。；点击资源栏的钻石“+”将跳转到钻石充值栏位，商店功能未解锁时，点击无效；配置；charge_config配置6档钻石充值

图 13：当一个商品被购买后，显示【已售罄】，整个商品图标灰化，点击无响应​

商店、购买与刷新 - 当一个商品被购买后，显示【已售罄】，整个商品图标灰化，点击无响应

  • 图状态：仅参考
  • 关联页面 / 状态：当一个商品被购买后，显示【已售罄】，整个商品图标灰化，点击无响应
  • 关联交互 / 状态说明：显示类型；显示条件；常规；无；无；免费获得；根据配置此商品可以免费获取；点击直接获取；广告获得；根据配置此商品需要观看广告才能获取；观看一次广告获取；售罄；购买1次商品（除钻石）后；无法再次购买此商品

图 14：当一个商品被购买后，显示【已售罄】，整个商品图标灰化，点击无响应​

商店、购买与刷新 - 当一个商品被购买后，显示【已售罄】，整个商品图标灰化，点击无响应

  • 图状态：仅参考
  • 关联页面 / 状态：当一个商品被购买后，显示【已售罄】，整个商品图标灰化，点击无响应
  • 关联交互 / 状态说明：显示类型；显示条件；常规；无；无；免费获得；根据配置此商品可以免费获取；点击直接获取；广告获得；根据配置此商品需要观看广告才能获取；观看一次广告获取；售罄；购买1次商品（除钻石）后；无法再次购买此商品

图 15：系统发放对应数量的钻石和附赠钻石（如有）​

商店、购买与刷新 - 系统发放对应数量的钻石和附赠钻石（如有）

  • 图状态：仅参考
  • 关联页面 / 状态：系统发放对应数量的钻石和附赠钻石（如有）
  • 关联交互 / 状态说明：参考图待补充具体交互说明。

图 16：商店整体图​

商店、购买与刷新 - 商店整体图

  • 图状态：仅参考
  • 关联页面 / 状态：商店整体图
  • 关联交互 / 状态说明：商店有可免费领取的金币；主界面商店入口（红点）---免费金币（红点）；无免费金币可领取；商店有广告获得金币、钻石时；主界面商店入口（红点）---广告钻石（红点）---广告金币（红点）；广告获得金币、钻石次数用尽；【260616补】；广告功能暂未实装，等正式需求；商店整体图；每日商店区域

图 17：Sheet1​

商店、购买与刷新 - Sheet1

  • 图状态：仅参考
  • 关联页面 / 状态：Sheet1
  • 关联交互 / 状态说明：界面

图 18：每日首次免费，之后观看广告获得​

商店、购买与刷新 - 每日首次免费，之后观看广告获得

  • 图状态：仅参考
  • 关联页面 / 状态：每日首次免费，之后观看广告获得
  • 关联交互 / 状态说明：（3）；大量钻石购买金币：shop_coin_config配置钻石消耗和金币获得数量；（4）；折扣配置；（5）；膨胀系数影响获得；界面

图 19：主界面标签页新增商店标签，最左​

商店、购买与刷新 - 主界面标签页新增商店标签，最左

  • 图状态：仅参考
  • 关联页面 / 状态：主界面标签页新增商店标签，最左
  • 关联交互 / 状态说明：商店入口；主界面标签页新增商店标签，最左；红点需求

图 20：红点需求​

商店、购买与刷新 - 红点需求

  • 图状态：仅参考
  • 关联页面 / 状态：红点需求
  • 关联交互 / 状态说明：红点需求；商店；商店有可免费领取的钻石；主界面商店入口（红点）---免费钻石（红点）；无免费钻石可领取；商店有可免费领取的金币；主界面商店入口（红点）---免费金币（红点）；无免费金币可领取；商店有广告获得金币、钻石时；主界面商店入口（红点）---广告钻石（红点）---广告金币（红点）；广告获得金币、钻石次数用尽；【260616补】；广告功能暂未实装，等正式需求；商店整体图

图 21：本模块暂不开发​

商店、购买与刷新 - 本模块暂不开发

  • 图状态：仅参考
  • 关联页面 / 状态：本模块暂不开发
  • 关联交互 / 状态说明：钻石充值界面（暂不开发）；本模块暂不开发；钻石充值栏位位于每日商店下方；此处展示不同价位的钻石充值档，档位显示价格、可获得钻石、附赠的钻石；按价格从低到高顺序排布

图 22：金币充值界面​

商店、购买与刷新 - 金币充值界面

  • 图状态：仅参考
  • 关联页面 / 状态：金币充值界面
  • 关联交互 / 状态说明：折扣；当商品配置了折扣字段时；可以折扣价购买此商品；金币充值界面；金币充值栏位位于钻石充值下方；一共三个档位金币购买项；左起第一个栏位每日首次免费领取一次

图 23：如果钻石不足，按钮上的数字显示红色，点击提示【钻石资源不足】​

商店、购买与刷新 - 如果钻石不足，按钮上的数字显示红色，点击提示【钻石资源不足】

  • 图状态：仅参考
  • 关联页面 / 状态：如果钻石不足，按钮上的数字显示红色，点击提示【钻石资源不足】
  • 关联交互 / 状态说明：如果钻石不足，按钮上的数字显示红色，点击提示【钻石资源不足】；钻石充值界面（暂不开发）；本模块暂不开发

6.2 页面结构与交互​

商店 UI 展示分类、格子、价格、购买按钮、刷新按钮、免费次数、广告提示和失败反馈。购买成功后应即时更新格子或置为已售。

商店入口为主界面标签页最左侧。每日商店区域显示标题、重置倒计时、刷新次数、广告刷新状态、8 个商品格和售罄态。商品格需要支持常规、免费获得、广告获得、售罄和折扣状态。资源不足时，价格数字显示红色；点击后提示对应资源不足。金币购买区域位于钻石充值下方，三个档位从左到右展示；钻石充值区域在未开发期间不应开放支付入口。

6.3 UI 页面状态表​

N/A。当前仅保留已绑定页面/状态的参考图和页面结构说明；具体可执行状态在 UI 评审或 UI brief 中确认。

7. 配置、数据与 Contract​

本节只记录策划案需要的逻辑数据与跨部门 contract，不预设物理配置表、协议文件、service 文件或 仓库落点。正式命名、字段名、接口名、协议对象名、文件名和仓库落点进入执行前由 Work Package 的 contract-registry.yaml、execution brief 和对应执行任务确认。

7.1 策划数据需求​

策划数据需求只描述逻辑数据域、逻辑字段或规则语义，不等同于配置表字段名、协议字段名或数据库字段名。正式字段命名进入 contract-registry.yaml、execution brief 和对应执行任务确认。

数据域逻辑字段 / 规则设计含义必填 / 边界产出责任
商店商品规则商店类型、格子、商品、价格、价格道具、限购、售罄状态定义商店类型、商品格、价格、限购和购买状态进入执行前补齐默认值、边界和可选性Planning
每日精品规则固定格、商品组、权重、折扣、每日可购、刷新次数、倒计时定义固定钻石格、普通商品随机、刷新和 0 点重置进入执行前补齐默认值、边界和可选性Planning
金币购买和充值栏位档位、免费/广告/钻石、获得数量、膨胀系数、开发状态定义金币购买档位和钻石充值栏位候选进入执行前补齐默认值、边界和可选性Planning

7.2 运行时数据与接口需求​

Contract设计含义使用方说明
商店列表状态保存每个商店类型的格子列表、刷新次数和购买状态服务端 / 客户端刷新和购买以状态权威为准
购买操作校验货币、限购、广告状态和库存服务端 / 客户端购买成功后更新售罄和奖励弹窗
刷新操作刷新普通商品并重置货架购买状态服务端 / 客户端固定格不参与刷新

7.3 跨部门 Contract 命名清单​

Contract 类型逻辑对象命名状态阻塞阶段说明
配置数据商店类型、商品、价格、限购、刷新、金币档位和充值栏位待 PLAN 确认PLAN 前不预设物理配置表名
协议 / API商店列表、购买、刷新、固定格领取待 PLAN 确认执行前由服务端 / UI brief 确认
错误码货币不足、次数不足、商品售罄、广告不可用、刷新失败待 PLAN 确认执行前需要玩家提示
资源引用商店图标、商品图标、折扣标、售罄态和倒计时表现待 PLAN 确认执行前由美术 / UI brief 确认

8. 系统边界​

方向负责内容备注
Planning逻辑数据、数值、文本需求、资源需求进入执行前由 PL 任务细化
服务端协议、校验、持久化、奖励发放、幂等与安全仅相关功能需要
客户端UI、交互、表现、本地状态、红点和跳转仅相关功能需要
美术图标、模型、特效、音频和导出资源仅相关功能需要
Ops / GM后台配置、运营投放、公告、补偿和数据看板仅相关功能需要

客户端与表现​

  • 红点：ShopRedDotHandler

美术与音频需求​

需要商店入口图标、商品格子背景、货币图标、刷新按钮、购买成功反馈和广告标识。

9. 数值、经济与奖励​

  • 商店商品配置 定义商品配置。
  • 商店参数配置 定义普通商店格子数、免费刷新次数、广告刷新次数、水晶商店格子数等零散参数。
  • 商品奖励与消耗只引用经济系统与道具资源，商品业务价格与限购留在本篇候选规则。

10. 异常、安全与运营边界​

10.1 异常与安全​

重复购买、重复刷新、广告回调伪造、货币不足、商品配置缺失必须服务端兜底。

10.2 埋点与运营​

建议记录商店打开、商品曝光、购买成功/失败、刷新、广告刷新、免费次数消耗。

11. Feature Relations 与回归范围​

Feature Relations​

依赖 item-resource、main-entry-red-dot、recharge-giftpack、广告 SDK。读取 shop 配置，写入玩家商品状态和资源变化。

红点与 main-entry-red-dot 共享：有免费钻石、免费金币或广告获取金币/钻石次数时，主界面商店入口和对应商品/区域显示红点；次数用尽后红点消失。

回归范围​

以 Feature Relations 影响功能、核心玩家流程、配置与系统边界为基础；进入执行前由 PLAN / QA brief 细化最小回归范围。

12. 验收标准​

12.1 关键验收结论​

商店列表、购买、刷新、免费次数、广告次数、限购、红点和失败提示均符合配置和服务端返回。

补充验收：每日 0 点重置、第一格钻石不刷新、普通商品刷新重置购买状态、8 格固定展示、折扣标签、售罄态、金币三档购买、资源不足红字和钻石充值暂不开发状态均需验证。

12.2 规则验收清单​

  • SHOP-R-001：候选内容见第 5 节；核对批准状态、证据与商业化系统待裁定项。
  • SHOP-R-002：候选内容见第 5 节；核对批准状态、证据与商业化系统待裁定项。
  • SHOP-R-003：候选内容见第 5 节；核对批准状态、证据与商业化系统待裁定项。
  • SHOP-R-004：候选内容见第 5 节；核对批准状态、证据与商业化系统待裁定项。
  • SHOP-R-005：候选内容见第 5 节；核对批准状态、证据与商业化系统待裁定项。
  • SHOP-R-006：候选内容见第 5 节；核对批准状态、证据与商业化系统待裁定项。
  • SHOP-R-007：候选内容见第 5 节；核对批准状态、证据与商业化系统待裁定项。
  • SHOP-R-008：候选内容见第 5 节；核对批准状态、证据与商业化系统待裁定项。
  • SHOP-R-009：候选内容见第 5 节；核对批准状态、证据与商业化系统待裁定项。
  • SHOP-R-010：候选内容见第 5 节；核对批准状态、证据与商业化系统待裁定项。
  • SHOP-R-011：候选内容见第 5 节；核对批准状态、证据与商业化系统待裁定项。
  • SHOP-R-012：候选内容见第 5 节；核对批准状态、证据与商业化系统待裁定项。

12.3 执行层验收​

  • 如填写操作矩阵，成功路径、失败场景、玩家反馈和状态权威均已覆盖。
  • 如填写 UI 页面状态表，页面 / 弹窗状态均已覆盖，或明确标记为 N/A。
  • Section 7 中标记为 PLAN 前或执行前阻塞的 contract 已在 contract-registry.yaml、execution brief 或执行任务中确认。
  • 相关 Feature Relations 回归通过。

13. 待澄清问题 / Open Questions​

  • 每日精品和金币购买已按日重置迁移为候选规则；其他商店类型的限购刷新周期仍需确认。
  • 广告购买、广告领取和广告刷新是否共享次数，需要确认。
  • 钻石充值栏位当前按暂不开发处理；是否转入 recharge-giftpack 正式范围需要确认。

14. 变更记录​

日期版本修改人变更摘要
2026-06-16v0.2Codex补充规则编号、操作矩阵、UI 状态表、逻辑字段和执行层验收锚点
2026-06-16v0.1Codex按新版功能策划案模板重排章节；保留既有规则内容并映射参考图