dotnet clean arch

ตัวอย่างสถาปัตยกรรมที่สะอาดใน C#

ที่เก็บนี้ให้การใช้งาน สถาปัตยกรรมที่สะอาด ในโซลูชัน C# ที่รวมเข้ากับ HTTP API สภาพอากาศรวมเครื่องมือที่ทันสมัยที่จำเป็นเช่น Prometheus และ Grafana สำหรับการตรวจสอบและสังเกตการณ์

โครงสร้างโครงการ

โครงการนี้เป็นไปตามโครงสร้างสถาปัตยกรรมที่สะอาด:

• CleanArch.Api : เลเยอร์ Web API ที่มีตัวควบคุมการกำหนดค่าและการตั้งค่าการฉีดพึ่งพา
• CleanArch.Domain : หลักธุรกิจหลักและหน่วยงานโดเมน
• CleanArch.Application : ตรรกะเฉพาะแอปพลิเคชันและกรณีการใช้งาน
• CleanArch.Infrastructure : รหัสโครงสร้างพื้นฐานเช่นการรวมบริการภายนอกและการคงอยู่ของข้อมูล

ห้องสมุดและเครื่องมือ

โครงการใช้ไลบรารีและเครื่องมือต่อไปนี้:

• ASP.NET CORE : สำหรับการสร้างเว็บ API
• Serilog : สำหรับการบันทึก
• prometheus.net : สำหรับการเปิดเผยตัวชี้วัดแอปพลิเคชัน
• Docker Compose : สำหรับบริการเตรียมการเช่น API, Prometheus และ Grafana

การตรวจสอบและการสังเกต

โครงการรวมไฟล์ docker-compose.yml ที่ตั้งค่า:

• โพร : เพื่อขูดตัวชี้วัดที่เปิดเผยโดย API
• Grafana : สำหรับการแสดงตัวชี้วัดจาก Prometheus

จุดสิ้นสุดตัวชี้วัด

แอปพลิเคชันเปิดเผยตัวชี้วัด AT /metrics โดยใช้ไลบรารี Prometheus.net

คำแนะนำการตั้งค่า

ข้อกำหนดเบื้องต้น

• ติดตั้ง Docker และ Docker
• คีย์ API Weatherstack สำหรับการรวม Weather API

ขั้นตอน

1. โคลนที่เก็บ:

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

2. เพิ่มคีย์ API Weatherstack ของคุณลงในตัวแปรสภาพแวดล้อมระบบของคุณ
3. สร้างและเรียกใช้แอปพลิเคชันโดยใช้ Docker Compose:

docker-compose up --build

4. เข้าถึงบริการ:

• API : http: // localhost: 8080
• โพร : http: // localhost: 9090
• Grafana : http: // localhost: 3000

การแสดงภาพตัวชี้วัด

1. เข้าสู่ Grafana ที่ http: // localhost: 3000 (ผู้ดูแลระบบเริ่มต้น/ผู้ดูแลระบบ)
2. เพิ่ม Prometheus เป็นแหล่งข้อมูล (ใช้ Prometheus: 9090 เป็น URL)
3. นำเข้าแดชบอร์ดที่กำหนดค่าไว้ล่วงหน้าหรือสร้างแบบกำหนดเองเพื่อตรวจสอบประสิทธิภาพ API

ตัวอย่างจุดสิ้นสุด API

• รับ /weathers?location=Brasil Sao Paulo : ดึงข้อมูลสภาพอากาศสำหรับสถานที่เฉพาะโดยใช้ WeatherStack API