セット商品プラグイン¶

目的¶

セット商品の定義は、商品バリアント（ProductVariant）のカスタムフィールド setComponents に保存します。
バンドル商品の代表画像は、商品バリアント（ProductVariant）の既存 Asset リレーション (featuredAsset / assetIds) を使って保持します。
setComponents は JSON 文字列で、以下の形式を想定します（管理画面から自動生成されます）。

{
  "components": [
    { "productCode": "00030048", "quantity": 2 },
    { "productCode": "00010001", "quantity": 1 }
  ]
}

用語:

セット商品そのものは、親 ProductVariant と customFields.setComponents を正本にします。
セット商品一覧 / 特設導線は、必要に応じて Collection で表現します。
セット商品であることの識別は、product-type=set Facet の付与を推奨します。
Policy / Campaign の対象指定では、セット親も独立の bundleProduct 型ではなく productVariantIds に含めて扱います。

商品バリアント詳細画面に 「セット商品構成」ブロックを追加しています。

構成品は SKU/名称で検索して追加できます。
構成数量を入力して保存すると、customFields.setComponents が更新されます。
構成品を 1 件以上保存した場合は、セット商品の前提を崩さないよう 在庫追跡（trackInventory）を自動で FALSE に更新します。
バンドル商品詳細では 代表画像を 1 枚設定できます。保存先は ProductVariant.featuredAsset / assetIds です。
構成品をすべて外して保存した場合は、customFields.setComponents を null に戻し、通常商品として扱います。
バンドル商品一覧は setComponents が null でも空文字でもない商品だけを表示します。過去データに空文字が残っていても一覧に混ざらない想定です。
一覧/詳細の「解除」は setComponents を null に戻す操作であり、空文字での解除は行いません。