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

ドキュメント

• CLAUDE.md — アーキテクチャ・設計パターン・規約
• migration.md — monorepo + REST + RR v7 移行計画の index
• doc/migration/ — 移行の領域別ドキュメント（画面別調査・ユースケース・step 分解）