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

خريطة Design Patterns الكاملة: إمتى أستخدم كل Pattern؟

Design Patterns Full Map — Catalog, Problems and .NET Examples

خريطة مرجعية للأنماط Creational/Structural/Behavioral/Enterprise/Distributed مع المشكلة التي تحلها والـ trade-offs وارتباطها بـ .NET.

  • Advanced
  • ~32 min read
  • 48 sections
  • 32 code examples
  • 1 diagrams
  • 5 questions
  • Priority L2 · Optional
  • C# 14 · .NET 10

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

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

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

SELECTIVE PRACTICALLearn each pattern from a real problem. Start with the 'Must' rows, then recognise the 'Know' rows when you read code.

01

اقرأ الخريطة كأداة اختيار لا كقائمة حفظ

Problem-first pattern selection
Deep dive

كل Pattern في الجدول يجيب عن مشكلة متكررة. ابدأ بالـ problem column، ثم اقرأ structure و trade-off، وبعدها اسأل هل عندك المشكلة فعلًا؟ التصنيف الأكاديمي يساعد التنظيم لكنه لا يحدد مكان الاستخدام وحده؛ Strategy مثلًا behavioral، لكنها شائعة في pricing/payment. Repository enterprise، لكنه boundary persistence.

المستوى العملي: افهم Strategy، Factory، Adapter، Decorator، Builder، Observer، Command، State، Chain، DI، Repository/UoW و Specification جيدًا. اعرف بقية الأنماط عندما تقرأ code أو تواجه مشكلة، ولا تحاول إدخالها كلها في مشروع واحد.

02

خريطة الأنماط حسب المشكلة

Patterns grouped by the problem they solve
Basics
Creating objectsFactory · Builder · Prototype(+ DI container in .NET)Composing structureAdapter · Decorator · FacadeProxy · Composite · BridgeVarying behaviourStrategy · State · CommandChain · Template · ObserverData accessRepository · UoW · SpecificationDistributedOutbox · Saga · Circuit breaker
Start from the change you expect, not from the pattern name
03

Creational Patterns

Object creation and lifecycle
Deep dive
Patternالمشكلة التي يحلهاإشارة ‎.NET / ملاحظة
Factory Methodإخفاء اختيار concrete type خلف creation contractFactory class/DI keyed selection؛ لا تلف new البسيطة
Abstract Factoryإنشاء عائلة objects متوافقةProvider-specific adapters/configurations؛ مفيد عند عائلات متعددة
Builderإنشاء object معقد بخطوات/اختياراتFluent builders و Options APIs؛ لا تحتاجه لكل DTO
SingletonInstance واحدة مشتركة ذات lifecycle واضحDI AddSingleton؛ لازم thread-safe ولا تحتفظ بـ scoped dependencies
Prototypeنسخ object configured بدل إعادة بنائهCopy/clone؛ وضح shallow/deep copy وتجنب mutable shared children

في ‎.NET غالبًا DI container يقوم بدور factory ويحدد lifecycle. لا تستخدم Singleton كـ global static state؛ تسجيل singleton في DI أسهل للاختبار والإدارة، لكن thread-safety تظل مسؤوليتك.

Creational Patterns بالكود: Factory و Builder و Prototype

Factory Method مناسب عندما creation يعتمد على configuration أو provider، لكن لا تخفي business workflow بداخله. Abstract Factory تنشئ مجموعة متوافقة، مثل storage client + signer + metadata mapper لنفس cloud provider. Builder مناسب عندما object له required/optional fields وقواعد combinations؛ استخدم constructor/record/object initializer لو أبسط.

C#Builder that validates before creating
public sealed class ReportOptions
{
    public DateOnly From { get; }
    public DateOnly To { get; }
    public string Currency { get; }

    private ReportOptions(DateOnly from, DateOnly to, string currency)
    { From = from; To = to; Currency = currency; }

    public static ReportOptions Create(DateOnly from, DateOnly to, string currency)
    {
        if (to < from) throw new ArgumentException("End date precedes start date.");
        if (currency.Length != 3) throw new ArgumentException("Invalid currency code.");
        return new ReportOptions(from, to, currency);
    }
}

Prototype/Clone يحتاج تحديد shallow vs deep copy. لو object يحتوي child lists mutable، shallow copy تشارك children. في C#‎ records with تنسخ top-level members فقط؛ nested references تظل مشتركة. لا تعتمد على MemberwiseClone كنسخ deep. اكتب clone method فقط عندما duplication semantics business واضحة، وإلا factory/reconstruction من immutable snapshot أوضح.

04

Structural Patterns

Compose objects and isolate interfaces
Deep dive
Patternالمشكلة التي يحلهامثال/تحذير
Adapterعدم توافق interface خارجي مع contract داخليPayment provider adapter؛ ترجم errors/currency/status
Decoratorإضافة behavior دون تعديل implementationLogging/caching/metrics؛ راقب wrapping order
Facadeتقديم API بسيطة فوق subsystem معقدCheckout facade؛ لا تتحول إلى God service
Proxyالتحكم في access/lazy/remote behaviorRemote client/proxy؛ انتبه latency/failure semantics
Compositeمعاملة leaf و group بنفس contractFile/folder tree أو bundle؛ لا تفرض child operations على leaf
Bridge / Flyweightفصل abstraction عن implementation / مشاركة state مكلفةمفيد في domains كبيرة أو memory-heavy objects؛ غالبًا ليس أول اختيار في CRUD API
05

Behavioral Patterns

Distribute behavior and communication
Deep dive
Patternالمشكلة‎.NET connection / trade-off
Strategyعدة algorithms لنفس contractPricing/payment policies؛ اختيار implementation عبر DI
Observerإخطار عدة subscribers عند eventC#‎ events/notifications؛ in-process ليس durable
Commandتمثيل intent كـ objectQueueable/retryable commands؛ افصلها عن events
Mediatorتقليل direct coupling بين sender و handlerMediatR/dispatch؛ ليس message broker
Template Methodهيكل algorithm ثابت مع خطوات متغيرةBase class hooks؛ inheritance قد يزيد coupling
Stateالسلوك يتغير حسب lifecycle stateOrder/payment state transitions؛ enum قد يكفي
Chain of Responsibilityتمرير request عبر handlers متتابعينASP.NET middleware/validation pipeline
IteratorTraversal دون كشف collection internalsIEnumerable/IEnumerator و yield return
Visitor / Memento / Interpreterعمليات على object structures / حفظ state / تفسير grammarمتخصصة؛ استخدمها عند structure/operations مستقرة وحاجة فعلية
06

Enterprise Application Patterns

Persistence, requests and configuration
Deep dive
Patternالمشكلةملاحظة ‎.NET
Repository + Unit of Workعزل aggregate persistence وتجميع commitDbContext يوفر change tracking/UoW؛ لا تكرر APIs بلا قيمة
Specificationإعادة استخدام query criteriaExpression trees مع EF Core؛ لا تحولها إلى Func مبكرًا
Result / Optionتمثيل expected failure/absence كقيمةTyped application outcomes؛ لا تخفِ unexpected exceptions
Options Patternتجميع configuration strongly typedIOptions/IOptionsSnapshot/IOptionsMonitor
CQRSفصل write commands عن read queriesابدأ logical داخل نفس DB؛ فصل stores يزيد consistency complexity
Null Objectتنفيذ no-op بدل null branchingمناسب للـ optional behavior؛ لا تخفِ mandatory misconfiguration
07

Cloud / Distributed Patterns

Resilience and cross-service consistency
Deep dive
Patternالمشكلةالتحذير الأساسي
Cache-Asideتقليل repeated reads و latencyInvalidation/staleness/stampede جزء من التصميم
Retry / Circuit Breaker / Bulkhead / Timeoutالتعامل مع transient failures وعزل المواردRetry فقط للأخطاء المناسبة ومع idempotency
Outbox / Inboxربط DB changes بالرسائل واكتشاف duplicate deliveryلا يزال consumer يحتاج idempotency
Sagaتنسيق workflow موزع عبر خدمات متعددةCompensation ليست rollback؛ كل خطوة قد تفشل
Anti-Corruption Layerمنع external model من تلويث domain modelترجم semantics/errors/identifiers لا مجرد أسماء properties
Strangler Figتحديث legacy تدريجيًايتطلب routing/data ownership/observability وخطة إزالة القديم
08

Patterns موجودة بالفعل في ‎.NET

Recognize framework idioms
Practical
  • ASP.NET Core middleware pipeline: Chain of Responsibility.
  • IEnumerable<T> و yield return: Iterator.
  • DI container و IHttpClientFactory: Factory/Composition Root/managed lifecycle.
  • Options pattern: strongly typed configuration.
  • Logging/metrics decorators: Decorator concept.
  • Events/notifications: Observer.
  • EF Core DbContext: Unit of Work + Identity Map + Repository-like sets.
  • Background job command: Command serialization/execution pattern.

تعلم idioms الموجودة يقلل إعادة اختراع framework. اقرأ source/docs عند الحاجة، لكن لا تنسخ internals؛ استخدم public abstractions.

09

Decision Checklist: هل أضيف Pattern؟

A quick architecture review
Practical
  1. ما المشكلة الحالية؟ اكتبها من غير اسم pattern.
  2. ما محور التغيير أو coupling الذي تريد عزله؟
  3. هل pattern تقلل dependencies أم تضيف indirection؟
  4. هل يوجد implementation أو use case ثانٍ يبرر abstraction؟
  5. هل يمكن اختبار السلوك بوضوح؟
  6. ما failure modes والـ operational costs؟
  7. هل الحل المباشر أبسط وأكثر وضوحًا؟

إذا لم تستطع شرح المشكلة التي تحلها pattern، لا تضفها بعد. Pattern الجيدة تجعل design intent واضحًا، لا تجعل القارئ يحفظ اسمًا جديدًا كي يفهم سطرين.

10

اختبر فهمك

Knowledge check
Practical
ما الفرق بين Strategy و Factory؟
Strategy تعزل algorithm/behavior؛ Factory تخفي قرار إنشاء أو اختيار concrete object. قد يعملان معًا.
لماذا DbContext مرتبط بـ Unit of Work؟
لأنه يتتبع التغييرات ويجمعها ثم يحفظها عند SaveChanges.
هل Saga تضمن distributed rollback؟
لا؛ تستخدم compensating business actions، وهي قد تفشل أيضًا.
ما الفرق بين Observer و Outbox؟
Observer غالبًا in-process notification؛ Outbox يسجل message durable مع DB transaction ثم ينشرها.
ما أول سؤال قبل استخدام pattern؟
ما المشكلة الفعلية التي أحاول حلها؟
11

Pattern Selection Scenarios

Start from the symptom
Deep dive

سيناريو 1: إضافة payment provider جديد. Adapter يترجم provider SDK إلى IPaymentGateway، Strategy يعزل طريقة الدفع أو اختيار provider، Factory يختار implementation. لا تحتاج Abstract Factory إلا لو provider يقدم عائلة خدمات يجب أن تكون متوافقة.

سيناريو 2: إضافة logging و metrics حول service. Decorator يلف نفس interface ويضيف instrumentation. لا تعدل business class ولا تجعل كل method تسجل يدويًا. انتبه لترتيب decorators وإخفاء sensitive data.

سيناريو 3: تغيير Order state. enum + guarded methods غالبًا كافٍ. لو كل state لها behavior مختلف ومعقد، State pattern. لو transition يحتاج شروط resource/permission، اجعل application authorization/domain rule واضحة بدل وضعها في UI.

سيناريو 4: إرسال OrderPaid إلى Billing و Shipping. Domain event يعلن الحقيقة داخل context، Outbox يحفظ integration message مع transaction، broker ينشرها، consumers idempotent. Observer in-process وحده لا يضمن delivery بعد crash.

سيناريو 5: query تتكرر كثيرًا. Cache-Aside أو HybridCache إذا reuse و stale tolerance يبرران. لكن أصلح index/N+1 أولًا، وحدد invalidation/failure policy. cache ليست pattern مجانية.

12

Patterns تتعاون: مثال Checkout

A coherent pattern composition
Deep dive

Checkout use case قد يستخدم Command لتمثيل الطلب، Mediator لتوجيهه إلى handler، Strategy لاختيار discount، Factory لاختيار payment processor، Adapter لدمج provider، Repository لتحميل Order، Unit of Work لحفظ changes، Outbox لتسجيل OrderPaid، Decorator لإضافة metrics/retry آمن، و Saga إذا workflow موزع عبر inventory/payment/shipping. لا يعني ذلك أنك يجب تستخدم كل هذه الأنماط؛ كل واحدة تظهر فقط لو المشكلة موجودة.

ارسم sequence diagram يوضح runtime call flow، و dependency diagram يوضح compile-time references. بعض patterns مثل DI/Repository تنظّم structure، وبعضها مثل Outbox/Saga تحمي behavior عبر failures. لا تخلط pattern structural مع distributed guarantee.

13

Pattern Misuse و Anti-Patterns

When abstraction becomes ceremony
Deep dive
  • Singleton service يحتفظ user/session state فيسبب cross-request leakage.
  • Factory تنفذ business workflow بدل creation/selection.
  • Generic repository يكرر كل DbContext APIs ثم يضيف عشرات overloads.
  • Observer event يرسل critical message بلا persistence/outbox.
  • Retry يكرر payment أو email بلا idempotency.
  • Decorator يخفي exceptions أو يغير response semantics.
  • Abstract Factory لعائلة واحدة من implementation بلا variation.
  • State classes كثيرة بينما enum + transition methods تكفي.
  • Null Object يخفي mandatory dependency غير مسجلة.
  • Mediator يخفي call graph ويصعب تتبع execution.

المعيار ليس «هل pattern معروفة؟» بل هل تجعل change/failure/testing أوضح؟ لو لا، احذفها. إزالة abstraction غير نافعة refactoring إيجابي.

14

تمارين اختيار Pattern

Practice the design decision
Practical
  1. نظام شحن يدعم Standard/Express/International وكل نوع له حساب مختلف: صمم Strategy ووضح من يختارها.
  2. مزود دفع خارجي يرجع statuses مختلفة عن domain: صمم Adapter mapping.
  3. تحتاج قياس latency لكل call من غير تعديل service: صمم Decorator وحدد ترتيب logging/retry.
  4. تحتاج نشر OrderConfirmed بعد DB commit: صمم Outbox flow و duplicate handling.
  5. حالة order لها 4 transitions: قرر enum أم State objects مع سبب.
  6. تحتاج تبسيط subsystem فيه inventory/payment/shipping: صمم Facade من غير God service.
  7. تحتاج retry ل HTTP provider: حدد transient errors و idempotency و timeout budget.

لكل تمرين اكتب problem، forces، class diagram صغير، sequence flow، test cases، trade-off وسبب رفض أقرب بديل. ده أهم من حفظ تعريف pattern.

15

Structural Patterns بالكود: Adapter و Facade و Composite و Proxy

Composition without leaking implementation details
Deep dive

Adapter يترجم interface، Facade ينسق subsystem خلف API بسيطة، Proxy يتحكم في access/lazy/remote calls، Composite يمثل tree من leaf/group. Bridge يفصل abstraction hierarchy عن implementation hierarchy عندما الاثنين يتغيران مستقلين. Flyweight يشارك intrinsic immutable state لتقليل memory عند أعداد ضخمة من objects؛ غالبًا غير مطلوب في business API المعتاد.

C#Composite: groups and leaf nodes share a contract
public interface IPriceComponent
{
    decimal CalculateTotal();
}

public sealed class ProductLeaf(decimal price) : IPriceComponent
{
    public decimal CalculateTotal() => price;
}

public sealed class ProductBundle(IEnumerable<IPriceComponent> children) : IPriceComponent
{
    private readonly IPriceComponent[] _children = children.ToArray();
    public decimal CalculateTotal() => _children.Sum(x => x.CalculateTotal());
}

Composite مفيد عندما العمليات على tree واضحة، لكن لا تفرض AddChild على leaf interface لو leaf لا يمكن أن تحتوي children. يمكن فصل ICompositePriceComponent أو إبقاء mutation في builder/factory. لا تجعل tree mutable بلا validation لو child قد يتكرر أو يسبب cycle.

16

Behavioral Patterns بالكود: Command و Iterator و Template Method

Encapsulate actions and traversal
Deep dive

Command يحول request إلى object قابل للتسجيل أو queue، لكن command لا يعني تلقائيًا durability. Iterator يخفي traversal mechanics؛ yield return في C#‎ ينشئ iterator state machine ويؤجل التنفيذ حتى enumeration. Template Method يثبت skeleton في base class ويترك hooks، لكنه قد يجعل inheritance fragile؛ composition غالبًا أسهل عند variation مستقل.

C#Iterator with deferred execution
public static IEnumerable<int> ReadPositive(IEnumerable<int> source)
{
    foreach (var value in source)
    {
        if (value > 0)
            yield return value;
    }
}

// Query runs when enumerated, not when ReadPositive is called.

Deferred execution تعني source قد تتغير بين creation/enumeration، وقد يعاد تنفيذ expensive query أكثر من مرة. لو تحتاج snapshot، materialize بـ ToArray/ToList عند boundary مناسبة. لا تعد enumerate EF Core query بلا داعٍ؛ كل enumeration قد ينفذ database roundtrip.

17

Enterprise Patterns بالكود: Specification و Result و Options

Express query and configuration intent
Deep dive

Specification encapsulates reusable predicate/query semantics؛ مع EF Core احتفظ بـ Expression<Func<T,bool>> حتى provider يترجمها SQL. لو حولتها إلى Func مبكرًا، ممكن تجبر filtering في memory. Result type يعبر عن expected business outcomes، و Option/Maybe عن absence، بينما exceptions للأخطاء غير المتوقعة أو failures التي لا يستطيع caller التعامل معها كقيمة. Options pattern يجمع config مع validation عند startup.

C#Specification that stays translatable
public sealed class PendingOrdersForCustomer(Guid customerId)
{
    public Expression<Func<Order, bool>> Criteria =>
        order => order.CustomerId == customerId && order.Status == OrderStatus.Pending;
}

var criteria = new PendingOrdersForCustomer(customerId).Criteria;
var orders = await db.Orders.Where(criteria).ToListAsync(ct);

Specification ليست دائمًا class؛ أحيانًا expression محلي يكفي. لا تبني specification framework ضخمًا قبل وجود query reuse حقيقي. راجع Includes/ordering/paging/projection لأن predicate وحده لا يمثل كل query semantics.

18

Distributed Patterns: Idempotency و Inbox و Circuit Breaker

The network changes the guarantees
Deep dive

Retry يكرر محاولة؛ لذلك العملية يجب أن تكون idempotent أو محمية بمفتاح idempotency. Inbox يسجل message IDs التي تمت معالجتها لمنع duplicate side effects. Circuit breaker يوقف calls إلى dependency متدهورة مؤقتًا، لكنه لا يعالج queue backlog أو business validation. Bulkhead يعزل concurrency/connection pools. Timeout يحدد budget، و Retry لا يجب أن يتجاوز budget الإجمالي.

C#Idempotent consumer using a message ID
public async Task HandleAsync(OrderPaid message, CancellationToken ct)
{
    if (await inbox.ExistsAsync(message.MessageId, ct)) return;

    await using var tx = await db.Database.BeginTransactionAsync(ct);
    if (await inbox.TryAddAsync(message.MessageId, ct))
    {
        await billing.ApplyPaymentAsync(message.OrderId, message.Amount, ct);
        await db.SaveChangesAsync(ct);
    }
    await tx.CommitAsync(ct);
}

المثال sketch؛ TryAddAsync يجب تكون محمية بـ unique constraint على MessageId داخل نفس transaction، والـ business update/inbox row لازم يتشاركون atomic commit. لو external provider call خارج DB transaction، استخدم outbox/workflow state بدل افتراض atomicity. Duplicate detection in memory لا يكفي عبر multiple instances.

19

Pattern Evolution: من Simple Code إلى Abstraction

Refactor when change pressure becomes real
Deep dive

لا تبدأ بـ 12 interfaces. ابدأ بأبسط implementation يحقق requirement، واكتب tests على behavior. عندما يظهر محور تغيير ثانٍ، استخرج interface/strategy. عندما تظهر عدة providers، أضف adapter/factory. عندما تحتاج side effect موحدًا، أضف decorator. عندما يصبح communication durable عبر process boundary، أضف outbox/broker. ده evolutionary design؛ كل abstraction لها سبب وتكلفة.

سجل في Architecture Decision Record: context، problem، options considered، decision، consequences، rollback/revisit trigger. مثال: «نستخدم modular monolith بدل microservices لأن team صغيرة و transaction boundaries ما زالت مشتركة؛ نعيد التقييم عند independent scaling/ownership needs». ADR يحفظ سبب القرار ويمنع إعادة النقاش بلا سياق.

20

خريطة قرار موسعة: المشكلة هي التي تختار الـ Pattern

Choose by change pressure and failure mode
Deep dive

لو عندك algorithm تتغير حسب نوع العميل، ابدأ بـ Strategy. لو قرار إنشاء concrete type معقد أو يعتمد على configuration، فكر في Factory. لو تحتاج بناء object متعدد الخطوات مع invariant، فكر في Builder. لو SDK خارجي لا يطابق contract الداخلي، Adapter. لو تريد إضافة behavior حول implementation موجودة، Decorator. لو تريد واجهة مبسطة لمجموعة خدمات، Facade. لو تريد التحكم في الوصول أو lazy loading، Proxy.

لو تريد تمثيل طلب قابل للتخزين أو التأجيل أو إعادة التنفيذ، Command. لو عدة receivers يجب إخطارهم، Observer داخل process أو Pub/Sub عبر broker عند الحاجة إلى فصل زمني ومكاني. لو request يمر عبر handlers، Chain of Responsibility. لو السلوك يتغير باختلاف lifecycle state، State. لو تريد توجيه request إلى handler وتقليل direct coupling، Mediator، لكن لا تخلطه مع broker أو durable queue.

لو تريد ضمان حفظ حدث مع تغيير قاعدة البيانات، Outbox. لو workflow يمتد عبر خدمات متعددة مع خطوات وتعويضات، Saga. لو تحتاج تحمل فشل dependency، Timeout + Circuit Breaker + Bulkhead وربما Retry آمن. لو تحتاج عزل model خارجي عن domain، Anti-Corruption Layer. لو تحتاج استعلام reusable بمواصفات قابلة للتركيب، Specification. الاختيار هنا مبني على failure mode وليس على شكل class diagram.

تجنب اختيار Pattern من اسم feature. مثال: “عندي notifications” لا يعني Observer بالضرورة؛ قد تحتاج queue + outbox + delivery state لأن الرسالة يجب أن تستمر بعد restart. و“عندي payment providers” لا يعني Factory فقط؛ تحتاج Strategy لسياسة الدفع، Adapter لكل provider، idempotency key، و resilience policy مناسبة.

21

Patterns مع بعض: تصميم Checkout واقعي

A composed design, not a pattern zoo
Deep dive

في Checkout قد تستخدم Strategy لاختيار pricing policy، Factory لاختيار payment adapter، Decorator لإضافة metrics، Command لتمثيل PlaceOrder، Repository لحفظ aggregate، Outbox لحفظ integration event، و Saga لو inventory/payment عمليات منفصلة. لكن لا يلزم أن تضع كل ده في أول نسخة. ابدأ بعملية محلية بسيطة، ثم أضف Outbox عند الحاجة إلى reliable event delivery، ثم Saga عند ظهور distributed workflow حقيقي.

TextCheckout flow and responsibility boundaries
HTTP Endpoint
  -> PlaceOrder Command
      -> Validate and load customer/cart
      -> Pricing Strategy
      -> Order Aggregate enforces invariants
      -> Payment Adapter (idempotency key)
      -> SQL transaction:
           Orders + OrderItems + OutboxMessage
  -> 202/201 response according to workflow contract

Outbox Worker
  -> publish OrderPlaced
  -> consumer reserves inventory idempotently
  -> workflow advances or compensates

قرار إرجاع 201 أو 202 يعتمد على هل العملية اكتملت قبل response أم أصبحت asynchronous workflow. لا ترجع 200 وتوحي أن المخزون حُجز بينما أنت فقط حفظت رسالة. اجعل API contract يعبر عن Pending/Confirmed بوضوح، ووفّر endpoint للاستعلام عن status عند اللزوم.

22

Structural Patterns Lab: Facade و Composite و Proxy بالكود

Compare intent through small implementations
Deep dive
C#Facade coordinates a complicated subsystem
public sealed class CheckoutFacade(
    ICartReader cart, IPricingService pricing,
    IInventory inventory, IOrderWriter orders)
{
    public async Task<Guid> PlaceAsync(Guid cartId, CancellationToken ct)
    {
        var snapshot = await cart.GetAsync(cartId, ct);
        var quote = await pricing.QuoteAsync(snapshot, ct);
        await inventory.ReserveAsync(quote.Items, ct);
        return await orders.CreateAsync(quote, ct);
    }
}

Facade تبسط واجهة subsystem للمستهلك، لكنها لا ينبغي أن تصبح god service تحتوي كل business rules. راجع transaction/failure boundaries: المثال قد يحتاج compensation لو inventory حجزت وفشل إنشاء الطلب. Proxy يضيف control مثل authorization أو caching أو lazy access؛ Decorator يضيف behavior، وقد يكون نفس الشكل structural لكن النية مختلفة. Composite يبني tree من nodes لها interface مشتركة، مثل folder يحوي files/folders، ويحتاج قواعد recursion ومنع cycles.

23

Behavioral Patterns Lab: Command و State و Chain

Model intent, lifecycle and sequential handlers
Deep dive

Command يمثل طلبًا يمكن وضعه في queue أو حفظ metadata له. State يمثل lifecycle وقواعد الانتقال. Chain يمرر context عبر handlers قد تكمل أو ترفض أو تتوقف. لا تستخدمهم بالتبادل: command ليس event، و state ليس strategy، و chain ليست mediator.

C#Chain handler contract with explicit continuation
public interface IRequestStep<TContext>
{
    Task ExecuteAsync(TContext context, CancellationToken ct);
}
public sealed class RequestPipeline<TContext>(
    IEnumerable<IRequestStep<TContext>> steps)
{
    public async Task RunAsync(TContext context, CancellationToken ct)
    {
        foreach (var step in steps)
            await step.ExecuteAsync(context, ct);
    }
}

الـ pipeline أعلاه ينفذ كل خطوة بالترتيب؛ لو تحتاج short-circuit فعرّف result مثل Continue/Stop بدل exceptions كآلية flow control. ترتيب التسجيل يجب أن يكون صريحًا ومختبرًا. لا تجعل handler يعتمد على ترتيب DI غير موثق.

24

Distributed Patterns Lab: Outbox و Idempotent Consumer

Reliability across database and message broker
Deep dive

Outbox يحل dual-write problem بين database و broker. في transaction واحدة تحفظ business state و outbox row. Background publisher يقرأ pending rows، ينشر message، ثم يعلّمها processed. crash بعد publish وقبل mark قد يؤدي إلى duplicate publish؛ لذلك consumer يحتاج Inbox/deduplication table بمفتاح message ID، وتسجيل أثر المعالجة مع تغيير state في transaction واحدة.

C#Idempotent consumer outline
public async Task HandleAsync(OrderPlaced message, CancellationToken ct)
{
    if (await db.ProcessedMessages.AnyAsync(
        x => x.MessageId == message.Id, ct)) return;

    await using var tx = await db.Database.BeginTransactionAsync(ct);
    db.ProcessedMessages.Add(new ProcessedMessage(message.Id));
    await inventory.ReserveAsync(message.Items, ct);
    await db.SaveChangesAsync(ct);
    await tx.CommitAsync(ct);
}

الكود توضيحي فقط: لو inventory خدمة خارجية فلا تدخل داخل SQL transaction كما لو كانت atomic؛ استخدم saga أو reservation API idempotent مع state machine. لو insert deduplication و business update في نفس database، unique constraint على MessageId يحمي السباق بين consumers. عند duplicate key، اقرأ حالة المعالجة وتعامل معها كـ already processed وفق semantics.

25

Factory Method — إنشاء object من غير ربط العميل بنوعه

Creational pattern · defer construction to a creator
Deep dive

المشكلة: كود التطبيق يحتاج إنشاء exporter أو parser، لكن وضع new PdfExporter() داخل كل use case يربط العميل بنوع محدد ويجعل إضافة نوع جديد تتطلب تعديل أماكن كثيرة. الفكرة: الـ Creator يعرّف factory method، والـ subclasses تختار concrete product. هذا يختلف عن Simple Factory التي غالبًا تكون class واحدة تحتوي اختيارًا مثل switch؛ Factory Method يستخدم polymorphism في قرار الإنشاء.

متى تستخدمه؟ عندما توجد عائلات أو أنواع إنشاء تتغير عبر subclasses أو plugins. متى تتجنبه؟ عندما لديك اختيار صغير ثابت يمكن التعبير عنه بـ DI keyed services أو factory function بسيطة؛ inheritance لمجرد إخفاء new قد يزيد التعقيد.

C#Factory Method: exporter creator
public interface IReportExporter
{
    string Export(string content);
}

public sealed class PdfExporter : IReportExporter
{
    public string Export(string content) => $"PDF:{content}";
}

public abstract class ReportJob
{
    protected abstract IReportExporter CreateExporter();

    public string Run(string report)
    {
        var exporter = CreateExporter();
        return exporter.Export(report);
    }
}

public sealed class PdfReportJob : ReportJob
{
    protected override IReportExporter CreateExporter() => new PdfExporter();
}

اختبار مهم: اختبر Run من خلال contract الخاص بالـ exporter، واختبر أن كل creator يعيد النوع المتوقع. لو الإنشاء يحتاج dependencies خارجية، لا تنشئها يدويًا داخل subclass؛ اجعل composition root أو factory injected مسؤولًا عن lifetime والتهيئة.

26

Abstract Factory — عائلة منتجات متوافقة

Creational pattern · create related product families
Deep dive

المشكلة: واجهة تطبيق لها منتجات مترابطة يجب أن تأتي من نفس العائلة، مثل عناصر واجهة Windows أو Linux، أو مزود تخزين وعميل queue متوافقين مع بيئة معينة. إنشاء كل منتج بشكل مستقل قد ينتج خليطًا غير متوافق. الفكرة: factory interface تنشئ مجموعة من abstractions ذات صلة؛ كل concrete factory تقدم عائلة كاملة.

Trade-off: إضافة عائلة جديدة سهلة نسبيًا، لكن إضافة نوع منتج جديد تتطلب تعديل كل factories. لذلك يناسب محور variation هو family، لا مجرد اختيار class واحدة.

C#Abstract Factory for environment-specific storage
public interface IBlobStore { Task SaveAsync(string key, Stream data, CancellationToken ct); }
public interface IQueuePublisher { Task PublishAsync(string message, CancellationToken ct); }
public interface ICloudResourcesFactory
{
    IBlobStore CreateBlobStore();
    IQueuePublisher CreateQueuePublisher();
}

public sealed class AzureResourcesFactory : ICloudResourcesFactory
{
    public IBlobStore CreateBlobStore() => new AzureBlobStore();
    public IQueuePublisher CreateQueuePublisher() => new AzureQueuePublisher();
}

public sealed class GcpResourcesFactory : ICloudResourcesFactory
{
    public IBlobStore CreateBlobStore() => new GcpBlobStore();
    public IQueuePublisher CreateQueuePublisher() => new GcpPubSubPublisher();
}

الأسماء هنا contracts توضيحية؛ implementations تتصل بالـ SDKs الفعلية. في تطبيق ‎.NET غالبًا تسجل factory المناسبة من configuration/hosting environment في Composition Root، ولا تسمح للـ Domain أن يعرف Azure أو GCP SDK.

27

Builder — بناء كائن معقد مع حماية الـ invariants

Creational pattern · staged construction
Deep dive

المشكلة: constructor به 9 parameters اختيارية يجعل ترتيب القيم غامضًا، وقد ينشئ object ناقصًا أو تركيبة غير صحيحة. الفكرة: Builder يجمع خطوات الإنشاء ويؤجل إنتاج object حتى Build()؛ هناك يمكن التحقق من required fields والعلاقات بينها.

C#Builder with required values and validation
public sealed record ReportOptions(string TenantId, DateOnly From, DateOnly To,
    string Currency, bool IncludeCancelled);

public sealed class ReportOptionsBuilder
{
    private string? _tenant;
    private DateOnly? _from;
    private DateOnly? _to;
    private string _currency = "EGP";
    private bool _includeCancelled;

    public ReportOptionsBuilder ForTenant(string tenant) { _tenant = tenant; return this; }
    public ReportOptionsBuilder Between(DateOnly from, DateOnly to)
    { _from = from; _to = to; return this; }
    public ReportOptionsBuilder InCurrency(string currency)
    { _currency = currency; return this; }
    public ReportOptionsBuilder IncludeCancelled(bool value)
    { _includeCancelled = value; return this; }

    public ReportOptions Build()
    {
        if (string.IsNullOrWhiteSpace(_tenant)) throw new InvalidOperationException("Tenant is required.");
        if (_from is null || _to is null || _from > _to) throw new InvalidOperationException("Invalid date range.");
        if (_currency.Length != 3) throw new InvalidOperationException("Use a 3-letter currency code.");
        return new(_tenant, _from.Value, _to.Value, _currency, _includeCancelled);
    }
}

Builder mutable فلا تشاركه بين requests أو تسجله Singleton. لو object بسيط، استخدم constructor واضح أو record initializer بدل pattern. اختبر missing tenant، range مقلوب، currency غير صحيحة، وتأكد أن Build لا يعيد object قابلًا لتعديل غير مقصود.

28

Prototype — نسخ نموذج مهيأ مع فهم Shallow و Deep Copy

Creational pattern · clone configured instances
Deep dive

المشكلة: إنشاء object جديد من الصفر مكلف أو يحتاج إعدادًا متكررًا. الفكرة: انسخ prototype معروف الإعداد. في C#‎ قد تستخدم copy constructor أو with في records، لكن with ينسخ المراجع السطحية؛ أي إن List داخل record قد تظل مشتركة.

C#Explicit deep copy for mutable child collection
public sealed record LineDraft(string ProductCode, int Quantity);

public sealed class OrderDraft
{
    public string CustomerCode { get; init; } = "";
    public List<LineDraft> Lines { get; init; } = [];

    public OrderDraft DeepCopy() => new()
    {
        CustomerCode = CustomerCode,
        Lines = Lines.Select(x => x with { }).ToList()
    };
}

var template = new OrderDraft { CustomerCode = "C-10", Lines = [new("P-1", 2)] };
var copy = template.DeepCopy();
copy.Lines.Add(new("P-2", 1)); // template.Lines remains unchanged

لا تستخدم reflection cloning عشوائيًا مع EF tracked entities أو streams أو sockets أو objects تحمل handles خارجية. حدد بوضوح ما الذي يُنسخ وما الذي يعاد استخدامه، واختبر عدم تسرب mutable references بين النسخ.

29

Singleton — نسخة واحدة، لكن Lifetime أهم من كلمة Pattern

Creational pattern · one shared instance
Deep dive

الفكرة: instance واحدة على مستوى process. المشكلة ليست كتابة static property فقط؛ المشكلة تحديد نطاق المشاركة، thread safety، disposal، والاختبارات. في ASP.NET Core استخدم DI lifetime غالبًا بدل Singleton يدوي. Singleton لا يعني نسخة واحدة على مستوى cluster؛ كل replica لها instance مستقلة.

C#Register a thread-safe shared service with DI
services.AddSingleton<TimeProvider>(TimeProvider.System);
services.AddSingleton<IClock, SystemClock>();

public sealed class SystemClock(TimeProvider timeProvider) : IClock
{
    public DateTimeOffset UtcNow => timeProvider.GetUtcNow();
}

لا تحقن Scoped DbContext داخل Singleton؛ هذا يسبب captive dependency وتسريب state بين requests. لا تخزن user-specific mutable data في Singleton. لو احتجت static singleton، Lazy<T> يوفر initialization thread-safe افتراضيًا، لكن DI أسهل في الاختبار وإدارة الإغلاق.

30

Adapter — ترجمة Contract خارجي إلى لغتك الداخلية

Structural pattern · make incompatible interfaces work together
Deep dive

المشكلة: SDK خارجي يستخدم أسماء وأنواع أخطاء أو وحدات مختلفة عن domain contract. الفكرة: Adapter يترجم الطلب والنتيجة والاستثناءات والـ cancellation، ويمنع تسرب تفاصيل المورد إلى core. ليس مجرد wrapper شكلي؛ هو boundary يحمي النموذج الداخلي.

C#Adapter translates a vendor payment SDK
public interface IPaymentGateway
{
    Task<PaymentResult> ChargeAsync(Money amount, string idempotencyKey, CancellationToken ct);
}

public sealed class VendorPaymentAdapter(IVendorClient client) : IPaymentGateway
{
    public async Task<PaymentResult> ChargeAsync(Money amount, string key, CancellationToken ct)
    {
        var response = await client.CreatePaymentAsync(
            amount.Amount, amount.Currency, key, ct);
        return response.Status switch
        {
            "approved" => PaymentResult.Approved(response.TransactionId),
            "declined" => PaymentResult.Declined(response.ReasonCode),
            _ => PaymentResult.Pending(response.TransactionId)
        };
    }
}

حدد mapping صريحًا لكل vendor status، ولا تعتبر unknown status نجاحًا. لا تبتلع timeout أو cancellation كأنها decline. اختبر contract adapter ضد vendor sandbox أو recorded contract fixtures، مع حماية بيانات الدفع.

31

Bridge — فصل محورين يتغيران مستقلين

Structural pattern · abstraction apart from implementation
Deep dive

المشكلة: عندك abstraction مثل NotificationChannel وأنواع delivery providers متعددة. الوراثة تنتج combinations مثل EmailWithProviderA و EmailWithProviderB و SmsWithProviderA. الفكرة: Bridge يفصل abstraction hierarchy عن implementation hierarchy ويربطهما بال composition.

C#Bridge: channel and sender vary independently
public interface IMessageSender
{
    Task SendAsync(string destination, string body, CancellationToken ct);
}

public abstract class NotificationChannel(IMessageSender sender)
{
    public abstract Task NotifyAsync(string destination, string message, CancellationToken ct);
    protected Task DeliverAsync(string to, string body, CancellationToken ct) =>
        sender.SendAsync(to, body, ct);
}

public sealed class SmsChannel(IMessageSender sender) : NotificationChannel(sender)
{
    public override Task NotifyAsync(string to, string message, CancellationToken ct) =>
        DeliverAsync(to, message, ct);
}

Bridge قريب من Strategy في الشكل، لكن intent مختلف: Strategy تبدل algorithm ضمن سياق واحد؛ Bridge يفصل بُعدين مستقلين في model. لو عندك implementation واحدة فقط، composition العادي قد يكون كافيًا.

32

Composite — تعامل مع Leaf و Group بنفس الواجهة

Structural pattern · represent part-whole trees
Deep dive

المشكلة: نظام ملفات أو تسعير bundle أو شجرة صلاحيات فيها عناصر مفردة ومجموعات. الفكرة: Component contract مشترك، Leaf تنفذ العمل، و Composite تحتوي أبناء وتفوض لهم recursively. العميل يتعامل مع العقد العام بدل فحص النوع في كل مرة.

C#Composite pricing tree
public interface IPriceComponent { decimal Total(); }
public sealed class ProductPrice(decimal price) : IPriceComponent
{
    public decimal Total() => price;
}
public sealed class BundlePrice : IPriceComponent
{
    private readonly List<IPriceComponent> _children = [];
    public void Add(IPriceComponent child) => _children.Add(child);
    public decimal Total() => _children.Sum(x => x.Total());
}

var bundle = new BundlePrice();
bundle.Add(new ProductPrice(100));
bundle.Add(new ProductPrice(50));
var total = bundle.Total(); // 150

لا تضع Add على interface عامة إذا كان Leaf لا يقبل أبناء. امنع cycles أو duplicate membership إذا كانت قواعد المجال تتطلب ذلك، وفكر في recursion depth عند أشجار ضخمة أو مدخلات غير موثوقة.

33

Decorator — أضف سلوكًا مع الحفاظ على نفس Contract

Structural pattern · wrap without modifying the component
Deep dive

المشكلة: تحتاج metrics أو caching أو auditing حول خدمة موجودة من غير تعديلها أو إنشاء subclasses لكل combination. الفكرة: decorator يطبق نفس interface ويحتفظ بـ inner component ثم يضيف behavior قبل/بعد التفويض. ترتيب decorators يغيّر semantics.

C#Decorator adds timing around a repository
public interface IProductReader { Task<Product?> GetAsync(Guid id, CancellationToken ct); }
public sealed class TimedProductReader(
    IProductReader inner, ILogger<TimedProductReader> logger) : IProductReader
{
    public async Task<Product?> GetAsync(Guid id, CancellationToken ct)
    {
        var started = Stopwatch.GetTimestamp();
        try { return await inner.GetAsync(id, ct); }
        finally { logger.LogInformation("Read took {Ms}ms", Stopwatch.GetElapsedTime(started).TotalMilliseconds); }
    }
}

Decorator يجب يحافظ على exceptions و cancellation و return semantics. لا تسجل secrets أو PII. اختبر decorator منفردًا باستخدام fake inner، واختبر ترتيب التسجيل في DI. لا تضع retry حول non-idempotent operation بلا idempotency strategy.

34

Facade — واجهة مبسطة أمام Subsystem

Structural pattern · simplify a complex subsystem
Deep dive

المشكلة: consumer يحتاج استدعاء خمس خدمات بترتيب معين لفعل use case شائع. الفكرة: Facade يقدم API أعلى مستوى ويخفي تفاصيل التنسيق. لا يعني نقل كل business rules إلى class ضخمة؛ حافظ على ownership للـ invariants والـ transaction.

C#Facade coordinates an export workflow
public sealed class StudentExportFacade(
    IStudentReader students, ISpreadsheetWriter writer, IFileStore files)
{
    public async Task<string> ExportAsync(Guid courseId, CancellationToken ct)
    {
        var rows = await students.GetForCourseAsync(courseId, ct);
        await using var stream = await writer.WriteAsync(rows, ct);
        return await files.SaveAsync($"courses/{courseId}/students.xlsx", stream, ct);
    }
}

Facade قد تنسق orchestration، لكنها لا يجب أن تصبح God Object. لو الخطوات تتضمن side effects موزعة، عرّف partial failure/compensation، ولا تفترض أن عدة خدمات تشترك في transaction واحدة.

35

Flyweight — مشاركة الحالة الثابتة لتقليل الذاكرة

Structural pattern · share intrinsic state
Deep dive

المشكلة: عدد هائل من objects المتشابهة يكرر بيانات ثابتة مثل font metadata أو map icons. الفكرة: افصل intrinsic state المشتركة عن extrinsic state الخاصة بكل occurrence، وشارك الكائنات غير القابلة للتغيير. الهدف memory footprint لا مجرد cache لأي شيء.

C#Flyweight factory for immutable glyph styles
public sealed record GlyphStyle(string Font, int Size, string Color);
public sealed class GlyphStyleFactory
{
    private readonly ConcurrentDictionary<GlyphStyle, GlyphStyle> _pool = new();
    public GlyphStyle Get(string font, int size, string color)
    {
        var key = new GlyphStyle(font, size, color);
        return _pool.GetOrAdd(key, key);
    }
}
// Position and character value are extrinsic state; style is shared.

الـ pool هنا قد ينمو بلا حد؛ استخدم bounded cache أو known finite key space عند بيانات غير محدودة. لا تشارك mutable objects بين tenants أو requests. قِس allocation/GC قبل وبعد، لأن complexity الإضافية قد لا تستحق إذا كان العدد صغيرًا.

36

Proxy — تحكم في الوصول مع الحفاظ على Contract

Structural pattern · stand in for another object
Deep dive

المشكلة: الوصول إلى resource مكلف أو حساس أو بعيد. الفكرة: Proxy يقدم نفس interface ويضيف authorization أو lazy loading أو remote access أو caching. الفرق عن Decorator في intent: Decorator يضيف behavior؛ Proxy يتحكم في الوصول/الإنشاء/الموقع، مع أن الشكل البنيوي متقارب.

C#Protection Proxy checks access before delegation
public sealed class ProtectedDocumentReader(
    IDocumentReader inner, ICurrentUser currentUser) : IDocumentReader
{
    public async Task<Document?> GetAsync(Guid id, CancellationToken ct)
    {
        if (!currentUser.IsAuthenticated)
            throw new UnauthorizedAccessException();
        var document = await inner.GetAsync(id, ct);
        if (document is not null && !document.CanRead(currentUser.UserId))
            throw new UnauthorizedAccessException();
        return document;
    }
}

Proxy ليس بديلًا عن authorization مركزي موثوق؛ تأكد أن كل path للوصول يمر بالتحقق. Remote proxy يجب يوضح latency، timeout، retry policy، serialization، و network exceptions بدل تمويه network كاستدعاء local عادي.

37

Chain of Responsibility — Pipeline من handlers

Behavioral pattern · pass a request through handlers
Deep dive

المشكلة: مجموعة خطوات مثل validation و authorization و enrichment يجب تنفيذها بالترتيب، وكل خطوة قد ترفض أو تكمل. الفكرة: كل handler يعرف التالي أو pipeline يدير sequence. ASP.NET Core middleware مثال واضح. حدد هل كل handler ملزم بالاستمرار، وهل يمكن short-circuit، وكيف تظهر أسباب الرفض.

C#Explicit validation chain
public sealed record Signup(string Email, int Age);
public interface ISignupStep { Signup Validate(Signup input); }
public sealed class EmailStep : ISignupStep
{
    public Signup Validate(Signup input)
    {
        if (!input.Email.Contains('@')) throw new ValidationException("Invalid email.");
        return input;
    }
}
public sealed class AgeStep : ISignupStep
{
    public Signup Validate(Signup input)
    {
        if (input.Age < 18) throw new ValidationException("Must be an adult.");
        return input;
    }
}

لا تجعل ترتيب handlers المخفي في DI ترتيب business غير موثق. اجعل priority أو pipeline declaration صريحة. اختبر short-circuit والـ order والـ duplicate registration. لو الخطوات مستقلة ويمكن جمع كل أخطائها، قد يكون validator مركبًا أفضل من chain تتوقف عند أول خطأ.

38

Command — حوّل الطلب إلى Object له هوية

Behavioral pattern · encapsulate an action
Deep dive

المشكلة: تريد تمثيل action كبيانات يمكن تمريرها أو queue أو retry أو audit. الفكرة: Command object يحمل intent والبيانات؛ handler ينفذه. Command يختلف عن Event: command يطلب فعلًا وقد يرفض؛ event يصف حقيقة حدثت. وجود class باسم Command لا يجعلها durable أو idempotent تلقائيًا.

C#Command and handler with idempotency key
public sealed record CreateInvoice(Guid OrderId, string IdempotencyKey);
public sealed class CreateInvoiceHandler(IInvoiceRepository invoices)
{
    public async Task<Guid> HandleAsync(CreateInvoice command, CancellationToken ct)
    {
        var existing = await invoices.FindByKeyAsync(command.IdempotencyKey, ct);
        if (existing is not null) return existing.Id;
        var invoice = Invoice.Create(command.OrderId, command.IdempotencyKey);
        await invoices.AddAsync(invoice, ct);
        return invoice.Id;
    }
}

في التزامن، check-then-insert وحده غير كافٍ؛ ضع unique constraint على idempotency key وتعامل مع duplicate-key race. لو command تتنفذ عبر broker، احفظ state والنتيجة أو inbox record بحيث إعادة التسليم لا تكرر side effects.

39

Interpreter — تمثيل Grammar صغيرة كـ Object Tree

Behavioral pattern · evaluate a small language
Deep dive

المشكلة: لديك لغة صغيرة جدًا مثل شروط تسعير أو expression rules. الفكرة: كل grammar rule تمثلها expression node تعرف كيف تفسر نفسها. لا تكتب Interpreter يدويًا للغات كبيرة؛ استخدم parser/grammar tooling أو expression trees. انتبه إلى resource limits إذا كان المستخدم هو من يرسل expression.

C#Interpreter for a tiny boolean rule language
public interface IRule { bool Evaluate(IReadOnlyDictionary<string, bool> facts); }
public sealed record Fact(string Name) : IRule
{
    public bool Evaluate(IReadOnlyDictionary<string, bool> facts) => facts.GetValueOrDefault(Name);
}
public sealed record And(IRule Left, IRule Right) : IRule
{
    public bool Evaluate(IReadOnlyDictionary<string, bool> facts) =>
        Left.Evaluate(facts) && Right.Evaluate(facts);
}
public sealed record Not(IRule Inner) : IRule
{
    public bool Evaluate(IReadOnlyDictionary<string, bool> facts) => !Inner.Evaluate(facts);
}

هذا AST لا parser؛ parser يجب يتحقق من tokens والأقواس والـ grammar قبل البناء. امنع arbitrary reflection أو dynamic code execution. اختبر precedence و nested expressions والحد الأقصى للعمق/عدد nodes.

40

Iterator — traversal من غير كشف تفاصيل التخزين

Behavioral pattern · expose sequential access
Deep dive

المشكلة: المستهلك يحتاج المرور على عناصر collection دون معرفة هل تخزن في list أو tree أو stream. الفكرة: Iterator يقدم next/current أو IEnumerable<T>. في C#‎ yield return ينشئ state machine ويجعل التنفيذ deferred حتى enumeration؛ لذلك query قد تنفذ أكثر من مرة.

C#Iterator with yield and explicit cancellation for async streams
public static IEnumerable<int> Positive(IEnumerable<int> source)
{
    foreach (var item in source)
        if (item > 0) yield return item;
}

public static async IAsyncEnumerable<Order> ReadOrdersAsync(
    IOrderFeed feed,
    [EnumeratorCancellation] CancellationToken ct = default)
{
    await foreach (var order in feed.ReadAllAsync(ct))
        if (order.IsActive) yield return order;
}

لا تعد enumerate query مكلفة مرتين بلا قصد؛ materialize عند الحاجة إلى snapshot. IAsyncEnumerable مناسب للبيانات المتدفقة، لكن راقب disposal و cancellation والـ backpressure في المصدر. اختبر empty sequence و early break وإلغاء enumeration.

41

Mediator — قلل الاتصالات المباشرة بين Components

Behavioral pattern · centralize request dispatch
Deep dive

المشكلة: عدة UI components أو application services تتواصل مباشرة في شبكة dependencies معقدة. الفكرة: Mediator يستقبل message ويوجهها إلى colleague/handler المناسب. في ‎.NET قد يظهر عبر MediatR أو mediator بسيط. هو داخل العملية عادة؛ لا يضمن persistence أو delivery بعد restart مثل broker.

C#Minimal mediator contract and dispatch
public interface IRequest<TResponse> { }
public interface IRequestHandler<TRequest, TResponse>
    where TRequest : IRequest<TResponse>
{
    Task<TResponse> HandleAsync(TRequest request, CancellationToken ct);
}
public sealed record GetOrder(Guid Id) : IRequest<OrderDto?>;
public sealed class GetOrderHandler(IOrderReader reader)
    : IRequestHandler<GetOrder, OrderDto?>
{
    public Task<OrderDto?> HandleAsync(GetOrder request, CancellationToken ct) =>
        reader.FindAsync(request.Id, ct);
}

المثال يوضح contract وليس dispatcher registration. لا تجعل كل method Mediator request بلا حاجة؛ كثرة indirection تصعّب navigation/debugging. ضع cross-cutting pipeline behaviors للـ logging/validation فقط عندما تكون semantics موحدة ومعلنة.

42

Memento — حفظ Snapshot لاستعادة حالة سابقة

Behavioral pattern · capture and restore state safely
Deep dive

المشكلة: تحتاج Undo/Redo أو rollback محلي لتغييرات في editor. الفكرة: Originator ينشئ snapshot لا يكشف internals، و Caretaker يحتفظ به ويعيده. في systems الكبيرة قد يكون snapshot مكلفًا؛ استخدم command history أو event log أو diff حسب حجم الحالة.

C#Memento for a text editor
public sealed class TextEditor
{
    public string Text { get; private set; } = "";
    public void Append(string value) => Text += value;
    public Snapshot Save() => new(Text);
    public void Restore(Snapshot snapshot) => Text = snapshot.Text;
    public sealed record Snapshot(string Text);
}

var editor = new TextEditor();
editor.Append("Hello");
var checkpoint = editor.Save();
editor.Append(" world");
editor.Restore(checkpoint); // Hello

لا تستخدم memento لتخزين secrets في plain text أو لحفظ state غير قابلة للتسلسل بلا سياسة. حدد snapshot versioning لو ستخزنها على القرص، واختبر restore بعد schema evolution.

43

Observer — إشعار Subscribers بتغير داخل العملية

Behavioral pattern · publish state changes to observers
Deep dive

المشكلة: publisher لا يريد معرفة كل consumers. الفكرة: subscribers يسجلون interest ويتلقون notification. C#‎ events مناسبة لأحداث محلية بسيطة؛ أما async delivery الموثوقة أو across processes فتحتاج queue/outbox. افهم memory leaks من event subscriptions الطويلة، واستثناء subscriber الذي قد يمنع الآخرين من التنفيذ.

C#Observer using .NET event pattern
public sealed class StockPriceFeed
{
    public event EventHandler<PriceChangedEventArgs>? PriceChanged;
    public void Publish(string symbol, decimal price) =>
        PriceChanged?.Invoke(this, new PriceChangedEventArgs(symbol, price));
}
public sealed class PriceChangedEventArgs(string symbol, decimal price) : EventArgs
{
    public string Symbol { get; } = symbol;
    public decimal Price { get; } = price;
}

var feed = new StockPriceFeed();
feed.PriceChanged += (_, e) => Console.WriteLine($"{e.Symbol}: {e.Price}");

في تطبيق UI افصل subscription عند التخلص من component. لو subscribers asynchronous أو يجب عزل فشل كل واحد، صمم dispatch policy صريحة. لا تخلط Observer مع event sourcing: observer notification ليست بالضرورة سجلًا دائمًا للحقيقة.

44

State — اجعل قواعد الانتقال جزءًا من الـ Lifecycle

Behavioral pattern · behavior depends on current state
Deep dive

المشكلة: شروط متكررة من نوع if status == ... منتشرة في كل use case، ويمكن تنفيذ transition غير مسموح. الفكرة: encapsulate state transitions. قد يكفي enum + methods؛ class-per-state مفيد عندما لكل state سلوك غني ومتغير.

C#State machine with guarded transitions
public enum OrderStatus { Draft, Submitted, Paid, Shipped, Cancelled }
public sealed class OrderLifecycle
{
    public OrderStatus Status { get; private set; } = OrderStatus.Draft;
    public void Submit()
    {
        if (Status != OrderStatus.Draft) throw new InvalidOperationException();
        Status = OrderStatus.Submitted;
    }
    public void MarkPaid()
    {
        if (Status != OrderStatus.Submitted) throw new InvalidOperationException();
        Status = OrderStatus.Paid;
    }
    public void Ship()
    {
        if (Status != OrderStatus.Paid) throw new InvalidOperationException();
        Status = OrderStatus.Shipped;
    }
}

اختبر transition matrix: كل state مع كل command، بما في ذلك transitions المرفوضة. عند concurrent updates استخدم optimistic concurrency/rowversion حتى لا ينجح transition بناءً على state قديمة. لا تخلط state pattern مع Strategy: state يتغير مع lifecycle؛ strategy تختار algorithm.

45

Strategy — بدّل Algorithm دون تغيير المستهلك

Behavioral pattern · encapsulate interchangeable algorithms
Deep dive

المشكلة: قواعد الشحن أو الضرائب أو الخصم تتغير حسب البلد أو العميل. الفكرة: contract واحد لسياسات مختلفة، والعميل يعتمد على abstraction. لا تضع كل business logic في switch مركزي يتضخم، لكن لا تحوّل enum بسيطًا إلى 20 class بلا variation حقيقي.

C#Strategy for shipping quotes
public interface IShippingStrategy
{
    bool Supports(string countryCode);
    decimal Calculate(decimal weightKg, decimal distanceKm);
}
public sealed class LocalShipping : IShippingStrategy
{
    public bool Supports(string countryCode) => countryCode == "EG";
    public decimal Calculate(decimal weightKg, decimal distanceKm) =>
        25m + weightKg * 3m + distanceKm * 0.2m;
}
public sealed class InternationalShipping : IShippingStrategy
{
    public bool Supports(string countryCode) => countryCode != "EG";
    public decimal Calculate(decimal weightKg, decimal distanceKm) =>
        150m + weightKg * 12m + distanceKm * 1.5m;
}

اجعل selection deterministic، وتعامل مع عدم وجود strategy أو وجود أكثر من match. اختبر boundary values و currency/rounding. إذا كانت الخوارزمية تحتاج بيانات خارجية، افصل quote retrieval عن pure calculation لتسهيل الاختبار.

46

Template Method — ثبّت Skeleton واترك Hooks محددة

Behavioral pattern · define algorithm steps in a base type
Deep dive

المشكلة: عدة jobs تتبع خطوات عامة ثابتة لكن تختلف في خطوة أو اثنتين. الفكرة: base class تحدد algorithm skeleton وتستدعي abstract/virtual hooks. الخطر: inheritance coupling و fragile base class؛ composition غالبًا أفضل إذا كان الاختلاف يتغير وقت التشغيل.

C#Template Method for import jobs
public abstract class ImportJob
{
    public async Task RunAsync(Stream input, CancellationToken ct)
    {
        var rows = await ParseAsync(input, ct);
        Validate(rows);
        await PersistAsync(rows, ct);
    }
    protected abstract Task<IReadOnlyList<string[]>> ParseAsync(Stream input, CancellationToken ct);
    protected virtual void Validate(IReadOnlyList<string[]> rows)
    {
        if (rows.Count == 0) throw new InvalidDataException("File is empty.");
    }
    protected abstract Task PersistAsync(IReadOnlyList<string[]> rows, CancellationToken ct);
}

لا تضع dependency acquisition داخل base class عبر service locator. اختبر ترتيب الخطوات، failure في كل خطوة، وعدم استدعاء Persist عند فشل validation. لو subclass تحتاج تخطي خطوات كثيرة، فربما الـ template abstraction لا تمثل workflow موحدًا أصلًا.

47

Visitor — أضف عمليات على Object Structure دون تعديل الأنواع

Behavioral pattern · externalize operations over a stable hierarchy
Deep dive

المشكلة: لديك hierarchy ثابتة نسبيًا وتحتاج عمليات متعددة مثل export/validation/metrics. الفكرة: Visitor يضيف operation خارج العناصر، ويستخدم double dispatch للوصول إلى النوع الفعلي. Trade-off: إضافة operation جديدة سهلة، لكن إضافة node type جديد تتطلب تعديل كل visitors؛ لذلك مناسب عندما hierarchy مستقرة والعمليات كثيرة.

C#Visitor over a small expression hierarchy
public interface IExpressionVisitor<T>
{
    T Visit(NumberExpression node);
    T Visit(AddExpression node);
}
public interface IExpression { T Accept<T>(IExpressionVisitor<T> visitor); }
public sealed record NumberExpression(int Value) : IExpression
{
    public T Accept<T>(IExpressionVisitor<T> visitor) => visitor.Visit(this);
}
public sealed record AddExpression(IExpression Left, IExpression Right) : IExpression
{
    public T Accept<T>(IExpressionVisitor<T> visitor) => visitor.Visit(this);
}
public sealed class EvaluateVisitor : IExpressionVisitor<int>
{
    public int Visit(NumberExpression node) => node.Value;
    public int Visit(AddExpression node) => node.Left.Accept(this) + node.Right.Accept(this);
}

في C#‎ الحديث قد يكون pattern matching على records أبسط وأكثر أمانًا للأنواع القليلة. Visitor يفيد عندما تريد فصل عمليات كثيرة على AST أو document model. اختبر كل node type مع كل visitor operation.

48

مصفوفة اختيار GoF: المشكلة، النمط، البديل الأبسط

A practical selection matrix
Deep dive

لا تختَر النمط لأن اسمه مشهور. اسأل عن محور التغيير، lifecycle، عدد التركيبات، وما إذا كان التغيير compile-time أو runtime. البديل الأبسط غالبًا يكون function أو composition أو switch محدودًا أو DI registration.

المشكلةPatternبديل أبسط/تحذير
إنشاء concrete product عبر creator hierarchyFactory MethodConstructor أو factory function
عائلة منتجات متوافقةAbstract FactoryDI registration واحد لكل environment
إنشاء object متعدد الخطواتBuilderConstructor / record initializer
نسخ نموذج configuredPrototypeCopy constructor / record with
نسخة واحدة process-wideSingletonDI Singleton lifetime مع تجنب mutable global state
SDK غير متوافق مع domainAdapterMapping function إن كانت بسيطة
بُعدان يتغيران مستقلينBridgeComposition عادي
Leaf ومجموعات في treeCompositeList recursion مباشرة
إضافة behavior حول contractDecoratorMiddleware أو wrapper بسيط
واجهة مبسطة لـ subsystemFacadeApplication service واحدة متماسكة
مشاركة state متكررة لتقليل الذاكرةFlyweightImmutable data / bounded cache
التحكم في الوصول أو lazy/remoteProxyAuthorization/service boundary مباشرة
تسلسل handlersChainقائمة خطوات واضحة أو middleware
Action قابلة للتخزين/التأجيلCommandMethod call إذا لا توجد حاجة لتمثيلها
لغة صغيرة قابلة للتفسيرInterpreterParser/expression library
Traversal موحدIteratorIEnumerable / IAsyncEnumerable
تقليل direct coupling بين colleaguesMediatorDirect dependency لو العلاقات قليلة
Undo/restore snapshotMementoCommand history أو diff
إشعار subscribersObserverDurable broker لو cross-process
سلوك يعتمد على lifecycleStateEnum + guarded methods
تبديل algorithmStrategyDelegate أو switch صغير
Skeleton ثابت بخطوات قابلة للتخصيصTemplate MethodComposition / pipeline
عمليات متعددة على hierarchy مستقرةVisitorPattern matching / switch expression
↗

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

References & further reading

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

خريطة التغطية: 31 عنصر من الـ Roadmap ومكان شرحه في الدرس
PatternCreational · Factory Method / Abstract Factory§01
PatternCreational · Builder§01
PatternCreational · Singleton (as a DI lifetime)§01
PatternCreational · Prototype§01
PatternStructural · Adapter§01
PatternStructural · Decorator§01
PatternStructural · Facade§01
PatternStructural · Proxy§01
PatternStructural · Composite§01
PatternStructural · Bridge / Flyweight§01
PatternBehavioral · Strategy§01
PatternBehavioral · Observer§01
PatternBehavioral · Command§01
PatternBehavioral · Mediator§01
PatternBehavioral · Template Method§01
PatternBehavioral · State§01
PatternBehavioral · Chain of Responsibility§01
PatternBehavioral · Iterator§01
PatternBehavioral · Visitor / Memento / Interpreter§01
PatternEnterprise · Repository + Unit of Work§01
PatternEnterprise · Specification§01
PatternEnterprise · Result / Option§01
PatternEnterprise · Options pattern§01
PatternEnterprise · CQRS§01
PatternEnterprise · Null Object§01
PatternCloud / Distributed · Cache-Aside§01
PatternCloud / Distributed · Retry, Circuit Breaker, Bulkhead, Timeout§01
PatternCloud / Distributed · Outbox / Inbox§01
PatternCloud / Distributed · Saga§01
PatternCloud / Distributed · Anti-Corruption Layer§01
PatternCloud / Distributed · Strangler Fig§01

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

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