カフェのゼロからのセットアップ方法
このガイドでは、インターネットカフェ、ゲーミングセンター、eスポーツアリーナへのHandyCafeの新規インストールのすべてのステップを説明します。読み終わると、動作するサーバー、少なくとも1台の接続クライアントPC、設定済みの料金、キャッシュレポートに記録された支払いを含む完了したテストセッションを手に入れることができます。
必要なもの
- HandyCafe Serverとして使用するWindows PC（Windows 10以降、最低4GB RAM）。
- クライアントステーションとして使用する少なくとも1台の追加Windows PC。
- すべてのPCを接続するローカルネットワーク（信頼性のために有線Ethernetを推奨）。
- 有効なHandyCafeベータライセンスキー。初期設定時に入力します。
- 希望する時間単価と通貨を事前に決定しておくこと。
フェーズ1：サーバーのインストールと設定
- HandyCafeダッシュボードから最新のHandyCafe Serverインストーラーをダウンロードします。
- サーバーとして指定したPCでインストーラーを実行します。画面上のプロンプトに従い、デフォルトのインストールディレクトリを受け入れます。
- HandyCafe Serverを起動します。最初の起動時に初期設定ウィザードが自動的に表示されます。
- プロンプトが表示されたらベータライセンスキーを入力します。サーバーはオンラインでキーを検証し、カフェ名とPC上限を表示します。
- 管理者アカウントを作成します。ユーザー名と強力なパスワードを入力します。このアカウントはすべての機能に無制限のアクセス権を持ちます。
- カフェ名を設定します。この名前はクライアントのアイドル画面とレポートに表示されます。
- 完了をクリックしてウィザードを終了します。
期待される結果: 接続クライアントがゼロのAdmin Panelを表示したサーバーのメインウィンドウが開きます。タイトルバーにカフェ名が表示されます。
フェーズ2：料金の設定
- 左サイドバーのギアアイコンをクリックして設定ページを開きます。
- 料金タブに移動します。
- 基本通貨を設定します。通貨ドロップダウンから選択します。すべての価格、取引、レポートにこの通貨が使用されます。
- 時間単価を入力します。これは後払いセッションの1時間あたりの基本価格です。例えば、1時間に通貨10単位の場合は10.00と入力します。
- VAT率を設定します。セッション料金に適用されるパーセンテージ（0〜100）を入力します。VATが適用されない場合は0を入力します。
- 開始料金を設定します。これはセッション時間に関係なくセッションごとの最低料金です。最低料金が不要な場合は0を入力します。
- 一般的な時間のプリセットを作成します。プリセットセクションまでスクロールします。プリセットを追加をクリックします。次のようなプリセットを作成します：
- 「30分」30分の時間。
- 「1時間」60分の時間。
- 「2時間」120分の時間。
- 保存をクリックして料金設定を適用します。
期待される結果: 料金タブに時間単価、VAT率、開始料金、その下にすべてのプリセットが表示されます。これらのプリセットは前払いセッションを開始する際にクイック選択ボタンとして表示されます。
フェーズ3：ネットワーク設定の確認
- 設定のままで、ネットワークタブに移動します。
- リッスンポートを確認します。デフォルトは7842です。ネットワーク上の別のサービスがそのポートを使用している場合のみ変更します。
- 接続キーを設定またはメモします。このキーはクライアント接続を認証します。すべてのクライアントPCは接続するために同じキーを使用する必要があります。
- サーバーPCのファイアウォールが設定されたポートへの受信TCP接続を許可していることを確認します。Windowsでは、HandyCafeは通常インストール時にこのルールを追加します。ポートを変更した場合は、新しいファイアウォールルールを手動で追加します。
- ネットワークタブに表示されるサーバーPCのIPアドレスをメモします。クライアントが自動検出でサーバーを見つけられない場合に必要になります。
期待される結果: ネットワークタブにリッスンポートと接続キーが表示されます。サーバーステータスインジケーターが緑色で「リッスン中」と表示されます。
フェーズ4：最初のクライアントの展開
- ダッシュボードからHandyCafe Clientインストーラーをダウンロードします。
- 最初のクライアントPCにインストールします。インストーラーを実行してプロンプトに従います。
- HandyCafe Clientを起動します。クライアントはローカルネットワーク上でmDNSを使用してサーバーを自動的に検出しようとします。
- 自動検出に失敗した場合は、クライアント接続ダイアログにサーバーIPアドレスとポートを手動で入力します。
- フェーズ3でメモした接続キーを入力します。
- 接続が確立するまで待ちます。クライアント画面は時計付きのロック画面を表示するアイドルページに切り替わります。
期待される結果: サーバーのAdmin Panelに1台の接続クライアントが表示されます。クライアントタイルにはホスト名と青い「アイドル」ステータスが表示されます。クライアントPCにロック画面が表示されます。
- サーバーはホスト名に基づいてクライアントに表示名を自動割り当てします。名前を変更するには、サーバーのクライアントタイルを選択して名前変更をクリックします。
フェーズ5：最初のテストセッションの実行
- サーバーのAdmin Panelで、アイドル状態のクライアントタイルの開始をクリックします。
- セッションダイアログで後払いを選択します。ゲストセッションのためにメンバーフィールドを空のままにします。
- 確認をクリックしてセッションを開始します。
期待される結果: クライアントタイルが緑色に変わり、上昇するタイマーが表示されます。クライアントPCでロック画面が消え、オンラインページのデスクトップが表示されます。
- 料金計算を確認するために、セッションを少なくとも5分間実行します。
- サーバーの緑色のクライアントタイルで停止をクリックします。
- コスト内訳ダイアログを確認します。以下が表示されます：
- 時間（例：5分）。
- 適用された時間単価。
- VAT金額。
- 合計料金。
- 支払い方法を選択します（現金がデフォルト）。
- 確認をクリックしてセッションを完了して支払いを記録します。
期待される結果: クライアントタイルが青い「アイドル」ステータスに戻ります。クライアントPCに再びロック画面が表示されます。システムに取引が記録されます。
フェーズ6：キャッシュレポートでの確認
- 左サイドバーを使用してキャッシュレポートページに移動します。
- 今日のレポートに1件のセッション取引が表示されていることを確認します。
- 取引金額がセッションを停止した際に見たコスト内訳と一致していることを確認します。
- 支払い方法列に「現金」（または選択した方法）が表示されていることを確認します。
期待される結果: キャッシュレポートに、正しい金額、時間、支払い方法を含む1件の完了したセッションが表示されます。カフェの準備が整いました。
フェーズ7：オプションの次のステップ
基本的な設定が機能したら、次の機能の設定を検討してください：
- メンバーを追加する。 メンバーページに移動します。追加をクリックして、ユーザー名と任意のウォレット残高を持つメンバーアカウントを作成します。メンバーはクライアントPCからログインできます。
- 商品を設定する。 商品ページに移動します。キャッシャーが注文を作成できるよう、価格付きの飲食物アイテムを追加します。
- クライアントメニューを設定する。 設定 > クライアントメニューに移動します。顧客がオンラインページにランチャーグリッドを見られるよう、アプリケーションカテゴリとアプリを追加します。
- 追加のクライアントを展開する。 カフェのすべてのステーションPCにHandyCafe Clientをインストールします。各PCはサーバーに自動的に表示されます。
- キャッシャーアカウントを作成する。 管理ページに移動します。スタッフがログインしてセッションを管理できるよう、適切なロールを持つキャッシャーアカウントを追加します。
- ピーク/オフピーク料金を設定する。 設定 > 料金スケジュールに移動します。繁忙期に多く請求するための時間帯別倍率を作成します。
- OAuthログインを有効にする。 設定 > OAuthに移動します。顧客がソーシャルアカウントでログインできるよう、GoogleまたはほかのプロバイダーをTo設定します。
よくある間違いと対策
- ファイアウォールルールをスキップする。 クライアントが接続できない場合、最も一般的な原因はWindowsファイアウォールルールがリッスンポートをブロックしていることです。他の問題のトラブルシューティングを行う前に、ルールが存在することを確認します。
- 接続キーの不一致。 すべてのクライアントのキーはサーバーのキーと完全に一致する必要があります。入力ミスを避けるためにコピー＆ペーストを使用します。
- 時間単価を0に設定する。 時間単価をゼロのままにすると、すべての後払いセッションが無料になります。公開前に必ず料金を確認してください。
- 設定を保存し忘れる。 設定ページの変更は保存をクリックするまで適用されません。再起動後に設定が変更されていない場合は、おそらく保存し忘れています。
- 同じPCでサーバーとクライアントを実行する。 テストでは技術的に可能ですが、本番環境では推奨されません。サーバーPCは専用のステーションである必要があります。