HandyCafe Docs
owner

会员等级

忠诚度等级系统根据会员累积的活动量自动给予折扣奖励。会员使用网吧(消费、登录、购买套餐或下单)时获得忠诚积分。当总积分超过某个等级的门槛时,自动晋升到更高等级并获得更大的时段定价折扣。

等级结构

每个忠诚度等级由四个字段定义:

字段 说明
code 等级的唯一短代码(如 silvergoldvip)。内部识别和 API 响应中使用。
name 显示名称(如"白银会员"、"黄金会员")。在会员资料和客户端锁定屏幕上显示。
threshold_points 会员达到此等级所需的最低忠诚积分数。
discount_bps 应用于时段定价的折扣,以基点表示。100 BPS 等于 1%。值为 500 表示 5% 折扣。

等级按 threshold_points 值排序。会员属于其积分所满足的最高等级。

基点(BPS)折扣

折扣以基点(BPS)而非百分比表示,以避免财务计算中的浮点舍入误差。一个基点等于 0.01%,即百分之一的百分之一。

常见折扣值:

BPS 值 百分比 1000 单位/小时费率示例
250 2.5% 会员每小时支付 975
500 5% 会员每小时支付 950
1000 10% 会员每小时支付 900
1500 15% 会员每小时支付 850
2000 20% 会员每小时支付 800

当拥有等级折扣的会员开始时段时,定价引擎在计算分段费用前,按等级的 discount_bps 降低基础小时费率。

忠诚事件

会员通过忠诚事件获得积分。每个事件记录积分变动和触发它的活动:

事件类型 说明 典型积分
spend 会员为时段付费(后付费或钱包扣款)。积分与消费金额成正比。 按消费金额变动
usage 会员使用了 PC 或主机时段,与付款方式无关。积分基于使用时长。 按使用分钟数变动
visit 会员从客户端 PC 登录。每次到店的固定积分,鼓励经常光顾。 每次到店固定值
topup 会员向钱包充值。积分反映充值金额。 按充值金额变动
order 会员下了商品订单(食品、饮料等)。积分与订单总额成正比。 按订单总额变动
adjustment 管理员手动调整的积分。用于修正、促销或特别奖励。 任意值(正或负)

每条忠诚事件记录包含:

  • points_delta:此事件获得(正值)或损失(负值)的积分数。
  • amount_minor:与事件关联的货币金额(最小单位),如适用。
  • minutes_delta:与事件关联的分钟数,如适用。
  • source_entity / source_entity_id:生成此事件的时段、订单或交易的引用。
  • event_at:事件发生的时间戳。

等级晋升

等级晋升工作原理:

  1. 会员执行活动(时段、购买、登录等)。
  2. 系统创建对应 points_delta 的忠诚事件。
  3. 会员的总积分重新计算为所有忠诚事件 points_delta 值的总和。
  4. 系统检查新总积分是否达到更高等级的门槛。
  5. 如果会员满足新等级条件,其 tier 字段更新,新折扣在下次时段时生效。

管理员也可以手动设置等级分配,覆盖自动计算。

等级折扣在时段定价中的应用

当定价引擎为会员计算时段分段费用时:

  1. 根据当前定价档位确定基础小时价格。
  2. 如果会员拥有带 discount_bps 值的等级,基础价格降低:discounted_price = base_price * (10000 - discount_bps) / 10000
  3. 此外,如果会员记录上有个人级别的折扣(member_discount_bps),也会应用。
  4. 最终折扣后的费率用于计算分段费用。

等级折扣和会员级别折扣可以叠加,给会员提供两者的组合优惠。

创建和管理等级

创建新等级:

  1. 导航到设置并打开定价部分(或专用的等级管理区域)。
  2. 点击添加等级
  3. 输入代码(唯一,小写)、名称(显示标签)、积分门槛折扣 BPS
  4. 保存等级。

编辑现有等级时,从列表中选择并修改任何字段。对等级 discount_bps 的变更会在所有当前分配到该等级的会员的下次时段时生效。

删除等级时,从列表中移除。被分配到已删除等级的会员将回退到其积分所满足的下一个较低等级。

等级配置示例

典型的三级配置如下:

代码 名称 积分门槛 折扣 BPS
bronze 青铜 0 0
silver 白银 500 500
gold 黄金 2000 1000
vip VIP 5000 1500

在此配置中,新会员从青铜开始(无折扣)。通过到店、消费和下单积累 500 积分后,自动升级到白银享受 5% 折扣。2000 积分达到黄金(10%),5000 积分达到 VIP(15%)。