Software Engineer Encyclopedia
0%
Domain 06 · Software Architecture & Design Patterns · Topic 6.5

Domain-Driven Design: فهم الـ Business قبل الـ Database

Domain-Driven Design — Foundations and Tactical Patterns

شرح DDD: ubiquitous language، entities/value objects، aggregates، repositories، domain/application services، events، bounded contexts، context mapping وEF Core.

  • Advanced
  • ~18 min read
  • 13 sections
  • 8 code examples
  • 1 diagrams
  • 5 questions
  • Priority L3 · Optional
  • .NET 10 · EF Core 10

المتطلبات قبل ما تبدأ

خبرة عملية ببناء API بقاعدة بيانات — الأنماط دي حلول لمشاكل لازم تكون شفتها.

مستوى التعمق المطلوب

FOUNDATIONS FIRSTLearn concepts first; advanced tactical patterns can wait.

01

DDD مش Framework؛ دي طريقة لفهم Business Domain

Domain complexity drives the model
Deep dive

Domain-Driven Design منهج لتصميم software حول فهم عميق للـ business domain والتعاون المستمر مع domain experts. مش معناه استخدام Entity Framework بطريقة معينة أو إنشاء Domain project فقط. DDD مفيد لما business rules معقدة، المصطلحات متداخلة، workflows كثيرة، والقرارات لها معنى اقتصادي/تشغيلي. لو التطبيق CRUD بسيط، DDD الكامل قد يكون تكلفة بلا عائد.

ابدأ بالسؤال: ما المشكلة التجارية التي يحلها النظام؟ ما القواعد التي لا يجوز كسرها؟ ما المصطلحات التي يستخدمها الخبراء؟ أين تختلف معاني الكلمات بين الأقسام؟ DDD يحاول أن يجعل model يعكس فهم الفريق للـ domain، لا مجرد نسخة من جداول قديمة.

Strategic DDD: Core و Supporting و Generic Subdomains

Strategic DDD يبدأ بتقسيم domain إلى subdomains: Core capability تميز business وتستحق أفضل modeling/team focus؛ Supporting مهمة لكنها ليست differentiator؛ Generic capability شائعة مثل identity/email/payment integration وقد تشتريها أو تستخدم provider. لا تصرف نفس الجهد على كل module.

Bounded Context هو boundary لنموذج/لغة، وليس بالضرورة microservice. ممكن عدة contexts داخل modular monolith. لو context صغيرة ومفهومة، لا تحتاج DDD tactical كامل. Strategic DDD يساعد تحديد ownership، contracts، team boundaries، data ownership و integration direction.

DDD: إمتى تستخدمه وإمتى يكون زيادة؟

DDD مفيد عندما domain معقدة، المصطلحات ملتبسة، business rules تتغير، وهناك workflows متعددة وفرق تحتاج حدود واضحة. مش مطلوب تطبق tactical patterns كلها في CRUD بسيط. في app إدارية بسيطة، DTO + EF Core + validation قد يكون أفضل. لا تحول كل table إلى Aggregate، ولا تجعل كل string Value Object قبل ظهور invariant حقيقي.

اسأل قبل إدخال DDD: هل نقدر نصف business rule بجملة واضحة؟ هل هناك invariants تحتاج حماية؟ هل الفريق والـ domain experts يتفقون على المصطلحات؟ هل bounded contexts موجودة فعليًا؟ هل التكلفة الإضافية في modeling والاختبارات ستقلل change cost؟ لو الإجابة لا، استخدم modeling أخف.

02

Bounded contexts و context map

A context map
Basics
SalesCustomer = lead, dealsOrder (draft, priced)BillingCustomer = payer, tax idInvoice, SubscriptionShippingCustomer = addressShipment, ParcelOrderPlacedInvoicePaidIntegration events + ACL at each boundary; no shared tables
The same word means different models in different contexts; integration happens through explicit contracts
03

Ubiquitous Language

One shared language inside a bounded context
Deep dive

Ubiquitous Language لغة مشتركة بين developers و domain experts داخل Bounded Context. لو business يقول «حجز مؤكد» بمعنى أن payment تم و room اتخصصت، لا تسمي object Booking بينما الفريق يقصد hold مؤقتًا. المصطلحات الدقيقة تقلل سوء الفهم وتظهر حالات domain.

اجمع glossary صغير: Reservation Hold، Confirmed Reservation، Cancellation Window، Refund Eligibility. استخدم نفس الأسماء في code/tests/diagrams، لكن لا تفترض أن المصطلح له نفس المعنى في كل النظام؛ bounded contexts المختلفة قد تستخدم نفس الكلمة بمعانٍ مختلفة.

04

Entities و Value Objects

Identity versus value equality
Deep dive

Entity لها identity تستمر عبر الزمن حتى لو تغيرت attributes. Customer Id=42 يظل نفس customer حتى لو غير email. Value Object لا يهمه identity منفصلة؛ Money(100, EGP) تساوي Money(100, EGP) بالقيمة، ويُفضّل أن يكون immutable. DateRange و Address و Quantity أمثلة محتملة.

C#Entity and value object
public sealed class Customer
{
    public Guid Id { get; private set; }
    public EmailAddress Email { get; private set; }

    public void ChangeEmail(EmailAddress newEmail) => Email = newEmail;
}

public sealed record EmailAddress
{
    public string Value { get; }
    public EmailAddress(string value)
    {
        if (!MailAddress.TryCreate(value, out _))
            throw new DomainException("Invalid email address.");
        Value = value.Trim().ToLowerInvariant();
    }
}

لا تجعل كل string Value Object بلا سبب؛ استخدمه عندما القيمة لها validation/meaning/operations أو تمنع خلط أنواع متشابهة. Money أفضل من decimal عارٍ عندما currency وال rounding rules مهمة.

Value Objects: مساواة بالقيمة لا بالهوية

Money ليس decimal فقط؛ له amount و currency وقواعد مقارنة وجمع. لا تجمع EGP مع USD بلا conversion rate واضح. EmailAddress قد يفرض normalization/validation وفق business policy. DateRange يحمي أن end بعد start ويقدم Contains/Overlaps. Value Object غالبًا immutable ويقارن بالقيم، مما يقلل invalid states ويجعل domain methods أوضح.

C#Money value object with currency-safe addition
public readonly record struct Money(decimal Amount, string Currency)
{
    public Money Add(Money other)
    {
        if (!StringComparer.Ordinal.Equals(Currency, other.Currency))
            throw new DomainException("Currencies must match.");
        return new Money(Amount + other.Amount, Currency);
    }
}

هذا مثال مبسط؛ في نظام مالي حقيقي حدد decimal precision/rounding لكل currency، ومنع currency codes غير المدعومة، وراجع serialization و EF Core value conversion. لا تستخدم floating-point للأموال. لا تجعل record equality كافية إذا عندك normalization أو قواعد identity خاصة.

05

Aggregates و Aggregate Roots و Invariants

Consistency boundaries
Deep dive

Aggregate مجموعة objects تُعامل كوحدة consistency، ولها Aggregate Root هو المدخل الخارجي للتعديل. القاعدة: caller يعدّل aggregate عبر root، والـ root يحافظ على invariants الداخلية. لا تجعل أي service تغير OrderItem مباشرة من غير المرور على Order لو Order هو root.

Aggregate size لازم يكون صغيرًا بقدر الإمكان. لا تجمع Customer وكل Orders وكل Payments في aggregate واحد؛ كل command ستحتاج تحميل وتحديث graph ضخم وستظهر concurrency contention. العلاقات بين aggregates غالبًا عبر IDs، وكل aggregate له transaction boundary مستقلة. لو workflow يحتاج تعديل aggregates متعددة، application service ينسقها وقد يحتاج eventual consistency/outbox/saga.

C#Aggregate root guards child changes
public sealed class Order
{
    private readonly List<OrderLine> _lines = [];
    public Guid Id { get; private set; }
    public IReadOnlyCollection<OrderLine> Lines => _lines.AsReadOnly();
    public OrderStatus Status { get; private set; }

    public void AddLine(ProductId productId, Money unitPrice, int quantity)
    {
        if (Status != OrderStatus.Draft)
            throw new DomainException("Order is not editable.");
        if (quantity <= 0) throw new DomainException("Quantity must be positive.");
        _lines.Add(new OrderLine(productId, unitPrice, quantity));
    }
}

Invariant داخل aggregate يمكن الحفاظ عليها في transaction واحدة. لكن «لا يوجد حجز آخر متداخل لنفس الغرفة» عبر عدة Reservation aggregates يحتاج database constraint/locking/query strategy؛ لا تعتمد على domain object منفردة لحماية invariant global.

Aggregate Design Rules و Consistency Boundaries

قاعدة تصميم: اجعل aggregate يحمي invariants التي يجب أن تكون صحيحة داخل transaction واحدة. لا تضف object إلى aggregate لمجرد وجود foreign key. لو Customer لديه ملايين Orders، لا تضع collection كل orders داخل Customer aggregate. Order aggregate قد يحتفظ CustomerId فقط ويقرأ customer details عبر query عند الحاجة.

كل aggregate root له repository؛ تعديل child يمر من root. cross-aggregate references غالبًا IDs. لو business rule تعتمد على عدة aggregates، استخدم domain service/application orchestration، مع consistency strategy: optimistic check، reservation/hold، event-driven process، أو eventual consistency. لا تتوقع أن تحميل aggregates اثنين يجعل تحديثهما atomic تلقائيًا عبر database contexts مختلفة.

Aggregate concurrency مهم: optimistic concurrency token على root يمكن أن يحمي changes، لكن لو child rows تتغير من غير تحديث root version، قد لا يكتشف conflict حسب mapping. اختبر ما الذي يحدث عند تعديل child من عمليتين متزامنتين، واختَر versioning strategy صريحة.

Aggregate Design: أصغر Transaction Boundary تحمي Invariants

Aggregate ليس مجرد مجموعة entities مرتبطة navigation properties. هو consistency boundary: مجموعة objects لازم تحافظ على invariants معًا داخل transaction واحدة، ولها Aggregate Root هو نقطة التعديل الخارجية. أي تعديل على child يمر عبر root حتى لا يتم تجاوز القواعد. الهدف ليس تحميل كل العلاقات في object graph، بل تحديد ما الذي يجب أن يكون consistent atomically.

قاعدة عملية: صمم aggregate صغيرًا قدر الإمكان، واجعل invariants داخله قابلة للتحقق داخل transaction واحدة. لو Order يحتوي 1000 OrderLine وتحديث line واحدة لا يحتاج تحميل الكل، فكر في حدود مختلفة أو عمليات domain موجهة. لا تجعل Customer aggregate يضم كل Orders مدى الحياة لمجرد وجود FK؛ غالبًا Customer و Order aggregates منفصلة وتتواصل عبر IDs.

C#Aggregate root controls child mutations
public sealed class ShoppingCart
{
    private readonly List<CartLine> _lines = [];
    public Guid Id { get; private set; }
    public IReadOnlyCollection<CartLine> Lines => _lines.AsReadOnly();

    public void Add(ProductId productId, int quantity, Money unitPrice)
    {
        if (quantity <= 0) throw new DomainException("Quantity must be positive.");
        var existing = _lines.SingleOrDefault(x => x.ProductId == productId);
        if (existing is null) _lines.Add(new CartLine(productId, quantity, unitPrice));
        else existing.Increase(quantity);
    }

    public void Remove(ProductId productId)
    {
        var line = _lines.SingleOrDefault(x => x.ProductId == productId);
        if (line is not null) _lines.Remove(line);
    }
}

الـ aggregate root يحمي invariants داخل object، لكن لو نفس invariant تعتمد على مخزون مشترك بين عدة carts/orders، لا يكفي تحميل inventory entity ثم التحقق ثم الحفظ من غير concurrency control. استخدم optimistic concurrency token، atomic SQL update، أو reservation model. Domain model يحدد rule، و database concurrency mechanism يمنع race conditions.

Aggregate عملي: Invariant لا يجوز أن يخرج إلى Controller

مثال Reservation: لا يجوز تأكيد حجز ملغي، ولا يجوز أن يكون CheckOut قبل CheckIn، ولا يجوز تأكيده دون توفر غرفة. بعض القواعد محلية داخل aggregate ويمكن حمايتها في method؛ أما توفر الغرفة عبر حجوزات كثيرة فيحتاج consistency strategy على مستوى database أو reservation service، لأن تحميل Aggregate واحد لا يمنع concurrent requests على نفس الغرفة.

C#Reservation aggregate protects local invariants
public sealed class Reservation
{
    public Guid Id { get; private set; }
    public DateOnly CheckIn { get; private set; }
    public DateOnly CheckOut { get; private set; }
    public ReservationStatus Status { get; private set; }

    private Reservation() { } // EF Core

    public static Reservation Create(DateOnly checkIn, DateOnly checkOut)
    {
        if (checkOut <= checkIn)
            throw new DomainException("Check-out must follow check-in.");
        return new Reservation { Id = Guid.NewGuid(), CheckIn = checkIn,
            CheckOut = checkOut, Status = ReservationStatus.Pending };
    }

    public void Confirm()
    {
        if (Status != ReservationStatus.Pending)
            throw new DomainException("Only pending reservations can confirm.");
        Status = ReservationStatus.Confirmed;
    }
}

هذا يحمي invariant داخل object واحد فقط. منع double booking يحتاج قفل/constraint مناسب: exclusion constraint في PostgreSQL لنطاق التواريخ، أو serializable/locking strategy مدروسة، أو جدول availability مع atomic conditional update. unique index على RoomId وحده لا يكفي لو الحجوزات في تواريخ مختلفة. اختبر concurrent attempts لا مجرد sequential calls.

06

Repositories و Domain Services و Application Services

Put behavior at the right level
Deep dive

Repository عادة لكل aggregate root، ويعيد aggregate كاملًا للـ command path. Domain Service يمثل business behavior لا ينتمي طبيعيًا إلى entity واحدة، مثل domain calculation تعتمد على عدة concepts. Application Service ينسق use case، يجلب aggregates، ينادي domain methods، يحفظ، ويطلق integration workflow.

لا تجعل Domain Service مجرد wrapper لـ repository أو HTTP. ولا تجعل Application Service تحمل كل business rules. مثال: PricingPolicy قد تكون domain service؛ CheckoutHandler application service ينسق order + payment + persistence. Repository interface في الداخل، implementation في Infrastructure.

07

Domain Events vs Integration Events

Communicate facts inside and outside the context
Deep dive

Domain Event حقيقة حصلت داخل domain مثل OrderConfirmed. يمكن أن تلتقطها handlers داخل نفس process لتحديث behavior تابع. Integration Event رسالة تُرسل إلى bounded context أو service أخرى بعد commit. لا تنشر integration event قبل نجاح transaction التي تحفظ الحقيقة.

Outbox pattern يحفظ event في نفس DB transaction مع aggregate change؛ dispatcher ينشر لاحقًا. Consumer يجب أن يكون idempotent لأن delivery قد تتكرر. Domain events غالبًا تستخدم domain language، بينما integration contract versioned ومصمم للـ consumers، ولا ينبغي أن يكشف internal model كله.

Domain Events vs Integration Events

Domain Event حقيقة حصلت داخل domain مثل OrderConfirmed. تساعد aggregate أو domain service تعبر عن حدث business مهم من غير coupling مباشر إلى email/payment/broker. Integration Event رسالة contract موجهة إلى bounded context أو system آخر، وتحتاج versioning، serialization، delivery guarantees و security. لا تنشر domain entity نفسها كـ integration payload؛ صمم integration contract مستقلًا.

C#Domain event is an internal fact
public sealed record OrderConfirmedDomainEvent(
    Guid OrderId,
    Guid CustomerId,
    DateTimeOffset OccurredAtUtc);

public sealed class Order
{
    private readonly List<object> _domainEvents = [];
    public IReadOnlyCollection<object> DomainEvents => _domainEvents;

    public void Confirm(DateTimeOffset now)
    {
        if (Status != OrderStatus.Draft || Items.Count == 0)
            throw new DomainException("Order cannot be confirmed.");
        Status = OrderStatus.Confirmed;
        _domainEvents.Add(new OrderConfirmedDomainEvent(Id, CustomerId, now));
    }
}

في monolith، handler قد يحدث read model أو يضيف outbox record. لو domain event handler يعمل external HTTP call قبل DB commit، قد تحصل inconsistency. الأفضل أن transaction تحفظ aggregate و outbox intent، ثم publisher ينشر integration event بعد commit. حدد هل domain event synchronous جزء من transaction أم asynchronous side effect؛ لا تخلط semantics.

Domain Events: Timing و Side Effects

Domain event object immutable يصف حقيقة حدثت داخل model. لا تجعل entity ترسل email أو HTTP call مباشرة؛ هي تسجل event أو ترجع event list. Application layer تجمع events وتتعامل معها. لو handler يحدث نفس DB، قد يعمل داخل transaction حسب التصميم. لو ينشر message خارج DB، استخدم outbox بعد commit.

تجنب recursive event chains غير محدودة: OrderConfirmed handler ينشئ Payment، Payment handler يؤكد Order، وهكذا. ارسم event flow وحدد owner لكل transition. Event names بالماضي، commands بصيغة imperative. Domain event ليس مجرد DTO لأي تغير property؛ استخدمه عندما fact له business meaning.

08

Bounded Contexts و Context Mapping

Different models for different business capabilities
Deep dive

Bounded Context يحدد حدودًا يكون فيها model ولغة متسقة. مثال في شركة تجارة: Catalog يعرف Product ووصفه وسعر العرض؛ Ordering يعرف ProductSnapshot الذي تم شراؤه؛ Shipping يعرف Package/Shipment؛ Accounting يعرف Invoice/Receivable. نفس كلمة Product قد تشير إلى نماذج مختلفة حسب السياق.

Context Mapping يصف علاقة السياقات: Customer/Supplier، Conformist، Anti-Corruption Layer، Published Language، Shared Kernel، أو Partnership. لا تشارك كل entities بين contexts لمجرد منع duplication؛ مشاركة model واحد قد تربط release cycles وتسبب coupling. استخدم integration contracts واضحة.

Context Mapping: ACL و Shared Kernel و Customer/Supplier

Customer/Supplier: downstream context يعتمد على upstream ويستطيع التأثير في roadmap/contract. Conformist: downstream يقبل upstream model كما هو؛ سريع لكنه يربطك بلغته. Anti-Corruption Layer: adapter يترجم model خارجي إلى domain language داخلي. Shared Kernel: جزء صغير مشترك بين teams مع governance قوي؛ أي تغيير يحتاج تنسيقًا. Published Language: schema/contract معلن ومستقر للتكامل. اختَر العلاقة بوعي بدل shared database غير موثقة.

ACL مفيدة خصوصًا عند legacy systems: حول legacy status codes إلى domain states، normalize identifiers/currency/timezones، map error semantics، وخلي anti-corruption translation في adapter boundary. لا تسمح external SDK types تنتشر في Domain/Application.

Bounded Context: نفس الكلمة قد تعني Models مختلفة

في نظام متجر، كلمة Customer في Sales قد تعني صاحب الطلب و credit terms، وفي Support تعني بيانات التواصل وتذاكر الدعم، وفي Billing تعني payer و tax profile. إجبار كل السياقات على Customer class واحدة يؤدي إلى نموذج ضخم وتبعيات متبادلة. Bounded Context يسمح لكل سياق بنموذج مناسب، ويتواصلون عبر contracts/events واضحة.

Shared Kernel يعني مشاركة جزء صغير ومستقر مع اتفاق تنسيقي بين الفرق، وليس وضع كل entities في Common project. Anti-Corruption Layer يترجم نموذج النظام القديم/الخارجي إلى لغة السياق الجديد حتى لا تتسرب مفاهيمه. Context Map توضح علاقة upstream/downstream ومن يملك contract، ومتى تحتاج translation أو published language.

ابدأ بتحديد حدود الدومين من اللغة وقواعد العمل وملكية التغيير. لا تقسم bounded contexts على أساس جداول SQL أو أسماء teams فقط. لو سياقين يتغيران معًا دائمًا ويحتاجان transaction واحدة، ربما الفصل غير مناسب بعد. DDD strategic design قرار تنظيمي وتقني معًا.

09

Rich vs Anemic Domain Model و Database-First

Avoid both empty models and ceremony
Deep dive

Rich domain model يضع behavior/invariants داخل entities/value objects. Anemic model يحتوي data فقط بينما services تحمل كل decisions. لا يوجد حكم أن rich أفضل دائمًا؛ لو قواعد domain بسيطة، anemic model قد يكون عمليًا. لكن عندما lifecycle والـ invariants معقدة، وضع rules في service عامة يسهل تجاوزها ويصعب الحفاظ عليها.

Database-first يبدأ من schema موجودة ثم يولد models؛ ده مناسب للتكامل مع legacy/enterprise database. لكن لا تجعل schema هي ubiquitous language تلقائيًا. قد تحتاج anti-corruption mapping بين persistence model و domain model. DDD لا يمنع ORM؛ EF Core يمكنه mapping private fields/value objects/owned types، لكن يجب اختبار persistence behavior.

اختبار DDD Model

Domain tests يجب أن تكون سريعة ومباشرة: given aggregate state، when operation، then state/event/error. لا تحتاج database في كل test. اختبر invariant boundaries: transitions غير مسموحة، equality/value semantics، money/currency، date ranges، concurrency decisions. Application tests تختبر orchestration، و Infrastructure integration tests تثبت EF mapping/transactions.

اختبر language model أيضًا: أسماء commands/events تعكس business terms؟ هل bounded context تتسرب بينها types؟ architecture tests تمنع references؟ code review مع domain expert يراجع هل behavior يعكس policy الفعلية. DDD model لا يمكن إثبات صحته من tests التقنية وحدها إذا فهم business نفسه خاطئ.

DDD Anti-Patterns

  • Entity لكل table حتى lookup tables البسيطة.
  • Aggregate ضخم يجمع كل data المرتبطة بعلاقات FK.
  • Repository لكل entity/child بدل aggregate root.
  • Domain Service لكل method لا تعرف أين تضعها.
  • Domain Event لكل property change بلا business meaning.
  • Shared Kernel كبير يربط كل bounded contexts.
  • Rich model شكلي مع public setters لكل شيء.
  • Database schema هي domain language من غير مراجعة business.
  • Microservice لكل bounded context قبل وجود team/deployment need.

استخدم DDD selectively. strategic modeling قد يفيد حتى لو tactical model بسيط. لا تجعل framework أو folder structure بديلًا عن فهم domain.

10

Event Storming و Aggregate Sizing

Discover domain flows collaboratively
Practical

Event Storming workshop يضع domain events (عادة بصيغة الماضي) على timeline، ثم commands التي سببتها، actors، policies، read models، external systems، hotspots. الهدف كشف workflow واللغة والحدود قبل تصميم classes. اسأل: أين يحصل conflict؟ ما المعلومات المطلوبة لاتخاذ القرار؟ ما الذي يمكن أن يفشل؟

قاعدة aggregate sizing: ابدأ من invariants التي يجب أن تكون atomic. اجمع objects فقط عندما تحتاج الحفاظ على consistency بينها في نفس transaction. لو aggregate كبير ويُعدّل كثيرًا، قسّمه إلى boundaries أصغر واربطها بـ events/process manager. لا تقسم فقط حسب عدد properties.

Event Storming و Context Mapping بشكل عملي

Event Storming workshop يبدأ بأحداث domain بلغة الماضي: OrderPlaced، PaymentAuthorized، RoomCheckedIn. بعد ذلك نضيف commands التي سببتها، actors، policies، aggregates، external systems، و hotspots المختلف عليها. الهدف كشف workflow واللغة والحدود، وليس رسم diagram جميل فقط. استخدم sticky notes أو board، واحتفظ بالقرارات والأسئلة المفتوحة.

Bounded Context هو حد تكون فيه المصطلحات والنماذج متسقة. كلمة Customer في Billing قد تحمل tax identity و credit terms، بينما في Support تحمل contact preferences و tickets. لا تجبر كل context على shared mega-entity. Context Mapping يصف العلاقات: upstream/downstream، Customer-Supplier، Conformist، Anti-Corruption Layer، Open Host Service، Published Language. اختَر integration contract واضحًا.

علامات boundary سيئة: جداول مشتركة يكتب فيها أكثر من module، entity واحدة ضخمة تخدم كل contexts، تغييرات schema تكسر عدة فرق، أو event names مبهمة مثل Updated. راجع ownership: من يملك الحقيقة؟ من ينشر؟ هل consumer يحتاج snapshot أم reference؟ وكيف يتم التعامل مع schema evolution؟

11

Anti-Corruption Layer و Persisting Aggregates with EF Core

Protect domain language from external models
Deep dive

Anti-Corruption Layer (ACL) adapter/translator يحول model خارجي إلى domain language الخاص بك. مثال: payment provider يرجع statuses مثل Authorized/Captured/Voided؛ domain عندك قد تستخدم PaymentPending/Paid/Refunded. لا تجعل provider enum يتسرب في domain. ACL يترجم errors/IDs/timezones/currencies أيضًا.

EF Core يمكنه حفظ aggregates عبر backing fields و private constructors و owned/value-converted types. استخدم configuration منفصلة في Infrastructure. لا تكسر encapsulation بفتح كل setters لمجرد ORM؛ اختبر materialization وال collections وال concurrency tokens. لا تجعل repository ترجع IQueryable للـ aggregate؛ caller لا يجب أن يغير consistency boundary عشوائيًا.

C#EF Core backing field mapping
modelBuilder.Entity<Order>(builder =>
{
    builder.HasKey(x => x.Id);
    builder.Metadata.FindNavigation(nameof(Order.Lines))!
        .SetPropertyAccessMode(PropertyAccessMode.Field);
    builder.HasMany<OrderLine>("_lines")
        .WithOne()
        .HasForeignKey("OrderId")
        .OnDelete(DeleteBehavior.Cascade);
});

راجع mapping API حسب EF Core version؛ المثال يوضح الفكرة، وقد تحتاج field/navigation configuration أكثر تحديدًا. اختبر أن private collection تتحمل صح وأن child لا يتم تعديله خارج root في application code.

Persisting Aggregates with EF Core

EF Core يقدر يربط private backing fields و private constructors، لكن mapping لازم يتوافق مع domain encapsulation. استخدم field access mode عند الحاجة، configure owned/value objects بوضوح، وتجنب public setters التي تسمح بتجاوز invariants. لا تفترض إن EF navigation collection exposed كـ IReadOnlyCollection تمنع كل mutation إذا backing field متاح للـ ORM؛ راجع mapping و tests.

C#EF Core backing-field mapping sketch
public sealed class OrderConfiguration : IEntityTypeConfiguration<Order>
{
    public void Configure(EntityTypeBuilder<Order> builder)
    {
        builder.HasKey(x => x.Id);
        builder.Property(x => x.Status).HasConversion<string>();

        builder.HasMany<OrderItem>("_items")
            .WithOne()
            .HasForeignKey("OrderId")
            .OnDelete(DeleteBehavior.Cascade);

        builder.Navigation("_items")
            .UsePropertyAccessMode(PropertyAccessMode.Field);
    }
}

اختبر materialization من database؛ بعض domain constructors أو readonly collections قد لا تتوافق مع mapping المختار. كذلك راجع cascade delete: aggregate child قد يحذف مع root، لكن لا تجعل cascade عبر bounded contexts أو relationships واسعة تسبب حذف بيانات مستقلة.

Repository في DDD غالبًا واحد لكل aggregate root، لا لكل table. IOrderRepository يحمل ويحفظ Order aggregate؛ لا تعرض IOrderItemRepository إذا OrderItem لا يملك lifecycle مستقلًا. Queries التقارير والبحث قد تستخدم read models/query services بدل تحميل aggregates ثقيلة.

12

إمتى DDD يستاهل التعقيد؟

Use strategic DDD where the domain is difficult
Practical

DDD مفيد عندما domain rules معقدة ومتغيرة، language ملتبسة، عدة teams/contexts، consistency boundaries مهمة، أو integration مع أنظمة مختلفة. لا تحتاج tactical patterns كلها في كل module. ممكن تستخدم strategic DDD لتحديد bounded contexts ثم CRUD model بسيط داخل context منخفض التعقيد.

لا تبدأ ب Aggregates و Domain Events قبل فهم business vocabulary. لا تنشئ Bounded Context لكل جدول. لا تخلط Domain Event مع integration message. لا تجعل كل entity rich لمجرد أن الكتاب قال ذلك. ابدأ من business risk/change cost ثم اختر الأدوات.

13

اختبر فهمك

Knowledge check
Practical
ما المقصود بـ Ubiquitous Language؟
لغة مشتركة بين experts والمطورين داخل bounded context وتنعكس في model/tests/code.
لماذا aggregate root مهم؟
هو المدخل الذي يحمي invariants ويحدد consistency boundary للـ aggregate.
هل DDD يتطلب Event Sourcing؟
لا؛ DDD يمكن تطبيقه مع relational database و EF Core عاديين.
ما الفرق بين Domain Event و Integration Event؟
الأول حقيقة داخل domain/context؛ الثاني contract للنشر إلى context/system أخرى، عادة بعد commit.
لماذا aggregate كبير جدًا خطر؟
يزيد contention والتحميل والتحديثات المتزامنة ويجعل transaction boundary واسعة.
↗

المراجع والقراءة الإضافية

References & further reading

الدرس بيشرح الفكرة نفسها؛ الروابط دي للتحقق والتعمق والرجوع لتفاصيل الـ API. (محتاجة إنترنت.)

التوثيق الرسمي — Official documentation

خريطة التغطية: 20 عنصر من الـ Roadmap ومكان شرحه في الدرس
RoadmapDomain Model§01
RoadmapUbiquitous Language§01
RoadmapEntities§04
RoadmapValue Objects§04
RoadmapAggregates and Aggregate Roots§04
RoadmapRepositories in DDD§05
RoadmapDomain Services§05
RoadmapApplication Services§05
RoadmapDomain Events§05
RoadmapBounded Contexts§01
RoadmapContext Mapping§01
RoadmapInvariants§04
RoadmapRich vs Anemic Domain Model§01
RoadmapDDD vs Database-First Design§01
RoadmapWhen DDD Is Worth the Complexity§01
SuggestedEvent Storming§05
SuggestedDomain events vs integration events§05
SuggestedAggregate sizing rules§05
SuggestedAnti-Corruption Layer§05
SuggestedPersisting aggregates with EF Core§05

خلصت الدرس وحليت الأسئلة؟ علّم عليه عشان يتحسب في تقدّمك.

محتويات الدرس