add claude

2025-06-01 21:39:53 +09:00
parent 3459231bba
commit 4246f718ef
80 changed files with 7249 additions and 0 deletions
--- a/docs/DEVELOPMENT.md
+++ b/docs/DEVELOPMENT.md
@ -0,0 +1,124 @@
+# 開発ガイド
+
+## セットアップ
+
+### 1. API (FastAPI)
+
+```bash
+cd api
+
+# 仮想環境作成
+python -m venv venv
+source venv/bin/activate  # macOS/Linux
+# or
+venv\Scripts\activate  # Windows
+
+# 依存関係インストール
+pip install -r requirements.txt
+
+# 環境変数設定
+cp .env.example .env
+# .envを編集
+
+# 開発サーバー起動
+uvicorn app.main:app --reload
+```
+
+APIは http://localhost:8000 で起動します。
+APIドキュメントは http://localhost:8000/docs で確認できます。
+
+### 2. Web (React + Vite)
+
+```bash
+cd web
+
+# 依存関係インストール
+npm install
+
+# 開発サーバー起動
+npm run dev
+```
+
+Webアプリは http://localhost:3000 で起動します。
+
+## プロジェクト構造
+
+```
+ai.card/
+├── api/                    # FastAPI backend
+│   ├── app/
+│   │   ├── core/          # 設定、共通処理
+│   │   ├── models/        # Pydanticモデル
+│   │   ├── routes/        # APIエンドポイント
+│   │   ├── services/      # ビジネスロジック
+│   │   └── main.py        # アプリケーションエントリ
+│   └── requirements.txt
+│
+├── web/                    # React frontend
+│   ├── src/
+│   │   ├── components/    # Reactコンポーネント
+│   │   ├── services/      # API通信
+│   │   ├── styles/        # CSS
+│   │   ├── types/         # TypeScript型定義
+│   │   └── App.tsx        # メインコンポーネント
+│   └── package.json
+│
+├── ios/                    # iOS app (今後実装)
+└── docs/                   # ドキュメント
+```
+
+## 技術スタック
+
+### Backend
+- Python 3.9+
+- FastAPI
+- Pydantic
+- SQLAlchemy (今後実装)
+- atproto SDK
+
+### Frontend
+- React 18
+- TypeScript
+- Vite
+- Framer Motion (アニメーション)
+- Axios
+
+## 開発のポイント
+
+### 1. カードデータ
+カードは0-15のIDを持ち、ai.jsonの定義に基づいています。
+
+### 2. レアリティシステム
+- 通常のガチャではキラカードが最高レア
+- uniqueカードは隠し要素として実装
+- 確率は設定ファイルで調整可能
+
+### 3. atproto連携
+- ユーザー認証はatproto OAuth（今後実装）
+- カードデータはユーザーのPDSに保存（今後実装）
+- 現在はローカルストレージのみ
+
+### 4. アニメーション
+- ガチャ演出はレアリティに応じて変化
+- uniqueカードは特別な演出
+- Framer Motionで実装
+
+## 今後の実装予定
+
+1. **データベース連携**
+   - SQLAlchemyでのモデル定義
+   - ユーザーごとのカード管理
+
+2. **atproto統合**
+   - OAuth認証
+   - PDSへのデータ保存
+   - DID検証
+
+3. **uniqueカード検証**
+   - グローバルレジストリ
+   - 重複チェック
+   - ai.verse連携
+
+4. **iOS app**
+   - SwiftUIで実装
+   - 共通APIを使用