aiskillstore/ecommerce

ECサイト開発

使用タイミング

• ECサイト新規構築時
• 商品・注文・決済機能の設計時
• 既存ECサイトのレビュー・改善時

ドメイン設計

コアエンティティ

| エンティティ | 責務 | |-------------|------| | Product | 商品マスタ（タイトル・説明・画像） | | Variant | バリエーション（SKU・価格・在庫） | | Cart | 買い物かご | | Order | 注文（ステータス・配送・支払） | | Customer | 顧客情報 | | Payment | 決済情報 |

状態遷移

注文: [作成] → [支払待ち] → [支払済] → [発送準備] → [発送済] → [完了]
在庫: [在庫あり] ←→ [残りわずか] → [在庫切れ] → [入荷待ち]

要件チェックリスト

商品管理

• [ ] 商品CRUD
• [ ] バリエーション（サイズ・色）
• [ ] 在庫管理（リアルタイム）
• [ ] カテゴリ・タグ
• [ ] 検索・フィルタ

カート・購入

• [ ] カート操作
• [ ] クーポン・割引
• [ ] 送料計算
• [ ] 配送日時指定
• [ ] ギフト設定

決済

• [ ] クレジットカード
• [ ] コンビニ払い
• [ ] 後払い / 電子マネー
• [ ] 定期購入

顧客管理

• [ ] 会員登録・ログイン
• [ ] 住所帳
• [ ] 注文履歴
• [ ] ポイント

法令対応

• [ ] 特定商取引法に基づく表記
• [ ] プライバシーポリシー
• [ ] 利用規約

技術設計

在庫確保パターン

// 楽観的ロック
async function reserveStock(variantId: string, qty: number) {
  const result = await db.variant.updateMany({
    where: {
      id: variantId,
      inventory: { gte: qty },
      version: currentVersion,
    },
    data: {
      inventory: { decrement: qty },
      version: { increment: 1 },
    },
  });
  
  if (result.count === 0) {
    throw new StockNotAvailableError();
  }
}

決済フロー

1. カート確定 → 在庫仮押さえ
2. 決済開始 → 決済サービス呼び出し
3. 成功 → 注文確定・在庫確定
4. 失敗 → 在庫解放
5. タイムアウト（15分） → 在庫解放

API設計

GET    /products          # 商品一覧
GET    /products/:id      # 商品詳細
POST   /cart/items        # カート追加
DELETE /cart/items/:id    # カート削除
POST   /orders            # 注文作成
GET    /orders/:id        # 注文詳細

セキュリティ

• [ ] HTTPS強制
• [ ] PCI DSS準拠（カード情報非保持）
• [ ] CSRF / XSS対策
• [ ] 認証（2FA推奨）
• [ ] 監査ログ

パフォーマンス目標

| 指標 | 目標 | |------|------| | ページ読み込み | < 3秒 | | 検索応答 | < 500ms | | 決済処理 | < 5秒 |

プラットフォーム別

Shopify

• context7: /websites/shopify_dev
• Storefront API / Admin GraphQL
• Hydrogen（ヘッドレス）

STORES

• API: https://heyinc.github.io/retail-api-docs/
• OAuth 2.0 / スタンダードプラン以上

自社開発

• Stripe / GMO / PAY.JP
• Algolia / Elasticsearch

出力形式

設計時

📋 ドメインモデル
📦 エンティティ一覧
🔄 状態遷移図
✅ 要件チェックリスト

レビュー時

🔴 Critical: 問題点 - 修正案
🟡 Warning: 改善推奨 - 提案
📊 Summary: カバー率 X%

外部知識ベース

context7で最新ドキュメント確認:

• /websites/shopify_dev - Shopify開発
• /shopify/hydrogen - ヘッドレスEC
• /woocommerce/woocommerce - WooCommerce
• /medusajs/medusa - Medusa（OSS）