Product / Service Catalog

Mewayzの製品/サービスカタログ

製品/サービス アドオンは、会計、CRM、POS、EcomStore、および予約で使用される共有在庫カタログです。

Mewayz-オリジナルモジュール — いいえ、Mewayz 上流です。ドキュメントは次のパッケージ ソースから作成されています。 packages/mewayz/ProductService/。

デモURL

はじめに

製品/サービス アドオンは、 唯一の真実の情報源 Mewayz プラットフォーム全体で販売可能なアイテムごとに。各モジュール (Sales、POS、EcomStore、Bookings) が独自の製品リストを維持するのではなく、すべてのモジュールが 1 つの共有カタログから読み書きします。これは、オペレーターが製品/サービスで新しい製品を作成すると、その製品が在庫数と税金ルールを同期して、すべての販売面ですぐに使用できることを意味します。

このモジュールは、在庫追跡を備えた物理的商品、時間またはセッションごとに価格設定される非在庫サービス、複数の倉庫在庫、階層カテゴリ、行ごとの課税ルール、および測定単位をカバーします。

このモジュールを有効にする方法

製品/サービス アドオンをセットアップするには、次のリンクをクリックします。 アドオンをセットアップします。

アドオンは次によってゲートされます。 PlanModuleCheck:ProductService。ほとんどの販売向けプランには、デフォルトでこれがバンドルされています。POS、アカウント、EcomStore、および予約はすべて、これがアクティブであるかどうかに依存します。

アイテム

アイテムを参照する

• に移動します 製品とサービス → アイテム サイドバーにあります。
• リスト ビューには、オペレーターが管理できるすべてのアイテムがフィルター付きで表示されます。 名前、 種類 (製品またはサービス)、 カテゴリ、そして アクティブステータス。
• 各行には、SKU、販売価格、購入価格、現在の倉庫在庫の合計、およびクイックアクション ボタン (表示、編集、削除) が表示されます。

新しいアイテムを作成する

• クリック + 新しいアイテム アイテムリストの右上にあります。
• フォームには次のフィールドがあります。
• 名前 — プラットフォーム全体でドロップダウンに表示される表示名
• 種類 — 製品 (在庫追跡あり) またはサービス (在庫なし)
• SKU — オプションの在庫管理単位 (テナントごとに固有)
• カテゴリ — 既存のカテゴリから選択するか、新しいカテゴリをインラインで作成します
• 単位 — 測定単位 (それぞれ、kg、時間、平方メートルなど)
• 販売価格 — この商品が請求書または注文に表示されるときのデフォルト価格
• 購入価格 — 在庫を受け取るときのデフォルトのコスト
• 税金 — この商品に適用される税率を複数選択します
• 画像 — EcomStore + POSで使用される製品画像
• 説明 — 長い形式の説明。 EcomStoreの詳細ページで使用されます
• クリック 保存 アイテムを作成します。イベント（CreateProductServiceItem) がディスパッチされると、他のモジュールのリスナーが反応できるようになります (検索インデックスの再インデックスなど)。

項目の編集/削除

• 項目リストから、行の編集ボタンをクリックして、項目のデータが入力された同じフォームを開きます。
• アイテムの発送を削除する DestroyProductServiceItem。アイテムが既存の請求書、注文、または POS 販売によって参照されている場合、基になる行は次のようになります。 論理的に削除された したがって、履歴記録はデータをそのまま保持します。

在庫管理

• に移動します 製品とサービス → 在庫 サイドバーにあります。
• 在庫ビューではアイテムをグループ化します。 倉庫 そのため、複数の物理的な場所を持つオペレーターは、各場所で正確な数量を確認できます。
• 各行には品目、倉庫、現在の数量、最終移動日が表示されます。

在庫の追加または調整

• クリック 在庫を追加する 在庫の動きを記録します。
• を選択します。 アイテム、 倉庫、 数量 (インバウンドの場合はプラス、調整アウトの場合はマイナス)、および 注記。
• あらゆる動きは記録されます。カタログは単に「数値を更新する」だけではなく、すべての変更が監査可能です。

カテゴリー

• に移動します 製品とサービス → カテゴリ。
• カテゴリはフラットまたは階層型 (親→子) です。各カテゴリには、 カラータグ それはアイテムリストとEcomStoreのリストページに反映されます。
• 作成/編集/削除の操作は、標準の CRUD パターンに従います。

税金

• に移動します 製品とサービス → 税金。
• 事業者のビジネスに必要な税率を追加します (例: VAT 15%、消費税 7.25% など)。
• それぞれの税金には、 名前、 率 (パーセンテージ)、およびオプション 説明。
• 税金は、アイテム フォームの複数選択を介してアイテムに付加されます。

単位

• に移動します 製品とサービス → ユニット。
• 単位は、カート/請求書の行に表示されるラベルです (「それぞれ」、「kg」、「時間」、「セッション」、「平方メートル」など)。
• Mewayz にはスターター セットが同梱されます。オペレータの業界用語に一致するように名前を追加または変更します。

モジュール間の動作

その他のMewayzモジュール 消費する 製品/サービスカタログ:

• アカウント モジュール — 販売請求書と購入請求書は、このカタログから品目を選択します。
• CRM / 販売 — 取引明細項目とプロポーザル参照項目。
• POS モジュール — POS 販売は製品リストを直接プルします。
• エコムストア モジュール — ストアフロント製品は、カテゴリベースの参照を使用してこのカタログからレンダリングされます。
• 予約 module — 予約可能なサービスのサービス カタログ。
• ApiDocsGenerator module — プログラムによるアクセスのためのパブリック API エンドポイントを文書化します (/api/products、など）。

権限

パッケージは詳細な権限を定義します。

• manage-product-service-item — 完全な管理
• create-product-service-item — 新しいアイテムを作成する
• manage-any-product-service-item — テナント項目を編集します
• manage-own-product-service-item — Edit only own-created items

これらを次のように割り当てます 設定 → 役割と権限。

APIアクセス

パッケージでも公開されています GET /api/product-service/items 他のモジュールおよび API Docs Generator が表面化する内部認証済みエンドポイントとして GET /api/products。

オペレーターメモ

• 株価の動きは不変です — 動きを「逆転」するには、元の行を編集するのではなく、反対方向の新しい動きを記録します。
• 手元に在庫があるアイテムを削除する場合、システムはアクションを許可する前に警告を出します。
• アイテム画像は以下に保存されています storage/app/public/product-service/ そして、経由して提供されます storage シンボリックリンク。新しい画像をアップロードすると、DB 内で単一のファイル名に正規化されます。パブリック URL はレンダリング時に計算されます。