CleanAspCoreWebApiTemplate

Template API minimal ASP .NET yang produktif

Ini adalah repositori template yang menunjukkan bagaimana seseorang dapat menerapkan API bersih dengan ASP.NET menggunakan API minimal. Fokus pada 'fitur' dalam template ini adalah pada produktivitas dev, fitur aktual API itu sendiri telah disaksikan dengan sengaja. Jangan ragu untuk menyalin repositori ini atau menggunakan kembali bagiannya, jangan lupa memberi bintang jika Anda melakukannya.

Beberapa fitur dalam templat ini:

• Arsitektur Slice Vertikal (pengelompokan berdasarkan fitur alih -alih lapisan teknis)
• Pengaturan tes integrasi yang mudah digunakan dan cepat untuk berjalan yang berjalan dalam hitungan detik dengan satu -satunya ketergantungan adalah Docker dengan penggunaan TestExamplesDotnet
• Otentikasi dan Otorisasi Menggunakan Token JWT. Ini juga digunakan oleh tes yang berarti Anda dapat memeriksa apakah otentikasi dan otorisasi Anda berfungsi dengan baik di dalam tes.
• Siap untuk OpenTelemetry
• LaunchProfile untuk Dotnet Watch
• Bangunan otomatis menggunakan tindakan GitHub yang memeriksa pemformatan kode, membangun, dan menjalankan tes.

Menjalankan tes

Hanya Docker yang diperlukan untuk menjalankan tes (Tip: Podman bebas digunakan). First Run dapat memakan waktu lebih lama karena gambar Docker diunduh. Jalankan perintah berikut untuk menjalankan tes:

dotnet test

Menjalankan aplikasi

1. Pertama menghasilkan JWT yang dapat Anda gunakan untuk pengujian lokal:

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

Catatan: Titik akhir pekerjaan dan departemen hanya memerlukan otentikasi tetapi titik akhir karyawan mengharuskan Anda memiliki klaim yang benar di token JWT.

2. Jalankan database menggunakan compose docker-compose.aml yang disediakan. Secara opsional juga menjalankan dasbor Aspire di file COMPOSE untuk dengan mudah melihat output OpenTelemetry.
3. Jalankan aplikasi. Anda dapat menjelajahi titik akhir menggunakan Swagger di https://localhost:7162/swagger .