セッション管理

セッションはHandyCafeの基本的な請求単位です。インターネットカフェやゲームセンターでお客様がPCやゲームコンソールを使用するたびに、セッションが使用時間を追跡し、費用を計算します。このページでは、セッションの開始から支払いの回収まで、セッションのライフサイクル全体を説明します。

セッションタイプ

HandyCafeは2種類のセッションをサポートしています：

• PCセッション。 管理パネルを通じて管理されるクライアントPCでのセッション。クライアントソフトウェアは、アイドル状態のときにPCをロックし、セッションが開始されるとアンロックします。
• コンソールセッション。 コンソールページを通じて管理されるゲームコンソール（PlayStation、Xboxなど）でのセッション。これらはサーバーによってのみ追跡され、コンソール自体にはクライアントソフトウェアはありません。

両方のセッションタイプは同じ料金エンジンとライフサイクルに従いますが、ダッシュボードの異なるページから管理されます。

セッションライフサイクル

すべてのセッションは、明確な状態遷移を持つ定義されたライフサイクルに従います：

開始 --> 実行中 --> (一時停止 <--> 再開) --> 時間追加 --> 停止

詳細な状態：

1. 開始。 キャッシャーがセッションを開始します。クライアントPCがアンロックされるか、コンソールのタイマーが始まります。
2. 実行中。 セッションがアクティブです。時間がカウントされ、請求が累積されます。
3. 一時停止。 キャッシャーが一時的にセッションを停止します。請求は停止します。クライアントは一時停止状態を表示します。
4. 再開。 キャッシャーが一時停止されたセッションを再開します。請求は新しい料金セグメントから再開されます。
5. 時間追加。 キャッシャーがアクティブなセッションに分を追加（または削除）します。
6. 停止。 セッションが終了します。システムは最終的な費用を計算し、支払いを促します。

セッションの開始

クライアントPCで新しいセッションを開始するには：

1. クライアントを選択。 管理パネルで、アイドル（シアン）状態のPCをクリックしてアクションボタンを表示します。
2. 請求タイプを選択。 後払い（終了時に支払う）または前払い（事前に支払う）を選択します。
3. メンバーを割り当て（オプション）。 顧客が登録メンバーである場合、オートコンプリートメンバー検索フィールドを使用してアカウントを検索します。メンバーを割り当てると、ウォレット支払いが可能になり、セッションが履歴に記録されます。
4. 期間または金額を設定（前払いのみ）。 前払いセッションの場合、顧客が購入する分数または支払う金額を入力します。システムは現在の料金スロットに基づいて対応する時間を計算します。
5. 支払い方法を選択。 支払い方法（現金、クレジットカード、または設定したカスタム方法）を選択します。
6. 確認。 詳細を確認し、確認します。クライアントPCは即座にアンロックされ、セッションタイマーが始まります。

コンソールセッションの場合、プロセスは似ていますが、コンソールページから開始されます。

後払いセッション

後払いセッションでは、顧客はPCを先に使用し、終了時に支払います。これはインターネットカフェ、サイバーカフェ、ゲームセンターで最も一般的な請求モードです。

動作方法：

• セッションは事前支払いなしで開始されます。
• タイマーが動作し、費用はリアルタイムでアクティブな料金スロットに基づいて累積されます。
• セッションが停止されると、システムは最終的な計算された費用を提示します。
• キャッシャーが支払いを受け取り、取引を確認します。

後払いセッションには時間制限がありません。キャッシャーが停止するか、顧客が退席を希望するまで続きます。

前払いセッション

前払いセッションでは、顧客は特定の時間分を事前に支払います。購入した時間が切れるとセッションは自動的に終了します。

設定 > 料金で設定された2つの前払い料金モードがあります：

購入時に固定

セッション開始時に費用が固定されます。購入時にアクティブな料金スロットと乗数がセッション全体の期間に使用され、セッション中に発生するスケジュール変更には影響されません。

例： 顧客が標準料金スロット中の午前10時に60分を購入します。午前11時に料金スケジュールが半額スロットに切り替わっても、顧客の残り時間には影響しません。彼らは元の料金で支払った分を正確に受け取ります。

ライブスケジュール

セッションが異なる料金スロットを通過するにつれて、費用はリアルタイムで調整されます。顧客のセッションがスロット変更をまたぐ場合、残り時間は新しい料金に基づいて再計算されます。

例： 顧客が標準料金スロット中の午前10時に60分を購入します。午前11時にスケジュールが半額スロットに切り替わります。各分が半額になるため、顧客の残り時間は実質的に伸びます。彼らは元々購入したよりも多くの合計分を得るかもしれません。

セッションの一時停止

一時停止は、セッションを終了せずに請求を一時的に停止します。これは、顧客が一時的に席を外す必要がある場合に便利です。

セッションを一時停止するには：

1. 管理パネルでアクティブなPCを選択し、カード上の一時停止ボタンをクリックします。

セッションが一時停止されたときに何が起こるか：

• 請求は即座に停止します。一時停止中は費用は発生しません。
• 現在の料金セグメントは「一時停止」境界で閉じられます。
• クライアントPCはオレンジ色のステータスインジケータで一時停止状態を表示します。
• セッションタイマーは停止します。

一時停止されたセッションは、キャッシャーが再開または停止するまで無期限に一時停止されたままです。

セッションの再開

再開は、一時停止されたセッションを元の状態から続行します。

セッションを再開するには：

1. 管理パネルで一時停止されたPCを選択し、カード上の再開ボタンをクリックします。

セッションが再開されたときに何が起こるか：

• 現在の時間で新しい料金セグメントが始まり、アクティブな料金スロットが使用されます。
• 請求が再開されます。
• クライアントPCはアクティブ（緑色）状態に戻ります。

再開時の料金スロットは、一時停止時のスロットと異なる場合があります。新しいセグメントは、現在アクティブな料金スケジュールのレートを使用します。

時間の追加

アクティブなセッションにいつでも分を追加または削除できます。

時間を追加するには：

1. 管理パネルでアクティブなPCを選択し、カード上の時間追加ボタンをクリックします。
2. 追加する分数を入力します。セッションを延長するには正の値を、短縮するには負の値を使用します。
3. 確認します。

時間が追加されたときに何が起こるか：

• セッション履歴に取引記録が作成されます。
• 前払いセッションの場合、終了時間が指定された分数だけ前後に調整されます。
• 後払いセッションの場合、追加時間イベントは記録されますが、終了時間は設定されません。

セッションの停止

セッションを停止すると、すべての請求が終了し、クライアントPCがロックされ、支払いプロセスが開始されます。

セッションを停止するには：

1. 管理パネルでアクティブまたは一時停止されたPCを選択し、カード上の停止ボタンをクリックします。
2. 支払いダイアログが表示され、セッションの概要が示されます。

支払いダイアログ

支払いダイアログには次の情報が表示されます：

キャッシャーの上書き： キャッシャーは請求額を手動で調整できます。例えば、キャッシャーが親切として切り下げたり、手動で割引を適用したりすることがあります。元の計算額は監査のために常に記録に残されます。

4. 支払い方法を選択し、確認します。セッションが記録され、クライアントPCがロックされ、取引が保存されます。

決済プロセス

セッションが停止されると、決済エンジンは次のステップを実行します：

1. 最後のオープン料金セグメントを閉じます。
2. すべてのクローズドセグメントの金額を合計します。
3. 丸めルールを適用します（常に設定された丸めステップに切り上げます）。
4. スタートアップ料金の最低額を適用します（合計はスタートアップ料金を下回ることはありません）。
5. 支払い方法の手数料（BPSベース）と固定料金を計算します。
6. 支払いダイアログに最終金額を提示します。

料金セグメントと決済計算の詳細な説明については、セッション料金を参照してください。

メンバーセッション

メンバーがセッションに割り当てられると、追加の請求オプションが利用可能になります：

• ウォレット支払い。 セッション費用はメンバーのウォレット残高から差し引かれます。
• 時間パッケージの控除。 メンバーが時間パッケージを購入している場合、分数は金銭的な金額を請求する代わりにパッケージ残高から差し引かれます。
• メンバー割引。 メンバーに割引が設定されている場合（基点で）、セッション費用に適用されます。
• セッション履歴。 セッションはメンバーのアカウントにリンクされ、彼らのセッション履歴に表示されます。

メンバーは、ユーザー名とパスワードでログインするか、OAuth（設定されている場合）を通じてクライアントアイドル画面から自分のセッションを開始することもできます。

セッションステータス値

各クライアントPCは、色分けされたステータスインジケータを表示します：

これらのステータスカラーは管理パネルのクライアントカードに表示され、各PCの状態を一目で確認できます。

セッション料金セグメント

各セッションは1つ以上の料金セグメントに分割されます。請求に関連するイベントが発生するたびに新しいセグメントが作成されます：

• セッション開始
• 一時停止
• 再開
• 料金スロットの変更（スケジュール上の異なる時間スロットに入るとき）
• 基本料金の変更（管理者がセッション中に時間料金を変更した場合）
• 切断または再接続

各セグメントは料金スロット、乗数、基本料金、開始時間、終了時間、計算額を記録します。セッションの合計は、すべてのセグメントの合計であり、丸めと最低料金ルールが適用されます。

セグメントの計算方法の詳細については、セッション料金を参照してください。

最低料金とスタートアップ料金

非常に短いセッションでも、スタートアップ料金額が最低限請求されます。これは設定 > 料金で設定されており、どんなに短い使用でも最低限の収益を保証します。

例： スタートアップ料金が$1.00に設定されており、顧客がPCを30秒だけ使用した場合、請求額は1時間料金での30秒の費用ではなく、$1.00です。

次のステップ

• セッション料金：料金エンジン、セグメント、決済計算の詳細
• 管理パネル：クライアントPCの監視と制御
• メンバー：メンバーアカウントとウォレットの管理
• キャッシュレポート：セッション収益とシフトサマリーの確認