SSR アーキテクチャ概要⚓︎

技術スタック⚓︎

AlesInfiny Maris OSS Edition （以降、 AlesInfiny Maris ） の SSR アプリケーションの構成を以下に示します。

アプリケーションアーキテクチャ⚓︎

AlesInfiny Maris における SSR アプリケーションアーキテクチャの全体概要を以下に示します。

構造の詳細⚓︎

サーバーサイドレンダリング方式の Web アプリケーションにおける、各層とそれを構成するコンポーネントの役割について、それぞれ説明します。

プレゼンテーション層⚓︎

プレゼンテーション層は、ユーザーインターフェースを提供する層です。 ユーザーからの入力を受け、アプリケーションコア層に処理を依頼します。 アプリケーションコア層からの処理結果に応じて、ユーザーに情報を表示します。

ビュー⚓︎

ビューは、ユーザーに情報を表示する役割を担います。ビューには UI の構造やスタイルを定義します。 Razor コンポーネントの HTML 部分がビューに相当します。 ビューでは以下を行います。

• プレゼンテーションロジックの結果を HTML に表示する
• 入力チェックやアプリケーションサービスの呼び出し等、プレゼンテーションロジックが実行できるように入力フォームを構築する
• HTML の要素に対して、 CSS を適用する

ビューモデル⚓︎

ブラウザーからのイベントを受け、プレゼンテーションロジックを実行します。 ビューモデルでは以下を行います。

• レンダリングに必要な処理
• 入力チェック（項目間チェック）
• アプリケーションサービスの呼び出しを通じたデータの取得・更新
• 業務エラーをハンドリングして、エラーメッセージをビューに設定する

ビューとビューモデルの間のデータのやり取りには、バインド変数またはバインドプロパティを使用します。

アプリケーションコア層⚓︎

アプリケーションコア層は、ビジネスロジックを実装する層です。 トランザクション管理を含む、すべてのビジネスロジックをここに実装します。

アプリケーションサービス⚓︎

アプリケーションサービスは、アプリケーションコア層の中で、ユースケースレベルのビジネスロジックを実装する役割を担います。 アプリケーションサービスでは以下を行います。

• データベーストランザクションの管理
• ビジネスロジック(計算処理、繰り返し、条件分岐など)の実行
• リポジトリインターフェースを介したデータアクセス

アプリケーションサービスの引数や戻り値では、複雑度に応じて以下を使用します（下に行くほど複雑になります）。

• 引数・戻り値
• 複数の引数・複数戻り値
• record
• 引数クラス・戻り値クラス

ビジネスロジックは手続き型で実装します。 他のアプリケーションサービスとビジネスロジックを共有しません。

リポジトリインターフェース⚓︎

リポジトリインターフェースは、アプリケーションコア層の中で、データアクセスを抽象化する役割を担います。 リポジトリインターフェースは、アプリケーションサービスから利用されます。 これにより、アプリケーションサービスのテスト容易性を確保します。

実装クラスであるリポジトリは、インフラストラクチャ層に実装します。 アプリケーションサービスには、 DI コンテナーからリポジトリを注入します。

インフラストラクチャ層⚓︎

インフラストラクチャ層は、データベースや外部システムとの接続を管理する層です。 データベースへの接続、外部システムと通信を担当します。 原則としてインフラストラクチャ層にビジネスロジックを実装しないようにします。

インフラストラクチャ層では、 Entity Framework Core （以降、 EF Core と記載）を使用します。 EF Core のツールを使用して、作成したテーブルエンティティのコードからデータベースを生成します (Code First) 。

リポジトリ⚓︎

リポジトリは、インフラストラクチャ層の中で、データアクセスを実装する役割を担います。 リポジトリは、リポジトリインターフェースを実装します。 リポジトリでは以下を行います。

• データベースへの接続
• データベースからのデータの取得
• データベースへのデータの登録・更新・削除

テーブルエンティティ⚓︎

テーブルエンティティはデータベースのテーブルに対応するデータ構造を表現するクラスです。 1 つのテーブルエンティティオブジェクトがテーブルの 1 レコードに対応します。

原則として、 1 つの C# コードファイル（ *.cs ）に 1 つのエンティティクラスを定義します。