套餐

套餐定义会员购买活动时获得的具体权益。每个套餐指定会员支付多少、获得什么回报（分钟、钱包余额或两者兼有）、权益适用于哪些设备，以及权益的有效期限。

套餐类型

每个套餐有两个类型字段决定权益的性质：

基础类型

基础类型定义主要权益：

• 分钟：会员获得一组预付分钟。基础数量代表包含的分钟数。购买时，系统创建对应分钟数的时间余额。
• 金额：会员获得钱包余额。基础数量代表以货币最小单位（如分）计的金额。购买时，系统创建对应余额的钱包条目。

赠送类型

赠送类型定义在基础权益之上的可选额外权益：

• 分钟：会员获得赠送分钟。赠送数量指定额外赠送的分钟数。创建"赠送"类型的单独时间余额。
• 金额：会员获得赠送钱包余额。赠送数量指定以最小单位计的赠送金额。创建"赠送"类型的单独钱包条目。
• 无：不包含赠送。会员仅获得基础权益。

组合示例

购买价格与权益

购买价格是会员在收银台支付的金额（以货币最小单位计）。这与基础数量是独立的，两者无需相等。

例如：

• 套餐可能花费 2000 最小单位（购买价格）但授予 3000 最小单位的钱包余额（基础数量）。会员实际获得了 50% 的内置增值。
• 分钟套餐可能花费 1500 最小单位并授予 120 分钟。"每分钟成本"是隐含的，无需与标准小时费率匹配。

这种分离允许网吧业主创建增值套餐，使权益超过付款金额，让套餐比按次计费更有吸引力。

设备限制

设备限制控制权益可在哪些类型的设备上使用：

设备限制被此套餐创建的所有钱包余额和时间余额继承。

有效期

有效天数

valid_days 字段设置权益在购买后保持可用的天数。会员购买套餐时，系统计算过期日期为 购买日期 + 有效天数。过期后，关联批次中的任何剩余余额（分钟或钱包余额）不再可用。

如未设置 valid_days，权益不过期。

有效星期

有效星期设置是可选的日期选择，限制权益可在一周中的哪几天消费。这允许创建"仅工作日"或"仅周末"等套餐。配置有效星期后，系统仅在符合条件的日期从套餐余额中扣除。

钱包类别和跨类别消费

套餐可以为其创建的钱包余额分配钱包类别。这为资金标记一个类别标签（如"游戏"、"通用"、"食品"），限制余额的消费范围。

套餐上的跨类别消费选项控制创建的余额是否允许在其类别之外消费：

• 0（默认）：资金限制在其指定类别内。
• 1：资金也可在其他类别中消费。

会员折扣叠加

会员折扣叠加选项控制当消费套餐的分钟或钱包余额时，会员的等级折扣是否在此套餐定价基础上叠加应用：

• 0（默认）：会员的等级折扣不叠加。套餐按固定价值处理。
• 1：会员的等级折扣在套餐条款基础上额外应用。这使高等级会员即使使用预付套餐时也能获得额外优惠。

套餐的购买和发放流程

套餐购买时：

1. 收取费用：向会员收取购买价格（现金、刷卡或钱包扣款）。
2. 购买记录：创建购买条目，记录会员、套餐、付款金额和时间戳。
3. 余额创建：根据套餐配置：
   • 如果基础类型为金额：创建"付费"类型的钱包余额，金额为基础数量。
   • 如果基础类型为分钟：创建"付费"类型的时间余额，分钟数为基础数量。
   • 如果赠送类型为金额：创建"赠送"类型的额外钱包余额，金额为赠送数量。
   • 如果赠送类型为分钟：创建"赠送"类型的额外时间余额，分钟数为赠送数量。
4. 限制和过期：所有创建的余额继承套餐的设备限制和钱包类别。如设置了有效期，则计算过期日期。
5. 追踪：购买记录维护付费和赠送部分的已消费与已授权数量的运行总计，在需要时可精确计算退款。

创建套餐

向现有活动添加套餐：

1. 从活动列表中打开活动。
2. 点击添加套餐。
3. 配置基础类型（分钟或金额）并设置基础数量。
4. 可选配置赠送类型和赠送数量。
5. 设置购买价格（会员支付的金额）。
6. 选择设备限制。
7. 可选设置有效天数和有效星期用于限时优惠。
8. 如使用基于类别的钱包分离，配置钱包类别和跨类别消费。
9. 设置会员折扣叠加偏好。
10. 保存套餐。