商品管理

商品カタログには、インターネットカフェやゲーミングセンターで販売するアイテムが一覧表示されます。飲食物、スナック、アクセサリー、その他の物理的な商品が含まれます。各商品には価格、カテゴリ、税率、在庫レベルが定義されています。商品は注文システムと統合されており、キャッシャーが注文を作成し、販売を追跡し、在庫を管理できます。

商品はメインナビゲーションの在庫ページの商品タブで管理します。タブにはテーブルビューとグリッドビューがあります。グリッドのカードには、商品の写真、価格、在庫ありまたは在庫切れのバッジが表示されます。

商品フィールド

各商品レコードには以下の情報が含まれます。

フィールド	説明
`name`	注文インターフェースに表示される商品名。一意（大文字小文字区別なし）である必要があります。
`category`	関連商品をグループ化するテキストラベル（例: 「飲料」「スナック」「アクセサリー」）。フィルタリングとレポートに使用されます。
`unit`	在庫追跡の計量単位（例: 「個」「kg」「リットル」「缶」「ボトル」）。
`barcode`	スキャナー統合用のバーコード値（任意）。キャッシャーが商品のバーコードをスキャンして注文にすぐ追加できます。
`sale_price`	最小通貨単位での販売価格（例: 銭）。顧客に1単位あたりに請求される金額です。
`vat_rate`	この商品に適用される消費税率のパーセンテージ（例: 18%消費税の場合は18）。各販売の税額計算に使用されます。
`stock`	小数量としての現在の在庫レベル。注文が作成された際や入荷記録が記録された際に自動更新されます。在庫は商品側では編集しません。在庫ページの在庫状況タブを使用してください。
`min_stock`	再発注のしきい値。在庫レベルがこの値以下になると、その商品は在庫状況タブで重要として表示されます。ゼロはしきい値なしを意味します。
`description`	商品の追加詳細のための任意のテキスト説明。
`photo`	グリッドビューとカフェテリアメニューに表示される任意の商品写真。

商品を販売から外す

提供を終了する商品は、商品タブの販売から外すアクションで削除します。確認ダイアログでは、この操作により商品がカタログから削除され、元に戻せないことが説明されます。その商品を含む過去の注文は明細のスナップショットを保持するため、過去の販売データは保持されます。

在庫追跡

HandyCafeはすべての商品の在庫数をリアルタイムで維持しています。この値は以下に応じてシステムが自動更新します。

販売: 注文を通じて商品が販売されると、注文数量分だけ在庫が減少します。
入荷記録: 新しい在庫が受け取られ、在庫ページの入荷記録タブに記録されると、在庫が増加します。
手動調整: 在庫状況タブには、廃棄、破損、数量差異などに対応するための在庫修正、廃棄、カウントのアクションがあります。

在庫はプロダクトエディタでは編集できません。すべての在庫変更は在庫状況タブを経由するため、変更はすべて移動履歴に残ります。

商品在庫ログ

商品の在庫レベルの変更はすべて商品在庫ログに記録され、完全な監査証跡が作成されます。

理由	説明
`sale`	顧客の注文により在庫が減少。特定の注文レコードにリンクされます。
`purchase`	在庫仕入れにより在庫が増加。特定の在庫エントリにリンクされます。
`adjustment`	キャッシャーまたは管理者が在庫を手動調整。
`waste`	廃棄、破損、償却により在庫が減少。
`return`	顧客の返品または注文キャンセルにより在庫が増加。

各ログエントリには数量変更（増加は正、減少は負）、変更後の在庫レベル、変更者、理由を説明する任意のメモが記録されます。

商品カテゴリ

商品はフリーテキストフィールドを使用してカテゴリでグループ化されます。一般的なカテゴリ:

飲料（ソフトドリンク、水、エナジードリンク）
ホットドリンク（コーヒー、お茶、ホットチョコレート）
スナック（ポテトチップス、キャンディ、チョコレートバー）
食品（サンドイッチ、ラップ、温かい食事）
アクセサリー（ヘッドセット、USBドライブ、マウスパッド）

カテゴリは注文インターフェースのフィルタリングに使用されます。キャッシャーはカテゴリをすばやく切り替えて目的の商品を見つけられます。カテゴリは販売レポートのグルーピングにも使用されます。

別途カテゴリ管理インターフェースはありません。カテゴリは商品にカテゴリ名を割り当てることで暗黙的に作成されます。カテゴリ名を変更するには、旧名を使用するすべての商品のカテゴリフィールドを更新してください。

商品の作成

カタログに新しい商品を追加するには:

サイドバーから在庫ページを開き、商品タブに切り替えます。
新商品ボタンをクリックします。
名前を入力します（一意である必要があります）。
カテゴリを選択または入力します。
計量単位を選択します。
販売価格を設定します（顧客に請求される金額）。
消費税率を設定します。
スキャナー対応のためにバーコードを入力し（任意）、写真を追加します。
保存をクリックします。

初期在庫はここでは設定しません。開始数量は入荷記録、または在庫状況タブのカウントアクションで記録します。納品にカタログへ未登録のアイテムが含まれる場合は、記録の行から直接商品を作成することもできます。

商品の編集

リストから商品を選択してエディタを開きます。名前、価格、カテゴリ、消費税率、バーコード、写真など任意のフィールドを更新できます。変更は即座に反映されます。価格を更新した場合、新しい価格は今後のすべての注文に適用されます。販売から外すアクションは、確認の後に商品をカタログから削除します。

過去の注文は価格変更の影響を受けません。各注文アイテムは販売時のunit_priceをスナップショットとして保存しています。

注文との統合

キャッシャーが注文を作成して商品を追加すると:

商品の現在の販売価格と消費税率が注文アイテムにスナップショットとしてコピーされます。
行合計がunit_price * qtyとして計算されます。
注文が完了すると、商品の在庫レベルが注文数量分減少します。
reason = 'sale'の在庫ログエントリが注文にリンクされて作成されます。

注文が後にキャンセルまたは返金された場合、返品在庫ログエントリを通じて在庫を復元できます。