HandyCafe Docs
owner it-admin

カフェテリア

カフェテリアは、HandyCafe に統合された飲食サービスモジュールです。テーブルのデジタルフロアプランを作成し、handy.cafe/{your-slug} でブランド付きのセルフサービスメニューを公開し、サーバーダッシュボードから入ってくる注文をリアルタイムで追跡できます。

顧客はテーブルに貼られた QR コードを読み取り、6 桁のセキュリティコードを入力し、自分の言語でメニューを閲覧して注文します。注文は数秒以内にカフェテリア注文画面に表示されます。スタッフは各調理段階を更新でき、提供が完了したら「精算」アクションで 1 ステップで会計を閉じられます。

対象ユーザー

カフェテリアは、客席で飲食も提供するインターネットカフェ、ゲーミングセンター、eスポーツアリーナ向けに設計されています。紙の注文伝票や口頭でのカウンター依頼を置き換えます。標準の HandyCafe セッションおよび料金システムと並行して動作し、カフェテリアの注文は同じカフェライセンス上で別管理されます。

主な機能

機能 概要
フロアプラン 複数フロアまで対応するビジュアルエディター。テーブルをドラッグで配置し、3D 表示に切り替え、テーブルを使用停止にできます。
テーブル テーブルごとの座席数、形状、サイズ（1〜10）、表示コードを設定できます。QR コードの生成と再発行にも対応します。
メニュー MDI アイコン付きカテゴリ、写真付き商品、Markdown 説明、材料一覧、バリアントグループ（例: サイズ、トッピング）を管理できます。
注文 3 秒間隔のポーリング、未処理件数バッジ、デスクトップ通知と音声通知、注文単位・明細単位のステータス表示を備えたライブダッシュボードです。
精算 選択した支払い方法で、テーブル上の未精算注文をワンクリックでまとめて精算できます。
顧客向けメニュー handy.cafe/{slug} で公開される 24 言語対応のブランド付き Web メニュー。ライト/ダークテーマと端末に応じた言語の初期選択を備えます。
オンライン決済 任意で Stripe Checkout を統合でき、注文時決済に対応します。テーブルでの現金支払いにもフォールバックできます。
プリンター 任意の TCP レシートプリンターに対応し、新規注文時の自動カットと自動印刷を設定できます。

サーバー UI におけるカフェテリアの場所

カフェテリアには 2 つの入口があります。

  1. サイドバーのカフェテリアセクション。 日常運用のためのワークスペースです。テーブル、フロアプラン、メニュー、注文、スケジュールの 5 つのタブがあります。新しい注文が待機しているときは、注文タブに未処理バッジが表示されます。
  2. 設定 > カフェテリア。 設定エリアです。ビジネスプロフィール（slug、表示名、ロゴ、ヘッダー画像、住所、通貨、タイムゾーン）、プリンター設定、フロア管理、任意機能の切り替えをまとめています。

カフェの作成

カフェテリアを初めて有効にすると、サーバーは認証トークンとして HandyCafe ライセンスを自動的に使用します。何かを手動で貼り付ける必要はありません。続く作成ウィザードでは、次の 4 項目を求められます。

  1. Slug。 公開 URL handy.cafe/{slug} になります。使用可能な文字は小文字の英字、数字、ハイフンです。長さは 3〜62 文字です。システムはリアルタイムで空き状況を確認し、「admin」「api」「dashboard」などの予約済み slug は拒否します。
  2. 表示名。 顧客向けメニュー上部に表示される、読みやすい名前です。
  3. 国と通貨。 メニュー価格の既定通貨です。価格は少数単位（例: セント）で保存され、設定された通貨記号で表示されます。
  4. タイムゾーン。 調理時間の動的計算、注文のタイムスタンプ、精算記録に使用されます。

作成が完了すると、カフェはクラウドデータベースに作成され、カフェテリアのワークスペースが開きます。あとはフロア、テーブル、メニュー項目を追加できます。

ビジネスプロフィール

ビジネスプロフィールは、設定 > カフェテリア からいつでも編集できます。主な項目は次のとおりです。

項目 用途
Slug 公開 URL の一部です。slug を変更すると、再発行するまで既存の QR コードは使えなくなります。
表示名 顧客向けメニュー上部に表示されます。
ロゴ 正方形画像。2 MB までの WebP を推奨します。
ヘッダー画像 顧客向けメニュー上部に表示される横長バナー画像。2 MB までの WebP を推奨します。
住所と電話番号 任意です。メニューのフッターに表示されます。
通貨 メニュー内のすべての商品価格に適用されます。
国 税金や地域別の既定値に使用されます。
タイムゾーン 注文と精算のタイムスタンプに適用されます。
メニューに準備時間を表示 トグルです。有効にすると、各商品に推定準備時間のチップが表示されます。

プリンター設定

プリンター欄では次の設定を行えます。

  • 種類。 無効または TCP のいずれかです。このリリースでは USB の直接印刷は未対応です。
  • IP とポート。 レシートプリンターのネットワークアドレスです。多くの ESC POS TCP プリンターはポート 9100 で待ち受けます。
  • 自動カット。 印刷後に用紙カット命令を追加します。
  • 新規注文時に自動印刷。 有効にすると、新しい注文が入るたびに自動でレシートを印刷します。
  • サウンド通知。 新規注文時に、デスクトップ通知に加えて音声アラートを再生します。
  • テスト印刷。 接続確認のため、設定済みプリンターへサンプルレシートを送信します。

アーキテクチャ概要

カフェテリアはクラウドファーストのデータモデルを採用しています。テーブル、カテゴリ、商品、注文、精算記録はすべて handy.cafe のクラウドデータベースに保存されます。ローカルの HandyCafe サーバーはこの状態をミラーリングし、3 秒ごとに Orders エンドポイントをポーリングして新しい動きを確認します。顧客向けページは handy.cafe のクラウドから直接配信されるため、サーバーがインターネットから到達可能である必要はありません。

データがクラウドにあるため:

  • サーバーがオフラインでも QR コードは引き続き機能しますが、接続が戻るまでスタッフはダッシュボードで注文を確認できません。
  • メニュー変更は保存後、数秒以内に handy.cafe へ反映されます。
  • 顧客が行った注文は、次の 3 秒ポーリング後に Orders ダッシュボードへ届きます。

次のステップ