Level 1: System Context

外部アクター:
  - 一般ユーザー（Web/モバイル）
  - 店舗管理者
  - システム管理者

外部システム:
  - Stripe（決済）
  - SendGrid（メール）
  - AWS S3（画像ストレージ）
  - 配送パートナーAPI

Level 2: Container

フロントエンド:
  - Next.js SPA（ユーザー向け）
  - React Admin（管理画面）
  - Flutter（モバイルアプリ）

バックエンド:
  - BFF Gateway（Node.js/Express）
  - 商品サービス（Node.js）
  - 注文サービス（Node.js）
  - ユーザーサービス（Node.js）
  - 検索サービス（Node.js）

データストア:
  - PostgreSQL（商品、注文、ユーザー）
  - Redis（キャッシュ、セッション）
  - Elasticsearch（商品検索）

メッセージング:
  - Apache Kafka（イベント）

インフラ:
  - AWS EKS（コンテナオーケストレーション）
  - CloudFront（CDN）

AWS構成:

Route 53 → CloudFront → ALB → EKS Cluster
                                  ├── 商品サービス Pod (3)
                                  ├── 注文サービス Pod (3)
                                  ├── ユーザーサービス Pod (3)
                                  └── BFF Pod (3)

データ層:
  RDS PostgreSQL (Multi-AZ)
  ElastiCache Redis (Cluster)
  Amazon Elasticsearch Service
  Amazon MSK (Kafka)

ストレージ:
  S3 (商品画像、静的アセット)

# ECプラットフォーム アーキテクチャ設計書

## 1. はじめに
BtoC向けECプラットフォーム。初年度10万→3年後100万ユーザー。

## 2. 制約条件
PCI DSS準拠、AWS環境、TypeScript統一。

## 3. コンテキストと範囲
ユーザー・管理者・外部決済・配送パートナーとの連携。

## 4. ソリューション戦略
モジュラーモノリス→段階的マイクロサービス。CQRS+イベント駆動。

## 5. ビルディングブロック
BFF + 4サービス（商品・注文・ユーザー・検索）。

## 6. ランタイムビュー
注文フロー、検索フロー、決済フローのシーケンス。

## 7. デプロイメントビュー
AWS EKS、マルチAZ、CI/CDパイプライン。

## 8. 横断的関心事
認証(JWT)、ログ(構造化)、エラー処理、ヘルスチェック。

## 9. アーキテクチャ決定
ADR-001〜005（DB、通信、キャッシュ、MQ、IaC）。

## 10. 品質要件
可用性99.95%、p95レスポンス500ms、セキュリティ要件。

## 11. リスク
Kafka運用スキル不足、スケーリング戦略の検証不足。

## 12. 用語集
BFF、CQRS、SLI/SLO等の用語定義。