メニュー管理

カフェテリアのメニュータブでは、handy.cafe/{slug}で顧客が見るカタログを作成します。メニューはカテゴリと商品で構成されます。商品にはサイズやトッピングのような選択肢のバリアントグループを持たせることができます。

構造

レベル	目的
カテゴリ	メニューのセクション。例：「ホットドリンク」や「バーガー」。各カテゴリにはアイコンと並び順があります。
商品	カテゴリ内の注文可能な単一アイテム。名前、説明、写真、価格、消費税率、調理時間を持ちます。
バリアントグループ	任意。商品に付随する選択セット。例：「サイズ：小、中、大」。各バリアントには追加価格があります。

カテゴリ

各カテゴリには以下のフィールドがあります：

フィールド	意味
名前	顧客メニューのセクションヘッダーとして表示されます。
アイコン	MDI（Material Design Icons）の名前。アイコンピッカーから選択します。
並び順	整数。小さい数字が先に表示されます。ドラッグや上下移動で調整します。
アクティブ	オフにすると、カテゴリとそのすべての商品が顧客メニューから非表示になりますが、削除はされません。

カテゴリの追加

カフェテリア > メニューを開きます。
カテゴリを追加をクリックします。
名前を入力します。
アイコンボックスをクリックし、MDIアイコンを選択します。ピッカーは検索可能なリストを開きます。「コーヒー」、「バーガー」、「ピザ」などのキーワードを試してください。
保存します。カテゴリがメニューエディタに表示されます。

カテゴリの並び替え

カテゴリ行のハンドルをドラッグして移動します。リリースすると新しい位置が保存されます。正確な配置には上下矢印を使用することもできます。

ソフト削除

依存する商品があるカテゴリを削除すると、そのカテゴリは非アクティブとしてマークされ、レコードは削除されません。これにより、元の商品IDを参照する注文履歴が保持されます。復元するには、管理UIからカテゴリを再度有効にします。

商品

各商品には以下のフィールドがあります：

フィールド	意味
カテゴリ	親カテゴリ。
名前	顧客に表示されます。
説明	Markdown対応。顧客がアイテムをタップしたときに商品詳細シートに表示されます。
原材料	説明の下に短い行。アレルゲンや原材料のハイライトに使用します。
基本価格	バリアント前の価格。小単位（例：セント）で保存されますが、通貨単位で入力されます。
消費税率	パーセンテージ。顧客のレシートに合計を表示する際に適用されます。
単位	任意のラベル。例：「ml」や「g」。価格の横に表示されます。
写真	商品画像。任意の形式が受け入れられます。WebPは2 MBまで推奨され、メニューの読み込みが最速です。
在庫追跡	オンにすると、商品は注文ごとに減少する在庫数量を持ちます。
在庫数	現在の在庫数。在庫がゼロになると注文が失敗し、商品は自動的に非表示になります。
アクティブ	オフにすると、商品は顧客メニューから非表示になります。
並び順	カテゴリ内の位置。
調理時間	静的な予備推定時間（分単位）。下記の動的調理時間を参照。

写真のアップロード

商品を開きます。
写真エリアをクリックします。
コンピュータから画像を選択します。アップロードエンドポイントは任意の形式を受け入れます。
サーバーがファイルを処理し、アセットID、MIMEタイプ、チェックサムを保存し、URLを返します。
写真はすぐにエディタと顧客メニューに表示されます。

既存の画像をクリックして新しいファイルをアップロードすることで写真を置き換えます。古いファイルは上書きされます。

説明でのMarkdown

商品説明はMarkdownをサポートしています。一般的な使用法：

**strong**で強調表示。
複数行の説明のための改行。
原材料やペアリングのための短いリスト。

商品説明には見出し（H1からH6）を避けてください。顧客メニューは説明を制約されたシートにレンダリングし、見出しは不格好に見えます。

バリアントグループ

バリアントは価格や構成を変更する顧客の選択をキャプチャします。商品は複数のバリアントグループを持つことができ、例えば同じバーガーにサイズとトッピングがあります。

各バリアントには：

フィールド	意味
名前	顧客向けラベル。例：「サイズ」や「追加チーズ」。
価格差額	このバリアントが選択されたときに基本価格に追加される金額。ゼロまたは負の値も可能です。
必須	オンにすると、顧客はカートに追加する前にこのグループから少なくとも1つのバリアントを選択する必要があります。
並び順	グループ内の位置。

バリアントグループの作成

商品を開きます。
バリアントセクションまでスクロールします。
バリアントを追加をクリックします。
名前と価格差額を入力します。選択が必須の場合は必須を有効にします。
保存します。

グループ内の各オプションに対して繰り返します。典型的な「サイズ」グループには3行があります：小は差額0、中は差額+1.00、大は差額+2.00。

動的調理時間

HandyCafeは実際のキッチンパフォーマンスに基づいて各商品のリアルタイム調理時間推定を計算できます。これにより、顧客メニューやアクティブな注文で表示される推定チップの精度が向上します。

設定	効果
静的時間	商品に保存されます。動的な値を計算するのに十分な履歴がない場合に使用されます。
動的推定	過去30日間の注文履歴から計算されます。商品ごとの平均調理時間に、現在のキュー長から導出されたビジーファクターを掛け合わせます。乗数は1.0から2.0の間で制限されます。最終値は1から120分の間で制限されます。

ビジネスプロファイルの「メニューに調理時間を表示」設定は、推定チップが顧客に表示されるかどうかを制御します。スタッフは常に注文ダッシュボードで推定を確認できます。

在庫追跡

商品ごとに在庫追跡を有効にして、売り切れたアイテムを販売しないようにします。

注文が行われると、在庫数は注文数量分減少します。
在庫がゼロになると、商品は在庫数を更新するまで顧客メニューから自動的に非表示になります。
再入荷するには、商品を編集して新しい在庫数を入力します。

在庫追跡がない商品は無限在庫として扱われ、自動的に非表示になることはありません。

カテゴリ内の商品並び替え

ハンドルをドラッグして商品を上下に移動します。リリースすると新しい並び順が保存されます。顧客メニューは次回のメニュー更新後に新しい順序を反映します。メニュー更新は各セッションの読み込み時に行われます。

ヒント

6から10のカテゴリで始めましょう。カテゴリが多すぎると顧客メニューの閲覧が遅くなります。
高コントラストで明るい写真を使用しましょう。暗い写真やノイズの多い写真は注文の転換率を下げます。
説明は可能な限り120文字以内にしましょう。長い説明はスマートフォンで「カートに追加」ボタンを最初の画面から押し出します。
現実的な静的調理時間を設定しましょう。動的システムが学習するのに30日かかります。それまでの間、顧客が見るのは静的な数値です。
選択肢が多いアイテムは、1つの大きなリストではなく2つのバリアントグループに分けましょう。「サイズ」と「ミルク」は「ミルク付きサイズ」よりもすっきりしています。