سیستم مدیریت سبد خرید با C# چیست و چرا اهمیت دارد؟

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

زبان C# به دلیل ساختار قوی، پشتیبانی از برنامه‌نویسی شیءگرا (OOP)، یکپارچگی با ASP.NET Core و اکوسیستم غنی مایکروسافت، یکی از بهترین انتخاب‌ها برای پیاده‌سازی چنین سیستمی است. در این مقاله، از صفر تا صد طراحی و پیاده‌سازی یک سیستم سبد خرید با C# را با هم مرور می‌کنیم.

معماری و اجزای اصلی سبد خرید

قبل از نوشتن حتی یک خط کد، باید معماری سیستم را درک کنیم. یک سبد خرید حرفه‌ای معمولاً از این اجزا تشکیل می‌شود:

• مدل داده (Data Model): کلاس‌هایی مثل Product، CartItem و ShoppingCart
• لایه سرویس (Service Layer): منطق اضافه کردن، حذف و به‌روزرسانی آیتم‌ها
• لایه ذخیره‌سازی (Repository Layer): ارتباط با دیتابیس یا Session
• لایه کنترلر (Controller Layer): دریافت درخواست‌های کاربر در ASP.NET
• View یا API Response: نمایش اطلاعات سبد به کاربر

طراحی مدل داده در C#

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

کلاس Product

public class Product

{

public int Id { get; set; }

public string Name { get; set; }

public string Description { get; set; }

public decimal Price { get; set; }

public int StockQuantity { get; set; }

public string ImageUrl { get; set; }

public string Category { get; set; }

}

کلاس CartItem

public class CartItem

{

public int Id { get; set; }

public int ProductId { get; set; }

public Product Product { get; set; }

public int Quantity { get; set; }

public decimal UnitPrice { get; set; }

public decimal TotalPrice => UnitPrice * Quantity;

}

کلاس ShoppingCart

public class ShoppingCart

{

public string CartId { get; set; }

public string UserId { get; set; }

public List Items { get; set; } = new List();

public DateTime CreatedAt { get; set; } = DateTime.Now;

public DateTime UpdatedAt { get; set; } = DateTime.Now;

public decimal SubTotal => Items.Sum(i => i.TotalPrice);

public decimal DiscountAmount { get; set; }

public decimal ShippingCost { get; set; }

public decimal TotalAmount => SubTotal - DiscountAmount + ShippingCost;

public int TotalItems => Items.Sum(i => i.Quantity);

}

پیاده‌سازی سرویس مدیریت سبد خرید

حالا باید منطق اصلی برنامه را بنویسیم. اینترفیس ICartService را ابتدا تعریف می‌کنیم تا از اصل Dependency Inversion پیروی کنیم:

public interface ICartService

{

Task GetCartAsync(string cartId);

Task AddItemAsync(string cartId, int productId, int quantity);

Task UpdateItemAsync(string cartId, int cartItemId, int quantity);

Task RemoveItemAsync(string cartId, int cartItemId);

Task ClearCartAsync(string cartId);

Task ApplyDiscountAsync(string cartId, string couponCode);

}

و حالا پیاده‌سازی اصلی این سرویس:

public class CartService : ICartService

{

private readonly ICartRepository _cartRepository;

private readonly IProductRepository _productRepository;

public CartService(

ICartRepository cartRepository,

IProductRepository productRepository)

{

_cartRepository = cartRepository;

_productRepository = productRepository;

}

public async Task AddItemAsync(

string cartId, int productId, int quantity)

{

var cart = await _cartRepository.GetCartAsync(cartId)

?? new ShoppingCart { CartId = cartId };

var product = await _productRepository.GetByIdAsync(productId);

if (product == null)

throw new Exception(“محصول یافت نشد.”);

if (product.StockQuantity < quantity)

throw new Exception(“موجودی کافی نیست.”);

var existingItem = cart.Items

.FirstOrDefault(i => i.ProductId == productId);

if (existingItem != null)

{

existingItem.Quantity += quantity;

}

else

{

cart.Items.Add(new CartItem

{

ProductId = productId,

Product = product,

Quantity = quantity,

UnitPrice = product.Price

});

}

cart.UpdatedAt = DateTime.Now;

await _cartRepository.SaveCartAsync(cart);

return cart;

}

public async Task RemoveItemAsync(

string cartId, int cartItemId)

{

var cart = await _cartRepository.GetCartAsync(cartId);

if (cart == null)

throw new Exception(“سبد خرید یافت نشد.”);

var item = cart.Items.FirstOrDefault(i => i.Id == cartItemId);

if (item != null)

cart.Items.Remove(item);

cart.UpdatedAt = DateTime.Now;

await _cartRepository.SaveCartAsync(cart);

return cart;

}

public async Task ApplyDiscountAsync(

string cartId, string couponCode)

{

var cart = await _cartRepository.GetCartAsync(cartId);

// منطق اعمال کد تخفیف

if (couponCode == “DISCOUNT20”)

cart.DiscountAmount = cart.SubTotal * 0.20m;

await _cartRepository.SaveCartAsync(cart);

return cart;

}

}

ذخیره‌سازی سبد خرید: Session یا دیتابیس؟

یکی از مهم‌ترین تصمیمات معماری در طراحی سبد خرید، محل ذخیره‌سازی داده‌ها است. دو رویکرد اصلی وجود دارد:

۱. ذخیره‌سازی با Session (برای کاربران مهمان)

• مزیت: پیاده‌سازی سریع و ساده
• مزیت: نیازی به لاگین کاربر ندارد
• معایب: با بستن مرورگر از بین می‌رود
• معایب: در محیط‌های Load Balanced مشکل‌ساز است

// ذخیره سبد در Session با JSON Serialization

public class SessionCartRepository : ICartRepository

{

private readonly IHttpContextAccessor _httpContextAccessor;

private const string CartSessionKey = “ShoppingCart”;

public SessionCartRepository(IHttpContextAccessor httpContextAccessor)

{

_httpContextAccessor = httpContextAccessor;

}

public Task GetCartAsync(string cartId)

{

var session = _httpContextAccessor.HttpContext.Session;

var cartJson = session.GetString(CartSessionKey);

if (string.IsNullOrEmpty(cartJson))

return Task.FromResult(null);

var cart = JsonSerializer.Deserialize(cartJson);

return Task.FromResult(cart);

}

public Task SaveCartAsync(ShoppingCart cart)

{

var session = _httpContextAccessor.HttpContext.Session;

var cartJson = JsonSerializer.Serialize(cart);

session.SetString(CartSessionKey, cartJson);

return Task.CompletedTask;

}

}

۲. ذخیره‌سازی در دیتابیس (برای کاربران لاگین‌شده)

با استفاده از Entity Framework Core، می‌توانیم سبد خرید را در SQL Server یا هر دیتابیس دیگری ذخیره کنیم. این روش برای کاربران ثبت‌نام‌شده ایده‌آل است زیرا سبد خرید بین جلسات مختلف حفظ می‌شود:

public class ApplicationDbContext : DbContext

{

public DbSet ShoppingCarts { get; set; }

public DbSet CartItems { get; set; }

public DbSet Products { get; set; }

protected override void OnModelCreating(ModelBuilder modelBuilder)

{

modelBuilder.Entity()

.HasMany(c => c.Items)

.WithOne()

.OnDelete(DeleteBehavior.Cascade);

modelBuilder.Entity()

.Property(i => i.UnitPrice)

.HasColumnType(“decimal(18,2)”);

}

}

پیاده‌سازی کنترلر در ASP.NET Core

با داشتن سرویس و ریپازیتوری، حالا می‌توانیم CartController را پیاده‌سازی کنیم:

[ApiController]

[Route(“api/[controller]”)]

public class CartController : ControllerBase

{

private readonly ICartService _cartService;

public CartController(ICartService cartService)

{

_cartService = cartService;

}

[HttpGet(“{cartId}”)]

public async Task GetCart(string cartId)

{

var cart = await _cartService.GetCartAsync(cartId);

if (cart == null)

return NotFound(new { message = “سبد خرید یافت نشد.” });

return Ok(cart);

}

[HttpPost(“{cartId}/items”)]

public async Task AddItem(

string cartId, [FromBody] AddItemRequest request)

{

try

{

var cart = await _cartService.AddItemAsync(

cartId, request.ProductId, request.Quantity);

return Ok(cart);

}

catch (Exception ex)

{

return BadRequest(new { message = ex.Message });

}

}

[HttpDelete(“{cartId}/items/{itemId}”)]

public async Task RemoveItem(

string cartId, int itemId)

{

var cart = await _cartService.RemoveItemAsync(cartId, itemId);

return Ok(cart);

}

[HttpPost(“{cartId}/discount”)]

public async Task ApplyDiscount(

string cartId, [FromBody] DiscountRequest request)

{

var cart = await _cartService.ApplyDiscountAsync(

cartId, request.CouponCode);

return Ok(cart);

}

}

استفاده از Redis برای کش سبد خرید

در پروژه‌های بزرگ با ترافیک بالا، استفاده از Redis برای کش کردن سبد خرید یک بهترین تجربه (Best Practice) محسوب می‌شود. Redis یک پایگاه داده In-Memory است که سرعت بسیار بالایی دارد:

public class RedisCartRepository : ICartRepository

{

private readonly IDistributedCache _cache;

private readonly TimeSpan _expiry = TimeSpan.FromDays(30);

public RedisCartRepository(IDistributedCache cache)

{

_cache = cache;

}

public async Task GetCartAsync(string cartId)

{

var cartJson = await _cache.GetStringAsync(cartId);

if (string.IsNullOrEmpty(cartJson))

return null;

return JsonSerializer.Deserialize(cartJson);

}

public async Task SaveCartAsync(ShoppingCart cart)

{

var cartJson = JsonSerializer.Serialize(cart);

await _cache.SetStringAsync(cart.CartId, cartJson,

new DistributedCacheEntryOptions

{

AbsoluteExpirationRelativeToNow = _expiry

});

}

public async Task DeleteCartAsync(string cartId)

{

await _cache.RemoveAsync(cartId);

}

}

ثبت سرویس‌ها در Program.cs

برای اینکه همه چیز کار کند، باید وابستگی‌ها را در Dependency Injection Container ثبت کنیم:

var builder = WebApplication.CreateBuilder(args);

// ثبت DbContext

builder.Services.AddDbContext(options =>

options.UseSqlServer(

builder.Configuration.GetConnectionString(“DefaultConnection”)));

// ثبت Redis

builder.Services.AddStackExchangeRedisCache(options =>

{

options.Configuration = builder.Configuration[“Redis:ConnectionString”];

});

// ثبت سرویس‌ها

builder.Services.AddScoped();

builder.Services.AddScoped();

builder.Services.AddScoped();

// Session Configuration

builder.Services.AddSession(options =>

{

options.IdleTimeout = TimeSpan.FromMinutes(30);

options.Cookie.HttpOnly = true;

options.Cookie.IsEssential = true;

});

var app = builder.Build();

app.UseSession();

app.MapControllers();

app.Run();

بهترین تجربه‌ها (Best Practices) در طراحی سبد خرید

• بررسی موجودی قبل از افزودن: همیشه قبل از اضافه کردن محصول به سبد، موجودی آن را چک کنید.
• ذخیره قیمت در لحظه خرید: قیمت را در CartItem ذخیره کنید تا تغییرات بعدی قیمت محصول روی سبد تاثیر نگذارد.
• ادغام سبد مهمان با سبد کاربر: وقتی کاربر مهمان لاگین می‌کند، سبد Session را با سبد دیتابیس ادغام کنید.
• اعتبارسنجی داده‌ها: از FluentValidation برای اعتبارسنجی تعداد و شناسه محصول استفاده کنید.
• Unit Testing: حتماً برای CartService تست واحد بنویسید تا از صحت منطق مطمئن شوید.
• مدیریت Concurrency: از Optimistic Concurrency برای جلوگیری از خریدهای همزمان یک محصول محدود استفاده کنید.

تست واحد برای CartService

یک کد بدون تست، کد ناقص است. با استفاده از xUnit و Moq، می‌توانیم سرویس را تست کنیم:

public class CartServiceTests

{

private readonly Mock _cartRepoMock;

private readonly Mock _productRepoMock;

private readonly CartService _cartService;

public CartServiceTests()

{

_cartRepoMock = new Mock();

_productRepoMock = new Mock();

_cartService = new CartService(

_cartRepoMock.Object,

_productRepoMock.Object);

}

[Fact]

public async Task AddItem_WhenProductExists_ShouldAddToCart()

{

// Arrange

var product = new Product

{

Id = 1,

Name = “لپ‌تاپ”,

Price = 25000000m,

StockQuantity = 10

};

_productRepoMock

.Setup(r => r.GetByIdAsync(1))

.ReturnsAsync(product);

_cartRepoMock

.Setup(r => r.GetCartAsync(“cart-001”))

.ReturnsAsync((ShoppingCart)null);

// Act

var cart = await _cartService.AddItemAsync(“cart-001”, 1, 2);

// Assert

Assert.Single(cart.Items);

Assert.Equal(2, cart.Items[0].Quantity);

Assert.Equal(50000000m, cart.TotalAmount);

}

}

سوالات متداول (FAQ)