آموزش Minimal API در ۹ ASP .NET Core

1.معرفی Minimal API و جایگاه آن در NET.

• چرا Microsoft این معماری را درNET 6. به بعد معرفی کرد؟
• مزایا و معایب استفاده از Minimal API    
• سناریوهای مناسب برای استفاده از Minimal API        

2.پیش نیازهای ورود به توسعه Minimal API

• آشنایی با زبان برنامه نویسی #C
• درک مفاهیم پایه ASP .NET Core
• آشنایی مقدماتی با معماری API و HTTP  

3.ابزارهای موردنیاز برای توسعه Minimal API

• NET 9 SDK.
• SQL Server 2022
• Visual Studio 2022
• ابزارهای تست API مانند Postman و Swagger UI

4.بررسی بنچمارک و عملکرد Minimal API 

• چرا Minimal API سریع‌تر است؟
• مقایسه عملکرد باWeb API/MVC در NET.
• بررسی حذف ساختارهای اضافه مانند Controller و Startup  

5.بررسی ساختار پروژه Minimal API

• ایجاد پروژه
• آشنایی با فایل Program.cs درمعماری جدید
• ساخت اولین Endpoint ساده و تست آن با Postman   
• بررسی جریان Request و Response در Minimal API جدول مقایسه ای بین Web API و Minimal API از نظر ساختار،عملکرد و … 
• توضیح در مورد حذف کلاس  Startup.cs و نقش مستقیم Program.cs در پیکربندی.

1.بررسی Roadmap    

2.مفهوم API

•  API چیست (Application Programming Interface)
• انواع API (Public ،Private ،Partner)
• نحوه کارکرد

3.Web Service چیست و چه تفاوتی با API دارد؟

• تعریف Web Service ،SOAPXML
• تفاوت Web API (RESTful)باWeb Service

4.Webhook چیست و چه زمانی از آن استفاده میشود؟

• تعریف Webhook     
• سناریوهای عملی استفاده از Webhook   

5.مقایسه API ،Web Service و Webhook 

• جدول مقایسه ویژگی‌ها ProtocolFormat ،Real-time، مصرف منابع و … 
• بررسی انتخاب درست بر اساس نیاز پروژه
• مثال واقعی از هر نوع API   

1.بررسی معماری RESTful

• REST چیست؟ (Representational State Transfer)
• اصول ششگانه معماری REST Stateless ،Uniform Interface ،Cacheable و …
• مزایا و معایب REST در مقابل سایر معماری‌ها
• مثال کاربردی از طراحی یک RESTful API  

2.بررسی معماریgRPC

•  GRPC چیست؟
• معرفی Protobuf (Protocol Buffers) به عنوان فرمت ارتباطی
• ارتباط بر پایه HTTP/2 و مزایای آن
• سناریوهای مناسب برای استفاده از GRPC     
• مقایسه عملکرد GRPC با REST 

3.بررسی معماری GraphQL

• GraphQL چیست و چه تفاوتی با REST دارد؟
• ساختار Query-based برای دریافت فقط داده‌های مورد نیاز
• محدودیت‌ها و چالش‌های GraphQL

1.آشنایی با مفاهیم پایه API (API Terms)

• بررسی Client،Server ،Endpoint ،Resource ،Payload
• تعریف دقیق تفاوت بین URI ،URL و URN
• مفهوم Base URL وPath
• Query Strin و کاربرد آن در فیلتر، صفحه بندی و جستجو

2.HTTP Verb چیست و چه کاربردی دارد؟ (HTTP Methods)

• تعریف HTTP Verb به عنوان عملیات روی منابع
• GET دریافت اطلاعات (Read-Only)
•  POST ایجاد یک رکورد جدید
•  PUT به روزرسانی کامل (Update)
•  PATCH به روزرسانی جزئی (Partial Updat)
• DELETEحذف اطلاعات
• تفاوت بین PUT و PATCH در کاربردهای واقعی
• رعایت اصول REST در انتخاب متد صحیح

3.آشنایی باStatus Code و نقش آن در ارتباط Client-Server

• ساختار Status Code
•  1XX اطلاعاتی (Informational)
• 2xx موفق (Success)
• 3xx ریدایرکت (Redirection)
• 4xx خطای سمت کالینت 
•  5xx خطای سمت سرور

4.آشنایی با HTTP Headers 

• تعریف Header و نقش آن در تنظیمات
• Header‌های رایج:
•  Content-Type نوع داده ارسالی/دریافتی
•  Authorization احراز هویت و توکنها(Bearer Token ،JWT)
•   Accept نوع داده مورد انتظار از سمت کلاینت
•  Cache-Control کنترل کش شدن محتوا

1.بررسی پروژه Product Management API 

• معرفی ویژگی‌ها و قابلیت‌‌های اصلی سیستم
• بررسی نیازمندی‌های پروژه API برای مدیریت محصولات
• بررسی معماری کلی پروژه و تصمیمات طراحی
• دیاگرام از Domain Model طراحی شده.

2.ایجاد پروژه

• نحوه ایجاد یک پروژه جدید با استفاده از NET 9 Minimal API.
• ساختار اولیه پروژه و چگونگی تنظیم مسیرها (Routing)

3.نصب پکیج های موردنیاز

• نصب پکیج‌های موردنیازمانند Entity Framework Core و SQL Server
• پیکربندی بسته‌های اضافی مثل Fluent Validation برای اعتبارسنجی داده‌ها
• نصب پکیج‌های مربوط به Swagger برای مستندسازی API  

4.ایجاد Domain Model

• طراحی مدل‌های داده‌ای (Domain Models) برای محصولات، دسته بندی‌ها و …
• چگونگی ایجاد کلاس‌های Product ،Category و مدل‌های دیگر
• استفاده از Fluent API برای تنظیمات مدل‌ها
• مدلسازی روابط مختلف میان داده‌ها (یک به چند، چند به چند)

5.ایجاد بانک اطالعاتیSQL Server

• پیکربندی اتصال به SQL Server  
• استفاده از Entity Framework Core برای پایگاه داده
• افزودن Seed Data برای اضافه کردن داده‌های پیش‌فرض به پایگاه داده
• تنظیمات مورد نیاز در appsettings.json  

1.پیاده سازی لایه Service برای موجودیت‌ها (Entities Service)

• ایجاد Interface و Class‌های سرویس مانند Product ،Category و … 
• اعمال وابستگی‌ها با استفاده از Dependency Injection   
• تعریف متدهای اصلی درسرویس ها GetAll ،GetById ،Create ،Update ،Delete   
• رعایت اصول SOLID

2.پیاده سازی عملیات کامل CRUD برای موجودیت‌ها

• نوشتنHandlerهای Minimal API برای مدیریت عملیات CRUD
• استفاده از Route Mapping و Endpoints با الگوی Minimal API 
• استفاده از DTOها برای جداسازی لایه ای مدل از ورودی‌ها و خروجی‌ها
• معرفی Mpaster و AutoMapper برای تبدیل بین DTO و Model

1.پیاده سازی احراز هویت (Authentication) با استفاده از JWT) JSON Web Token)

• مفهوم JWT و معماری توکن در احراز هویت
• پیاده سازی Endpoint ورود (Login) و صدورJWT
• استفاده از Middleware برای اعتبارسنجی توکن در درخواست‌ها
• افزودن ویژگی‌های امنیتی مانند Role-based Access Control برای تعیین سطح
  دسترسی کاربران
• افزودن پیاده سازی Refresh Token همراه با انقضایJWT

2.جلوگیری از حملات CORS          

• توضیح مفهوم CORS و اهمیت آن در APIهای عمومی
• سناریوهایی که نیاز به تنظیم CORS دارند.
• پیکربندی دقیق CORS در AllowSpecificOrigins ،AllowAnyMethod 

3.جلوگیری از حملات CSRF (Cross-Site Request Forgery)  

• تفاوتCSRF و XSS 
• روش های جلوگیری: استفاده از توکن ضد CSRF در فرم‌ها و یا ارسال‌های خاص

1.ساختار دهی بهتر وبهینه‌تر Endpoints 

• گروه بندی و تفکیک منطقی Endpoints برای خوانایی و توسعه پذیری
• رعایت اصول RESTful برای نام‌گذاری و ساختار مسیرها
• استفاده از Route Prefix و دسته‌بندی بر اساس Resource 
• استفاده از مفهوم API Versioning (Query ،Header ،URL) 

2.پوشش رفتارهای منطقی در خطاها و نتایج

• مدیریت خطاهای رایج: داده نامعتبر، یافت نشدن رکورد، خطاهای دیتابیس
• برگرداندن پاسخ های استاندارد همراه با وضعیت مناسب (API Response)

3.کار باخروجی‌ها در Swagger   

• تست کامل متدهای CRUD از طریقSwagger UI
• بررسی و دیباگ خروجی‌ها با استفاده از Postman و Swagger

1.رایج حمله مانند DoS و سوءاستفاده از API

• معرفی سیاست‌های محدودسازی(Fixed Window ،Sliding Window ،Token Bucket)
• شخصی سازی محدودیت بر اساس IP

2.افزودنPagination

• دلیل استفاده از Pagination در لیست‌ها
• طراحی ورودی‌های استاندارد (Page Number, Page Size)
• پیاده سازی ساده و کارآمد با Entity Framework باSkip و Take

3.مدیریتOver-FetchingوUnder-Fetchingداده ها

• تعریفOver-fetchingوUnder-fetching در API
• چرا این موارد باعث کندی یا افزایش هزینه می‌شوند؟
• راهکارهای جلوگیری: استفاده از DTOهای سفارشی، انتخاب ستون‌های مورد نیاز