Appearance
抽奖规则
概述
本条目定义“灵妙儿带你游西湖项目”中的抽奖规则,包括奖池配置、消耗规则、奖品发放、概率口径、库存扣减、参与限制与风控要求。
奖池结构
- 后台固定维护 8 个奖品位。
- 每个奖品位可配置:
- 奖品名称
- 图片
- 概率
- 类型
- 库存
消耗规则
- 单次抽奖消耗积分为后台配置值。
- 发起抽奖前必须先校验用户积分余额。
奖品类型与发放方式
积分类奖品
- 中奖后直接到账。
核销券 / 实物奖品
- 中奖后生成中奖记录。
- 同时发送系统消息。
- 通过消息引导用户联系客服领取。
概率规则
- 所有奖品的总概率必须等于 100%。
- 库存为 0 的奖品不可参与抽奖:
- 不进入抽样集合
- 不参与概率计算
概率公示口径
前端“概率公示”入口需遵循以下规则:
- 展示精确概率。
- 概率展示为百分比,保留 2 位小数。
- 仅对当前可参与抽奖的奖品集合进行归一化后公示。
- 若某奖品库存为 0:
- 不展示其概率
- 在奖品位标记为 “已兑完” 或 “已售罄”
库存扣减规则
- 以服务端抽奖确认成功为准,同步扣减库存。
- 同步完成:
- 库存扣减
- 抽奖记录落库
- 不得异步扣减库存,避免并发场景下出现超卖。
页面展示要求
抽奖页必须展示以下内容:
- 活动规则入口
- 概率公示说明
- 参与限制(含次数口径)
- 奖品发放 / 兑奖说明
- 客服路径
当奖品库存为 0 时:
- 对应按钮需置灰
- 提示文案为:“奖品已兑完”
参与限制
- 默认单用户每日最多参与 20 次。
- 统计口径为:自然日(+08:00)。
- 后台可对次数上限进行下调。
- 不可上调超过合规审批值。
风控规则
幂等要求
- 单用户抽奖请求必须携带幂等键:
X-Idempotency-Key
频控要求
- 抽奖请求必须具备频控机制。
- 推荐频控窗口:同一
userId3 秒内最多 1 次抽奖请求。 - 命中频控时返回错误码:
A0004
实施要点
- 抽奖服务端应基于可用库存奖品集合构建抽样池。
- 概率公示与实际抽样口径必须一致,避免前后端口径不一致。
- 并发场景下需保证扣库存、抽奖确认、记录落库的一致性。
- 幂等与频控应作为抽奖接口的默认保护能力。
