منصوبے کے بارے میں

کلین آرکیٹیکچر ASP.NET Core ایپلیکیشنز بنانے کے لیے ایک سلوشن ٹیمپلیٹ ہے، جو کہ loosely-coupled (کم جڑے ہوئے) اور dependency-inverted (انحصار الٹ) انداز استعمال کرتا ہے، جسے hexagonal, ports-and-adapters یا onion architecture بھی کہا جاتا ہے۔ یہ dotnet CLI ٹیمپلیٹ (NuGet پر Ardalis.CleanArchitecture.Template) کے طور پر تقسیم کیا جاتا ہے اور GitHub ریپوزٹری کو کلون کرکے بھی استعمال کیا جا سکتا ہے۔ ٹیمپلیٹ دو شکلوں میں دستیاب ہے: ایک مکمل کلین آرکیٹیکچر ٹیمپلیٹ (clean-arch) اور ایک کم سے کم کلین آرکیٹیکچر ٹیمپلیٹ (min-clean)، تاکہ ٹیمیں شروع میں اپنی مطلوبہ ساخت کی مقدار منتخب کر سکیں۔ README میں ٹیمپلیٹ کا موازنہ اور استعمال کرنے کے بارے میں رہنمائی شامل ہے۔ حل (solution) الگ الگ پروجیکٹس میں منظم ہے: ایک Core پروجیکٹ، ایک Use Cases پروجیکٹ، ایک Infrastructure پروجیکٹ، اور ایک Web پروجیکٹ، نیز ٹیسٹ پروجیکٹس۔ README ہر ایک کے ڈیزائن فیصلوں اور انحصاروں کو دستاویز کرتا ہے، بشمول یہ کہ validation کہاں آتا ہے اور SharedKernel پیکیج کیسے فٹ ہوتا ہے۔ یہ استعمال شدہ پیٹرنز جیسے domain events کا بھی احاطہ کرتا ہے۔ بطور ڈیفالٹ ٹیمپلیٹ MVC کنٹرولرز یا Razor Pages کے بجائے API endpoints استعمال کرتا ہے۔ README وضاحت کرتا ہے کہ Ardalis.ApiEndpoints کو کیسے شامل کریں، کنٹرولرز کیسے شامل کریں، اور Razor Pages کیسے شامل کریں اگر کوئی مختلف پریزنٹیشن اسٹائل پسند کیا جائے۔ یہ database migrations چلانے کا بھی احاطہ کرتا ہے اور نوٹ کرتا ہے کہ سائٹ لوکل ہوسٹ کے لیے self-signed ڈیولپر سرٹیفکیٹ کے ساتھ HTTPS استعمال کرتی ہے، اور اگر Chrome سرٹیفکیٹ کی خرابی رپورٹ کرے تو تخفیف کی ہدایات کی طرف اشارہ دیتا ہے۔ مین برانچ .NET 9 کو ہدف بناتی ہے، جو NuGet پیکیج ورژن 10.x کے مساوی ہے؛ پچھلے ورژن پروجیکٹ کی ریلیزز کے ذریعے دستیاب ہیں۔ سرکاری دستاویزات، بشمول شروع کرنے کے اقدامات، مائیگریشن گائیڈز، اور آرکیٹیکچرل فیصلے، ایک علیحدہ دستاویزات سائٹ پر شائع ہوتی ہیں، اور README پرانے ورژنز سے اپ گریڈ کرتے وقت مائیگریشن گائیڈز کا جائزہ لینے کی تجویز دیتا ہے۔ README متعلقہ تعلیمی مواد کے لنکس بھی فراہم کرتا ہے، بشمول ایک کلین آرکیٹیکچر کورس، ایک DDD بنیادیات کا کورس جو اس آرکیٹیکچر کو استعمال کرتا ہے، لائیو اسٹریم ریکارڈنگز، اور پوڈ کاسٹ مباحثے۔ یہ نوٹ کرتا ہے کہ پروجیکٹ کو Amazon AWS کے FOSS فنڈ سے سپانسرشپ ملی ہے اور صارفین کو دعوت دیتا ہے کہ وہ ریپوزٹری کو اسٹار کریں یا اسپانسر کریں۔