よくある質問

セットアップとインストール

HandyCafeはどのような業種に対応していますか？

HandyCafeはインターネットカフェ、ゲーミングセンター、eスポーツアリーナ、サイバーカフェ、PCバン向けに設計されています。PCやゲーミングコンソールへの時間課金アクセスを提供するすべての事業で、HandyCafeを使用してセッション、課金、メンバーシップを管理できます。

HandyCafe Serverのシステム要件は何ですか？

サーバーにはWindows 10以降（64ビット）、4 GB以上のRAM、500 MBのディスク空き容量、ローカルネットワーク接続が必要です。クライアントPCにはWindows 10以降と2 GBのRAMが必要です。すべてのPCは同一LANに接続されている必要があります。詳細はシステム要件をご覧ください。

HandyCafe Serverのインストール方法は？

公式サイトからインストーラーをダウンロードして実行し、指示に従います。初回起動時に初回セットアップウィザードが管理者アカウントを作成します。手順の詳細はサーバーインストールをご覧ください。

クライアントPCをサーバーに接続する方法は？

PCにHandyCafe Clientをインストールします。ローカルネットワーク上のサーバーをmDNSで自動検出します。自動検出に失敗した場合は、クライアント設定でサーバーのIPアドレスを手動入力してください。詳細はクライアントインストールをご覧ください。

クライアントがサーバーに接続できないのはなぜですか？

一般的な原因: サーバーが起動していない、PCが異なるサブネットにある、ファイアウォールがポート（TCP 5001、5002、5003およびUDP 5004）をブロックしている、接続キーが一致していない。詳細な解決策はトラブルシューティングをご覧ください。

HandyCafeが使用するポートは？

TCP 5001（コマンド）、TCP 5002（ファイル転送）、TCP 5003（リモート管理）、UDP 5004（画面ストリーミング）です。これらはネットワーク設定で変更可能です。

ライセンスの有効化方法は？

ライセンスパネルでライセンスキーを入力します。サーバーがライセンスサーバーで検証を行います。初回有効化にはインターネット接続が必要です。詳細はライセンスをご覧ください。

サーバーが72時間以上オフラインになるとどうなりますか？

HandyCafeには72時間のオフライン猶予期間があります。この間、すべての機能が正常に動作します。72時間を超えてライセンスサーバーに接続できない場合、インターネットアクセスが復旧するまでサーバーはロック状態になります。

セッションと料金設定

PCでセッションを開始する方法は？

管理パネルでアイドル状態のPC（シアン）を選択し、カードの開始をクリックします。後払いまたは前払いモードを選択し、メンバーの割り当て（任意）、前払いの場合は時間/金額を設定し、支払い方法を選択して確認します。詳細はセッションをご覧ください。

前払いと後払いセッションの違いは何ですか？

後払いモードでは、顧客は実際の使用時間に基づいてセッション終了時に支払います。前払いモードでは、固定時間または金額を前払いします。前払いには2つのサブモード（購入時固定とリアルタイムスケジュール）があります。詳細はセッションをご覧ください。

料金スケジュールの仕組みは？

料金スケジュールは、7日間 x 24時間のグリッドで、各時間ブロックに色分けされた料金スロットが割り当てられます。各スロットには倍率（例: 1.0x 標準、1.5x ピーク、0.5x オフピーク）があります。セッション費用は「基本時間単価 x スロットの倍率 x 利用時間」で計算されます。詳細はセッション料金をご覧ください。

週末と平日で異なる料金を設定する方法は？

設定 > 料金スケジュールで、異なる倍率を持つ料金スロットを作成します（例: 「平日」1.0x、「週末」1.3x）。週末の列を週末スロットの色で、平日の列を平日スロットの色で塗ります。詳細は料金スケジュール設定をご覧ください。

セッションの一時停止と再開の方法は？

オンラインPCカードの一時停止をクリックします。一時停止中は課金が停止します。再開するには、一時停止中のPCカードの再開をクリックします。再開時に新しい料金セグメントが開始されます。詳細はセッションをご覧ください。

アクティブセッションに時間を追加する方法は？

オンラインPCカードの時間追加をクリックします。追加する分数を入力します（正の値で延長、負の値で短縮）。調整に対する取引記録が作成されます。

セッションが複数の料金スロットにまたがる場合はどうなりますか？

セッションはスロット境界で自動的にセグメントに分割されます。各セグメントはその期間中にアクティブな倍率を使用します。合計費用はすべてのセグメント費用の合計です。詳細はセッション料金をご覧ください。

開始料金とは何ですか？

開始料金はすべてのセッションに適用される最低料金です。セッションが非常に短い場合でも、顧客には少なくともこの金額が請求されます。料金設定で設定します。

メンバーとロイヤルティ

新しいメンバーの作成方法は？

メンバーページに移動してメンバー追加をクリックします。ユーザー名、表示名、メールアドレス（任意）、電話番号（任意）などの詳細を入力します。該当する場合はティアを割り当てます。詳細はメンバーをご覧ください。

ウォレットシステムの仕組みは？

各メンバーにはウォレット残高があります。ウォレットをチャージすると、特定の金額とクレジットタイプ（有料、ボーナス、手動など）を持つウォレットクレジットが作成されます。セッション中にウォレットが自動的に消費されます。クレジットには有効期限とデバイス制限を設定できます。詳細はメンバーウォレットをご覧ください。

ウォレットクレジットとは何ですか？

ウォレットクレジットは、1回のチャージによって作成されるウォレット残高の個別エントリです。各クレジットは独自の金額、クレジットタイプ（有料、ボーナス、手動）、ステータス（アクティブ、期限切れ、消費済み）、対象デバイス制限を追跡します。クレジットは古いものから順に消費されます。詳細はメンバーウォレットをご覧ください。

ロイヤルティティアとポイントの仕組みは？

メンバーは活動（利用額、来店、チャージ、注文）を通じてポイントを獲得します。各ティアにはポイントの閾値があります。メンバーが十分なポイントを蓄積すると次のティアに昇格します。上位ティアではより良い割引率が適用される場合があります。詳細はロイヤルティティアをご覧ください。

メンバーのウォレットをチャージする方法は？

メンバーページでメンバーを選択し、支払い/チャージオプションをクリックし、金額を入力し、クレジットタイプと支払い方法を選択して確認します。新しいウォレットクレジットが作成されます。詳細はメンバーウォレットをご覧ください。

メンバーはPCとコンソールの両方でウォレット残高を使用できますか？

クレジットのデバイス制限によります。クレジットは「PCのみ」「コンソールのみ」「両方」に制限できます。パッケージ購入時、作成されるウォレット/時間クレジットはパッケージの設定に定義されたデバイス制限を継承します。詳細はパッケージをご覧ください。

ウォレットクレジットが期限切れになるとどうなりますか？

クレジットが有効期限に達すると、ステータスが「期限切れ」に変更され、残額は利用できなくなります。期限切れの金額はメンバーの取引履歴にログされます。

メンバーの取引履歴の確認方法は？

メンバーページでメンバーを選択します。メンバー詳細パネルにすべてのウォレットチャージ、利用、返金、調整がタイムスタンプと金額とともに表示される取引元帳が表示されます。

商品、注文、在庫

商品カタログへの商品追加方法は？

商品ページに移動して商品追加をクリックします。名前、カテゴリ、単位、バーコード、販売価格、仕入価格、消費税率を入力します。有効/無効を切り替えます。詳細は商品をご覧ください。

顧客への注文作成方法は？

注文ページに移動して新規注文をクリックします。PCへの割り当て（任意）やメモの追加後、商品カタログからアイテムを数量とともに追加し、支払い方法を選択して注文を完了します。詳細は注文をご覧ください。

注文のキャンセルや返金方法は？

注文ページから注文を開き、キャンセルをクリックします。注文は無効となり、支払いは記録されません。完了済み注文の返金には、該当する返金ワークフローを使用してください。

在庫追跡の仕組みは？

各商品には在庫レベルがあります。在庫ログは変更理由とともに追跡します: 販売（注文完了時に自動減算）、仕入（在庫エントリから）、調整、廃棄、返品。詳細は商品および在庫をご覧ください。

キャンペーンとパッケージ

キャンペーンの作成方法は？

キャンペーンページに移動してキャンペーン追加をクリックします。名前、説明を入力し、アクティブに設定し、必要に応じて有効期限を設定します。次にキャンペーンにパッケージを追加します。詳細はキャンペーンをご覧ください。

分数ベースと金額ベースのパッケージの違いは何ですか？

分数ベースのパッケージはセッションに使用できる時間（分）をメンバーに付与します。金額ベースのパッケージはメンバーのウォレットに資金を追加します。どちらもボーナス金額を含めることができます。詳細はパッケージをご覧ください。

パッケージのボーナスシステムの仕組みは？

パッケージには基本特典に加えてボーナスを含めることができます。たとえば、「60分 + 15分ボーナス」や「1,000円 + 200円ボーナス」といったパッケージが可能です。ボーナスは「ボーナス」クレジットタイプでタグ付けされた別のクレジットエントリを作成します。

パッケージのデバイス制限の仕組みは？

各パッケージにはデバイス制限が定義されています: クライアント（PC）、コンソール、両方、PCのみ、コンソールのみ。パッケージ購入時、作成されるウォレット/時間クレジットはこの制限を継承し、対応するデバイスタイプでのみ使用できます。

キャッシャー管理

キャッシャーアカウントの作成方法は？

マネジメント > キャッシャーに移動します。キャッシャー追加をクリックし、ユーザー名とパスワードを入力し、ロールを割り当てます。キャッシャーはこの資格情報でログインできるようになります。詳細はキャッシャーロールをご覧ください。

キャッシャーロールの権限設定方法は？

マネジメント > キャッシャーロールに移動します。新しいロールを作成するか既存のロールを編集します。6つのカテゴリ（認証、メンバー、コンソール、ログ、レポート、支払い方法）の各権限フラグをチェックまたはアンチェックします。詳細はキャッシャーロールをご覧ください。

6つの権限カテゴリとは？

認証（1フラグ）、メンバー（6フラグ: 表示、追加、削除、更新、メール表示、電話表示）、コンソール（4フラグ: 表示、追加、削除、更新）、ログ（4フラグ: 表示、全履歴、今日のみ、削除）、レポート（3フラグ: 表示、全履歴、今日のみ）、支払い方法（4フラグ: 管理、追加、削除、更新）です。合計: 22個の権限フラグ。

キャッシャーログインのブルートフォース対策の仕組みは？

10分以内に5回のログイン失敗で、アカウントが15分間ロックされます。すべてのログイン失敗はセキュリティアラートとともに監査証跡に記録されます。

キャッシャーのシフトレポートの確認方法は？

キャッシュレポートページを開きます。キャッシャー名でフィルタリングして、特定のキャッシャーがシフト中に処理した取引を確認できます。シフトサマリーには合計と支払い方法別の内訳が表示されます。

設定と構成

言語の変更方法は？

設定 > 一般に移動してドロップダウンから言語を選択します。HandyCafeは24言語に対応しています。インターフェースは即座に更新されます。詳細は一般設定をご覧ください。

Google OAuthログインの設定方法は？

設定 > OAuthに移動します。OAuthをグローバルに有効にし、Googleを有効にします。Google Cloud ConsoleからGoogle Client IDとClient Secretを入力します。JSON資格情報ファイルのインポートも可能です。クライアントPCからOAuthログインを開始してテストしてください。詳細はOAuth設定をご覧ください。

料金スケジュールグリッドの設定方法は？

設定 > 料金スケジュールに移動します。スケジュールを有効にし、倍率付きの色分けスロットを作成し、7 x 24時間グリッド上でクリック/ドラッグして時間ブロックに目的のスロットを塗ります。詳細は料金スケジュール設定をご覧ください。

クライアントアイドル画面のカスタマイズ方法は？

設定 > クライアント > アイドル画面タブに移動します。スライドショーを有効にし、画像や動画を追加し、表示時間とトランジションを設定します。時計やカフェ名のオーバーレイ表示も設定できます。詳細はクライアントアイドル画面をご覧ください。

クライアントの外観テーマの変更方法は？

設定 > クライアント > 外観タブに移動します。テーマ（Neon Arena、Crimson Pulse、Emerald Depth）を選択し、レイアウトプリセットを選び、背景、カード密度、エフェクトを設定します。詳細はクライアントの外観設定をご覧ください。

サウンド通知の設定方法は？

設定 > サウンドに移動します。マスターサウンドトグルを有効にし、各イベント（キャッシャー呼び出し、新規注文、セッション終了、ログインリクエスト）に15種類の内蔵サウンドからサウンドを選択します。詳細はサウンド設定をご覧ください。

接続キーとは何ですか？なぜ重要ですか？

接続キーは、サーバーとクライアント間の暗号認証に使用される共有シークレットです。不正なデバイスがサーバーに接続することを防止します。すべてのクライアントはサーバーと同じキーを使用する必要があります。ネットワーク設定で設定します。

リモート管理

クライアントPCのリモートスクリーンショットの撮影方法は？

管理パネルでクライアントを選択し、カードのスクリーンショットをクリックします。スクリーンショットビューアーにキャプチャ画像が表示されます。新しいキャプチャの更新や画像のダウンロードが可能です。詳細はスクリーンショットをご覧ください。

リモートデスクトップでクライアントPCを制御する方法は？

クライアントカードを選択してリモートデスクトップをクリックします。ライブH.264映像ストリーミングのウィンドウが開きます。リモートでマウスとキーボードを操作でき、サーバーとクライアント間のクリップボード同期も機能します。詳細はリモートデスクトップをご覧ください。

ファイル同期システムの仕組みは？

設定 > 同期エクスプローラーで同期するディレクトリを設定します。同期が実行されると、サーバーがファイルマニフェストを作成します。クライアントはマニフェストをローカルファイルと比較し、変更されたファイルや新しいファイルのみをチャンクベース転送でダウンロードします。詳細はファイル同期をご覧ください。

クライアントPCで実行中のアプリの確認方法は？

管理パネルでクライアントを選択し、カードの実行中のアプリをクリックします。現在実行中のすべてのプロセスが名前と詳細とともにパネルに表示されます。同じアクションボタンからスタートアップアプリ、インストール済みアプリ、ウィンドウ付きアプリも確認できます。

クライアントPCへのメッセージ送信方法は？

クライアントカードを選択してメッセージ送信をクリックします。メッセージを入力して確認します。メッセージが顧客の画面に表示されます。

クライアントPCのリモートシャットダウンや再起動方法は？

クライアントカードを選択してシャットダウンまたは再起動をクリックします。一括操作のために複数のクライアントを選択することもできます。Wake on LANに対応するオフラインPCの電源投入にはWake on LAN機能を使用できます。

レポートと分析

キャッシュレポートの確認方法は？

サイドバーからキャッシュレポートに移動します。レポートにはサマリーカード、取引履歴、端末別売上、チャートが表示されます。日付フィルターを使用して期間を絞り込めます。詳細はキャッシュレポートをご覧ください。

レポートデータのエクスポート方法は？

キャッシュレポートでエクスポート/コピー機能を使用して、取引データをCSV形式でクリップボードにコピーします。Excelやスプレッドシートアプリケーションに貼り付けて使用できます。

統計ページで利用できる分析は？

9つの分析タブ: 売上トレンド、販売分析、経費追跡、セッション統計、コンソール稼働率、アプリケーション利用状況、コンピューター使用率、メンバー活動、キャッシャーパフォーマンス。詳細は統計をご覧ください。

コンピューターの稼働率を確認する方法は？

統計 > コンピューター利用タブに移動します。PC別の稼働率、稼働時間、端末別売上が表示されます。最も稼働率の高いPCも特定できます。詳細はセッションとコンピューター統計をご覧ください。

トラブルシューティング

クライアントが「オフライン」と表示されますが、PCは起動しています。どうすればよいですか？

以下を確認してください: 1) PCでHandyCafe Clientが実行中、2) 両方のPCが同じネットワーク/サブネットに接続、3) ファイアウォールがTCPポート5001-5003を許可、4) サーバーとクライアント間で接続キーが一致。詳細はトラブルシューティングをご覧ください。

セッション料金が正しくないように見えます。確認方法は？

料金設定（設定 > 料金設定）で基本時間単価と消費税を確認します。料金スケジュール（設定 > 料金スケジュール）でセッション時間のアクティブな倍率を確認します。取引詳細でセッションの料金セグメントを確認し、各セグメントの計算方法を確認してください。

OAuthログインが「保留中」のまま止まっています。解決方法は？

管理者がリクエストページでリクエストを承認していることを確認してください。リクエストが停止している場合: 1) 設定 > OAuthでOAuthプロバイダーの資格情報が正しいか確認、2) サーバーがプロバイダーのAPIにアクセスするためのインターネット接続があるか確認、3) デバイスコードの有効期限が切れていないか確認（通常15～30分で期限切れ）。

リモートデスクトップが遅延します。パフォーマンスの改善方法は？

ストリーム設定でビットレートを下げてください（LANの場合は1000～2000 kbpsを推奨）。サーバーとクライアント間のネットワーク帯域幅を確認してください。UDPポート5004がブロックされていないことを確認してください。最良の結果を得るには、Wi-Fiではなく有線Ethernetを使用してください。

ライセンスに「over_limit」と表示されます。どういう意味ですか？

ライセンスの許可数を超えるクライアントPCが接続されています。使用していないクライアントを切断するか、ライセンスをアップグレードしてください。接続クライアント数が制限以下になるまで、サーバーは新しいセッションを開始しません。

キャッシャーがログイン失敗回数超過でロックアウトされました。解除方法は？

自動ロックアウトの期限切れまで15分間お待ちください。緊急の場合は、管理者が管理インターフェースからキャッシャーアカウントを管理できます。