Merge pull request #24 from kc3hack/feature/issue-7-backend-setup

feat: Backend初期構成の作成（FastAPI + ディレクトリ構成）

Author: Inlet-back

.github/skills/architecture/SKILL.md

@@ -12,31 +12,55 @@ Frontendはユーザーインターフェースを提供し、Backendはビジ
 
 ## 2. Backend Architecture (Python/FastAPI)
 
-Backendは、関心事の分離（Separation of Concerns）を重視し、以下のようなレイヤー構造を意識してください。
-
-### Directory Structure & Responsibilities
-
-- **`app/api/` (Presentation Layer)**:
-  - ルーティング定義とリクエスト/レスポンスのハンドリングのみを行う。
-  - ビジネスロジックをここに書かないこと。ServiceやChainを呼び出す役割に徹する。
-  - Pydanticモデル(`schemas/`)を使用してバリデーションを行う。
-
-- **`app/chains/` & `app/services/` (Business Logic Layer)**:
-  - コアとなるビジネスロジックや、LangChain等を用いたLLMのオーケストレーションを記述する。
-  - 特定のAPIエンドポイントに依存しない再利用可能なロジックを目指す。
-
-- **`app/models/` (Data Access Layer)**:
-  - データベースのモデル定義（SQLAlchemy等）。
-  - DB操作の具体的な実装（CRUD）は、必要に応じて `crud/` ディレクトリ（またはRepositoryパターン）に分離することを推奨するが、規模が小さいうちはService内で完結させても良い。
-
-- **`app/schemas/` (Data Transfer Object)**:
-  - APIの入出力定義（Pydanticモデル）。
-  - DBモデルとAPIレスポンスモデルは分離して定義すること。
-
-### Key Principles
-
-- **Dependency Injection (DI)**: DBセッションや設定、Serviceクラスの依存関係は、FastAPIの `Depends` を使用して注入する。
-- **Statelessness**: サーバーはステートレスに保ち、スケーラビリティを確保する。
+バックエンドは関心事の分離（Separation of Concerns）と依存性注入（Dependency Injection）を重視したレイヤー構造を意識してください。
+
+### 2.1. Directory Structure
+
+```
+backend/
+├── app/
+│   ├── api/
+│   │   ├── api.py          # ルーター集約
+│   │   └── endpoints/      # 各エンドポイント
+│   ├── services/           # Business Logic（調整役）
+│   ├── chains/             # LLM実装詳細
+│   ├── crud/               # データアクセス
+│   ├── core/               # ユーティリティ
+│   ├── middleware/         # 横断的処理
+│   ├── db/                 # DB接続
+│   ├── models/             # SQLAlchemyモデル
+│   ├── schemas/            # Pydantic（Request/Response）
+│   └── main.py
+├── tests/                  # テストコード
+│   ├── test_api/
+│   ├── test_services/
+│   └── test_chains/
+└── pyproject.toml
+```
+
+### 2.2. レイヤー構造
+
+#### **Presentation Layer (`api/`)**
+- ルーティング、リクエスト/レスポンス処理
+- ビジネスロジックは書かず、サービス呼び出しのみ
+
+#### **Business Logic Layer (`services/`, `chains/`)**
+- `services/`: 複数のRepository/Chainの調整（薄い層）
+- `chains/`: LLM実装の詳細（変更頻度が高い可能性がある）
+- 特定のエンドポイントに依存しない、再利用可能なロジック
+
+#### **Infrastructure Layer (`crud/`, `core/`, `middleware/`, `db/`)**
+- `crud/`: データアクセス
+- `core/`: 技術的実装（JWT, ハッシュ化, 設定等）
+- `middleware/`: 横断的処理（認証、ログ等）
+- `db/`: DB接続管理
+
+### 2.3. 設計原則
+
+- **Dependency Injection**: `Depends`で依存注入
+- **Separation of Concerns**: 各層は単一責任
+- **Reusability**: 特定エンドポイントに依存しない
+- **Testability**: DIによるモック化
 
 ## 3. Frontend Architecture (Next.js)
 

backend/app/__init__.py

@@ -0,0 +1,10 @@
+"""ルーター集約"""
+
+from fastapi import APIRouter
+
+api_router = APIRouter()
+
+# 将来的にエンドポイントを追加する際はここでインクルード
+# from app.api.endpoints import auth, quests
+# api_router.include_router(auth.router, prefix="/auth", tags=["auth"])
+# api_router.include_router(quests.router, prefix="/quests", tags=["quests"])

backend/app/api/api.py

@@ -0,0 +1,7 @@
+"""アプリケーション設定"""
+
+# API バージョン
+API_V1_STR = "/api/v1"
+
+# プロジェクト情報
+PROJECT_NAME = "Team29 Backend"

backend/app/core/config.py

@@ -1,13 +1,29 @@
 from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
 
-app = FastAPI()
+app = FastAPI(
+    title="Team29 Backend API",
+    description="KC3HACK2026 Team29 Backend",
+    version="0.1.0",
+)
+
+# CORS設定（開発環境用）
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],  # 本番環境では具体的なオリジンを指定
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
 
 
 @app.get("/")
-def read_root():
-    return {"message": "Hello form FastAPI"}
+def health_check():
+    """ヘルスチェックエンドポイント"""
+    return {"message": "Hello from Team29 Backend", "status": "ok"}
 
 
 @app.get("/health")
-def health_check():
+def health():
+    """ヘルスチェック用エンドポイント"""
     return {"status": "ok"}