CleanAspCoreWebApiTemplate

نموذج ASP .NET الحد الأدنى من واجهة برمجة التطبيقات

هذا هو مستودع قالب يوضح كيف يمكن للمرء تنفيذ واجهة برمجة تطبيقات نظيفة مع ASP.NET باستخدام الحد الأدنى من واجهات برمجة التطبيقات. التركيز على "الميزات" في هذا القالب على إنتاجية Dev ، تم الحفاظ على الميزات الفعلية لواجهة برمجة التطبيقات (API) نفسها عن قصد. لا تتردد في نسخ هذا المستودع أو إعادة استخدام أجزاء منه ، لا تنسى إعطاء نجمة إذا قمت بذلك.

بعض الميزات في هذا القالب:

• بنية الشريحة العمودية (التجميع على أساس الميزات بدلاً من الطبقات الفنية)
• إعداد سهل الاستخدام وسريع لتشغيل اختبارات التكامل التي تعمل في ثوان مع التبعية الوحيدة هي Docker مع استخدام testexamplesDotnet
• المصادقة والترخيص باستخدام الرموز JWT. يتم استخدام هذا أيضًا من خلال الاختبارات مما يعني أنه يمكنك التحقق مما إذا كانت المصادقة والتفويض تعمل بشكل صحيح داخل الاختبارات.
• جاهز لقياس الأوبنتيل
• LaunchProfile لـ Dotnet Watch
• البناء الآلي باستخدام إجراءات github التي تتحقق من تنسيق الكود وإنشاء وتشغيل الاختبارات.

إجراء اختبارات

مطلوب Docker فقط لتشغيل الاختبارات (نصيحة: Podman مجاني للاستخدام). يمكن أن يستغرق التشغيل الأول وقتًا أطول قليلاً حيث يتم تنزيل صورة Docker. قم بتشغيل الأمر التالي لتشغيل الاختبارات:

dotnet test

تشغيل التطبيق

1. قم أولاً بإنشاء JWT الذي يمكنك استخدامه للاختبار المحلي:

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

ملاحظة: تتطلب نقاط نهاية الوظائف ونقاط القسم المصادقة فقط ، لكن نقاط نهاية الموظف تتطلب أن يكون لديك المطالبات الصحيحة في رمز JWT.

2. قم بتشغيل قاعدة البيانات باستخدام Docker-corm.yaml. اختياريًا أيضًا قم بتشغيل لوحة معلومات Aspire في ملف Compose لرؤية إخراج قياس الأوبنتيل بسهولة.
3. تشغيل التطبيق. يمكنك استكشاف نقاط النهاية باستخدام Swagger في https://localhost:7162/swagger .