dotnet clean arch

مثال العمارة النظيف في C#

يوفر هذا المستودع تنفيذًا للهندسة المعمارية النظيفة في حل C# يتكامل مع واجهة برمجة تطبيقات HTTP للطقس ، ودمج الأدوات الحديثة الأساسية مثل Prometheus و Grafana للمراقبة والملاحظة.

هيكل المشروع

يتبع هذا المشروع هيكل الهندسة المعمارية النظيفة:

• CleanArch.Api : طبقة API على الويب ، تحتوي على وحدات تحكم ، والتكوين ، وإعداد حقن التبعية.
• CleanArch.Domain : منطق الأعمال الأساسي والكيانات المجال.
• CleanArch.Application : المنطق الخاص بالتطبيق والاستخدام.
• CleanArch.Infrastructure : رمز البنية التحتية مثل تكامل الخدمة الخارجية واستمرار البيانات.

المكتبات والأدوات

يستخدم المشروع المكتبات والأدوات التالية:

• ASP.NET CORE : لبناء واجهة برمجة تطبيقات الويب.
• Serilog : للتسجيل.
• Prometheus.net : لفضح مقاييس التطبيق.
• Docker Compose : لتنسيق الخدمات مثل API و Prometheus و Grafana.

المراقبة والملاحظة

يتضمن المشروع ملف docker-compose.yml الذي ينشئ:

• بروميثيوس : لكشط المقاييس المكشوفة من قبل واجهة برمجة التطبيقات.
• غرافانا : لتصور المقاييس من بروميثيوس.

مقاييس نقطة نهاية

يعرض التطبيق مقاييس AT /metrics باستخدام مكتبة Prometheus.net .

تعليمات الإعداد

المتطلبات الأساسية

• Docker و Docker تأليف مثبت.
• Weatherstack API مفتاح لتكامل API الطقس.

خطوات

1. استنساخ المستودع:

git clone https://github.com/MatheusSw/dotnet-clean-arch.git
cd CleanArch

2. أضف مفتاح واجهة برمجة تطبيقات WeatherStack إلى متغيرات بيئة النظام الخاصة بك
3. بناء وتشغيل التطبيق باستخدام Docker Compose:

docker-compose up --build

4. الوصول إلى الخدمات:

• API : http: // localhost: 8080
• Prometheus : http: // localhost: 9090
• Grafana : http: // localhost: 3000

تصور المقاييس

1. قم بتسجيل الدخول إلى Grafana على http: // localhost: 3000 (المسؤول الافتراضي/المسؤول).
2. أضف بروميثيوس كمصدر بيانات. (استخدم بروميثيوس: 9090 كـ URL)
3. استيراد لوحات المعلومات التي تم تكوينها مسبقًا أو إنشاء لوحات مخصصة لمراقبة أداء واجهة برمجة التطبيقات.

مثال API نقاط نهاية

• Get /weathers?location=Brasil Sao Paulo : يجلب معلومات الطقس لموقع معين باستخدام Weatherstack API.