Share
Embed
形から入ったドメイン駆動設計によるゲーム開発の光と闇
TECHxGAME COLLEGE #28(https://techxgamecollege.connpass.com/event/148035/) の発表資料です
n1215
October 23, 2019
Transcript
97 slides
-
⾃⼰紹介 京都から来ました - 中榮健⼆ (なかえけんじ) - twitter: @n_1215 - 株式会社Nextat
取締役 - baserCMS コアコミッター(最近コミットしてない) - Laravel + Unity でソシャゲ開発など Nextat Inc. 3 -
発表概要 1. ドメイン駆動設計の概要と軽量DDD 2. レイヤ・クラス分割の話 3. ユビキタス⾔語が統⼀されなかった話 4. 10分経っても返ってこないガチャAPIのチューニングの話 5.
境界づけ(られなかっ)たコンテキストの話 6. ちょっと深いモデルの話 Nextat Inc. 4 -
⽤語 ドメイン ソフトウェアを作る対象となる問題領域 モデル 事象の特定の側⾯を抜き出し簡略化した模型のようなもの。 ex. 数理モデル ドメインエキスパート 問題領域に詳しい専⾨家 ユビキタス⾔語
ドメインモデルを表現するためのチームメンバ全員によって使⽤される共通の⾔語 Nextat Inc. 9 -
お話しするゲームシステムの主な構成 ゲームサーバ: PHP + Laravel ゲームAPI: Web, Android, iOSに対応するため、JSONを返すAPI マスタデータ管理画⾯:
マスタデータ作成・更新のための機能。HTML CS管理画⾯: ユーザの⾏動履歴などお問い合わせ対応⽤の機能。HTML データベース: MySQL、Redis クライアント: Unity、 JavaScript Nextat Inc. 21 -
Model Eloquent (ActiveRecord系のORM) の"モデル"を継承しただけ クエリ発⾏、DB保存、ドメインロジックを全て⾏う class UserCharacter extends \Illuminate\Database\Eloquent\Model {
} Controller class UserCharactersController { public function lock(int $userCharacterId): JsonResponse { $userId = auth()->id(); $userChara = UserCharacter::whereUserId(userId)->findOrFail($userCharacterId); $userChara->is_locked = true; $userChara->save(); return response()->json($userChara->toArray()); // この辺りがView } } Nextat Inc. 25 -
定番の戦術1. レイヤ化アーキテクチャ レイヤ 責務 UI (Presentation) ユーザに情報を表⽰、ユーザのコマンドを解釈 Application ソフトウェアで⾏う仕事の定義。ドメインオブジェクトにより問 題を解決
Domain (Model) ビジネスの概念、情報、ビジネスルールを表現 Infrastructure 上位のレイヤを⽀える⼀般的な技術的機能を提供 Nextat Inc. 26 -
ex). ユーザ所持キャラクター(略式) class UserCharacter { /** ID */ private $userCharacterId;
/** キャラクター(マスタ) */ private $character; /** 攻撃⼒などのステータス */ private $status; /** ロックされているかどうか */ private $isLocked; public function lock(): void { $this->isLocked = true; } } Nextat Inc. 30 -
ex) キャラクターのレアリティ class CharacterRarity { /** @var int */ private
$value; public function __construct(int $value): void { if ($value < 1 || $value > 5) { throw new \InvalidArgumentException(' レアリティは1 以上5以下の整数'); } $this->value = value; } public function getValue(): int { return $this->value(); } } Nextat Inc. 32 -
ex) キャラクターのファクトリ class CharacterFactory { public function makeFromRecord(CharacterRecord $record): Character
{ return new Character( new CharacterId($record->id), new Name($record->name), new Rarity($record->rarity), // 略 ); } } Nextat Inc. 34 -
ex) キャラクターのリポジトリ class CharacterRepository { public function find(CharacterId $characterId): ?Character
{ $record = CharacterRecord::query()->find($characterId->getValue())); if ($record === null) { return null; } return $this->characterFactory->makeFromRecord($record); } } Nextat Inc. 36 -
ex) ユーザ所持キャラクターをロックする操作 class LockUserCharacterService { public function lock(UserCharacterId $userCharacterId): UserCharacter
{ $userCharacter = $this->userCharacterRepository->find($userCHaracterId); $userCharacter->lock(); $this->userCharacterRepository->save($userCharacter); return $userCharacter; } } Nextat Inc. 38 -
整理し直す before after UI Controller,View Controller,View Application Controller ApplicationService Domain
Eloquent Model Entity、VO RepositoryのInterface Factory DomainService Infrastructure Eloquent Model Repository(Eloquent実装) Nextat Inc. 39 -
Therefore its name was called Babel, because there the LORD
confused the language of all the earth. And from there the LORD dispersed them over the face of all the earth. https://biblehub.com/esv/genesis/11.htm The city and its tower Nextat Inc. 49 -
例1. 仕様書からしてそもそも揺れている 仕様書: キャラ or キャラクター or ユニット バックエンド: キャラクター、ところによりキャラ
フロントエンド: キャラクター、ところによりユニット Nextat Inc. 51 -
例3. 英語名がバラバラ アイテムの数量 itemAmount itemQuantity itemCount など、 バックエンドのEntity フロントエンドのEntity フロントエンドのView
で揺れているようなケースも Nextat Inc. 56 -
おまけ:プログラムを⽇本語で書くのはあり? ⽇英翻訳が⾟いならそのまま⽇本語を使えばいいじゃない → いろいろ⾟い 複数形。characters => キャラクター達? キャラクターリスト? 真偽値を返すメソッドの命名 〜かどうか
⽇本語ファイル名で問題が起こるツールも Nextat Inc. 58 -
語順も違うし…… 英語:主語(S)動詞(V)⽬的語(0) The user character attacks to the enemy. $userCharacter->attack($enemy);
⽇本語: 主語(S)⽬的語(0) 動詞(V) ユーザー所持キャラクターが 敵を 攻撃する $ ユーザー所持キャラクター-> 攻撃する($ 敵) 助詞もないし⽚⾔っぽい Nextat Inc. 59 -
よーし、回しちゃうぞ〜 フロント HTTPレスポンスのステータスが500 PHP Fatal error: Maximum execution time of
30 seconds exceeded そうか時間が⾜りなかったか〜 Nextat Inc. 64 -
何が問題だったか 巨⼤な集約 柔軟すぎるマスタの仕様。対価の設定、排出率設定、出現確率アップ、確定設定 などガチャのマスタテーブルだけで20超え ガチャ = ガチャ内容物×1000個がそのままEntityに。純粋に⼤きい クエリ数もさることながら、DBレコードオブジェクトからEntityへの変換にもか なりの時間がかかり、不必要にメモリも⾷っていた DBクエリ
Repository以外の場所で発⾏されている脱法クエリが多くあった レイヤを分離したことで、FactoryでN+1問題が発⽣していることも Nextat Inc. 67 -
マスタデータはキャッシュ DBクエリレベルでのキャッシュ → イミュータブルなマスタEntityのキャッシュ へ ローカルのAPCuにキャッシュ デプロイ時にキャッシュのウォームアップ DBクエリ数、キャッシュ取得数を可視化して地道にチューニング Clockwork を拡張した管理画⾯でローカルでも確認できるように
ORMレベルではなく、Repositoryレベルでのクエリ発⾏元の追跡。 Nextat Inc. 69 -
Eloquent (ActiveRecord系ORM)との付き合い⽅ before: Eloquent DBレコードに⾃我が芽⽣えたオブジェクト。はじめにDBありき CRUDくらいしかないアプリならお⼿軽 永続化・クエリの機能とドメインのための機能が⼀つのオブジェクトに混在 規模が⼤きくなってくると、⻑期的に秩序を保ち続けるのは難しい after: Repository
考え⽅が逆。はじめにEntityありき Entityが永続化される際にデータストアにマッピングされる Repositoryの実装にEloquentが使われるが詳細はドメインからは隔離される Nextat Inc. 74 -
境界づけられたコンテキスト 同じモノを対象とした複数の機能において、違う属性を抽出してモデル化したい ケースがある モデルが複数存在するようなケースでは、混乱を防ぐためにスコープを明確化す ることが重要 アプリケーションの⽤途やチームに応じて境界を定め、コンテキスト内でのモデ ルの分裂を防ぐ ex) 輸送アプリケーションにおける予約コンテキストと輸送ネットワークコンテ キスト
とあるプロジェクト 解決したい問題が根本的に異なる機能でも、共通のモデルで対応していた Nextat Inc. 80 -
例1. マスタデータ管理 ゲームの設定の調整を柔軟に⾏うための機能 マスタデータの⼊⼒ミスは結構な確率で起こる ⼊⼒内容のバリデーションが必須 ⼿法は様々 Excel⼊⼒ + 型定義DSLによるバリデーション Googleスプレッドシート管理
+ ⼈の形をしたマスタ管理システム 専⽤のマスタデータ管理画⾯ Nextat Inc. 81 -
ex) ユーザ所持キャラクターの限界突破の履歴 class BreakLimitUserCharacterService public function breakLimit( PlayerId $playerId, UserCharacterId
$userCharacterId ) { // ( 略) // 限界突破の処理 $afterUserCharacter = $beforeUserCharacter->breakLimit($materials); $this->userCharacterRepository->save($afterUserCharacter); // 履歴を残す処理 $this->breakLimitHistoryService->add( $beforeUserCharacter, $afterUserCharacter, $materials ); // その他限界突破素材アイテムを消費する処理など } Nextat Inc. 85 -
コードの重複 ユーザに付与されるデータ アイテムマスタ + 有効期限 + 数 装備品マスタ + 初期経験値
+ 数 キャラクターマスタ + 初期経験値 + 初期限界突破数 + 数 switchで分岐してそれぞれ処理 あまりに多すぎて実は共通化したほうがいいことに気づく Nextat Inc. 89