saleor-storefront

Saleor Storefront

Saleor eコマースプラットフォームでストアフロントを構築するための汎用ガイドです。Saleor GraphQL APIのデータモデル、権限システム、チェックアウトのライフサイクル、チャネルアーキテクチャ、商品／バリアントのパターンを扱います。フレームワークに依存しないため、Next.js、Remix、Nuxt、またはカスタム構成のいずれを使用する場合にも適用できます。

適用する場面

次の作業を行う際に、これらのガイドラインを参照してください。

• 商品、カテゴリ、コレクションについてSaleorのGraphQL APIにクエリを送信する
• バリアント選択機能を備えた商品詳細ページを構築する
• チェックアウトと決済のフローを実装する
• マルチチャネルおよび複数通貨の構成を扱う
• 「商品を購入できません」エラーや権限エラーをデバッグする
• Saleor 3.23以降の在庫状況モード（useLegacyShippingZoneStockAvailability）を扱う
• ソースコードを通じてSaleor APIの動作を調査する

ルールのカテゴリ

優先度	カテゴリ	影響度	接頭辞
1	API	CRITICAL	api-
2	商品	HIGH	products-
3	チェックアウト	HIGH	checkout-
4	チャネル	MEDIUM	channels-

クイックリファレンス

1. API（CRITICAL）

• api-data-model — null許容フィールド、価格構造、ストアフロントの自動フィルタリング
• api-permissions — トークンの種類、権限エラー、2段階のクエリパターン
• api-graphql-patterns — チャネルにスコープされたクエリ、バリアント属性、フィルタリング、コード生成
• api-investigation — 型とソースを使ってSaleor APIの動作を調査する方法

2. 商品（HIGH）

• products-variants — バリアントモデル、選択属性と非選択属性、価格設定、UXパターン

3. チェックアウト（HIGH）

• checkout-lifecycle — セッションのライフサイクル、よくあるエラー、決済の問題のデバッグ

4. チャネル（MEDIUM）

• channels-purchasability — 在庫状況モード（従来型と直接型、3.23以降）、購入可能性と配送可能性、フルフィルメントの三角関係、モードに応じたチェックリスト、チャネルにスコープされたクエリ、在庫Webhook

使い方

詳しい説明とコード例については、個々のルールファイルをお読みください。

rules/api-data-model.md
rules/products-variants.md

各ルールファイルには、次の内容が含まれています。

• 重要な理由の簡単な説明
• コード例（正しいパターンと誤ったパターン）
• 避けるべきアンチパターン

完全版ドキュメント

すべてのルールを詳しく記載した完全なガイドについては、AGENTS.mdを参照してください。