docs: Add contributing guide and update README for setup and architecture details

Author: thiger7

CONTRIBUTING.md

@@ -0,0 +1,50 @@
+# 開発ガイド
+
+## セットアップ
+
+### Docker Compose (推奨)
+
+```bash
+# 起動
+docker compose up --build
+
+# アクセス
+# - フロントエンド: http://localhost:3000
+# - バックエンド API: http://localhost:8000
+```
+
+### ローカル開発
+
+```bash
+# フロントエンド
+cd client
+bun install
+bun dev
+
+# バックエンド
+cd backend
+pip install -r requirements.txt
+make dev
+```
+
+## テスト
+
+```bash
+# フロントエンド
+cd client
+bun run test      # lint + typecheck + vitest
+bun run e2e       # Playwright E2E テスト
+
+# バックエンド
+cd backend
+make test         # pytest + lint + typecheck
+```
+
+## デプロイ
+
+```bash
+# AWS へデプロイ (要: direnv allow)
+./scripts/deploy.sh all       # backend + frontend
+./scripts/deploy.sh backend   # backend のみ
+./scripts/deploy.sh frontend  # frontend のみ
+```

README.md

@@ -6,16 +6,13 @@
 
 ブラウザ上でギターエフェクターを並べ替え、音声ファイルにエフェクトを適用できるデモアプリです。
 
-## アーキテクチャ
+## エフェクト一覧
 
-- **client/** - React + TypeScript + Vite
-  - エフェクターボードの UI
-  - ドラッグ&ドロップでエフェクトの並び替え
-  - 波形表示 (wavesurfer.js)
-- **backend/** - FastAPI + Python
-  - REST API エンドポイント
-  - 音声処理 (Spotify Pedalboard ライブラリ)
-  - Lambda 関数としてもデプロイ可能
+| カテゴリ | エフェクト |
+|----------|------------|
+| 歪み系 | Booster, Blues Driver, OverDrive, Distortion, Fuzz, Metal Zone, Heavy Metal |
+| モジュレーション系 | Chorus, Dimension, Vibrato |
+| 空間系 | Delay |
 
 ## 技術スタック
 
@@ -43,37 +40,46 @@
 ### 保守
 - **Renovate** - 依存関係の自動更新
 
-## セットアップ
-
-### Docker Compose (推奨)
-
-```bash
-# 起動
-docker compose up --build
-
-# アクセス
-# - フロントエンド: http://localhost:3000
-# - バックエンド API: http://localhost:8000
-```
+## AWS アーキテクチャ
+
+![AWS Architecture](infra/architecture.png)
+
+- **CloudFront** - 統一エントリーポイント
+  - `/*` → S3 (Frontend) へルーティング
+  - `/api/*` → API Gateway へルーティング
+- **S3 (Frontend)** - 静的ファイルホスティング
+  - OAC (Origin Access Control) で CloudFront からのみアクセス可能
+- **API Gateway (HTTP API)** - REST API エンドポイント
+  - Lambda へのプロキシ統合
+- **Lambda (arm64)** - バックエンド処理
+  - ECR コンテナイメージ
+  - FastAPI アプリケーション
+- **S3 (Audio)** - 音声ファイルストレージ
+  - `input/` - アップロードされた入力ファイル
+  - `output/` - エフェクト適用後の出力ファイル
+  - `output/normalized/` - 波形表示用の正規化ファイル
+  - ライフサイクルルール: 7日で自動削除
+- **ECR** - Lambda 用コンテナレジストリ
+- **CloudWatch Logs** - ログ管理
+  - `/aws/lambda/...` - Lambda ログ
+  - `/aws/apigateway/...` - API Gateway ログ
+
+### インフラ管理
+
+- `infra/` - Terraform による IaC
+- `scripts/deploy.sh` - デプロイスクリプト
+
+## プロジェクト構成
 
-### ローカル開発
-
-```bash
-# フロントエンド
-cd client
-bun install
-bun dev
-
-# バックエンド
-cd backend
-pip install -r requirements.txt
-make dev
-```
+- **client/** - React + TypeScript + Vite
+  - エフェクターボードの UI
+  - ドラッグ&ドロップでエフェクトの並び替え
+  - 波形表示 (wavesurfer.js)
+- **backend/** - FastAPI + Python
+  - REST API エンドポイント
+  - 音声処理 (Spotify Pedalboard ライブラリ)
+  - Lambda 関数としてもデプロイ可能
 
-## エフェクト一覧
+## セットアップ
 
-| カテゴリ | エフェクト |
-|----------|------------|
-| 歪み系 | Booster, Blues Driver, OverDrive, Distortion, Fuzz, Metal Zone, Heavy Metal |
-| モジュレーション系 | Chorus, Dimension, Vibrato |
-| 空間系 | Delay, Reverb |
+[CONTRIBUTING.md](CONTRIBUTING.md) を参照してください。