Order Module Entities Configuration

خلينا نكمل ونشوف إزاي نستخدم الـ Fluent API لكل Entity عندك في الـ Order Module، ونكتب الـ Configuration Class لكل واحدة منهم: Order, OrderItems, وDeliveryMethod.

Order Config

• هنبدأ بعمل Configuration Class للـ Order Entity.
• هنروح في الـ Repository وفي فولدر الـ Config ونعمل class اسمه OrderConfigurations ونسيبه Internal.
• هنستخدم الـ Fluent API لتحديد العلاقات والخصائص.

internal class OrderConfigurations : IEntityTypeConfiguration<Order>
{
	public void Configure(EntityTypeBuilder<Order> builder)
	{
		// One-to-One relationship: Shipping Address
		builder.OwnsOne(O => O.ShippingAddress, shippingAddress => shippingAddress.WithOwner());
 
		// Enum: Order Status
		builder.Property(O => O.Status)
			.HasConversion(
				OStatus => OStatus.ToString(),
				OStatus => (OrderStatus) Enum.Parse(typeof(OrderStatus), OStatus)
			);
 
		// Relationship with Delivery Method
		builder.HasOne(O => O.DeliveryMethod)
			.WithMany(); // Default
 
		// Subtotal as decimal
		builder.Property(O => O.Subtotal)
			.HasColumnType("decimal(18,2)");
	}
}

خلينا نشرح الجزء المتعلق بالـ Fluent API المستخدم في التعامل مع الـ Delivery Method والـ Subtotal في الـ Order Entity:

Delivery Method Relationship

العلاقة بين الـ Order والـ Delivery Method هي في الأساس One-to-Many من ناحية الـOrder. يعني ممكن يكون عندك أكتر من Order بيستخدم نفس الـ Delivery Method. لكن لو عايز تضمن إنها One-to-One، ممكن تعمل Constraint باستخدام الـ Fluent API.

1. Default Relationship:

   builder.HasOne(O => O.DeliveryMethod)
       .WithMany(); // Default

   • هنا بنحدد إن الـ Order عنده DeliveryMethod، والعلاقة الافتراضية هي One-to-Many من ناحية الـ Order. يعني ممكن أكتر من Order يستخدم نفس الـ Delivery Method.

2. One-to-One Constraint:

   builder.HasOne(O => O.DeliveryMethod)
       .WithOne();

   • لو عايز تضمن إن العلاقة One-to-One، ممكن تستخدم WithOne() لتحديد إن كل Order لازم يكون له Delivery Method واحد فقط، والعكس صحيح.

3. Unique Constraint:

   builder.HasIndex(O => O.DeliveryMethodId).IsUnique();

   • هنا بنعمل Unique Constraint على الـ Foreign Key بتاع الـ Delivery Method في الـ Order. ده بيضمن إن كل Order له Delivery Method فريد، لكن مش ضروري تعمل ده لو مش محتاجه.

Subtotal Property

الـ Subtotal هو قيمة من نوع decimal، وعلشان نحدد إزاي هيتخزن في الـ Database، بنستخدم الـ Fluent API لتحديد نوع العمود.

builder.Property(O => O.Subtotal)
    .HasColumnType("decimal(18,2)");

• الـ HasColumnType("decimal(18,2)"): ده بيحدد إن العمود اللي هيخزن الـ Subtotal في الـ Database هيكون من نوع decimal مع 18 رقم إجمالي و2 رقم بعد العلامة العشرية. ده بيساعد في تخزين القيم المالية بدقة عالية.

ملاحظات إضافية

• استخدام الـ HasColumnType مهم جدًا في التعامل مع القيم المالية عشان تتجنب أي مشاكل في الدقة عند التخزين في الـ Database.
• لو مش محتاج تعمل Unique Constraint على الـ Delivery Method، ممكن تكتفي بالعلاقة الافتراضية One-to-Many.

Delivery Method Config

• العلاقة بين الـ Order والـ Delivery Method هي One-to-Many من ناحية الـ Order.
• ممكن نعمل Constraint لو عايزين نضمن إنها One-to-One.

Order Item Config

هنعمل Configuration Class للـ OrderItem Entity.

internal class OrderItemConfiguration : IEntityTypeConfiguration<OrderItem>
{
	public void Configure(EntityTypeBuilder<OrderItem> builder)
	{
		// One-to-One relationship: ProductItemOrdered
		builder.OwnsOne(orderItem => orderItem.Product, Product => Product.WithOwner());
 
		// Price as decimal
		builder.Property(orderItem => orderItem.Price)
			.HasColumnType("decimal(18,2)");
	}
}

Apply Configs

علشان نطبق كل الـ Configurations اللي عملناها، هنروح للـ StoreContext ونعمل Apply لكل الـ Configurations.

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
	modelBuilder.ApplyConfigurationsFromAssembly(Assembly.GetExecutingAssembly());
}

ملاحظات إضافية

• تأكد إنك بتستخدم الـ namespace الصحيح لكل Entity وEnum عشان تتجنب أي تعارضات.
• لو عايز تعمل Unique Constraint على الـ Delivery Method في الـ Order، ممكن تستخدم HasIndex مع IsUnique().