wolf-mansion
人狼ゲーム（Werewolf/Mafia）の Web アプリケーション。Spring Boot + Kotlin（バックエンド）、Thymeleaf（テンプレート）、MySQL + DBFlute（ORM）によるサーバーサイドレンダリングの Web アプリ。
移行中: monorepo + REST + React Router v7 への移行作業を進行中。移行計画は migration.md（index）と doc/migration/ を参照。
ディレクトリ構成（monorepo）
(root)/
backend/ # Spring Boot (Kotlin) — 現状は Thymeleaf SSR、移行で REST API 専用へ
frontend/ # React Router v7 (SSR) ※ Step 2.3 で雛形を追加予定
e2e/ # Playwright ※ Step 2.4 で雛形を追加予定
doc/migration/ # 移行計画ドキュメント
Gradle プロジェクト一式は backend/ 配下に自己完結している（backend/gradlew、root に Gradle ファイルは無い）。以下のビルド/起動コマンドは backend/ で実行する。
必要ランタイム
| ツール | バージョン | 用途 |
|---|
| Java (JDK) | 21 | backend（Spring Boot / Gradle） |
| MySQL | 8 系 | ローカル DB |
| Node.js | 22 系 | Step 2 以降で導入する frontend 用（現状は不要） |
| pnpm | 10 系 | Step 2 以降の frontend パッケージマネージャ（現状は不要） |
Node / pnpm は移行で導入する frontend 用。現状の backend 開発だけなら Java + MySQL があれば動く。
Java バージョン管理（jenv）
backend/.java-version が 21 に固定されている（Java は backend のみで使うため pin も backend 配下）。jenv を使う場合、JDK 21 を登録しておけば backend/ で自動的に 21 が選択される。
# 既存の JDK 21 を jenv に登録（JDK のパスは環境に合わせて指定）
jenv add /path/to/jdk-21 # 任意の OS
jenv add "$(/usr/libexec/java_home -v 21)" # macOS の場合
# 確認（backend/ で 21 になっていること）
cd backend
jenv version # => 21 (set by .../backend/.java-version)
java -version # => openjdk version "21.x"
backend/build.gradle.kts は JavaVersion.VERSION_21 を要求するため、JDK 17 等でビルドすると失敗する。
ローカル DB
接続情報は backend/src/main/resources/config/application.yml（既定プロファイル）にある:
| 項目 | 値 |
|---|
| host:port | 127.0.0.1:4306 |
| database | werewolf_mansiondb |
| user | wmansion |
| password | wmans10n |
上記はローカル開発専用の既定値（application.yml）。本番は環境変数（WOLF_MANSION_DB_USERNAME / WOLF_MANSION_DB_PASSWORD 等）で上書きされる（application-production.yml）。
スキーマ定義は backend/dbflute_wolf_mansiondb/ 配下。backend/src/main/java/com/ort/dbflute/ は DBFlute による自動生成コード（手動編集不可。exbhv/ exentity/ のみカスタマイズ可）。
ビルド & 起動
いずれも backend/ で実行する:
cd backend
# ビルド（テストスキップ）
./gradlew build -x test
# テスト実行
./gradlew test
# 単一テストクラス実行
./gradlew test --tests "com.ort.app.domain.model.village.room.RoomSizeTest"
# アプリ起動（ローカル）
./gradlew bootRun
起動後のアクセス先: **http://localhost:8089/wolf-mansion/**（port 8089 / context-path /wolf-mansion）。
Docker イメージ（Jib）をビルドする場合（backend/ で実行、image 名 ghcr.io/h-orito/wolf-mansion-backend）:
cd backend && ./gradlew jibDockerBuild
ドキュメント
