商品管理

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

商品フィールド

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

フィールド	説明
`name`	注文インターフェースに表示される商品名。一意（大文字小文字区別なし）である必要があります。
`category`	関連商品をグループ化するテキストラベル（例: 「飲料」「スナック」「アクセサリー」）。フィルタリングとレポートに使用されます。
`unit`	在庫追跡の計量単位（例: 「個」「kg」「リットル」「缶」「ボトル」）。
`barcode`	スキャナー統合用のバーコード値（任意）。キャッシャーが商品のバーコードをスキャンして注文にすぐ追加できます。
`sale_price`	最小通貨単位での販売価格（例: 銭）。顧客に1単位あたりに請求される金額です。
`vat_rate`	この商品に適用される消費税率のパーセンテージ（例: 18%消費税の場合は18）。各販売の税額計算に使用されます。
`stock`	小数量としての現在の在庫レベル。注文が作成された際や在庫仕入れが記録された際に自動更新されます。
`active`	商品が注文インターフェースに表示されるかどうかを制御するトグル。非アクティブな商品はキャッシャーからは非表示になりますが、過去のレポート用にデータベースに保持されます。
`description`	商品の追加詳細のための任意のテキスト説明。

アクティブ/非アクティブ切替

商品はアクティブと非アクティブの状態を切り替えることができます。

アクティブな商品は注文インターフェースに表示され、新しい注文に追加できます。
非アクティブな商品は注文インターフェースから非表示になりますが、データベースに残ります。その商品を含む過去の注文は参照を保持するため、過去の販売データは保持されます。

季節商品、製造中止商品、一時的に在庫切れで顧客に提供すべきでない商品に便利です。

在庫追跡

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

販売: 注文を通じて商品が販売されると、注文数量分だけ在庫が減少します。
在庫仕入れ: 新しい在庫が受け取られ在庫ページに記録されると、在庫が増加します。
手動調整: キャッシャーまたは管理者が廃棄、破損、数量差異などのために在庫レベルを手動調整できます。

商品在庫ログ

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

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

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

商品カテゴリ

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

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

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

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

商品の作成

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

サイドバーから商品ページに移動します。
ツールバーの商品追加ボタンをクリックします。
名前を入力します（一意である必要があります）。
カテゴリを選択または入力します。
計量単位を選択します。
販売価格を設定します（最小通貨単位で顧客に請求される金額）。
消費税率を設定します（小数で、たとえば8%の場合は0.08）。
スキャナー対応のためにバーコードを入力します（任意）。
該当する場合は初期在庫レベルを設定します。
保存をクリックします。

商品の編集

リストから商品を選択して詳細ビューを開きます。名前、価格、カテゴリ、消費税率、在庫レベル、アクティブ状態など任意のフィールドを更新できます。変更は即座に反映されます。価格を更新した場合、新しい価格は今後のすべての注文に適用されます。

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

注文との統合

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

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

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