CleanAspCoreWebApiTemplate

生産的なASP .NET最小APIテンプレート

これは、最小限のAPIを使用してASP.NETを使用してクリーンAPIを実装する方法を示すテンプレートリポジトリです。このテンプレートの「機能」に焦点を当てることは開発の生産性にあります。API自体の実際の機能は、意図的に基本的に保たれています。このリポジトリをコピーするか、その一部を再利用してください。もしそうなら、星を与えることを忘れないでください。

このテンプレートのいくつかの機能：

• 垂直スライスアーキテクチャ（技術レイヤーの代わりに機能に基づくグループ化）
• 唯一の依存関係はtestexamplesdotnetを使用した唯一の依存関係で実行できる統合テストのセットアップを簡単に実行できます。
• JWTトークンを使用した認証と承認。これは、テストでも使用されます。つまり、テスト内で認証と承認が適切に機能しているかどうかを確認できます。
• Opentelemetryの準備ができました
• dotnetウォッチのLaunchProfile
• コードのフォーマットをチェックするGitHubアクションを使用して自動化されたビルド、テストをビルドして実行します。

実行中のテスト

テストを実行するにはDockerのみが必要です（ヒント：Podmanは自由に使用できます）。 Docker画像がダウンロードされると、最初の実行には少し時間がかかります。次のコマンドを実行してテストを実行します。

dotnet test

アプリを実行します

1. 最初にローカルテストに使用できるJWTを生成します。

dotnet user-jwts create --role " read " --role " write "

注：ジョブと部門のエンドポイントは認証のみを必要としますが、従業員のエンドポイントは、JWTトークンに正しい請求を行う必要があります。

2. 提供されたdocker-compose.yamlを使用してデータベースを実行します。オプションでは、ComposeファイルのAspireダッシュボードも実行して、OpenTeleMetry出力を簡単に表示します。
3. アプリを実行します。 https://localhost:7162/swaggerでswaggerを使用してエンドポイントを探索できます。