اقرأ الخريطة كأداة اختيار لا كقائمة حفظ
كل 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 أو تواجه مشكلة، ولا تحاول إدخالها كلها في مشروع واحد.
خريطة الأنماط حسب المشكلة
Creational Patterns
| Pattern | المشكلة التي يحلها | إشارة .NET / ملاحظة |
|---|---|---|
| Factory Method | إخفاء اختيار concrete type خلف creation contract | Factory class/DI keyed selection؛ لا تلف new البسيطة |
| Abstract Factory | إنشاء عائلة objects متوافقة | Provider-specific adapters/configurations؛ مفيد عند عائلات متعددة |
| Builder | إنشاء object معقد بخطوات/اختيارات | Fluent builders و Options APIs؛ لا تحتاجه لكل DTO |
| Singleton | Instance واحدة مشتركة ذات 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 لو أبسط.
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 أوضح.
Structural Patterns
| Pattern | المشكلة التي يحلها | مثال/تحذير |
|---|---|---|
| Adapter | عدم توافق interface خارجي مع contract داخلي | Payment provider adapter؛ ترجم errors/currency/status |
| Decorator | إضافة behavior دون تعديل implementation | Logging/caching/metrics؛ راقب wrapping order |
| Facade | تقديم API بسيطة فوق subsystem معقد | Checkout facade؛ لا تتحول إلى God service |
| Proxy | التحكم في access/lazy/remote behavior | Remote client/proxy؛ انتبه latency/failure semantics |
| Composite | معاملة leaf و group بنفس contract | File/folder tree أو bundle؛ لا تفرض child operations على leaf |
| Bridge / Flyweight | فصل abstraction عن implementation / مشاركة state مكلفة | مفيد في domains كبيرة أو memory-heavy objects؛ غالبًا ليس أول اختيار في CRUD API |
Behavioral Patterns
| Pattern | المشكلة | .NET connection / trade-off |
|---|---|---|
| Strategy | عدة algorithms لنفس contract | Pricing/payment policies؛ اختيار implementation عبر DI |
| Observer | إخطار عدة subscribers عند event | C# events/notifications؛ in-process ليس durable |
| Command | تمثيل intent كـ object | Queueable/retryable commands؛ افصلها عن events |
| Mediator | تقليل direct coupling بين sender و handler | MediatR/dispatch؛ ليس message broker |
| Template Method | هيكل algorithm ثابت مع خطوات متغيرة | Base class hooks؛ inheritance قد يزيد coupling |
| State | السلوك يتغير حسب lifecycle state | Order/payment state transitions؛ enum قد يكفي |
| Chain of Responsibility | تمرير request عبر handlers متتابعين | ASP.NET middleware/validation pipeline |
| Iterator | Traversal دون كشف collection internals | IEnumerable/IEnumerator و yield return |
| Visitor / Memento / Interpreter | عمليات على object structures / حفظ state / تفسير grammar | متخصصة؛ استخدمها عند structure/operations مستقرة وحاجة فعلية |
Enterprise Application Patterns
| Pattern | المشكلة | ملاحظة .NET |
|---|---|---|
| Repository + Unit of Work | عزل aggregate persistence وتجميع commit | DbContext يوفر change tracking/UoW؛ لا تكرر APIs بلا قيمة |
| Specification | إعادة استخدام query criteria | Expression trees مع EF Core؛ لا تحولها إلى Func مبكرًا |
| Result / Option | تمثيل expected failure/absence كقيمة | Typed application outcomes؛ لا تخفِ unexpected exceptions |
| Options Pattern | تجميع configuration strongly typed | IOptions/IOptionsSnapshot/IOptionsMonitor |
| CQRS | فصل write commands عن read queries | ابدأ logical داخل نفس DB؛ فصل stores يزيد consistency complexity |
| Null Object | تنفيذ no-op بدل null branching | مناسب للـ optional behavior؛ لا تخفِ mandatory misconfiguration |
Cloud / Distributed Patterns
| Pattern | المشكلة | التحذير الأساسي |
|---|---|---|
| Cache-Aside | تقليل repeated reads و latency | Invalidation/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 وخطة إزالة القديم |
Patterns موجودة بالفعل في .NET
- 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.
Decision Checklist: هل أضيف Pattern؟
- ما المشكلة الحالية؟ اكتبها من غير اسم pattern.
- ما محور التغيير أو coupling الذي تريد عزله؟
- هل pattern تقلل dependencies أم تضيف indirection؟
- هل يوجد implementation أو use case ثانٍ يبرر abstraction؟
- هل يمكن اختبار السلوك بوضوح؟
- ما failure modes والـ operational costs؟
- هل الحل المباشر أبسط وأكثر وضوحًا؟
إذا لم تستطع شرح المشكلة التي تحلها pattern، لا تضفها بعد. Pattern الجيدة تجعل design intent واضحًا، لا تجعل القارئ يحفظ اسمًا جديدًا كي يفهم سطرين.
اختبر فهمك
ما الفرق بين Strategy و Factory؟
لماذا DbContext مرتبط بـ Unit of Work؟
هل Saga تضمن distributed rollback؟
ما الفرق بين Observer و Outbox؟
ما أول سؤال قبل استخدام pattern؟
Pattern Selection Scenarios
سيناريو 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 مجانية.
Patterns تتعاون: مثال Checkout
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.
Pattern Misuse و Anti-Patterns
- 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 إيجابي.
تمارين اختيار Pattern
- نظام شحن يدعم Standard/Express/International وكل نوع له حساب مختلف: صمم Strategy ووضح من يختارها.
- مزود دفع خارجي يرجع statuses مختلفة عن domain: صمم Adapter mapping.
- تحتاج قياس latency لكل call من غير تعديل service: صمم Decorator وحدد ترتيب logging/retry.
- تحتاج نشر OrderConfirmed بعد DB commit: صمم Outbox flow و duplicate handling.
- حالة order لها 4 transitions: قرر enum أم State objects مع سبب.
- تحتاج تبسيط subsystem فيه inventory/payment/shipping: صمم Facade من غير God service.
- تحتاج retry ل HTTP provider: حدد transient errors و idempotency و timeout budget.
لكل تمرين اكتب problem، forces، class diagram صغير، sequence flow، test cases، trade-off وسبب رفض أقرب بديل. ده أهم من حفظ تعريف pattern.
Structural Patterns بالكود: Adapter و Facade و Composite و Proxy
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 المعتاد.
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.
Behavioral Patterns بالكود: Command و Iterator و Template Method
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 مستقل.
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.
Enterprise Patterns بالكود: Specification و Result و Options
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.
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.
Distributed Patterns: Idempotency و Inbox و Circuit Breaker
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 الإجمالي.
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.
Pattern Evolution: من Simple Code إلى Abstraction
لا تبدأ بـ 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 يحفظ سبب القرار ويمنع إعادة النقاش بلا سياق.
خريطة قرار موسعة: المشكلة هي التي تختار الـ Pattern
لو عندك 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 مناسبة.
Patterns مع بعض: تصميم Checkout واقعي
في 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 حقيقي.
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 عند اللزوم.
Structural Patterns Lab: Facade و Composite و Proxy بالكود
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.
Behavioral Patterns Lab: Command و State و Chain
Command يمثل طلبًا يمكن وضعه في queue أو حفظ metadata له. State يمثل lifecycle وقواعد الانتقال. Chain يمرر context عبر handlers قد تكمل أو ترفض أو تتوقف. لا تستخدمهم بالتبادل: command ليس event، و state ليس strategy، و chain ليست mediator.
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 غير موثق.
Distributed Patterns Lab: Outbox و Idempotent Consumer
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 واحدة.
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.
Factory Method — إنشاء object من غير ربط العميل بنوعه
المشكلة: كود التطبيق يحتاج إنشاء 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 قد يزيد التعقيد.
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 والتهيئة.
Abstract Factory — عائلة منتجات متوافقة
المشكلة: واجهة تطبيق لها منتجات مترابطة يجب أن تأتي من نفس العائلة، مثل عناصر واجهة Windows أو Linux، أو مزود تخزين وعميل queue متوافقين مع بيئة معينة. إنشاء كل منتج بشكل مستقل قد ينتج خليطًا غير متوافق. الفكرة: factory interface تنشئ مجموعة من abstractions ذات صلة؛ كل concrete factory تقدم عائلة كاملة.
Trade-off: إضافة عائلة جديدة سهلة نسبيًا، لكن إضافة نوع منتج جديد تتطلب تعديل كل factories. لذلك يناسب محور variation هو family، لا مجرد اختيار class واحدة.
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.
Builder — بناء كائن معقد مع حماية الـ invariants
المشكلة: constructor به 9 parameters اختيارية يجعل ترتيب القيم غامضًا، وقد ينشئ object ناقصًا أو تركيبة غير صحيحة. الفكرة: Builder يجمع خطوات الإنشاء ويؤجل إنتاج object حتى Build()؛ هناك يمكن التحقق من required fields والعلاقات بينها.
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 قابلًا لتعديل غير مقصود.
Prototype — نسخ نموذج مهيأ مع فهم Shallow و Deep Copy
المشكلة: إنشاء object جديد من الصفر مكلف أو يحتاج إعدادًا متكررًا. الفكرة: انسخ prototype معروف الإعداد. في C# قد تستخدم copy constructor أو with في records، لكن with ينسخ المراجع السطحية؛ أي إن List داخل record قد تظل مشتركة.
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 بين النسخ.
Singleton — نسخة واحدة، لكن Lifetime أهم من كلمة Pattern
الفكرة: instance واحدة على مستوى process. المشكلة ليست كتابة static property فقط؛ المشكلة تحديد نطاق المشاركة، thread safety، disposal، والاختبارات. في ASP.NET Core استخدم DI lifetime غالبًا بدل Singleton يدوي. Singleton لا يعني نسخة واحدة على مستوى cluster؛ كل replica لها instance مستقلة.
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 أسهل في الاختبار وإدارة الإغلاق.
Adapter — ترجمة Contract خارجي إلى لغتك الداخلية
المشكلة: SDK خارجي يستخدم أسماء وأنواع أخطاء أو وحدات مختلفة عن domain contract. الفكرة: Adapter يترجم الطلب والنتيجة والاستثناءات والـ cancellation، ويمنع تسرب تفاصيل المورد إلى core. ليس مجرد wrapper شكلي؛ هو boundary يحمي النموذج الداخلي.
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، مع حماية بيانات الدفع.
Bridge — فصل محورين يتغيران مستقلين
المشكلة: عندك abstraction مثل NotificationChannel وأنواع delivery providers متعددة. الوراثة تنتج combinations مثل EmailWithProviderA و EmailWithProviderB و SmsWithProviderA. الفكرة: Bridge يفصل abstraction hierarchy عن implementation hierarchy ويربطهما بال composition.
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 العادي قد يكون كافيًا.
Composite — تعامل مع Leaf و Group بنفس الواجهة
المشكلة: نظام ملفات أو تسعير bundle أو شجرة صلاحيات فيها عناصر مفردة ومجموعات. الفكرة: Component contract مشترك، Leaf تنفذ العمل، و Composite تحتوي أبناء وتفوض لهم recursively. العميل يتعامل مع العقد العام بدل فحص النوع في كل مرة.
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 عند أشجار ضخمة أو مدخلات غير موثوقة.
Decorator — أضف سلوكًا مع الحفاظ على نفس Contract
المشكلة: تحتاج metrics أو caching أو auditing حول خدمة موجودة من غير تعديلها أو إنشاء subclasses لكل combination. الفكرة: decorator يطبق نفس interface ويحتفظ بـ inner component ثم يضيف behavior قبل/بعد التفويض. ترتيب decorators يغيّر semantics.
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.
Facade — واجهة مبسطة أمام Subsystem
المشكلة: consumer يحتاج استدعاء خمس خدمات بترتيب معين لفعل use case شائع. الفكرة: Facade يقدم API أعلى مستوى ويخفي تفاصيل التنسيق. لا يعني نقل كل business rules إلى class ضخمة؛ حافظ على ownership للـ invariants والـ transaction.
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 واحدة.
Flyweight — مشاركة الحالة الثابتة لتقليل الذاكرة
المشكلة: عدد هائل من objects المتشابهة يكرر بيانات ثابتة مثل font metadata أو map icons. الفكرة: افصل intrinsic state المشتركة عن extrinsic state الخاصة بكل occurrence، وشارك الكائنات غير القابلة للتغيير. الهدف memory footprint لا مجرد cache لأي شيء.
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 الإضافية قد لا تستحق إذا كان العدد صغيرًا.
Proxy — تحكم في الوصول مع الحفاظ على Contract
المشكلة: الوصول إلى resource مكلف أو حساس أو بعيد. الفكرة: Proxy يقدم نفس interface ويضيف authorization أو lazy loading أو remote access أو caching. الفرق عن Decorator في intent: Decorator يضيف behavior؛ Proxy يتحكم في الوصول/الإنشاء/الموقع، مع أن الشكل البنيوي متقارب.
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 عادي.
Chain of Responsibility — Pipeline من handlers
المشكلة: مجموعة خطوات مثل validation و authorization و enrichment يجب تنفيذها بالترتيب، وكل خطوة قد ترفض أو تكمل. الفكرة: كل handler يعرف التالي أو pipeline يدير sequence. ASP.NET Core middleware مثال واضح. حدد هل كل handler ملزم بالاستمرار، وهل يمكن short-circuit، وكيف تظهر أسباب الرفض.
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 تتوقف عند أول خطأ.
Command — حوّل الطلب إلى Object له هوية
المشكلة: تريد تمثيل action كبيانات يمكن تمريرها أو queue أو retry أو audit. الفكرة: Command object يحمل intent والبيانات؛ handler ينفذه. Command يختلف عن Event: command يطلب فعلًا وقد يرفض؛ event يصف حقيقة حدثت. وجود class باسم Command لا يجعلها durable أو idempotent تلقائيًا.
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.
Interpreter — تمثيل Grammar صغيرة كـ Object Tree
المشكلة: لديك لغة صغيرة جدًا مثل شروط تسعير أو expression rules. الفكرة: كل grammar rule تمثلها expression node تعرف كيف تفسر نفسها. لا تكتب Interpreter يدويًا للغات كبيرة؛ استخدم parser/grammar tooling أو expression trees. انتبه إلى resource limits إذا كان المستخدم هو من يرسل expression.
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.
Iterator — traversal من غير كشف تفاصيل التخزين
المشكلة: المستهلك يحتاج المرور على عناصر collection دون معرفة هل تخزن في list أو tree أو stream. الفكرة: Iterator يقدم next/current أو IEnumerable<T>. في C# yield return ينشئ state machine ويجعل التنفيذ deferred حتى enumeration؛ لذلك query قد تنفذ أكثر من مرة.
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.
Mediator — قلل الاتصالات المباشرة بين Components
المشكلة: عدة UI components أو application services تتواصل مباشرة في شبكة dependencies معقدة. الفكرة: Mediator يستقبل message ويوجهها إلى colleague/handler المناسب. في .NET قد يظهر عبر MediatR أو mediator بسيط. هو داخل العملية عادة؛ لا يضمن persistence أو delivery بعد restart مثل broker.
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 موحدة ومعلنة.
Memento — حفظ Snapshot لاستعادة حالة سابقة
المشكلة: تحتاج Undo/Redo أو rollback محلي لتغييرات في editor. الفكرة: Originator ينشئ snapshot لا يكشف internals، و Caretaker يحتفظ به ويعيده. في systems الكبيرة قد يكون snapshot مكلفًا؛ استخدم command history أو event log أو diff حسب حجم الحالة.
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.
Observer — إشعار Subscribers بتغير داخل العملية
المشكلة: publisher لا يريد معرفة كل consumers. الفكرة: subscribers يسجلون interest ويتلقون notification. C# events مناسبة لأحداث محلية بسيطة؛ أما async delivery الموثوقة أو across processes فتحتاج queue/outbox. افهم memory leaks من event subscriptions الطويلة، واستثناء subscriber الذي قد يمنع الآخرين من التنفيذ.
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 ليست بالضرورة سجلًا دائمًا للحقيقة.
State — اجعل قواعد الانتقال جزءًا من الـ Lifecycle
المشكلة: شروط متكررة من نوع if status == ... منتشرة في كل use case، ويمكن تنفيذ transition غير مسموح. الفكرة: encapsulate state transitions. قد يكفي enum + methods؛ class-per-state مفيد عندما لكل state سلوك غني ومتغير.
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.
Strategy — بدّل Algorithm دون تغيير المستهلك
المشكلة: قواعد الشحن أو الضرائب أو الخصم تتغير حسب البلد أو العميل. الفكرة: contract واحد لسياسات مختلفة، والعميل يعتمد على abstraction. لا تضع كل business logic في switch مركزي يتضخم، لكن لا تحوّل enum بسيطًا إلى 20 class بلا variation حقيقي.
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 لتسهيل الاختبار.
Template Method — ثبّت Skeleton واترك Hooks محددة
المشكلة: عدة jobs تتبع خطوات عامة ثابتة لكن تختلف في خطوة أو اثنتين. الفكرة: base class تحدد algorithm skeleton وتستدعي abstract/virtual hooks. الخطر: inheritance coupling و fragile base class؛ composition غالبًا أفضل إذا كان الاختلاف يتغير وقت التشغيل.
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 موحدًا أصلًا.
Visitor — أضف عمليات على Object Structure دون تعديل الأنواع
المشكلة: لديك hierarchy ثابتة نسبيًا وتحتاج عمليات متعددة مثل export/validation/metrics. الفكرة: Visitor يضيف operation خارج العناصر، ويستخدم double dispatch للوصول إلى النوع الفعلي. Trade-off: إضافة operation جديدة سهلة، لكن إضافة node type جديد تتطلب تعديل كل visitors؛ لذلك مناسب عندما 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.
مصفوفة اختيار GoF: المشكلة، النمط، البديل الأبسط
لا تختَر النمط لأن اسمه مشهور. اسأل عن محور التغيير، lifecycle، عدد التركيبات، وما إذا كان التغيير compile-time أو runtime. البديل الأبسط غالبًا يكون function أو composition أو switch محدودًا أو DI registration.
| المشكلة | Pattern | بديل أبسط/تحذير |
|---|---|---|
| إنشاء concrete product عبر creator hierarchy | Factory Method | Constructor أو factory function |
| عائلة منتجات متوافقة | Abstract Factory | DI registration واحد لكل environment |
| إنشاء object متعدد الخطوات | Builder | Constructor / record initializer |
| نسخ نموذج configured | Prototype | Copy constructor / record with |
| نسخة واحدة process-wide | Singleton | DI Singleton lifetime مع تجنب mutable global state |
| SDK غير متوافق مع domain | Adapter | Mapping function إن كانت بسيطة |
| بُعدان يتغيران مستقلين | Bridge | Composition عادي |
| Leaf ومجموعات في tree | Composite | List recursion مباشرة |
| إضافة behavior حول contract | Decorator | Middleware أو wrapper بسيط |
| واجهة مبسطة لـ subsystem | Facade | Application service واحدة متماسكة |
| مشاركة state متكررة لتقليل الذاكرة | Flyweight | Immutable data / bounded cache |
| التحكم في الوصول أو lazy/remote | Proxy | Authorization/service boundary مباشرة |
| تسلسل handlers | Chain | قائمة خطوات واضحة أو middleware |
| Action قابلة للتخزين/التأجيل | Command | Method call إذا لا توجد حاجة لتمثيلها |
| لغة صغيرة قابلة للتفسير | Interpreter | Parser/expression library |
| Traversal موحد | Iterator | IEnumerable / IAsyncEnumerable |
| تقليل direct coupling بين colleagues | Mediator | Direct dependency لو العلاقات قليلة |
| Undo/restore snapshot | Memento | Command history أو diff |
| إشعار subscribers | Observer | Durable broker لو cross-process |
| سلوك يعتمد على lifecycle | State | Enum + guarded methods |
| تبديل algorithm | Strategy | Delegate أو switch صغير |
| Skeleton ثابت بخطوات قابلة للتخصيص | Template Method | Composition / pipeline |
| عمليات متعددة على hierarchy مستقرة | Visitor | Pattern matching / switch expression |
المراجع والقراءة الإضافية
الدرس بيشرح الفكرة نفسها؛ الروابط دي للتحقق والتعمق والرجوع لتفاصيل الـ API. (محتاجة إنترنت.)
التوثيق الرسمي — Official documentation
مصادر تعليمية ومتقدمة — Third-party & advanced reading
خريطة التغطية: 31 عنصر من الـ Roadmap ومكان شرحه في الدرس
خلصت الدرس وحليت الأسئلة؟ علّم عليه عشان يتحسب في تقدّمك.