HandyCafe Docs
owner it-admin

カフェテリアのセットアップ方法

このガイドでは、カフェテリアモジュールの初回セットアップを完全に説明します。最終的に、handy.cafe/{your-slug}で公開された顧客メニュー、少なくとも1つの稼働中のテーブルを含むフロアプラン、商品が登録されたメニュー、そして成功したテスト注文を完了することができます。

必要なもの

  • 有効なHandyCafeライセンス。カフェテリアの認証はライセンスを自動的に使用するため、キーを手動で入力する必要はありません。
  • サーバーのインターネット接続。カフェテリアはクラウドファーストであるため、プロビジョニング、メニュー同期、注文ポーリングにはクラウドAPIへのアウトバウンドアクセスが必要です。
  • 公開メニューURLに使用するスラッグ。使用可能な文字は小文字、数字、ハイフンで、長さは3から62文字です。
  • オプション: ロゴとヘッダー画像。推奨フォーマットは最大2MBのWebPです。
  • オプション: ローカルネットワーク上のTCPレシートプリンター。

ステップ1: カフェテリアを有効にする

  1. HandyCafeサーバーを開きます。
  2. サイドバーの設定に移動します。
  3. カフェテリアタブを開きます。
  4. カフェテリアを有効にするをオンに切り替えます。
  5. サーバーはライセンスを認証トークンとして使用してクラウドAPIに接続します。成功すると、プロビジョニングウィザードが開きます。

期待される結果: プロビジョニングウィザード画面が表示されます。ライセンスや接続に関するエラーが表示された場合は、インターネット接続を確認し、HandyCafeライセンスが有効であることを確認してください。

ステップ2: カフェをプロビジョニングする

ウィザードでは4つのフィールドを入力する必要があります。

  1. スラッグ。 希望するURLサフィックスを入力します。利用可能性インジケーターが1秒以内に更新されます。スラッグが使用中または予約済みの場合は、別のものを選択してください。
  2. 表示名。 顧客メニューの上部に表示される人間が読める名前です。例: "アティラのゲーミングラウンジ"。
  3. 国と通貨。 カフェが運営されている国を選択します。通貨は国に基づいてデフォルトで設定され、変更可能です。
  4. タイムゾーン。 注文と決済のタイムスタンプ用のタイムゾーンを選択します。
  5. カフェを作成をクリックします。

期待される結果: ウィザードが閉じ、カフェテリアワークスペースが開きます。公開URL handy.cafe/{slug} がライブになりますが、メニューは空です。

ステップ3: ビジネスプロファイルを入力する

  1. 設定 > カフェテリアの下で、ビジネスプロファイルセクションまでスクロールします。
  2. ロゴ（正方形の画像）をアップロードします。
  3. ヘッダー画像（ワイドバナー）をアップロードします。
  4. 顧客メニューのフッターに表示する住所と電話番号を入力します。
  5. メニューに準備時間を表示をオンまたはオフに切り替え、顧客に推定準備時間を表示するかどうかを決定します。
  6. 保存をクリックします。

期待される結果: プレビューにロゴとヘッダーが表示されます。ブラウザでhandy.cafe/{slug}を訪れると、ブランド化されたヘッダーが表示されますが、コンテンツはまだ空です。

ステップ4: フロアを作成する

  1. 設定 > カフェテリアで、フロアセクションを見つけます。
  2. フロアを追加をクリックし、名前を付けます（例: "メインホール"）。
  3. 会場に複数のエリアがある場合は、追加のフロアを追加します（例: "メザニン", "アウトドアパティオ"）。
  4. フロアを上下に移動するボタンで並べ替えます。フロアプランエディターで一番上のフロアがデフォルトになります。

期待される結果: フロアがリストに表示されます。カフェテリア > フロアプランタブには、フロアピルが上部に表示されます。

ステップ5: フロアプランを作成する

  1. カフェテリア > フロアプランを開きます。
  2. ピルから最初のフロアを選択します。
  3. テーブルを追加をクリックします。キャンバスの原点に正方形のテーブルが表示されます。
  4. テーブルを希望の位置にドラッグします。リリースして保存します。
  5. テーブルをクリックしてプロパティパネルを開き、以下を設定します:
    • コード（例: "T1", "窓際3"）。
    • 表示名（オプションの長いラベル）。
    • 座席数（座席の数）。
    • 形状（正方形、横長の長方形、縦長の長方形、または円形）。
    • サイズ（1から10）。
  6. フロア内のすべてのテーブルに対して繰り返します。
  7. オプションで3Dビューに切り替えて、建築家の視点からレイアウトを確認します。

期待される結果: フロアプランが実際の位置にすべてのテーブルをレンダリングします。3Dビューではドラッグが無効です。テーブルを移動するには2Dに戻ります。

ステップ6: メニューを作成する

  1. カフェテリア > メニューを開きます。
  2. カテゴリを追加をクリックします。名前を入力し、アイコンピッカーからMDIアイコンを選択します。保存をクリックします。
  3. 各カテゴリ（例: "ホットドリンク", "コールドドリンク", "バーガー", "デザート"）に対して繰り返します。
  4. カテゴリ内で商品を追加をクリックします。以下を入力します:
    • 名前。
    • 説明（Markdown対応）。
    • 材料行。
    • 基本価格。
    • VAT率。
    • 準備時間（静的フォールバック）。
    • オプション: 単位ラベル、在庫追跡フラグ、在庫数。
  5. 商品の写真をアップロードします。任意のフォーマットが受け入れられますが、最大2MBのWebPが推奨されます。
  6. 保存をクリックします。
  7. 商品に選択肢がある場合は、バリアントセクションにスクロールし、バリアントを追加をクリックします。各オプションの価格差を持つ行を作成します。顧客が1つを選択する必要がある場合は必須を切り替えます。
  8. メニュー内のすべての商品に対して繰り返します。

期待される結果: handy.cafe/{slug}の顧客メニューにカテゴリと商品が表示されます。ブラウザで確認してください。

ステップ7: プリンターを設定する（オプション）

  1. 設定 > カフェテリアの下で、プリンター設定までスクロールします。
  2. 種類をTCPに設定します。
  3. プリンターのIPとポートを入力します。ほとんどのESC POS TCPプリンターはポート9100でリッスンしています。
  4. プリンターが対応している場合はオートカットを有効にします。
  5. 新しい注文ごとに印刷をトリガーするために新しい注文で自動印刷を有効にします。
  6. デスクトップ通知と一緒に音声アラートを出すために音声通知を有効にします。
  7. テスト印刷をクリックします。数秒以内にサンプルレシートが印刷されるはずです。

期待される結果: テストレシートが正常に印刷されます。何も印刷されない場合は、IP、ポート、およびプリンターがサーバーと同じローカルネットワーク上にあることを確認してください。

ステップ8: テーブルに着席し、テスト注文を行う

  1. カフェテリア > テーブル（またはフロアプランのアクションメニュー）を開きます。
  2. 1つのテーブルを選択し、顧客を着席（または「テーブルを開く」）をクリックします。
  3. 表示された6桁のセキュリティコードをメモするか、ダイアログを開いたままにします。
  4. 携帯電話でhandy.cafe/{slug}/{table-code}にアクセスします。印刷されたステッカーがある場合はQRをスキャンすることもできます。
  5. 6桁のコードを入力します。
  6. メニューを閲覧し、アイテムをカートに追加します。
  7. チェックアウトに進みます。支払い方法として現金を選択します（Stripeの設定はオプションで、後で追加できます）。
  8. 注文を送信します。
  9. サーバーでカフェテリア > 注文に切り替えます。

期待される結果: 3秒以内に新しい注文カードが注文ダッシュボードに表示されます。デスクトップ通知が発生します。音声通知が有効な場合は音声アラートが鳴ります。注文タブの保留カウントバッジが増加します。

ステップ9: テスト注文を進めて決済する

  1. 注文カードで次のステータスボタンをクリックします。注文が配置済みから確認済みに移動します。
  2. 準備中、準備完了、提供済みまでクリックし続けます。
  3. テーブルページで同じテーブルを開き、チェックを決済をクリックします。
  4. 支払い方法として現金を選択し、確認します。

期待される結果: テーブルがアイドルに戻ります。セキュリティコードは無効になります。決済記録が作成され、後で監査できます。

避けるべき一般的なミス

  • ビジネスプロファイルをスキップする。 プロファイルを保存する前に起動すると、顧客はデフォルトの表示名と壊れたロゴエリアを目にします。
  • スラッグ変更後にQRコードを再印刷しない。 スラッグを変更すると、既存のQRがすべて無効になります。新しいステッカーを印刷し、すべてのテーブルに貼り替えてください。
  • 起動時に多くのカテゴリを公開しすぎる。 トップレベルカテゴリは6から10に抑えます。メニューが画面に収まると顧客はより速く閲覧できます。
  • 最初の実際のシフトの前にプリンターを設定し忘れる。 新しい注文で自動印刷がないと、忙しい時期にスタッフが注文を見逃す可能性があります。必ず少なくとも1回のテスト印刷を行ってください。
  • 動的履歴がない状態でメニューに準備時間を表示するデフォルトを有効にしておく。 最初の30日間は静的値が顧客に表示されます。現実的な静的時間を設定するか、動的推定がトレーニングされるまでチップを無効にします。
  • スタッフと顧客のテストに同じデバイスを使用する。 顧客セッションは24時間持続します。テストデバイスが後に顧客に渡された場合、彼らはすでにメニューにアクセスでき、確認なしで利用できます。デバイスをクリアするか、テストにはクリーンなブラウザプロファイルを使用してください。