HandyCafe Docs
owner cashier it-admin

よくある質問

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

HandyCafeはどのようなビジネスに対応していますか?

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

HandyCafeサーバーのシステム要件は何ですか?

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

HandyCafeサーバーをインストールするにはどうすればよいですか?

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

クライアントPCをサーバーに接続するにはどうすればよいですか?

PCにHandyCafeクライアントをインストールします。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日間×24時間のグリッドで、各時間ブロックが色分けされた料金スロットに割り当てられています。各スロットには乗数があります(例:標準1.0x、ピーク1.5x、オフピーク0.5x)。セッションのコストは、基本的な時間料金にスロットの乗数を掛け、さらに期間を掛けたものとして計算されます。セッション料金をご覧ください。

週末と平日の料金を異なる設定にするにはどうすればよいですか?

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

セッションを一時停止して再開するにはどうすればよいですか?

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

アクティブなセッションに追加時間を加えるにはどうすればよいですか?

オンラインPCカードで時間追加をクリックします。追加する分数を入力します(延長する場合は正の数、短縮する場合は負の数)。調整のための取引記録が作成されます。

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

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

スタートアップ料金とは何ですか?

スタートアップ料金は、すべてのセッションに適用される最低料金です。セッションが非常に短くても、顧客は少なくともこの金額を請求されます。料金設定で設定します。


メンバーとロイヤルティ

新しいメンバーを作成するにはどうすればよいですか?

メンバーページに移動し、メンバー追加をクリックします。ユーザー名、表示名、オプションでメール、電話番号、その他の詳細を入力します。適用可能な場合はティアを割り当てます。メンバーをご覧ください。

ウォレットシステムはどのように機能しますか?

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

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

ウォレットクレジットは、単一のチャージによって作成されたウォレット残高の個別のエントリです。各クレジットはその金額、クレジットタイプ(有料、ボーナス、手動)、ステータス(アクティブ、期限切れ、消費済み)、および適格なデバイス制限を追跡します。クレジットは順番に消費されます(最も古いものから)。メンバーウォレットをご覧ください。

ロイヤルティティアとポイントはどのように機能しますか?

メンバーは活動(支出、訪問、チャージ、注文)を通じてポイントを獲得します。各ティアにはポイントのしきい値があります。メンバーが十分なポイントを蓄積すると、次のティアに進みます。上位のティアはより良い割引率を持つことができます。ロイヤルティティアをご覧ください。

メンバーのウォレットをチャージするにはどうすればよいですか?

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

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

クレジットのデバイス制限によります。クレジットは「PCのみ」、「コンソールのみ」、または「両方」に制限できます。パッケージを購入する際、デバイス制限はパッケージの設定によって定義されます。パッケージをご覧ください。

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

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

メンバーの取引履歴を表示するにはどうすればよいですか?

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


商品、注文、在庫

カタログに商品を追加するにはどうすればよいですか?

商品ページに移動し、商品追加をクリックします。名前、カテゴリ、単位、バーコード、販売価格、原価、VAT率を入力します。アクティブ/非アクティブを切り替えます。商品をご覧ください。

顧客の注文を作成するにはどうすればよいですか?

注文ページに移動し、新規注文をクリックし、オプションでPCに割り当てるかメモを追加し、商品カタログから数量を指定してアイテムを追加し、支払い方法で注文を完了します。注文をご覧ください。

注文をキャンセルまたは返金するにはどうすればよいですか?

注文ページから注文を開き、キャンセルをクリックします。注文は無効となり、支払いは記録されません。クローズされた注文の返金については、適切な返金ワークフローを使用します。

在庫追跡はどのように機能しますか?

各商品には在庫レベルがあります。在庫ログは、理由と共に変更を追跡します:販売(注文クローズ時に自動減少)、購入(在庫エントリから)、調整、廃棄、返品。商品および在庫をご覧ください。


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

キャンペーンを作成するにはどうすればよいですか?

キャンペーンページに移動し、キャンペーン追加をクリックします。名前、説明を入力し、アクティブに設定し、適用可能な場合は有効期限を設定します。その後、キャンペーンにパッケージを追加します。キャンペーンをご覧ください。

分単位のパッケージと金額ベースのパッケージの違いは何ですか?

分単位のパッケージは、セッションで使用できる時間(分)をメンバーに提供します。金額ベースのパッケージは、メンバーのウォレットに資金を追加します。どちらもボーナス金額を含むことができます。パッケージをご覧ください。

パッケージのボーナスシステムはどのように機能しますか?

パッケージには、基本的な権利に加えてボーナスを含めることができます。たとえば、「60分 + 15ボーナス分」または「$10 + $2ボーナス」を提供するパッケージがあります。ボーナスは「ボーナス」クレジットタイプでタグ付けされた別のクレジットエントリを作成します。

パッケージのデバイス制限はどのように機能しますか?

各パッケージはデバイス制限を定義します:クライアント(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クライアントIDとクライアントシークレットを入力します。オプションでJSON資格情報ファイルをインポートします。クライアントPCからOAuthログインを開始してテストします。OAuth設定をご覧ください。

料金スケジュールグリッドを設定するにはどうすればよいですか?

設定 > 料金スケジュールに移動します。スケジュールを有効にし、乗数を持つ色分けされたスロットを作成し、7x24時間グリッドでクリック/ドラッグして、希望するスロットで時間ブロックを塗ります。料金スケジュール設定をご覧ください。

クライアントのアイドル画面をカスタマイズするにはどうすればよいですか?

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

クライアントの外観テーマを変更するにはどうすればよいですか?

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

サウンド通知を設定するにはどうすればよいですか?

設定 > サウンドに移動します。マスターサウンドのトグルを有効にし、各イベント(キャッシャー呼び出し、新規注文、セッション終了、ログインリクエスト)に対して15の組み込みオプションからサウンドを選択します。サウンド設定をご覧ください。

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

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


リモート管理

クライアントPCのリモートスクリーンショットを撮るにはどうすればよいですか?

管理パネルでクライアントを選択し、カード上のスクリーンショットをクリックします。スクリーンショットビューアがキャプチャされた画像を表示します。新しいキャプチャを更新したり、画像をダウンロードすることができます。スクリーンショットをご覧ください。

リモートデスクトップを使用してクライアントPCを制御するにはどうすればよいですか?

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

ファイル同期システムはどのように機能しますか?

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

クライアントPCで実行中のアプリを確認するにはどうすればよいですか?

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

クライアントPCにメッセージを送信するにはどうすればよいですか?

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

クライアントPCをリモートでシャットダウンまたは再起動するにはどうすればよいですか?

クライアントカードを選択し、シャットダウンまたは再起動をクリックします。オフラインPCをサポートする場合、Wake on LANを使用して電源を入れることもできます。


レポートと分析

キャッシュレポートを表示するにはどうすればよいですか?

サイドバーからキャッシュレポートに移動します。レポートにはサマリーカード、取引履歴、デバイス収益、チャートが表示されます。日付フィルタを使用して時間範囲を絞り込みます。キャッシュレポートをご覧ください。

レポートデータをエクスポートするにはどうすればよいですか?

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

統計ページで利用可能な分析は何ですか?

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

コンピュータ利用率を確認するにはどうすればよいですか?

統計 > コンピュータ使用タブに移動します。これには、PCごとの利用率、稼働時間、マシンごとの収益が表示されます。また、最も忙しいPCを特定します。セッションとコンピュータ統計をご覧ください。


トラブルシューティング

クライアントが「オフライン」と表示されるが、PCはオンになっている。どうすればよいですか?

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

セッション料金が正しくないように見える。どうすれば確認できますか?

料金設定(設定 > 料金)で基本時間料金とVATを確認します。料金スケジュール(設定 > 料金スケジュール)でセッション時のアクティブな乗数を確認します。取引詳細でセッションの料金セグメントを確認し、各セグメントがどのように計算されたかを確認します。

OAuthログインが「保留中」で止まっている。どうすれば解決できますか?

管理者がリクエストページでリクエストを承認したことを確認します。リクエストが止まっている場合は、1) 設定 > OAuthでOAuthプロバイダの資格情報が正しいこと、2) サーバーがプロバイダのAPIに到達するためのインターネットアクセスを持っていること、3) デバイスコードが期限切れでないこと(通常15-30分で期限切れ)を確認します。

リモートデスクトップが遅い。パフォーマンスを向上させるにはどうすればよいですか?

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

ライセンスが「over_limit」と表示されるのはなぜですか?

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

キャッシャーがログイン試行の失敗が多すぎてロックアウトされた。どうすれば解除できますか?

自動ロックアウトが解除されるまで15分待ちます。緊急の場合は、管理者が管理インターフェースを通じてキャッシャーアカウントを管理できます。


カフェテリア

顧客はテーブルからどのように注文を行いますか?

テーブル上のQRコードをスマートフォンでスキャンし、スタッフから渡された6桁のセキュリティコードを入力し、メニューを自分の言語で閲覧し、カートにアイテムを追加し、現金またはオンライン(Stripe)で支払いを行います。注文は3秒以内にカフェテリア注文ダッシュボードに表示されます。顧客メニューをご覧ください。

カフェテリアモジュールを有効にするにはどうすればよいですか?

設定 > カフェテリアを開き、カフェテリアを有効にします。サーバーは自動的にHandyCafeライセンスを認証として使用します。プロビジョニングウィザードがスラッグ、表示名、国、通貨、タイムゾーンを尋ねます。カフェテリア概要およびカフェテリアの設定方法をご覧ください。

顧客メニューは何言語をサポートしていますか?

handy.cafe/{slug}の顧客メニューは24言語をサポートしています。初回訪問時には、ブラウザのAccept-Languageヘッダーから最適な言語を選択します。顧客はトップのピッカーでいつでも言語を切り替えることができます。

カフェテリアはインターネットなしで動作しますか?

いいえ。カフェテリアはクラウドファーストです。プロビジョニング、メニュー同期、注文ポーリングにはすべてアウトバウンドインターネットアクセスが必要です。顧客向けページはクラウドによって提供され、ローカルサーバーがインターネットから到達可能であることに依存しません。


レガシークライアント

HandyCafeは古いV3またはV4クライアントをサポートしていますか?

はい。設定 > レガシークライアントでランタイムサポートを有効にすると、サーバーは元のレガシーポート(UDP 710/711, TCP 712, ファイル転送717)でリスナーを開始します。既存のクライアントは、側で変更を加えることなく接続します。管理パネルには、制限されたアクションセット(ログイン、ログアウト、時間追加、スクリーンショット、ログオフ、再起動、シャットダウン)で表示されます。レガシークライアントをご覧ください。

レガシーとモダンクライアントは同じサーバーで同時に動作できますか?

はい。2つのプロトコルスタックは異なるポートを使用し、衝突しません。同じLAN上で古いクライアントと新しいクライアントを混在させ、同じ管理パネルから管理できます。

古いHandyCafeインストールからデータを持ち込むことはできますか?

はい、Windowsで可能です。設定 > レガシークライアントを開き、データベース移行までスクロールし、移行開始をクリックします。メンバー、料金、商品、注文、取引、ログがインポートされます。元のファイルは変更または削除されません。結果が期待したものでない場合は、移行を元に戻すをクリックしてロールバックします。レガシーインストールからの移行方法をご覧ください。

STEと標準プロトコルバリアントの違いは何ですか?

STE(Smart/Turbo Edition)フレームには70バイトのライセンス情報プレフィックスが含まれています。フレームサイズは1337バイトです。標準フレームはプレフィックスを省略し、フレームサイズは1267バイトです。レガシーサーバーがどのように構築されたかに一致するバリアントを選択してください。間違ったバリアントを選択すると、フレームがドロップされたり、誤読されたりします。