【React】ドメイン駆動設計への道（I）：理論編

# 序論

弊社の技術チームは、Reactに基づくプロジェクトにおいて、ドメイン駆動設計（Domain-Driven Design、以下「DDD」）の理念を取り入れました。本稿では、DDDへの理解と、従来のアーキテクチャ設計との比較分析を通じて、その長所と短所を探求するものです。

複雑なビジネス要件への適応とコードの保守性の向上を目指し、ReactアプリケーションにおけるDDDの導入が図られました。DDDは一朝一夕に体得できるものではなく、広範な理論体系を有しています。本稿を通じて、私がDDDの学習過程で得た洞察を共有し、チームがどのようにしてこの理論をプロジェクトに応用しているかを述べることで、読者がDDDの核心的概念と実践手法を迅速に理解できるように努めます。

# ドメイン駆動設計とは何か？

DDDの理念は、2004年に模型化の権威であるEric Evansによって発表された影響力の大きい著作『ドメイン駆動設計: ソフトウェアの核心における複雑さへの対処』に端を発しています。

Ericは、技術専門家たちに対して、彼らの業務手法に対する全く新しい視点を提示しました。これは、複雑なビジネスシステムの開発に立ち向かう際に、即座にシステムの設計やコーディング作業に着手するのではなく、ドメインの専門家と協力して問題解決に取り組むアプローチを中心としています。この共同作業により、一連のドメインモデルが構築され、ビジネスの概念や規則をソフトウェア設計に落とし込むことで、ビジネスの複雑さを軽減し、または隠蔽することが可能になります。この過程は、現実のビジネスで発生する複雑かつ多様な問題への対応能力を拡充し、システムの拡張性を向上させることを目的としています。

ここで言及される「ドメイン（Domain）」とは、特定の事物の範囲や集合を指します。例えば「数学分野」、「金融分野」、「通信分野」といった様々な領域が含まれます。これらの異なるドメインは、それぞれ独自の境界を持ち、特定の「共通性」と「特有性」を示します。「技術専門家」と「ドメイン専門家」は、それぞれ異なる役割を担っており、専門的な知識と責任が異なります。以下に、これら二つの役割についての詳細を述べます：

1. **技術専門家**：
    - **役割**：技術専門家は、主にソフトウェア開発のプロフェッショナルであり、深いプログラミングスキルおよび技術知識を有しています。プログラマー、アーキテクト、システムエンジニアなどがこれに該当し、ソフトウェアシステムを実現するために技術的な解決策を提供し、適用することに集中します。
    - **責任**：技術専門家の主要な責務は、技術的な解決策の理解と応用です。これにはシステムの設計、コーディング、テスト、デプロイメントなどが含まれます。彼らはソフトウェアシステムの可用性、パフォーマンス、セキュリティなどの技術的要件を確実に満たす責任を担います。
2. **ドメイン専門家**：
    - **役割**：ドメイン専門家は、特定のビジネスドメインにおいて深い知識と経験を持つ専門家です。彼らはビジネスアナリスト、業界のエキスパート、ビジネスオーナーなどであり、ビジネスプロセス、ルール、要件についての深い理解を持っています。
    - **責任**：ドメイン専門家の主な責務は、そのドメインに関する専門知識を提供し、技術チームがビジネスニーズを理解し、適切なソリューションを設計することを支援することです。彼らはビジネス知識の保護者として機能し、開発されるソフトウェアシステムが実際のビジネス要件を満たすことを確認します。

DDDの理論体系においては、技術専門家と領域専門家の間の緊密な連携が重要視されています。コミュニケーションを効率化する手段として、ドメイン特化言語（Domain-Specific Language, DSL）の導入が推奨されています。DSLは、ビジネス領域の具体的な概念、原則、及び相互関係を直感的かつ簡潔に表現するための言語体系であり、特定の専門分野に特化した表現手法となっています。

Ericは、システムの技術的実装が現実世界の複雑性を適切に反映するよう、複数の技術モデリングのアプローチとそれに伴うアーキテクチャの概念を提唱しました。彼の提案する目標は、技術専門家と領域専門家が協力してドメインモデルを創造する過程で、意図的にあるいは無意識に、最終的な技術実装に適合するモデルとアーキテクチャの枠組みを共同で策定することにあります。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3688781/6ffb864a-0115-bd3a-babc-1d95dcca8f8c.png)

DSLの採用は、領域の専門家と技術の専門家が共同で、具体性と明確性を備えた言語を用いて、ビジネスの要求とその解決策を表現する上で大いに寄与します。この共通言語の使用は、コミュニケーションにおける不明瞭さを排除し、両者がドメインモデルに関して同一の理解を共有することを確実にするものです。この共通言語は、しばしば「ユビキタス言語」と称され、ドメイン駆動設計の文脈において、合意の形成とコミュニケーションの促進という重要な役割を担っています。

この理念を実践の観点から明示するために、「電子商取引プラットフォームにおける注文管理ソフトウェア」のプロジェクトを例に取り上げ、異なるチームの役割におけるユビキタス言語の活用事例について考察いたします：

1. **ビジネスサイド**：
    - **説明**：ビジネスサイドは注文処理に関わる要件を明確に定義しています。これには、注文の作成、支払処理、商品の出荷、返金手続きなどのプロセスが包括されています。
    - **シナリオ**：文書において「注文ライフサイクル」、「支払状況」、「出荷プロセス」といったユビキタス言語を駆使しています。これらの用語は、注文管理に関する核心的な概念を明瞭に示しています。

2. **製品**：

    - **説明**：プロダクトマネージャーは製品要件定義書（PRD）を作成し、注文管理システムが提供すべき機能及びユーザーとのインタラクションを具体的に記述します。
    - **シナリオ**：PRDにおいて、「注文ステータス」や「支払確認」といったユビキタス言語を使用し、製品の要求が正確に伝達されることが確保されています。

3. **デザイン**：

   - **説明**：デザインチームは、ユーザーの経験に関する要求に応じて、注文管理システムのユーザーインターフェースとインタラクションデザインを策定します。
   - **シナリオ**：デザイン画面では、ビジネス部門や製品部門が用いる同じ用語を採用し、「注文詳細ページ」や「支払いボタン」における一貫性を図っています。

4. **技術**：

   - **説明**：技術チームは、注文管理システムのバックエンド及びフロントエンドの機能を実装し、それに対応するプログラムコードを記述します。
   - **シナリオ**：バックエンドのコードを開発する際に、「注文エンティティ」や「支払いサービス」といった、ビジネス部門から提供されるドメインモデルに準じた用語を使用し、プログラムのロジックがビジネスの要件に適合していることを保証します。

上記の事例から明らかなように、様々な専門分野のチームメンバーが、プロジェクトの異なる段階において同一のユビキタス言語を使用することで、役割間に存在する理解の齟齬に由来するコミュニケーションの障害を避けることができます。この種の言語の一貫性は、要件定義書、設計図、ソースコードを通じて維持されており、チームメンバーがより効果的に協力し、作業を進めることを助けます。

また、プロジェクト開発の過程で生じる可能性のある誤解や誤りを最小限に抑えることに貢献しています。この方式は、プロジェクトの透明性を高め、結果的に製品の品質とプロジェクトの成功率を向上させる効果が期待されます。

# ソフトウェアアーキテクチャにおけるドメイン駆動設計の際立ちとフロントエンドへの啓発

DDDは、従来のアーキテクチャ設計の方法論と比較して、ソフトウェアにおけるビジネスの構造をモデリングすることに重点を置いています。このアプローチでは、コードの表現力が重要視され、ビジネスシナリオを直接的に捉え、それに基づいたモデル構築に優れた適応性を持ちます。

技術的観点から見ると、DDDの実践は、ソフトウェアの中で明瞭なドメインモデルの構築を意味します。これには、エンティティ、バリューオブジェクト、集約根などの概念が含まれ、これらはビジネスの実体、属性、関係性に直接対応しています。このようなマッピングにより、ビジネスの本質をより正確に反映させることができるだけでなく、コードの理解や保守が容易になるという利点があります。

- **ビジネスモデルとの密接な関係性**：DDDが実務上のビジネス問題解決において優れたアプローチである理由は、そのビジネスモデルとの密接な関連性にあります。このアプローチにより、システムは業務の変化や複雑性に柔軟に対応できるようになります。明確な業務概念の定義を通じて、業務ルールの追跡と適用が容易になり、システムの柔軟性が保たれます。この方法は、コードの可読性と表現力を高めると同時に、変化の激しい市場ニーズに迅速かつ適切に対応できるようにします。
- **バックエンド領域における顕著な成果**：技術およびアーキテクチャの進化とビジネスの複雑性の増大に伴い、DDDは再びソフトウェア設計の分野で注目を集めています。バックエンド領域では、DDDは実際のプロジェクトにおいて顕著な成果を挙げ、多くの関連記事がコミュニティから発信されています。これらの成果と議論は、バックエンド領域に留まらず、フロントエンド領域にも深い影響を及ぼしています。
- **フロントエンド領域への啓発**：DDDの原則と実践は、フロントエンド領域にも深い洞察を提供しています。ビジネスモデルをフロントエンドコードに明確にマッピングすることで、フロントエンド開発はビジネス要件とより密接に連携し、コードの保守性や拡張性が向上します。DDDの統一された言語とモデル構築の手法は、フロントエンドチーム間のコミュニケーションと協力を促進し、より効果的な作業を実現しています。

総合的な観点から考察すると、DDDをソフトウェアアーキテクチャに適応させた結果、開発過程において、より明瞭で体系立ったビジネスに基づく思考が注ぎ込まれていることが明らかです。特にバックエンド領域での顕著な成功は、フロントエンドの開発領域に対しても有用な指標を提供しており、フロントエンド開発者がコードにおけるビジネスモデルの表現を見直す契機を提供しました。結果として、ビジネスの要請に即応し、更に効率的なフロントエンド開発の実践へと導かれているのです。

# クリーンアーキテクチャの理解

近年におけるソフトウェア工学の領域では、数多くの革新的なアーキテクチャ理論が出現しています。[クリーンアーキテクチャ](https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html)に関する論考においては、システムの各アーキテクチャ層を明確に示す図式が示されることがあり、それによりシステムの構造が直観的に把握できるようになっています。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3688781/f59b44ab-e700-6fb3-3d15-e59827d067ba.png)

クリーンアーキテクチャの原則に従い、ソフトウェアシステムは四つの主要な層に区分されており、それぞれの層は固有の責任を有し、依存関係の階層が明確に定義されています。

1. **エンタープライズビジネスルール層（Enterprise Business Rules Layer）：**
    - **作用**：アーキテクチャの要となる部分は、ソフトウェアシステムにおける中心的ビジネスロジックを精確に規定しており、その範疇にはエンティティおよびドメインイベントが包括されています。
    - **特徴**：該当するアーキテクチャは、具体的なアプリケーションや特定の技術スタックとは独立しており、ソフトウェアシステムの中核を成すものです。
2. **アプリケーションビジネスルール層（Application Business Rules Layer）：**
    - **作用**：ユースケースとドメインサービスを内包し、ソフトウェアシステムの応用に関するロジックを規定しています。
    - **特徴**：コーディネーターとして機能し、「カートに追加」などのユーザー操作から引き起こされるビジネスプロセスを適切に管理し、実行に移す責務を担います。
3. **インターフェースアダプタ層（Interface Adapters Layer）：**
    - **作用**：コントローラー、プレゼンター、リポジトリ、ファクトリー、ゲートウェイなどを含むこの層は、外部からの要請をシステムの内部ユースケースに転換し、内部ユースケースから生じた成果を外部への応答に変換する任務を果たします。
    - **特徴**：ドライブ型アダプタとドライブされる型アダプタの二種類に分類されるこの層は、システムとサードパーティのサービスコードとの間の結合度を低減させることにより、システムの柔軟性を高める役割を担っています。
4. **フレームワーク＆ドライバ層（Frameworks & Drivers Layer）：**
    - **作用**： 最も外側の層として、デバイス、ネットワーク、ユーザーインターフェース、外部インターフェースといった要素を含み、具体的な技術的実装を提供します。これにはデータベース、メールサービス、 Web、UIなどが含まれる場合があります。
    - **特徴**： アーキテクチャ全体において、より具体的かつ実用的な構造を実現し、ソフトウェアシステムに対して根本的な支持と動力を提供する役割を果たします。

要約すると、同心円構造はソフトウェアの異なる領域を象徴しており、このアーキテクチャを構築するための中心的な原則は「依存規則（The Dependency Rule）」です。この規則により、依存関係は常に内側の層に向けてのみ設定され、内層のコンポーネントは外層の任意の要素について認知していない状態が保たれます。これは関数、クラス、変数、その他の名前付きエンティティに適用されます。この制約は内層と外層の間の分離を維持し、アーキテクチャの明確な境界を形成するのに役立ちます。

# フロントエンドにおけるクリーンアーキテクチャの深い分析

[フロントエンドのクリーンなアーキテクチャ](https://dev.to/bespoyasov/clean-architecture-on-frontend-4311)に関する論述は、ソフトウェアシステムを複数の層に分節し、それぞれの機能とアプリケーション領域の繋がりの密度に基づき階層化する手法を提案しています。このアーキテクチャ設計は、DDDの指針のもと、機能モジュールを柔軟に組織することの重要性を強調しています。以下に、ドメイン層、アプリケーション層、およびアダプタ層を解説する詳細な節を設けます。

### ドメイン層

クリーンアーキテクチャにおける中心的構成要素たるドメイン層は、アプリケーションの主要な対象領域を描写するエンティティ、データ、並びにデータの変換を行う処理のコードを包含しております。この層は、ビジネスの本質的な定義を担い、システムの核心部分を形成しています。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3688781/cdee383d-05b5-8276-328d-289824e25fe6.png)

ドメイン層の主要な特徴は、その独立性にあります。技術選定が変更されても、例えばReactからAngularへの移行が行われたり、具体的なユースケースが微調整されたとしても、ドメイン層の中核となる概念やデータ構造は一貫して不変であるべきです。ドメインエンティティのデータ構造およびそれに伴う変換処理は、外部環境の影響を受けずに設計されるものであり、外部イベントによってドメイン内での変換が引き起こされた場合であっても、その実装手法には影響を与えません。

電子商取引アプリケーションでは、ドメイン層に商品エンティティの定義、ショッピングカートの集約、注文処理サービスなどが含まれることが想定されます。これらの要素は、注文が有効であるかの検証や、注文の総額計算等、ビジネスにおける核心的なロジックを実行する責務を担います。

```jsx
// ドメインエンティティ
class Product {
  private name: string;
  private price: number;

  constructor(name: string, price: number) {
    this.name = name;
    this.price = price;
  }

	// その他のビジネスメソッドとルール
}


// ドメインサービス
class ProductService {
	// 注文が有効かどうかを検証するビジネスロジックを処理する
	validateOrder(order: any): boolean {
		// ドメイン層の検証ロジック
		return /* 検証ロジックの結果 */;
	}

	// 注文合計額を計算するビジネスロジックを処理する
	calculateOrderTotal(order: any): number {
		// ドメイン層の計算ロジック
		return /* 計算ロジックの結果 */;
	}
}

// アプリケーション層でドメインサービスを呼び出す
const productService = new ProductService();
const orderInfo = /* ユーザーが提出した注文情報 */;
const isValidOrder = productService.validateOrder(orderInfo);
const orderTotal = productService.calculateOrderTotal(orderInfo);
// 注文の検証と合計金額の計算結果を処理する
/* 結果処理ロジック */
```

明瞭なレイヤー構造を採用することで、システムは保守が容易になり、テストや拡張を行いやすくなります。この結果、システムの保守性が高まり、テスト可能性も向上します。

### アプリケーション層

アダプター層に次ぐ階層はアプリケーション層であり、アプリケーションのビジネスロジックとデータフローの調整を担う重要な役割を果たしています。アプリケーション層の主要な目的は、ビジネスルールと実装の具体的な詳細を明確に隔てることにあります。これにより、ビジネスロジックがフレームワーク、ライブラリ、その他の技術的な詳細から独立した状態を維持することを保証しつつ、ドメイン層およびインターフェイス層との間における透明性が確保されます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3688781/5add3001-d101-fb9c-adea-d4bf67111c54.png)

DDDにおけるアプリケーション層は、ユーザ入力をドメインオブジェクト操作へ転換する中継役を担います。この層はユーザの要求を満たすためにドメイン層のオブジェクトを統合しますが、具体的なビジネスルールは包含せず、それらはドメイン層が処理を担当します。

1. トランザクションの実行管理。
2. ユーザーからの入力を受け付け、パラメータを解析。
3. ドメイン層のドメインオブジェクトがビジネスロジックを実行することを調整。
4. ドメインオブジェクトからの出力をユーザーが理解可能な形式に整形して返送。

電子商取引アプリケーションにおいて、アプリケーション層はショッピングカートの管理、注文の処理、価格の計算といったビジネスフローを処理する役割を担うことがあります。

```jsx
// アプリケーション層のサービス
class ShoppingCartService {
	// ユーザーが商品をカートに追加するリクエストを処理
	addToCart(product: any, quantity: number): void {
		// ユーザー入力を解析
		const item = /* ユーザー入力の商品情報を解析 */;

		// ドメイン層のショッピングカートオブジェクトでビジネスロジックを調整
		const cart = /* ドメイン層からショッピングカートオブジェクトを取得 */;
		cart.addItem(item);

		// 取引処理     
		/* 関連する取引のロジック */      

		// ショッピングカートオブジェクトの結果をユーザーに返すための適切な形式に変換する     
		const cartSummary = cart.getSummary();      

		// ユーザーへ返す     
		/* ユーザーに返すロジック */  
	} 
}

// アダプタ層でアプリケーション層サービスを呼び出す 
const shoppingCartService = new ShoppingCartService(); 
const product = /* ユーザーが選択した商品情報 */; 
const quantity = /* ユーザーが選択した商品数量 */;
shoppingCartService.addToCart(product, quantity);
```

### アダプタ層

アダプタ層は全体のアーキテクチャーにおける最外層であり、主な任務は内部と外部データの適応処理を行うことです。これには、外部サービスのAPIデータをアプリケーションが期待する互換性のあるAPIへ変換する作業が含まれます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3688781/92f1c4d2-c1f7-cddb-ebb8-f3da4b231f45.png)

アダプタ層は、システムのコードとサードパーティーサービスとの間の密接な結合を顕著に緩和し、システムへの柔軟性を増大させる機能を有しています。一般に、アダプタはドライブ型と受動型の二つに類別されます。前者は能動的に外部システムに対して要求を送信する役割を果たし、後者は外部システムからの要求を受信する役割を担います。

#### ドライブ型アダプタ

電子商取引アプリケーションにおいて、ユーザーがインターフェース上の購入ボタンを押下する場合について考察します。このシナリオにおいて、ドライブ型アダプタはユーザーの操作を処理し、フロントエンドからの購入リクエストをバックエンドAPIが処理可能な形式に変換し、次にその変換されたリクエストをバックエンドに送信します。このアダプタは積極的にバックエンドシステムとの通信を行い、フロントエンドからのデータをバックエンドが要求する仕様に応じて変換する役割を持ちます。これにより、フロントエンドとバックエンド間の結合度を低下させることができます。

```jsx
// 駆動型アダプター
class PurchaseAdapter {
  // 購入リクエストを処理し、フロントエンドデータをバックエンドデータ形式に変換する
  adaptPurchaseRequest(frontendData: any): any {
    // アダプトロジックで、バックエンドAPIが要求する形式に変換
    const backendData = /* アダプトロジック */;
    return backendData;
  }

	// バックエンドに購入リクエストを送信する
	sendPurchaseRequest(backendData: any): Promise<any> {
    // リクエスト送信のロジック
    return /* リクエストの非同期操作 */;
	}
}

// アプリケーション層でアダプタを呼び出す
const frontendData = /* ユーザーがインターフェース上で購入ボタンをクリックしたデータ */;
const purchaseAdapter = new PurchaseAdapter();
const backendData = purchaseAdapter.adaptPurchaseRequest(frontendData);
purchaseAdapter.sendPurchaseRequest(backendData).then(response => { 
	/* xxxxxxxxx */
});
```

#### 受動型アダプタ

受動型アダプタの機能に関するシナリオを検討いたします。フロントエンドが商品リストのデータを取得するためにバックエンドサーバーと通信する必要がある場合、受動型アダプタはアプリケーションからの商品リスト取得要求を受信します。受動型アダプタは、この要求をバックエンドサーバーに転送し、バックエンドサーバーからの応答を受け取った後、そのデータをフロントエンドが解釈できる形式に変換し、フロントエンドに返送します。このプロセスにより、フロントエンドとバックエンド間のデータ交換がスムーズに行われることを保証します。

```jsx
// 受動型アダプタ
class ProductListAdapter {
  // 商品リストの取得要求を処理し、バックエンドサーバーと通信する
  fetchProductList(): Promise<any> {
    // リクエスト送信ロジック
    return /* リクエスト送信の非同期操作 */;
  }

	// バックエンドから返された商品リストデータをフロントエンドのデータ構造に変換する
	adaptProductList(response: any): any {
		// 適応ロジック
		const frontendData = /* 適応ロジック */;
		return frontendData;
	}
}

// アプリケーション層でアダプタを呼び出す
const productListAdapter = new ProductListAdapter();
productListAdapter.fetchProductList();then(response => {   
	// フロントエンドが必要とする商品リストデータに加工する   
	const frontendData = productListAdapter.adaptProductList(response); 
});
```

# DDDの使用タイミングは？

DDDは、複雑な商業要件に適応するためのソフトウェア開発の手法であります。実装と進化するモデルを結合させることにより、変動しやすい要求または複雑な商業環境に対して有効に対応することが可能です。実務において、以下の状況におけるDDDの採用が妥当であると認識されます。

### 複雑なビジネス及び領域概念

プロジェクトが商品、注文、履行などの複雑な商業ロジックや領域概念に深く関連している場合、DDDを採用する利点は顕著であります。これらの事情下において、適切に構築されたドメインモデルを通じて領域内の課題を明確に表現し、効果的に解決することができます。その優れた利点は以下の通りでございます：

- **コードの複雑性削減**：DDDは精緻なドメインモデルの構築を促進し、それによって領域に固有の課題を明確に定義し解決するのに寄与します。結果として、コードの複雑さが軽減され、読みやすさ及びメンテナンス性が増進されます。
- **大規模な調整回避**：固定されたドメインモデルを確立することにより、ビジネスの変更に対して柔軟に適応する能力が向上し、ビジネスの変動がコード全域に大規模な修正を必要とする事態を減少させることが可能となります。これにより、システムの柔軟性及び拡張性が強化されます。
- **可読性と保守性の向上**：ドメインモデルは技術者とドメイン専門家間のコミュニケーションを促進し、共通の言語を確立します。これにより、ビジネス要件と実装の詳細がより深く理解され、開発者が迅速に業務に対応し、システムの保守や反復作業を効率的に行うことを支援します。

### ビジネスロジックの再利用

Web、移動端末（Mobile）、デスクトップなど複数の端末でビジネスロジックを実装し、再利用する際に、ロジックをドメイン層に抽出することは有益な戦略です。その利点を以下に記載します：

- **独立したドメイン層**: ドメイン層は独自の層として機能し、核心的なビジネスロジックを内包しています。これは特定の技術やプラットフォームに依存せず、汎用性を有しています。
- **マルチプラットフォームでのビジネスロジックの共有**: ドメイン層を介して、異なるプラットフォーム間で迅速にビジネス機能を実現し、同一のビジネスロジックを共有することが可能です。これはコードの再利用性と統一性を高める効果をもたらします。
- **他の層との連携容易性**: ドメイン層はプレゼンテーション層やインフラ層といったその他の層と簡単に連携することができます。これにより、データの伝送や変換プロセスが効率化され、システムの安定性と拡張性が確保されます。

### 複数の外部システムと統合する必要があるシステム

このタイプのシステムにおいて、DDDは、各システム間の交流及び協力の枠組みを構築する上で欠かせぬ役割を担っています。この手法の適用により得られる利点は下記の通りです：

- **境界コンテキストの明確化**：DDDを導入することで、システム間の相互作用や協調を行う際に必要となる、明確で独自の境界コンテキストを定義することが可能となります。これにより、異なるシステム間で発生しうる意味論的な差異に起因する混乱や誤解の防止に寄与します。
- **マイクロサービスの分割基準**：限界コンテキストはマイクロサービスを構築する際の分割の指針として機能します。それぞれのマイクロサービスは特定の限界コンテキストに基づき、内部的には独自のドメインロジックを備え、外部とは軽量な通信プロトコルを用いてやり取りを行います。このアプローチは、システムの柔軟性とスケーラビリティの両方を高める効果を持ちます。

# フロントエンドでDDDを採用する利点と欠点

現代のフロントエンドアプリケーションの開発において、DDDのアーキテクチャを採用することは、顕著な利益を提供する一方で、いくつかの重要な挑戦にも直面します。このアーキテクチャは、単に技術的な選択を超えたものであり、思考方法と方法論を体現しています。しかしながら、DDDが提供する強力なツールと概念があるにもかかわらず、実際の適用においては、その導入に伴う影響に対して注意深い対応を要求されます。

### 利点

1. **独立領域**
    - コア機能の細分化と特定の領域における一元管理により、システムの独立性が確立されました。
    - モジュール化された独立性は、テストの必要性を低減させ、各シナリオやユースケースに応じて適切なサードパーティーサービスやツールを選択する柔軟性を提供します。これにより、一つの固定された実装方式に依存することなく、システムの保守性と適応性が高まります。
2. **独立ユースケース**
    - 平坦なコード構造は、テストや拡張を容易にし、アプリケーション層におけるビジネスロジックの柔軟性を高めます。
    - 各使用シナリオおよびユースケースが個別に記述されることで、必要な機能やサービスを精確に把握することが可能となります。
    - 各シナリオやユースケースに応じて選択される適切なサードパーティーサービスやツールは、システムの保守性と柔軟性の向上に寄与します。
3. **より明確なビジネスロジック**
    - 明瞭に区別されたドメイン、サブドメイン、および境界コンテキストは、チームメンバーに明確な役割分担と協力の枠組みを提供し、複雑な問題を解決する際の難易度を軽減します。
    - DDDの方法論は、開発者にビジネスドメインの中核的な概念とロジックに深く注目することを促し、アプリケーション全般のビジネスフローをより明確かつ理解しやすくすることを目的としています。
4. **交換可能な第三者サービス**
    - アダプタの導入により、外部の第三者サービスを容易に交換することが可能になり、インターフェースの一貫性を保ちつつサービスの切り替えを実現できるため、システム全体の安定性が強化されます。
5. **改善されたモジュール化と保守性**
    - DDDは、アプリケーションのモジュール化を促進し、それぞれのドメインモデルが独立して開発、テスト、デプロイされることを可能にします。このようにすることで、一部の変更がアプリケーション全体に及ぼす影響を最小限に抑えることができ、それによってシステムの安定性とメンテナンスのしやすさが向上します。

### 短所

1. **学習コスト**
    - チームは一定の技術レベルとDDDの概念に対する理解が必要であり、初心者にとって学習曲線はかなり急です。
    - 新しいアーキテクチャスタイルの習得及びその適応には、相応の時間と精力の投資が必要となる。
2. **開発サイクル**
    - 既存のビジネスを分析し、細分化することはチームに対して高度な要求を課し、同時に甚大なる精神的な負担をもたらすことが必至である。
    - 後続機能の統合、モジュール間の相互作用、並びに要件の変更を考慮した際、モジュールの拡張性を確保することが開発サイクルの長期化を招く要因となる。
3. **適用シナリオ**
    - クリーンアーキテクチャは万能の解決策ではなく、特に単純なビジネスモデルにおいては効率性を損なうリスクが存在する。小規模なプロジェクトにおけるクリーンアーキテクチャの採用は、不必要に複雑性を増加させ、導入の障壁を高める可能性がある。
4. **ビジネスコード量**
    - 成果物のパッケージサイズの増大は考慮すべき要因であり、コードの量を慎重に管理し、必要に応じて削減及び適切な分割を行い、コードの簡潔性と保守性を維持することが求められる。
5. **デプロイメントとメンテナンスの複雑さ**
    - ドメインモデルの比較的高い独立性により、デプロイメントとメンテナンスの複雑性が増加する場合があります。このため、アプリケーション全体の一貫性と安定性を保持するためには、より細やかな調整と緻密な管理が必要とされます。
6. **チーム間コミュニケーションおよび協力コスト**
    - チームメンバー間での緊密なコミュニケーションと協力が不可欠であり、ビジネスドメインに対する共通の理解と合意を確実にすることがその目的です。これはチーム間のコミュニケーションコストの増加や協力の難易度を引き上げる可能性も含んでいます。

上述の通り、フロントエンドアプリケーションにDDDアーキテクチャーを適用することは、数多くのメリットを提供します。しかしながら、それに伴う潜在的なコストや挑戦も十分に考慮する必要があり、特定のシナリオにおいては適合しない場合もあり得ます。

# 実践上の問題と挑戦

最近の経験を踏まえ、私は弊社が採用しているアーキテクチャパターンに対していくつかの疑念を抱き始めています。イテレーションごとの開発を進める中で、以前に設計したドメインデータの妥当性や、新しいビジネスモデルに対するアプローチについて再考する機会が増えました。これらの考察は、DDDパターンの現実的な効果に対して、深い疑問と反思を引き起こしています。

### チーム理解と実行

チームメンバーの間でDDDに関する理解が一部欠けているか、或いは誤解が生じていることが明らかになっており、私もその例外ではありません。実践する中で、既存の設計案に何となく違和感を覚える場面が散見されます。具体的には、業務設計の非合理性や完全性の不足、システムの拡張性や業務の分割を十分に配慮していないためにコードが複雑化している部分などがそれに該当します。これらの点から、私たちはDDDにおいて経験が不足していると認識しました。

これらの課題を克服するためには、チーム内の学びと共有を促進し、DDDの概念への理解と応用技術を継続的に向上させることが必須です。同時に、標準化された「**デザインプロセス**」および「**開発規約**」を策定し、それに従うことでコードの品質と一貫性を確保することが重要です。後続の章では、これらの二つの側面について詳細な説明とともに、具体的な提案や実践方法を展開しています。

### 複雑度の界定と分割

DDDは、複雑な商業的課題への対応策として広く認識されておりますが、しばしば「複雑さ」の具体的な定義が不明瞭とされる事例が見受けられます。プロジェクトにおけるビジネスプロセスのうち、実のところ複雑性を帯びている部分は少数に過ぎないことが多いですが、大部分は比較的に単純なものです。故に、ビジネスの複雑性に直面した際、それを如何に分割するかが重要な問題となります。

本問題に取り組むためには、詳細な領域分析と設計が不可欠であり、業務の境界及び関連性についても細心の注意を払うべきです。これは、複雑な商業的プロセスをより小さく、扱いやすく、そして理解しやすい単位に細分化することを意味します。このプロセスにおいては、ドメイン駆動設計の基本概念である集約ルート、エンティティ、値オブジェクトなどを用いて、複雑なビジネス領域を適切なモジュールに区切ることが可能です。

各モジュールは特定のビジネス機能やシナリオを担うとともに、内部的には更に多くのフラグメントに細分化され、各々が特定のタスクやロジックを処理する責務を担います。このアプローチにより、システム全体の複雑性が著しく低減されます。このようなモジュラー設計は、ビジネスロジックの明確化を促進するだけでなく、システムのメンテナンス性および拡張性の向上に寄与します。

最後に、業務領域の専門家との密接な協力を通じて深い理解を獲得することが極めて重要です。細分化されたドメインモデルやフラグメントが実際のビジネスニーズに合致しており、将来的な発展や変更にも対応できる状態であることを確認する必要があります。これにより、複雑なビジネスが直面する課題に真正面から取り組むことが可能となります。

### 思考の転換と技術実践の組み合わせ

組織の理解と実行能力、複雑性の把握に加えまして、DDDの原則を技術的実践に応用するには、さらなる深みのある考察と実践が求められます。この過程には、多面的なアスペクトが含まれております：

- **ドメインモデルの設計**：DDDの理念では、ビジネスドメインモデルの構築がソフトウェア開発過程において中心的な役割を占めます。このため、開発チームは集約根、エンティティ、値オブジェクトといったドメインモデルの構成要素について綿密に設計を行う必要があります。このプロセスは、ビジネスの要求とロジックを適切に反映することを目的としています。この実践には、ビジネス領域の専門家との緊密な議論と協力が不可欠であり、モデルの精度と完全性を確保することが不可欠です。
- **ドメインサービスの定義**：ドメインサービスは、エンティティの操作ではなく、ビジネス機能を提供するサービスとして定義されます。開発チームは、どのビジネスロジックをドメインサービスに封じ込めるかを決定し、適切なインターフェイスおよび実装を設計する必要があります。この過程は、ビジネス要件、モジュール間の依存関係、およびシステム全体のアーキテクチャを考慮することを要求します。
- **ドメインイベントの処理**：ドメインイベントとは、ドメイン内で発生する重要なトランザクションイベントを指し、他のドメインモジュールの反応を引き起こす可能性があります。実践では、開発チームは適切なイベント駆動メカニズムを設計し、ドメインイベントをタイムリーに捕捉・処理し、システムのデータ一貫性とビジネスプロセスの正確さを保証する必要があります。
- **継続的学習と改善**：DDDは、継続的に進化するプロセスであり、開発チームは常に学習と改善を重ねることが求められます。これには、適切なトレーニングコースへの参加、関連する書籍や記事の閲覧、コミュニティでのディスカッションへの参加などが含まれます。これらの方法を通じて、チームはドメイン駆動設計の理念と実践スキルを常に向上させることができます。また、実際の開発過程での反省や検討を通して、チームの作業フローや開発規範の調整及び最適化を行い、プロジェクトの要求に応じた変更へ適切に対応することが可能です。
- **適用技術ツールとフレームワークの探索**：アプリケーションのドメイン駆動設計を実施する際、適切な技術ツールやフレームワークの選択は極めて重要です。開発チームは、現行のフロントエンド開発技術に関する綿密な調査及び評価を行う必要があります。これにより、ドメイン駆動設計の実践を最も効果的に支援するツールやフレームワークを選定します。このプロセスには、ReactやVue.jsのようなフロントエンドフレームワーク、ReduxやVuexなどの状態管理ライブラリ、およびその他の関連ツールやライブラリの選択と統合が考慮されるべきです。

上述の措置を講じることにより、開発チームは領域駆動設計の原理を具体的な技術的実践と有機的に結合させることが可能となり、結果としてシステムの保守性、拡張性、および適応性が向上します。これにより、ビジネスの環境が変化し成長する過程において、適切に対応することができます。

# 総括および反省

DDD の原則は、システム間の結合度を低下させることにより、保守性、拡張性、およびテストのしやすさを高めるという価値を提供します。論理的に階層化された設計を通じて、各機能モジュールはその本質的な責務とより緊密に結びつけられ、開発者はビジネスの要求に対して集中しやすくなることから、ソフトウェアシステムの総合的な品質及び保守性が向上します。

しかしながら、各手法には、適用されるべき特定のシナリオと認識されるべき限界があります。流行に左右されることなく、適切性を重視し、選択する手法においては「簡潔性は複雑性に優先する」「進化は全面的な統一性に勝る」という原則を採用します。コードの記述に際しては、「保守の容易さ」「拡張の容易さ」「安定性」「効率性」を基本原則としています。どのような実装方法を採用しても、チームがDDDの目標を達成できれば、それは成功と評価されます。

ドメイン駆動設計(DDD)の理念に深く理解すると、その中核をなす理念は、「単一責任の原則」、「開放/閉鎖の原則」、「エンティティ」、「バリューオブジェクト」、「集約」、「リポジトリ」といった一連の基本原則と概念にわたることが理解されます。これらの概念は、フロントエンドの領域におけるドメイン駆動設計に対して、強固な基盤をもたらします。高い内聚性と低い結合度を核とするこの指導的なデザインの理念は、開発者が明確で、柔軟性に富み、保守が容易なフロントエンドアプリケーションを創造するための助けとなります。

次回の実践では、React + Zustand の技術スタックをを事例に、フロントエンドにおけるDDDの原理を詳細に検討いたします。簡素化された電子商取引システムの構築を通じて、これらの原則と概念を具体的なプロジェクトに応用し、フロントエンドのモデリングプロセスを披露することにより、透明性が高く、保守が容易なフロントエンドアプリケーションの構築に対する期待を高めることを目指しています。皆様のご期待に添えるよう努めますので、どうかご注目ください。共にフロントエンド開発の緻密さを追求する旅を始めましょう。

# 創作チーム

作者：Brycen

校閲：Wayne、Yuki