アーキテクチャ決定

# プロジェクトフォルダを作成して移動
mkdir taskflow
cd taskflow

# Claude Codeを起動
claude

# CLAUDE.md

## プロジェクト概要
TaskFlow - カンバン形式のプロジェクト管理ツール。
リアルタイム同期対応。複数ユーザーが同時に共同作業可能。

## 技術スタック
- Frontend: Next.js 14 (App Router, TypeScript, Tailwind CSS)
- Backend: FastAPI (Python 3.11+)
- DB: MySQL 8
- Cache/PubSub: Redis
- Container: Docker Compose

## 開発コマンド
```bash
# 全サービス起動
docker compose up -d

# フロントエンドのみ（ホットリロード）
cd frontend && npm run dev

# バックエンドのみ（ホットリロード）
cd backend && uvicorn app.main:app --reload

# テスト実行
cd backend && pytest
cd frontend && npm test
```

## アーキテクチャ
- バックエンドはレイヤードアーキテクチャ（API → Service → Repository）
- フロントエンドはfeatureベースのディレクトリ構成
- サーバー状態: TanStack Query / UI状態: Zustand
- リアルタイム通信: WebSocket (Redis PubSub経由)

## コーディング規約
- Python: snake_case（関数・変数）、PascalCase（クラス）
- TypeScript: camelCase（関数・変数）、PascalCase（コンポーネント・型）
- APIエンドポイント: /api/v1/ プレフィックス、RESTful設計
- エラーレスポンス: {"detail": "エラーメッセージ"} 形式

# Web framework
fastapi==0.104.1
uvicorn[standard]==0.24.0

# Database
sqlalchemy==2.0.23
pymysql==1.1.0
alembic==1.13.0

# Authentication
python-jose[cryptography]==3.3.0
passlib[bcrypt]==1.7.4

# WebSocket & Cache
websockets==12.0
redis==5.0.1

# Utilities
pydantic-settings==2.1.0
httpx==0.25.2
python-multipart==0.0.6

# Testing
pytest==7.4.3
pytest-asyncio==0.23.2

{
  "name": "taskflow-frontend",
  "version": "0.1.0",
  "dependencies": {
    "next": "14.0.4",
    "react": "^18",
    "react-dom": "^18",
    "@dnd-kit/core": "^6.1.0",
    "@dnd-kit/sortable": "^8.0.0",
    "@tanstack/react-query": "^5.13.4",
    "zustand": "^4.4.7",
    "axios": "^1.6.2"
  },
  "devDependencies": {
    "typescript": "^5",
    "tailwindcss": "^3.3.0",
    "@types/node": "^20",
    "@types/react": "^18",
    "eslint": "^8"
  }
}

taskflow/
├── CLAUDE.md                  # Claude Code用プロジェクト設定
├── docker-compose.yml         # 全サービスのコンテナ定義
├── .gitignore
├── frontend/
│   ├── src/
│   │   ├── app/               # Next.js App Router（ページ定義）
│   │   ├── components/        # 共通UIコンポーネント
│   │   ├── features/          # 機能別モジュール
│   │   │   ├── auth/          #   認証（login, register）
│   │   │   ├── projects/      #   プロジェクト管理
│   │   │   └── tasks/         #   タスク・カンバンボード
│   │   ├── hooks/             # カスタムフック
│   │   ├── lib/               # ユーティリティ（API client等）
│   │   └── stores/            # Zustandストア定義
│   ├── package.json
│   ├── Dockerfile
│   └── ...
├── backend/
│   ├── app/
│   │   ├── main.py            # FastAPIアプリケーションのエントリーポイント
│   │   ├── api/               # APIエンドポイント定義
│   │   │   └── v1/            #   バージョニング対応
│   │   ├── services/          # ビジネスロジック層
│   │   ├── repositories/      # データアクセス層
│   │   ├── models/            # SQLAlchemyモデル定義
│   │   ├── schemas/           # Pydanticスキーマ（リクエスト/レスポンス）
│   │   ├── websocket/         # WebSocket接続管理
│   │   ├── core/              # 設定・認証・DB接続
│   │   └── utils/             # 共通ユーティリティ
│   ├── alembic/               # DBマイグレーション
│   ├── tests/                 # テストコード
│   ├── requirements.txt
│   ├── Dockerfile
│   └── ...
└── docs/                      # API仕様書・設計ドキュメント