アプリケーション構成⚓︎

AlesInfiny Maris OSS Edition （以降、 AlesInfiny Maris ）として、アプリケーション形態ごとに標準的なアプリケーション構成を定義しています。 ここでは主要な構成要素を示します。

Web アプリケーション ( クライアントサイドレンダリング )⚓︎

Vue.js を用いた SPA の構成をとります。 サーバーサイドは .NET 8 以降の ASP.NET Core の Web API アプリケーションです。 データアクセスには Entity Framework Core を利用します。

Web アプリケーション ( サーバーサイドレンダリング )⚓︎

（今後追加予定）

コンソールアプリケーション⚓︎

コンソールアプリケーションでは、汎用ホスト Microsoft.Extensions.Hosting を用いて構築します。データアクセスには Entity Framework Core を利用します。

サンプルのダウンロードおよび解説については、 コンソールアプリケーションで DI を利用する を参照してください。

ソリューションの構造⚓︎

ソリューションの単位⚓︎

Web アプリケーションやコンソールアプリケーション ( バッチ ) など、 1 つのサブシステムは通常複数のアプリケーションで構成されます。 AlesInfiny Maris では、 1 サブシステム 1 ソリューションを基本として推奨します。 ただし、複数サブシステム ( 複数ソリューション ) で共用する共通機能を作成する場合は、必要に応じてソリューション分割を検討してください。

ビルド時間が長すぎる場合や、開発者の PC スペックがソリューションの大きさに耐えられない場合は、ソリューションフィルターの機能を活用しましょう。 1 ソリューションを保ちながら、プロジェクト単位でフィルター処理を行うことができます。

Visual Studio のフィルター処理済みソリューション - ソリューション フィルター ファイル

プロジェクトの単位⚓︎

プロジェクトは、原則として機能単位、層単位で分割することを推奨します。 プロジェクトの分割にあたっては、以下の手順で分割を検討してください。

1. 業務分割、機能分割

   サブシステムを業務的な観点で機能に分割します。

2. アプリケーションアーキテクチャの検討

   アプリケーションの内部構造をどのように整理していくか検討します。 典型的なアプリケーションの内部構造には以下のような種類があります。

   • レイヤードアーキテクチャ
   • クリーンアーキテクチャ

   各アーキテクチャの詳細は、以下を参照してください。

   一般的な Web アプリケーション アーキテクチャ

3. アプリケーションアーキテクチャをプロジェクト構造に落とし込む

   定めたアプリケーションアーキテクチャをプロジェクト構造に落とし込みます。 アプリケーションアーキテクチャの定める各コンポーネントをどのようにプロジェクトとして構成するか定めます。 .NET のプロジェクト間には、循環参照¹ の設定ができません。 アプリケーションアーキテクチャを適切に表現できるプロジェクト構造を検討してください。

   最も基本的な構造は、以下の通りです。

   • クライアントサイドレンダリング

   

   • コンソールアプリケーション

   

4. 業務 / 機能をプロジェクト構造に当てはめる

   プロジェクトは原則として業務 / 機能で分割してから、層で分割します。 アプリケーションをマイクロサービス化しないのであれば、エントリーポイントのプロジェクトは 1 プロジェクトとすることを推奨します。