ロイヤルティティア

ロイヤルティティアシステムは、蓄積された活動に基づいて常連顧客に自動割引を提供します。メンバーがカフェを利用する（金銭の支出、ログイン、パッケージの購入、注文）と、ロイヤルティポイントが獲得されます。総ポイントがティアの閾値を超えると、上位ティアに昇格し、セッション料金に対するより大きな割引が適用されます。

ティアの構成

各ロイヤルティティアは4つのフィールドで定義されます。

ティアはthreshold_points値で順序付けられます。メンバーはポイント閾値を満たす最も高いティアに所属します。

ベーシスポイント（BPS）割引

割引はパーセンテージではなくベーシスポイント（BPS）で表されます。これは財務計算における浮動小数点の丸め誤差を回避するためです。1ベーシスポイントは0.01%（パーセントの100分の1）に相当します。

一般的な割引値:

ティア割引のあるメンバーがセッションを開始すると、料金エンジンがセグメント費用の計算前にティアのdiscount_bpsで基本時間単価を減額します。

ロイヤルティイベント

メンバーはロイヤルティイベントを通じてポイントを獲得します。各イベントはポイントの変動とそのトリガーとなった活動を記録します。

各ロイヤルティイベントレコードには以下が含まれます。

• 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値がある場合、基本価格が減額されます: 割引後価格 = 基本価格 * (10000 - discount_bps) / 10000。
3. さらに、メンバーレコードの個別メンバーレベル割引（member_discount_bps）がある場合も適用されます。
4. 最終的な割引後レートがセグメント費用の計算に使用されます。

ティア割引とメンバーレベル割引は累積可能で、メンバーは両方の割引の恩恵を受けられます。

ティアの作成と管理

新しいティアを作成するには:

1. 設定に移動し、料金設定セクション（または専用のティア管理エリア）を開きます。
2. ティア追加をクリックします。
3. コード（一意、小文字）、名前（表示ラベル）、閾値ポイント、割引BPSを入力します。
4. ティアを保存します。

既存のティアを編集するには、リストからティアを選択して任意のフィールドを変更します。ティアのdiscount_bpsの変更は、現在そのティアに割り当てられているすべてのメンバーの次のセッションから有効になります。

ティアを削除するには、リストから削除します。削除されたティアに割り当てられていたメンバーは、ポイントに基づいて認定される次の下位ティアに戻ります。

ティア設定の例

一般的な3ティア構成は以下のようになります。

この設定では、新しいメンバーはブロンズ（割引なし）から開始します。来店、支出、注文を通じて500ポイントを蓄積すると、自動的に5%割引のシルバーにアップグレードされます。2000ポイントでゴールド（10%）、5000ポイントでVIPステータス（15%）を獲得します。