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