Test_Store.Application => Services => Users => Queries => GetUsers => GetUsersDto.cs نام‌فضا (Namespace) csharp namespace Test_Store.Application.Services.Users.Queries.GetUsers این خط، نام‌فضا (namespace) Test_Store.Application.Services.Users.Queries.GetUsers را تعریف می‌کند. نام‌فضاها برای سازماندهی و دسته‌بندی کدها استفاده می‌شوند. کلاس GetUsersDto csharp public class GetUsersDto { public long Id { get; set; } public string FullName { get; set; } public string Email { get; set; } } public class GetUsersDto: این خط کلاس GetUsersDto را تعریف می‌کند. Dto مخفف "Data Transfer Object" است که برای انتقال داده‌ها بین لایه‌های مختلف یک برنامه استفاده می‌شود. public long Id { get; set; }: این پراپرتی شناسه‌ی منحصربه‌فرد (ID) برای کاربر را نشان می‌دهد. این شناسه از نوع long است. public string FullName { get; set; }: این پراپرتی نام کامل کاربر را ذخیره می‌کند. این نام از نوع string است. public string Email { get; set; }: این پراپرتی ایمیل کاربر را ذخیره می‌کند. این ایمیل از نوع string است. نتیجه‌گیری کلاس GetUsersDto یک Data Transfer Object (DTO) ساده است که برای انتقال اطلاعات مربوط به کاربران بین لایه‌های مختلف برنامه استفاده می‌شود. این کلاس شامل سه پراپرتی Id، FullName و Email است که به ترتیب شناسه، نام کامل و ایمیل کاربر را نگهداری می‌کنند.

Test_Store.Application => Services => Users => Queries => GetUsers => RequestGetUserDto.cs نام‌فضا (Namespace) csharp namespace Test_Store.Application.Services.Users.Queries.GetUsers این خط، نام‌فضا (namespace) Test_Store.Application.Services.Users.Queries.GetUsers را تعریف می‌کند. نام‌فضاها برای سازماندهی و دسته‌بندی کدها استفاده می‌شوند. کلاس RequestGetUserDto csharp public class RequestGetUserDto { public string SearchKey { get; set; } public int Page { get; set; } } public class RequestGetUserDto: این خط یک کلاس به نام RequestGetUserDto تعریف می‌کند. public string SearchKey { get; set; }: این پراپرتی یک کلید جستجو (SearchKey) از نوع string را ذخیره می‌کند. این کلید جستجو برای فیلتر کردن کاربران بر اساس نام یا ایمیل استفاده می‌شود. public int Page { get; set; }: این پراپرتی شماره صفحه‌ای (Page) را ذخیره می‌کند که کاربران باید در آن نمایش داده شوند. این ویژگی برای صفحه‌بندی کاربران استفاده می‌شود. نتیجه‌گیری کلاس RequestGetUserDto یک Data Transfer Object (DTO) است که برای انتقال داده‌های مربوط به درخواست دریافت کاربران بین لایه‌های مختلف برنامه استفاده می‌شود. این کلاس شامل دو پراپرتی SearchKey (کلید جستجو) و Page (شماره صفحه) است که به ترتیب برای فیلتر کردن و صفحه‌بندی کاربران استفاده می‌شوند.

اضافه کردن ایترفیس و کلاس ارث بری در program افزودن سرویس‌ها به کانتینر DI (Dependency Injection) csharp builder.Services.AddScoped<IDataBaseContext, DataBaseContext>(); builder.Services.AddScoped<IGetUsersService, GetUsersService>(); builder.Services.AddScoped<IGetRolesService, GetRolesService>(); AddScoped<IDataBaseContext, DataBaseContext>(); تعریف: این خط به DI Container می‌گوید که هر بار که نیاز به IDataBaseContext وجود دارد، یک نمونه از DataBaseContext ایجاد کند. و Scope: Scoped به این معنی است که یک نمونه جدید برای هر درخواست HTTP ساخته می‌شود و تا پایان آن درخواست استفاده می‌شود. AddScoped<IGetUsersService, GetUsersService>(); تعریف: این خط به DI Container می‌گوید که هر بار که نیاز به IGetUsersService وجود دارد، یک نمونه از GetUsersService ایجاد کند. و Scope: همانند IDataBaseContext، Scoped به این معنی است که یک نمونه جدید برای هر درخواست HTTP ساخته می‌شود. AddScoped<IGetRolesService, GetRolesService>(); تعریف: این خط به DI Container می‌گوید که هر بار که نیاز به IGetRolesService وجود دارد، یک نمونه از GetRolesService ایجاد کند. و Scope: باز هم، Scoped به این معنی است که یک نمونه جدید برای هر درخواست HTTP ساخته می‌شود. نتیجه‌گیری این خطوط کد سه سرویس مختلف را به DI Container اضافه می‌کنند و به برنامه شما اجازه می‌دهند تا وابستگی‌ها را به طور خودکار تزریق کند. هر سرویس با استفاده از الگوی Scoped ایجاد می‌شود، به این معنی که یک نمونه جدید برای هر درخواست HTTP ایجاد می‌شود.

EndPoint.Site => Areas => Admin => Controllers => UsersController.cs نام‌فضا (Namespace) csharp namespace EndPoint.Site.Areas.Admin.Controllers این خط، نام‌فضا (namespace) EndPoint.Site.Areas.Admin.Controllers را تعریف می‌کند. نام‌فضاها برای سازماندهی و دسته‌بندی کدها استفاده می‌شوند. استفاده از Area csharp [Area("Admin")] این خط کنترلر را به یک ناحیه (Area) به نام Admin اختصاص می‌دهد. Areas در ASP.NET Core برای تقسیم‌بندی منطق برنامه به بخش‌های جداگانه استفاده می‌شود. تعریف کلاس UsersController csharp public class UsersController : Controller این خط کلاس UsersController را تعریف می‌کند که از کلاس پایه Controller ارث‌بری می‌کند. متغیرهای خصوصی و سازنده csharp private readonly IGetUsersService _getUsersService; private readonly IGetRolesService _getRolesService; public UsersController(IGetUsersService getUsersService, IGetRolesService getRolesService) { _getUsersService = getUsersService; _getRolesService = getRolesService; } متغیرهای خصوصی: دو متغیر خصوصی از نوع اینترفیس‌های IGetUsersService و IGetRolesService تعریف می‌شوند که برای دریافت کاربران و نقش‌ها استفاده می‌شوند. سازنده: سازنده UsersController دو پارامتر از نوع اینترفیس‌های ذکر شده را دریافت کرده و آن‌ها را به متغیرهای خصوصی اختصاص می‌دهد. این پارامترها از طریق DI (Dependency Injection) تزریق می‌شوند. متد Index csharp public IActionResult Index(string serchKey, int page = 1) { return View(_getUsersService.Execute(new RequestGetUserDto { Page = page, SearchKey = serchKey, })); } public IActionResult Index(string serchKey, int page = 1): این متد برای نمایش صفحه اصلی کاربران استفاده می‌شود. پارامترهای serchKey و page برای جستجو و صفحه‌بندی استفاده می‌شوند. بازگشت View: این متد نتیجه اجرای متد Execute از سرویس IGetUsersService را به ویو بازمی‌گرداند. این نتیجه شامل لیستی از کاربران و تعداد کل کاربران است. متد Create csharp [HttpGet] public IActionResult Create() { ViewBag.Roles = new SelectList(_getRolesService.Execute().Data, "Id", "Name"); return View(); } [HttpGet]: این اتریبیوت نشان می‌دهد که این متد فقط برای درخواست‌های GET مورد استفاده قرار می‌گیرد. public IActionResult Create(): این متد برای نمایش فرم ایجاد کاربر جدید استفاده می‌شود. ViewBag.Roles: این خط نقش‌ها را از سرویس IGetRolesService دریافت کرده و آن‌ها را در ViewBag ذخیره می‌کند تا در ویو به صورت لیست کشویی نمایش داده شوند. بازگشت View: این متد ویو Create را نمایش می‌دهد که شامل فرم ایجاد کاربر جدید است. نتیجه‌گیری این کنترلر UsersController برای مدیریت کاربران در ناحیه Admin استفاده می‌شود. شامل دو متد اصلی است: Index: برای نمایش لیست کاربران با قابلیت جستجو و صفحه‌بندی. Create: برای نمایش فرم ایجاد کاربر جدید و دریافت نقش‌ها از دیتابیس و نمایش آن‌ها به صورت لیست کشویی. این ساختار کنترلر به شما امکان می‌دهد تا کاربران و نقش‌ها را به صورت کارآمد مدیریت کنید و از DI برای تزریق وابستگی‌ها استفاده کنید.

در packing manager console عبارت Add-Migration AddRoles و بعد Update-Database وارد کنید

قسمت آخر user ثبت نام و ورود واقعا ببخشید که کد های من زمان زیادی طول کشید بعدا کد ها را توضیح می دهم

ساختار درختی پوشه و فایل Test_Store │ ├── Doc │ ├── Src │ ├── Common │ │ └── library: Test_Store.Common │ │ ├── Dto │ │ │ └── ResultDto.cs │ │ ├── Roles │ │ │ └── UserRoles.cs │ │ ├── Pagination.cs │ │ └── PasswordHasher.cs │ │ │ ├──── Core │ │ ├──── library: Test_Store.Application │ │ │ ├── Interfaces │ │ │ │ ├── Contexs │ │ │ │ │ └── IDataBaseCotex.cs │ │ │ │ └── FacadPatterns │ │ │ │ └── IProductFacad.cs │ │ │ └── Services │ │ │ ├── Users │ │ │ │ ├── Commands │ │ │ │ │ ├── EditUser │ │ │ │ │ │ └── IEditUserService.cs │ │ │ │ │ ├── RegisterUser │ │ │ │ │ │ └── IRegisterUserService.cs │ │ │ │ │ ├── RemoveUser │ │ │ │ │ │ ├── IRemoveUserService.cs │ │ │ │ │ │ └── RemoveUserService.cs │ │ │ │ │ ├── UserLogin │ │ │ │ │ │ └── IUserLoginService.cs │ │ │ │ │ └── UserSatusChange │ │ │ │ │ └── IUserSatusChangeService.cs │ │ │ │ └── Queries │ │ │ │ ├── GetRoles │ │ │ │ │ ├── GetRolesService.cs │ │ │ │ │ ├── IGetRolesService.cs │ │ │ │ │ └── RolesDto.cs │ │ │ │ └── GetUsers │ │ │ │ ├── GetUsersDto.cs │ │ │ │ ├── GetUsersService.cs │ │ │ │ ├── IGetUsersService.cs │ │ │ │ ├── RequestGetUserDto.cs │ │ │ │ └── ReslutGetUserDto.cs │ │ │ └── Products │ │ │ ├── Commands │ │ │ │ └── AddNewCategory │ │ │ │ └── IAddNewCategoryService.cs │ │ │ ├── FacadPattern │ │ │ │ └── ProductFacad.cs │ │ │ └── Queries │ │ │ └── GetCategories │ │ │ └── IGetCategoriesService.cs │ │ │ │ │ └── library: Test_Store.Domain │ │ └── Entities │ │ ├── Users │ │ │ ├── Role.cs │ │ │ ├── User.cs │ │ │ └── UserInRole.cs │ │ ├── Commons │ │ │ ├── BaseEntity.cs │ │ │ └── BaseEntityNotId.cs │ │ └── Products │ │ └── Category.cs │ │ │ ├── Infrastructure │ │ ├── library: Test_Store.Infrastructure │ │ └── library: Test_Store.Persistence │ │ ├── Context │ │ │ └── DataBaseContext.cs │ │ └── Migrations │ │ ├── ......_Users.cs │ │ └── DataBaseContextModelSnapshot.cs │ │ │ └── Presentation │ └── ASP.NET Core: EndPoint.Site │ │ │ ├── Areas │ │ └── Admin │ │ ├── Controllers │ │ │ └── UsersController.cs │ │ ├── Views │ │ │ ├── Shared │ │ │ │ └── _AdminLayout.cshtml │ │ │ └── Users │ │ │ ├── Create.cshtml │ │ │ └── Index.cshtml │ │ └── Models │ ├── Controllers │ │ ├── AuthenticationController.cs │ │ └── HomeController.cs │ ├── Views │ │ ├── Authentication │ │ │ ├── Signin.cshtml │ │ │ └── Signup.cshtml │ │ ├── Home │ │ │ ├── Index.cshtml │ │ │ └── Privacy.cshtml │ │ ├── Shared │ │ │ ├── _Layout.cshtml │ │ │ ├── _ValidationScriptsPartial.cshtml │ │ │ └── Error.cshtml │ │ ├── _ViewImports.cshtml │ │ └── _ViewStart.cshtml │ ├── Models │ │ ├── ViewModels │ │ │ └── AuthenticationViewModel

│ │ │ └── SignupViewModel.cs │ │ └── ErrorViewModel.cs │ ├── wwwroot │ │ ├── AdminTemplate │ │ ├── css │ │ ├── js │ │ ├── lib │ │ ├── SiteTemplate │ │ └── favicon.ico │ └── Program.cs │ └── Test

ساختار درختی user ثبت نام و ورود

Test_Store.Common => PasswordHasher.cs بیایید با توضیح کد

PasswordHasher

که در کلاس

Test_Store.Common.PasswordHasher

قرار دارد، شروع کنیم. این کلاس به منظور هش و تأیید رمز عبور‌ها طراحی شده است و از الگوریتم‌های مختلفی استفاده می‌کند. توضیحات کد: 1. Properties (ویژگی‌ها): -

bool _useAspNetCore

: مشخص می‌کند که آیا از کتابخانه Microsoft.AspNetCore.Cryptography.KeyDerivation استفاده می‌شود یا خیر. -

byte _formatMarker

: نشانگر قالب هش (مانند IdentityV2, IdentityV3, Custom). -

KeyDerivationPrf _prf

: تابع اشتقاق کلید مورد استفاده (مانند HMACSHA256). -

HashAlgorithmName _hashAlgorithmName

: نام الگوریتم هش مورد استفاده (مانند SHA256). -

bool _includeHeaderInfo

: مشخص می‌کند که آیا اطلاعات پیکربندی در هدر قرار داده می‌شود یا خیر. -

int _saltLength

: طول نمک. -

int _requestedLength

: طول کلید مشتق شده. -

int _iterCount

: تعداد تکرارهای الگوریتم PBKDF2. 2. Constructor (سازنده): - سازنده کلاس

PasswordHasher

پیش‌فرض‌ها را تنظیم می‌کند. در این مثال، تنظیمات IdentityV3 با HMACSHA256 و 10000 تکرار استفاده شده است. 3. HashPassword Method (متد HashPassword): - این متد یک رمز عبور را هش می‌کند. ابتدا یک نمک تولید می‌کند، سپس کلید مشتق شده (subkey) را با استفاده از PBKDF2 تولید می‌کند و نهایتاً خروجی به دست آمده را به صورت Base64 بازمی‌گرداند. 4. VerifyPassword Method (متد VerifyPassword): - این متد رمز عبور ورودی را با رمز عبور هش شده مقایسه می‌کند. ابتدا رمز عبور هش شده را تجزیه و تحلیل می‌کند، سپس رمز عبور ورودی را هش می‌کند و کلیدهای مشتق شده (subkeys) را با هم مقایسه می‌کند. 5. Helper Methods (متدهای کمکی): -

ByteArraysEqual

: دو آرایه بایت را برای برابری مقایسه می‌کند. -

ReadNetworkByteOrder

: خواندن یک مقدار UInt32 از آرایه بایت. -

WriteNetworkByteOrder

: نوشتن یک مقدار UInt32 به آرایه بایت. نتیجه‌گیری: این کلاس به شما کمک می‌کند تا رمز عبورهای کاربران را به صورت ایمن هش کنید و در پایگاه داده ذخیره کنید. همچنین می‌توانید رمز عبورهای ورودی کاربران را با رمز عبورهای ذخیره شده مقایسه کنید و از صحت آن‌ها اطمینان حاصل کنید.

Test_Store.Application => FacadPatterns => IProductFacad.cs بیایید این اینترفیس

IProductFacad

را بررسی کنیم تا ببینیم که چگونه عمل می‌کند و چه نیازهایی دارد. بررسی کد: 1. تعریف اینترفیس `IProductFacad`: - این اینترفیس دو پراپرتی شامل

AddNewCategoryService

و

GetCategoriesService

دارد. - این دو پراپرتی به سرویس‌های مربوط به افزودن دسته‌بندی جدید و دریافت دسته‌بندی‌ها اشاره دارند. کد: csharp public interface IProductFacad { AddNewCategoryService AddNewCategoryService { get; } IGetCategoriesService GetCategoriesService { get; } } مفاهیم مرتبط: 1. پراپرتی `AddNewCategoryService`: - این پراپرتی به یک کلاس سرویس به نام

AddNewCategoryService

اشاره دارد که مسئولیت افزودن دسته‌بندی جدید را بر عهده دارد. 2. پراپرتی `GetCategoriesService`: - این پراپرتی به یک اینترفیس سرویس به نام

IGetCategoriesService

اشاره دارد که مسئولیت دریافت دسته‌بندی‌ها را بر عهده دارد. نتیجه‌گیری: این اینترفیس به نوعی الگوی طراحی Facade را پیاده‌سازی می‌کند که به شما امکان می‌دهد تا مجموعه‌ای از سرویس‌های مرتبط را از طریق یک نقطه ورود واحد مدیریت کنید.

Test_Store => Application => Services => Products => Commands => AddNewCategory => IAddNewCategoryService.cs بیایید با هم کد AddNewCategoryService را بررسی کنیم. این کد به منظور افزودن یک دسته‌بندی جدید به فروشگاه شما طراحی شده است. توضیحات کد: Interface IAddNewCategoryService: اینترفیس IAddNewCategoryService یک متد Execute را تعریف می‌کند که یک دسته‌بندی جدید را به دیتابیس اضافه می‌کند. این متد دو پارامتر می‌پذیرد: ParentId که شناسه دسته‌بندی والد است (در صورت وجود) و Name که نام دسته‌بندی جدید است. این متد یک شیء ResultDto برمی‌گرداند که حاوی وضعیت و پیام نتیجه عملیات است. Class AddNewCategoryService: کلاس AddNewCategoryService پیاده‌سازی اینترفیس IAddNewCategoryService است. Constructor (سازنده): سازنده کلاس AddNewCategoryService که یک شیء از نوع IDataBaseContext را دریافت می‌کند. این شیء برای دسترسی به دیتابیس استفاده می‌شود. Method Execute: این متد مسئول اجرای عملیات افزودن دسته‌بندی جدید است. ابتدا بررسی می‌کند که آیا Name خالی یا null است. اگر خالی باشد، یک پیام خطا برمی‌گرداند. سپس یک شیء از نوع Category ایجاد می‌کند و نام دسته‌بندی و دسته‌بندی والد (در صورت وجود) را تنظیم می‌کند. این دسته‌بندی جدید را به دیتابیس اضافه می‌کند و تغییرات را ذخیره می‌کند. در نهایت، یک پیام موفقیت‌آمیز برمی‌گرداند. Method GetParent: این متد مسئول یافتن دسته‌بندی والد با استفاده از ParentId است. اگر ParentId موجود باشد، دسته‌بندی والد را از دیتابیس پیدا می‌کند و برمی‌گرداند. نتیجه‌گیری: این کد به شما امکان می‌دهد تا دسته‌بندی‌های جدید را به دیتابیس خود اضافه کنید و در صورت وجود، دسته‌بندی والد را نیز تنظیم کنید. این فرآیند به شما کمک می‌کند تا ساختار دسته‌بندی‌های فروشگاه خود را بهبود بخشید و مدیریت کنید.