دوره Minimal API با NET 10. و #C

آنچه یاد خواهید گرفت:

• ساخت APIهای سریع و تمیز با استفاده از معماری Minimal API در NET 10.
• پیاده‌سازی احراز هویت و مجوزهای مبتنی بر نقش ایجاد کامل اندپوینت‌های CRUD با Entity Framework Core
• ادغام PostgreSQL برای عملیات‌های واقعی پایگاه داده
• مدیریت آپلود امن تصاویر و تحویل فایل
• مستندسازی API با Swagger و پیکربندی سفارشی
• استقرار اپلیکیشن با Docker و Railway

پیش‌نیازهای دوره

• دانش اولیه برنامه‌نویسی
• کامپیوتر با سیستم‌عامل Windows 10/11 و دسترسی به اینترنت
• همه نرم‌افزارها رایگان هستند - لینک‌ها توسط مدرس ارائه خواهد شد.

توضیحات دوره

به دوره Minimal API با NET 10. و #C خوش آمدید، جامع‌ترین و کاربردی‌ترین دوره موجود برای تسلط بر توسعه APIهای مدرن با استفاده از معماری ساده‌شده Minimal API مایکروسافت.

در این دوره عملی و پروژه‌محور، شما یک API کاملاً کاربردی و آماده برای تولید خواهید ساخت که برای مدیریت سایت‌های تحقیقاتی فرضی، مصنوعات، رکوردهای کاتالوگ، فایل‌های رسانه‌ای و حساب‌های کاربری در سیستم Aeon Registry استفاده می‌شود.

چه در NET. تازه‌کار باشید و چه در حال انتقال از کنترلرهای MVC باشید، این دوره شما را گام‌به‌گام در طراحی، ساختاردهی، ساخت، مستندسازی و استقرار یک اپلیکیشن واقعی مطابق با بهترین شیوه های صنعت راهنمایی می‌کند.

چرا این دوره متمایز است؟

این یک API نمایشی ساده نیست. شما یک سیستم چندلایه کامل را با ویژگی‌های زیر معماری خواهید کرد:

• احراز هویت و مجوزدهی مبتنی بر نقش
• اندپوینت‌های Identity API (با بازنویسی‌های سفارشی)
• سیستم‌های مدیریت سایت و Artifact کاملاً طراحی شده
• معماری اندپوینت‌های عمومی و خصوصی
• آپلود رسانه، اعتبارسنجی و تحویل تصویر باینری
• ادغام PostgreSQL از طریق Entity Framework Core
• مدیریت خطا و فیلترها در سطح تولید
• مستندسازی Swagger با برندینگ اختصاصی
• استقرار در Railway با استفاده از Docker
• میزبانی فایل‌های استاتیک، نقشه‌ها و صفحه اصلی

هر ویژگی نه به صورت تئوری، بلکه از طریق پیاده‌سازی واقعی آموزش داده می‌شود.

آنچه یاد خواهید گرفت:

در پایان این دوره، شما قادر خواهید بود اپلیکیشن‌های Minimal API در سطح حرفه‌ای بسازید، از جمله:

معماری Minimal API

• سازماندهی پروژه‌ها با استفاده از Entityها، DTOها، سرویس‌ها، فیلترها و گروه‌های اندپوینت
• پیاده‌سازی الگوهای CRUD منسجم برای اندپوینت‌ها
• به‌کارگیری تکنیک‌های Projection و Mapping برای مدل‌های پاسخ

احراز هویت و مجوزدهی 

• افزودن ASP.NET Identity از طریق رویکرد Minimal API
• Map کردن اندپوینت‌های داخلی Identity (ثبت نام، ورود، بازنشانی رمز عبور و غیره)
• پیکربندی پالیسی‌های سفارشی و دسترسی مبتنی بر نقش
• بازنویسی اندپوینت پیش‌فرض ثبت نام برای ورود کنترل‌شده توسط ادمین
• تولید و ارسال لینک‌های بازنشانی رمز عبور برای کاربران جدید

ویژگی‌های واقعی اپلیکیشن

• ساخت ده‌ها اندپوینت در بخش‌های سایت‌ها، Artifactها و فایل‌های رسانه‌ای
• بازگرداندن نسخه‌های عمومی در مقابل خصوصی از همان داده‌ها
• طراحی اندپوینت‌های تو در تو مانند دریافت Artifactها بر اساس سایت
• جداسازی وظایف در لایه‌های سرویس و مسیریابی

ادغام پایگاه داده با PostgreSQL

• پیکربندی EF Core DbContext برای PostgreSQL
• درک Navigation Properties و روابط یک‌به‌چند
• استفاده از کوئری‌های غیرهمزمان، Projections و بارگذاری مشتاقانه 

آپلود امن رسانه

• پردازش آپلود فایل‌های چندبخشی
• اعتبارسنجی انواع MIME، پسوندهای فایل و بایت‌های جادویی 
• اعمال محدودیت‌های حجم فایل
• ارائه تصاویر باینری با هدرهای کشینگ 

روش‌های ساخت API در سطح تولید

• پیاده‌سازی فیلتر متمرکز برای مدیریت خطا
• افزودن برندینگ و مستندسازی سفارشی به Swagger
• سازماندهی گروه‌های اندپوینت با متادیتای مشترک
• میزبانی فایل‌های استاتیک و ساخت صفحه ورودی فرانت‌اند سبک

استقرار ابری و DevOps

• کانتینرسازی API با Docker
• استقرار در Railway با استفاده از ادغام GitHub
• مدیریت DATABASE_URL در Railway با استفاده از تولید داینامیک Connection String
• انتشار Swagger در محیط‌های تولید
• پیکربندی متغیرهای محیطی و میزبانی استاتیک

آنچه خواهید ساخت:

در طول دوره، شما Aeon Registry Minimal API کامل را خواهید ساخت، یک بک‌اند واقعی که برای مدیریت تحقیقات و کاتالوگ Artifactها طراحی شده است.

API مدیریت سایت

• ایجاد، بروزرسانی، حذف و دریافت سایت‌های تحقیقاتی
• بازگرداندن هم خلاصه‌های عمومی و هم شرح تحقیقاتی خصوصی
• ساخت مسیرهای تو در تو برای Artifactهای متعلق به یک سایت

سیستم کاتالوگ Artifact

• ایجاد و مدیریت رکوردهای Artifact
• پشتیبانی از روابط بین Artifactها، سایت‌ها، فایل‌های رسانه‌ای و یادداشت‌های کاتالوگ
• ارائه اندپوینت‌های عمومی و خصوصی با مدل‌های پاسخ متفاوت

سیستم آپلود و بازیابی رسانه

• آپلود و ذخیره‌سازی فایل‌های تصویری
• اعتبارسنجی محتوا، اندازه و نوع تصویر
• ارائه داده‌های تصویر باینری به صورت عمومی
• مدیریت انتخاب تصویر اصلی برای Artifactها

مدیریت هویت و کاربر

• پیاده‌سازی ASP.NET Core Identity با استفاده از Minimal APIs
• افزودن منطق ثبت نام سفارشی برای مدیران
• تخصیص نقش‌هایی مانند «محقق»
• ارسال لینک‌های تنظیم رمز عبور از طریق ایمیل

استقرار ابری با Docker و Railway

• ساخت و استقرار یک اپلیکیشن داکرایز شده
• افزودن و پیکربندی پایگاه داده PostgreSQL در Railway
• مدیریت متغیرهای محیطی و Connection Stringهای خودکار
• میزبانی فایل‌های استاتیک و نمایشگر نقشه
• راه‌اندازی CI/CD با GitHub

مباحث پوشش داده شده به صورت عمیق

مفاهیم Minimal API

• گروه‌های اندپوینت 
• طراحی Handler
• نتایج نوع‌دار 
• فیلترهای استثنا 
• انتزاع سرویس 

هویت و امنیت

• احراز هویت JWT
• پالیسی‌های مبتنی بر نقش
• Onboarding سفارشی

Entity Framework Core

• Entityها، کلیدهای خارجی، Navigation Properties
• بارگذاری مشتاقانه با Include
• Projectionها با LINQ
• عملیات‌های پایگاه داده غیرهمزمان

مدیریت رسانه

• پردازش امن فایل‌های چندبخشی
• بررسی بایت هدر 
• اعتبارسنجی سایز و نوع فایل
• فرمت‌دهی پاسخ باینری

استقرار ابری

• پیکربندی Dockerfile
• میزبانی در Railway
• Swagger در محیط تولید
• میزبانی فایل استاتیک

مخاطبان این دوره

• توسعه‌دهندگانی که برای اولین بار Minimal APIها را یاد می‌گیرند.
• توسعه‌دهندگان ASPNET. MVC که می‌خواهند الگوهای مدرن را اتخاذ کنند.
• دانشجویانی که اولین اپلیکیشن بک‌اند کامل خود را می‌سازند.
• مهندسانی که برای نقش‌های بک‌اند یا فول‌استک آماده می‌شوند.
• هر کسی که می‌خواهد تجربه عملی در استقرار یک API واقعی دات‌نت در فضای ابری داشته باشد.

پروژه نهایی شما

پس از تکمیل دوره، شما یک API کاملاً مستقر شده و آماده برای تولید خواهید داشت که شامل موارد زیر است:

• یک سیستم احراز هویت و مجوزدهی کامل
• جداسازی داده‌های عمومی و خصوصی
• یک سیستم آپلود رسانه امن با اعتبارسنجی
• عملیات‌های End-to-end CRUD برای منابع متعدد
• ادغام PostgreSQL از طریق EF Core
• یک داشبورد Swagger با برندینگ اختصاصی
• یک اپلیکیشن مستقر شده در Railway
• یک صفحه اصلی استاتیک و نمایشگر نقشه تعاملی
• اتوماسیون CI/CD از طریق GitHub

این یک پروژه در سطح پورتفولیو است که مهارت‌های عملی و مدرن توسعه بک‌اند را نشان می‌دهد.

این دوره برای چه کسانی مناسب است؟

• توسعه‌دهندگان فول‌استک مشتاق که آماده‌اند یک پورتفولیوی قوی بسازند.
• برنامه‌نویسان جونیور تا میدل که به‌دنبال ارتقای مهارت‌های خود هستند.
• فارغ‌التحصیلان بوت‌کمپ و افرادی که تغییر مسیر شغلی داده‌اند و می‌خواهند در ساخت اپلیکیشن‌های سازمانی اعتمادبه‌نفس و تجربه کسب کنند.
• توسعه‌دهندگان باتجربه‌ای که به‌دنبال جدیدترین دانش در ‎.NET 10‎ و Minimal API هستند.