يعني إيه Object-Oriented Design؟
الـ Object-Oriented Design (OOD) هو تحويل متطلبات business إلى objects/classes لها مسؤوليات واضحة وتتعاون لتحقيق behavior مطلوب. مش الهدف إن كل noun في الكلام يتحول class، ولا إننا نعمل interface لكل class. الهدف توزيع المسؤوليات بحيث النظام يظل مفهومًا، قابلًا للتغيير والاختبار، ويحافظ على قواعد العمل حتى لو استدعاه API أو worker أو message handler.
فرّق بين Requirements (النظام يعمل إيه)، Analysis (المفاهيم والأدوار والسيناريوهات)، Design (classes/interfaces والعلاقات وتسلسل الرسائل). القفز مباشرة للكود ينتج غالبًا CRUD classes، وبعدها تتبعثر business rules بين controllers و services و repositories.
التصميم الجيد مش اللي فيه patterns كتير؛ هو اللي يحقق المتطلبات بأقل تعقيد مناسب. كل abstraction لها تكلفة: ملفات أكثر و indirection و contracts لازم تتفهم. اسأل: هل فيه سبب حقيقي للتجريد؟ هل فيه implementations متعددة أو boundary مهم؟ هل abstraction هتسهّل test أو change؟
تحليل المتطلبات والـ Actors والـ Use Cases
قبل التصميم اكتب: actor، trigger، preconditions، happy path، alternate paths، failure paths، business constraints، non-functional requirements. كلمة «احجز غرفة» ناقصة: هل الحجز فوري أم pending؟ هل نسمح بتداخل التواريخ؟ هل الدفع قبل التأكيد؟ ما سياسة الإلغاء؟ وهل timezone مؤثر؟
Actor دور خارجي، مش شرط شخصًا؛ قد يكون Admin أو Payment Gateway أو Scheduled Worker. Use Case هدف actor من منظور business، وليس اسم method أو endpoint. «Create reservation» use case، أما POST /reservations فهو HTTP mapping.
Use case: Reserve a room
Primary actor: Customer
Supporting actor: Payment Provider
Preconditions: Customer is active; check-out > check-in.
Main flow:
1. Customer searches availability.
2. System checks room capacity and date overlap.
3. System creates a temporary hold with expiry.
4. Customer completes payment.
5. System confirms reservation exactly once.
Failure flows:
- Room becomes unavailable: reject and suggest alternatives.
- Payment fails: release hold according to policy.
- Duplicate callback: do not confirm twice.
Invariants:
- Confirmed reservations do not overlap for the same room.
- Money has an explicit currency and precision.الـ non-functional constraints قد تغيّر التصميم: latency، حجم البيانات، auditability، availability، security، concurrency. لو فيه 10 آلاف room أو duplicate payment callbacks، لازم تظهر القيود دي من البداية بدل ما تكتشفها بعد كتابة الكود.
استخراج المفاهيم و CRC Cards
استخرج nouns كمرشحين للمفاهيم و verbs كمرشحين للسلوك، ثم صنّف: Entity لها identity ودورة حياة؛ Value Object يتحدد بقيمته ويفضل أن يكون immutable؛ Domain Service لسلوك لا ينتمي طبيعيًا لكيان واحد؛ Repository abstraction لجلب aggregate roots؛ Policy/Strategy لقاعدة قابلة للتبديل. لا تحول كل noun إلى class: «تقرير» قد يكون DTO، و«بحث» قد يكون query object.
CRC = Class–Responsibility–Collaborator. لكل class اكتب مسؤولياتها ومن تتعاون معه. مثال: Reservation مسؤولة عن التواريخ والحالة والانتقالات؛ تتعاون مع Room للتحقق من السعة ومع Money لحساب التكلفة. لو class عندها مسؤوليات من مجالات مختلفة، راجع تقسيمها.
Class: Reservation
Responsibilities: validate stay dates; guard state transitions;
preserve agreed price snapshot.
Collaborators: Room, Money, CancellationPolicy
Class: AvailabilityService
Responsibilities: find rooms with no overlapping active reservation;
apply occupancy and capacity constraints.
Collaborators: IReservationReadStore, IRoomCatalog
Class: PaymentCoordinator (application layer)
Responsibilities: coordinate hold → payment → confirmation.
Collaborators: Reservation, IPaymentGateway, IUnitOfWorkCohesion و Coupling
Cohesion مدى ترابط مسؤوليات الوحدة. class متماسكة تعمل أفعالًا حول purpose business واضح. Coupling مقدار اعتماد وحدة على تفاصيل أخرى. المطلوب ليس zero coupling؛ objects لازم تتعاون. المطلوب dependencies مقصودة ومستقرة عبر contracts مناسبة.
علامات ضعف cohesion: class فيها methods لا تشترك في state أو purpose، أو اسم عام مثل Manager، أو تغييرات payment و email و inventory كلها تجبرك تعدل نفس class. علامات coupling عالي: معرفة class بتفاصيل SQL/HTTP، أو التنقل في object graph طويل، أو constructor يحتاج dependencies كثيرة غير مترابطة.
public sealed class OrderTaxCalculator(ITaxPolicy policy)
{
public Money Calculate(Order order) => policy.Calculate(order.Subtotal);
}
public sealed class InvoiceSender(IEmailGateway email)
{
public Task SendAsync(Invoice invoice, CancellationToken ct) =>
email.SendAsync(invoice.Recipient, invoice.Subject, invoice.Body, ct);
}
public sealed class OrderRepository(AppDbContext db)
{
public Task AddAsync(Order order, CancellationToken ct) =>
db.Orders.AddAsync(order, ct).AsTask();
}ما تفصلش لمجرد الفصل. استخدم change scenarios: «لو غيرنا tax policy؟» «لو غيرنا email provider؟» لو لكل تغيير boundary طبيعي، التقسيم منطقي. أما تقسيم class صغيرة إلى خمس classes من غير سبب فيزيد indirection بلا قيمة.
Encapsulation و Invariants و Design by Contract
Encapsulation مش private fields فقط؛ هي حماية قواعد object وتقديم operations مفهومة بدل setters مفتوحة تسمح بحالة غير صالحة. Invariant قاعدة يجب أن تظل صحيحة في كل حالة مستقرة: Order لا يتأكد وهو فارغ، Reservation لا يكون check-out قبل check-in، و Money لا تجمع عملتين مختلفتين بلا conversion صريح.
Design by Contract: Preconditions قبل العملية، Postconditions ما تضمنه بعد نجاحها، Invariants ما يظل صحيحًا دائمًا. الـ API layer يتحقق من شكل المدخلات، لكن الـ domain object يحمي قواعده حتى لو استدعاه worker أو message handler.
public enum ReservationStatus { Pending, Confirmed, Cancelled, Expired }
public sealed class Reservation
{
public Guid Id { get; private set; }
public DateOnly CheckIn { get; private set; }
public DateOnly CheckOut { get; private set; }
public ReservationStatus Status { get; private set; }
private Reservation() { } // EF Core materialization
public static Reservation Create(DateOnly checkIn, DateOnly checkOut)
{
if (checkOut <= checkIn)
throw new DomainException("Check-out must be after check-in.");
return new Reservation { Id = Guid.NewGuid(), CheckIn = checkIn,
CheckOut = checkOut, Status = ReservationStatus.Pending };
}
public void Confirm()
{
if (Status != ReservationStatus.Pending)
throw new DomainException("Only pending reservations can be confirmed.");
Status = ReservationStatus.Confirmed;
}
}الـ private constructor قد يخدم EF Core، لكن public creation path يضمن صحة البيانات. في التطبيق الفعلي اختبر إن mapping لا يتجاوز قواعد domain بطريقة غير مقصودة.
Abstraction و Interfaces و Polymorphism و DIP
Abstraction تعرض ما يحتاجه caller وتخفي تفاصيل التنفيذ. Interface مفيدة عند وجود contract مهم أو boundary أو implementation بديل أو حاجة اختبار حقيقية. مش لازم interface لكل class؛ ده يضيف تكلفة. خلي interfaces صغيرة وموجهة للعميل بدل interface ضخمة تجمع عمليات غير مترابطة.
Polymorphism يسمح بالتعامل مع implementations مختلفة عبر contract واحد. Dependency Inversion Principle يقول إن السياسات عالية المستوى لا تعتمد مباشرة على تفاصيل منخفضة المستوى؛ الاثنين يعتمدان على abstractions مناسبة. لا تحوّل كل شيء إلى interface لمجرد تطبيق DIP؛ abstraction لازم تمثل boundary مستقرة.
public interface IDiscountPolicy
{
Money Calculate(OrderSubtotal subtotal);
}
public sealed class NoDiscount : IDiscountPolicy
{
public Money Calculate(OrderSubtotal subtotal) => Money.Zero(subtotal.Currency);
}
public sealed class PercentageDiscount(decimal rate) : IDiscountPolicy
{
public Money Calculate(OrderSubtotal subtotal)
{
if (rate is < 0 or > 1) throw new ArgumentOutOfRangeException(nameof(rate));
return subtotal.Amount * rate;
}
}
public sealed class CheckoutService(IDiscountPolicy discount)
{
public Money GetDiscount(OrderSubtotal subtotal) => discount.Calculate(subtotal);
}Inheritance vs Composition والعلاقات
Inheritance تعبر عن subtype حقيقي: كل Dog هو Animal ويمكن استخدامه مكانه من غير كسر توقعات الـ base type. Composition تعني object يستخدم objects أخرى لبناء behavior. فضّل composition لتبديل policies وإعادة استخدام behavior؛ inheritance العميق يخلق coupling بين base class وكل descendants.
Association علاقة عامة. Aggregation whole/part ضعيفة نسبيًا والجزء قد يعيش مستقلًا. Composition ملكية أقوى والجزء lifecycle تابع للكل في النموذج. دي مفاهيم modeling؛ لا تفترض أن كل composition لازم تكون cascade delete في database. Persistence policy قرار منفصل.
public interface IShippingCostPolicy
{
Money Calculate(Order order, Address destination);
}
public sealed class StandardShipping : IShippingCostPolicy
{
public Money Calculate(Order order, Address destination) => new(50m, "EGP");
}
public sealed class ShippingCalculator(IShippingCostPolicy policy)
{
public Money Calculate(Order order, Address address) =>
policy.Calculate(order, address);
}Liskov Substitution Principle مرتبط هنا: لو derived class غيرت معنى contract أو رفضت حالات كانت base class تقبلها، الوراثة غير سليمة حتى لو الكود يترجم. اختبر السلوك من منظور contract وليس أسماء الأنواع.
UML: Class و Sequence و State و Use-Case Diagrams
Class Diagram يوضح classes و attributes و operations والعلاقات. Sequence Diagram يوضح الرسائل وترتيبها عبر الزمن. State Diagram يوضح الحالات والانتقالات والأحداث والحراس. Use-Case Diagram يوضح actors وأهدافهم وحدود النظام. الهدف تقليل سوء الفهم، مش استبدال الكود أو إنتاج وثائق لا يتم تحديثها.
في class diagram: association خط، multiplicity مثل 1 و0..*، inheritance سهم مثلث فارغ، dependency سهم متقطع. اكتب multiplicity بوضوح: Customer لديه 0..* Orders، و Order يتبع Customer واحدًا في النموذج المعتاد. الـ sequence diagram لازم يعرض failure branches مثل timeout و duplicate callback، مش happy path فقط.
Customer -> API: POST /reservations/{id}/pay
API -> ApplicationService: PayReservation(command)
ApplicationService -> ReservationRepository: Load(id)
ApplicationService -> PaymentGateway: Charge(amount, idempotencyKey)
PaymentGateway --> ApplicationService: Approved / Declined
ApplicationService -> Reservation: Confirm()
ApplicationService -> UnitOfWork: SaveChanges()
ApplicationService --> API: PaymentResult
API --> Customer: 200 / 409 / 402في State Diagram عرّف الانتقالات المسموحة: Pending → Confirmed، Pending → Cancelled، Pending → Expired. الانتقال من Cancelled إلى Confirmed يجب رفضه إلا لو فيه business process صريح لإعادة الفتح.
GRASP و Law of Demeter و Tell, Don't Ask
GRASP heuristics لتوزيع المسؤوليات: Information Expert أعطِ المسؤولية لمن يمتلك المعلومات اللازمة؛ Creator اجعل object ينشئ object يرتبط به أو يحتويه؛ Controller نقطة استقبال use-case event وتنسيقها؛ Low Coupling قلل الاعتماد غير الضروري؛ High Cohesion اجمع المسؤوليات المتجانسة؛ Polymorphism للسلوك المختلف حسب النوع؛ Pure Fabrication service تقنية/تنسيقية لا تنتمي إلى entity؛ Indirection وسيط يعزل طرفين؛ Protected Variations اعزل نقاط التغيير خلف contract.
Information Expert لا يعني أن entity تعرف database أو ترسل email؛ هي تملك business decision المعتمد على state الخاص بها. Controller في GRASP مش بالضرورة MVC Controller؛ قد يكون Application Service أو command handler.
Law of Demeter: لا تجعل object يتجول في graph من objects لا يعرفها. التعبير order.Customer.Address.City يربط caller بتفاصيل داخلية. الأفضل expose behavior أو value object مناسب. القاعدة heuristic وليست حظرًا مطلقًا على navigation.
Tell, Don't Ask: بدل ما تسأل object عن state ثم تتخذ القرار خارجيًا، اطلب منه تنفيذ behavior الذي يملك مسؤوليته. بدل if (account.Balance > amount) account.Balance -= amount استخدم account.Withdraw(amount) ليحمي invariant. لكن orchestration بين عدة aggregates غالبًا مكانه application service.
Immutability و Value Objects وتصميم الأخطاء
Entity تتحدد بهويتها حتى لو تغيرت خصائصها؛ Value Object يتحدد بقيمه، مثل Money و DateRange و EmailAddress. الـ immutability تقلل shared-state bugs وتسهّل reasoning، خصوصًا في concurrent code. record لا يضمن deep immutability لو بداخله mutable collection.
public sealed record Money
{
public decimal Amount { get; }
public string Currency { get; }
public Money(decimal amount, string currency)
{
if (string.IsNullOrWhiteSpace(currency))
throw new ArgumentException("Currency is required.", nameof(currency));
Amount = decimal.Round(amount, 2, MidpointRounding.ToEven);
Currency = currency.ToUpperInvariant();
}
public Money Add(Money other)
{
if (Currency != other.Currency)
throw new InvalidOperationException("Currency mismatch.");
return new Money(Amount + other.Amount, Currency);
}
}صمم error handling حسب النوع: invalid input، domain rule violation، not found، conflict، transient infrastructure failure، unexpected defect. لا تستخدم exceptions كـ normal branching لكل حالة متوقعة إذا Result type أو validation result أوضح. لا تبتلع exceptions، ولا تسجل secrets أو card data.
Testability و Concurrency و YAGNI و Refactoring
التصميم القابل للاختبار يجعل dependencies الخارجية واضحة ويعزل pure business rules عن network/database/clock. استخدم clock abstraction لما الزمن يؤثر في business rules، و gateway interface عند التعامل مع provider خارجي. لا تعمل mock لكل object؛ اختبر domain behavior مباشرة، واستخدم integration tests عند boundaries الحقيقية.
Concurrency جزء من التصميم: requestان قد يقرآن نفس state ثم يحدثانها. in-memory check وحده لا يمنع double booking أو overselling. استخدم database constraints، transactions، optimistic concurrency tokens، atomic updates أو distributed coordination حسب المشكلة. Singleton lock محلي للعملية ولا يحمي عدة replicas.
Extensibility مقابل YAGNI: صمم نقاط التغيير المعروفة، لكن لا تبنِ framework عامًا لعشرة احتمالات لم يطلبها أحد. لو عندك provider واحد قد يكفي adapter واضح؛ لو فيه providers متعددة أو contract متوقع، abstraction يصبح له مبرر. Refactor toward patterns لما يظهر pressure حقيقي، مش لمجرد حفظ أسماء patterns.
public sealed class InventoryItem
{
public int Id { get; private set; }
public int Available { get; private set; }
public byte[] RowVersion { get; private set; } = [];
public void Reserve(int quantity)
{
if (quantity <= 0) throw new ArgumentOutOfRangeException(nameof(quantity));
if (Available < quantity) throw new DomainException("Insufficient stock.");
Available -= quantity;
}
}
modelBuilder.Entity<InventoryItem>()
.Property(x => x.RowVersion).IsRowVersion();عند concurrent update قد يرمي EF Core DbUpdateConcurrencyException. تعامل معها كـ conflict يحتاج إعادة قراءة وقرار business، وليس retry أعمى؛ إعادة المحاولة بدون إعادة تقييم stock قد تبيع كمية غير موجودة.
Kata 1 — Parking Lot
المطلوب: جراج بمستويات ومواقف Compact/Regular/Large، مركبات Motorcycle/Car/Truck، دخول وخروج وحساب رسوم. الموقف لا يستوعب أي مركبة عشوائيًا؛ truck يحتاج مساحة مناسبة وقد يشغل أكثر من spot حسب policy.
التصميم: ParkingLot ينسق المستويات، ParkingLevel يختار مكانًا، ParkingSpot يحمي occupied/free، Vehicle يمثل النوع، ParkingTicket يسجل الأوقات، و PricingPolicy تحسب الرسوم. اختبر الجراج الممتلئ، مركبة غير مناسبة، محاولتي حجز لنفس spot، خروج ticket مرتين، عبور منتصف الليل، وتغيير الأسعار مع الحفاظ على السعر التاريخي للتذكرة.
public enum SpotSize { Compact, Regular, Large }
public enum VehicleKind { Motorcycle, Car, Truck }
public sealed class ParkingSpot(int number, SpotSize size)
{
public int Number { get; } = number;
public SpotSize Size { get; } = size;
public bool IsOccupied { get; private set; }
public bool CanFit(VehicleKind vehicle) => vehicle switch
{
VehicleKind.Motorcycle => true,
VehicleKind.Car => Size is SpotSize.Regular or SpotSize.Large,
VehicleKind.Truck => Size is SpotSize.Large,
_ => false
};
public void Occupy()
{
if (IsOccupied) throw new DomainException("Spot is occupied.");
IsOccupied = true;
}
}توسعة المشروع: أضف EV charging، reserved spots، subscriptions، و multiple pricing strategies. لا تضع كل الاختيارات داخل switch مركزي يكبر مع كل نوع؛ استخدم policy أو capabilities حين يظهر اختلاف حقيقي.
Parking Lot — تنفيذ Domain Model كامل خطوة بخطوة
Step 1 — ثبت assumptions: كل ticket تخص vehicle واحدة و spot واحدة في النسخة الأولى؛ spot لا تقبل أكثر من vehicle؛ الدخول يختار أصغر spot مناسبة لتقليل استهلاك الأماكن الكبيرة؛ الرسوم تحسب عند الخروج وفق pricing policy الحالية أو policy snapshot محددة. وضّح إن دعم truck الذي يشغل أكثر من spot سيكون extension منفصلًا وليس implicit behavior.
Step 2 — حدد invariants: spot occupied لها ticket نشطة واحدة؛ لا يمكن إصدار ticket مرتين لنفس vehicle في نفس الجراج؛ لا يمكن إنهاء ticket مرتين؛ exit time لا يسبق entry time؛ لا يمكن occupancy لو vehicle غير مناسبة. database تحتاج unique constraint على active spot/ticket أو concurrency-safe allocation؛ in-memory check وحده لا يكفي.
public enum VehicleKind { Motorcycle, Car, Truck }
public enum SpotSize { Compact, Regular, Large }
public sealed record Vehicle(string Plate, VehicleKind Kind);
public sealed record ParkingTicket(Guid Id, string Plate, int SpotNumber,
DateTimeOffset EnteredAt, DateTimeOffset? ExitedAt, decimal? Fee);
public interface IParkingPricingPolicy
{
decimal Calculate(VehicleKind kind, DateTimeOffset enteredAt,
DateTimeOffset exitedAt);
}public sealed class ParkingSpot(int number, SpotSize size)
{
public int Number { get; } = number;
public SpotSize Size { get; } = size;
public bool IsOccupied { get; private set; }
public bool CanFit(VehicleKind kind) => kind switch
{
VehicleKind.Motorcycle => true,
VehicleKind.Car => Size is SpotSize.Regular or SpotSize.Large,
VehicleKind.Truck => Size == SpotSize.Large,
_ => false
};
public void Occupy()
{
if (IsOccupied) throw new DomainException("Spot already occupied.");
IsOccupied = true;
}
public void Release()
{
if (!IsOccupied) throw new DomainException("Spot is already free.");
IsOccupied = false;
}
}
public sealed class ParkingLevel(IReadOnlyList<ParkingSpot> spots)
{
public ParkingSpot? FindSpot(VehicleKind kind) => spots
.Where(s => !s.IsOccupied && s.CanFit(kind))
.OrderBy(s => s.Size)
.ThenBy(s => s.Number)
.FirstOrDefault();
}Step 3 — application orchestration: ParkingService.EnterAsync يطلب allocation، يحفظ ticket و occupancy في transaction واحدة. عند exit، يحمل ticket النشطة، يحسب fee عبر policy، يحرر spot ويحفظ exit time. لا تجعل controller يختار spot أو يحسب fee؛ هذه قرارات domain/application.
public sealed class ParkingService(
IParkingRepository repository,
IParkingPricingPolicy pricing,
IClock clock,
IUnitOfWork unitOfWork)
{
public async Task<ParkingTicket> EnterAsync(Vehicle vehicle, CancellationToken ct)
{
if (await repository.HasActiveTicketAsync(vehicle.Plate, ct))
throw new DomainException("Vehicle is already parked.");
var spot = await repository.FindAndReserveSpotAsync(vehicle.Kind, ct)
?? throw new DomainException("No compatible spot is available.");
var ticket = new ParkingTicket(Guid.NewGuid(), vehicle.Plate,
spot.Number, clock.UtcNow, null, null);
await repository.AddTicketAsync(ticket, ct);
await unitOfWork.SaveChangesAsync(ct);
return ticket;
}
}الـ repository method FindAndReserveSpotAsync يجب أن تكون atomic على storage، لا مجرد SELECT ثم UPDATE بلا حماية. SQL Server يمكنه استخدام transaction/locking أو conditional update مع unique constraint. لو reservation فشلت بسبب race، أعد اختيار spot وفق retry محدود.
Step 4 — tests: test لـ vehicle مناسبة وغير مناسبة، full lot، duplicate plate، double exit، fee boundaries، DST/timezone، و two concurrent entries تتنافس على آخر spot. Integration test ضرورية لإثبات atomic allocation والـ unique constraints. لا تعتمد على test in-memory لإثبات concurrency بين عدة API instances.
Kata 2 — Hotel Reservation
المطلوب: مبانٍ وغرف Standard/VIP، availability، حجز بالتواريخ، دفع وإلغاء واسترداد. لا تكرر كل السلوك المشترك في inheritance hierarchy كبيرة؛ استخدم RoomType أو amenities/policies حسب اختلاف القواعد.
التصميم: Room، Reservation aggregate، DateRange و Money value objects، AvailabilityService، CancellationPolicy و PaymentGateway. تداخل فترتين يتحقق بـ existing.Start < requested.End && requested.Start < existing.End إذا checkout يوم مغادرة لا يشغل الليلة.
public sealed record DateRange
{
public DateOnly Start { get; }
public DateOnly End { get; }
public DateRange(DateOnly start, DateOnly end)
{
if (end <= start) throw new ArgumentException("Invalid date range.");
Start = start; End = end;
}
public bool Overlaps(DateRange other) =>
Start < other.End && other.Start < End;
}السيناريوهات الصعبة: لا تنفذ payment داخل DB transaction طويلة؛ أنشئ hold بوقت انتهاء، نفّذ payment خارج transaction، ثم أكّد الحجز بعملية محمية من التكرار. اختبر duplicate callbacks، timeout بعد الخصم، انتهاء hold، timezone، وإلغاء بعد confirmation. في production تحتاج idempotency وقد تحتاج outbox/inbox أو reconciliation.
Hotel Reservation — التصميم والتنفيذ والـ Concurrency
Step 1 — حدد lifecycle: Draft/Requested → Held → Confirmed → CheckedIn → CheckedOut، أو Cancelled/Expired. لا تستخدم status enum من غير تعريف transitions. DateRange يحدد check-in inclusive و check-out exclusive في الليالي؛ بالتالي checkout يوم 12 يسمح بحجز آخر يبدأ يوم 12 إذا policy لا تضيف cleaning buffer.
Step 2 — model: Building يحتوي Rooms، Room لها type/capacity، Reservation aggregate يحفظ GuestId و RoomId و DateRange و price snapshot و status. Money و DateRange Value Objects. Availability query تقرأ reservations الفعالة التي تتداخل مع المطلوب، لكن التأكيد النهائي يحتاج concurrency protection.
public enum ReservationStatus { Held, Confirmed, Cancelled, Expired }
public sealed class Reservation
{
public Guid Id { get; private set; }
public Guid RoomId { get; private set; }
public Guid GuestId { get; private set; }
public DateRange Stay { get; private set; } = default!;
public Money PriceSnapshot { get; private set; } = default!;
public ReservationStatus Status { get; private set; }
public DateTimeOffset HoldExpiresAt { get; private set; }
private Reservation() { }
public static Reservation Hold(Guid roomId, Guid guestId,
DateRange stay, Money price, DateTimeOffset expiresAt) => new()
{
Id = Guid.NewGuid(), RoomId = roomId, GuestId = guestId,
Stay = stay, PriceSnapshot = price,
HoldExpiresAt = expiresAt, Status = ReservationStatus.Held
};
public void Confirm(DateTimeOffset now)
{
if (Status != ReservationStatus.Held || now >= HoldExpiresAt)
throw new DomainException("Reservation hold is no longer valid.");
Status = ReservationStatus.Confirmed;
}
}Step 3 — overlap query: existing reservation تتداخل لو existing.CheckIn < requested.CheckOut و requested.CheckIn < existing.CheckOut، مع استبعاد Cancelled/Expired. ضع index على RoomId + date/status columns وفق query plan. Availability result قد تصبح stale بعد لحظة القراءة؛ لذلك لا تعتبرها lock.
var conflict = await db.Reservations.AnyAsync(r =>
r.RoomId == roomId &&
(r.Status == ReservationStatus.Held || r.Status == ReservationStatus.Confirmed) &&
r.Stay.Start < requested.End && requested.Start < r.Stay.End,
ct);
if (conflict) return AvailabilityResult.Unavailable;Step 4 — payment workflow: لا تعمل charge داخل transaction database مفتوحة. أنشئ hold، ثم نفّذ payment بــ idempotency key، ثم confirm في transaction قصيرة. لو payment نجح و confirm فشل، reconciliation job تفحص payment state وتكمل confirmation أو تعمل refund وفق policy. webhook duplicate يجب أن تكون idempotent.
Step 5 — concurrency: عمليتان قد تفحصان availability في نفس الوقت ثم تحجزان نفس الغرفة. الحل ليس فقط C# lock لأنه لا يعمل بين replicas. استخدم database strategy مناسبة: serializable/locking أو reservation slot model/unique constraints أو atomic allocation. اختبر race فعليًا بعمليتين متزامنتين على نفس database.
Tests: check-out exclusive boundary، overlapping exact dates، adjacent stays، expired hold، duplicate payment callback، payment timeout، concurrent booking، cancellation cutoff، timezone conversion، room capacity، و price snapshot بعد تغيير سعر الغرفة.
Kata 3 — Library Management
المطلوب: أعضاء، نسخ مادية من الكتب، إعارة، إرجاع، حجز queue وغرامات. ميّز بين BookTitle وبين BookCopy؛ عنوان واحد له نسخ كثيرة ولكل نسخة barcode وحالة مستقلة.
التصميم: Member يحمي حد الإعارة، BookCopy يدير الحالة، Loan يسجل due/return dates، HoldQueue ينظم الحجز، و FinePolicy تحسب الغرامة. لا تحذف loan التاريخي عند الإرجاع.
public enum LoanStatus { Active, Returned, Lost }
public sealed class Loan(DateOnly dueDate)
{
public DateOnly DueDate { get; } = dueDate;
public DateOnly? ReturnedOn { get; private set; }
public LoanStatus Status { get; private set; } = LoanStatus.Active;
public void Return(DateOnly date)
{
if (Status != LoanStatus.Active)
throw new DomainException("Loan is not active.");
ReturnedOn = date;
Status = LoanStatus.Returned;
}
}اختبر: عضو بلغ الحد، نسخة غير متاحة، حجزان، إرجاع متأخر، إرجاع مرتين، نسخة مفقودة، تغيير fine policy، وأولوية queue. ناقش هل الغرامة تتوقف في العطلات وهل يمكن تجديد الإعارة مع وجود hold.
Library Management — تصميم الإعارة والحجوزات والغرامات
Implementation steps: افصل BookTitle عن BookCopy؛ الإعارة تخص نسخة barcode محددة. Member يحمي maximum active loans، Loan يحتفظ due date/return date، و HoldQueue تدير ترتيب الانتظار. FinePolicy تحسب الغرامة باستخدام تاريخ الإرجاع و calendar policy. لا تحذف loan بعد الإرجاع؛ هي audit/history.
public sealed class LibraryMember(int maxActiveLoans)
{
private readonly List<Loan> _loans = [];
public IReadOnlyCollection<Loan> Loans => _loans.AsReadOnly();
public void Borrow(BookCopy copy, DateOnly dueDate)
{
if (_loans.Count(x => x.Status == LoanStatus.Active) >= maxActiveLoans)
throw new DomainException("Active loan limit reached.");
if (!copy.IsAvailable) throw new DomainException("Copy is unavailable.");
copy.CheckOut();
_loans.Add(new Loan(dueDate));
}
}Transactions: تحديث copy status وإنشاء loan لازم يتمان كوحدة واحدة. حجز آخر نسخة في نفس اللحظة يحتاج conditional update/rowversion. عند إرجاع نسخة عليها queue، لا تجعل أي user يحجزها مباشرة؛ أنشئ hold fulfillment/notification workflow. اختبر duplicate return، lost copy، renew مع وجود hold، fine cap، holiday calendar، و concurrent checkout.
Kata 4 — ATM
المطلوب: إدخال بطاقة، PIN، اختيار حساب، سحب/إيداع/استعلام، إخراج بطاقة وإيصال. الـ ATM يتعامل مع hardware adapters، والـ bank system يملك ledger والرصيد الحقيقي؛ لا تجعل ATM مصدر الحقيقة المالية.
التصميم: AtmSession state machine، ICardReader و ICashDispenser، IBankingGateway، WithdrawalPolicy و TransactionReceipt. افصل authorization عن cash dispensing؛ لو البنك خصم لكن dispenser تعطل، تحتاج reversal/reconciliation.
public enum AtmState { Idle, CardInserted, Authenticated, Processing, Ejecting }
public sealed class AtmSession
{
public AtmState State { get; private set; } = AtmState.Idle;
public void Authenticate()
{
if (State != AtmState.CardInserted)
throw new DomainException("Insert a card first.");
State = AtmState.Authenticated;
}
public void BeginTransaction()
{
if (State != AtmState.Authenticated)
throw new DomainException("Session is not authenticated.");
State = AtmState.Processing;
}
}اختبر: PIN خاطئ عدة مرات، بطاقة منتهية، cash unavailable، partial dispense، network timeout، duplicate withdrawal، power failure بعد debit، وإلغاء session. سجّل audit events من غير PIN أو PAN كامل.
ATM — State Machine و Financial Failure Recovery
قسم التصميم إلى AtmSession (حالة الجلسة)، CardReader/CashDispenser hardware adapters، BankingGateway (authorization/debit)، ReceiptPrinter، WithdrawalPolicy. الـ ATM لا يملك ledger؛ bank core هو source of truth. session transitions: Idle → CardInserted → Authenticated → Processing → Ejecting. أي exception لازم يحدد هل نحتفظ بالبطاقة أم نخرجها وفق safety policy.
public async Task<WithdrawalResult> WithdrawAsync(
AtmSession session, Money amount, CancellationToken ct)
{
session.EnsureAuthenticated();
withdrawalPolicy.Validate(amount);
var key = $"atm:{session.Id}:withdraw:{session.NextOperationNumber}";
var authorization = await bank.AuthorizeWithdrawalAsync(
session.AccountId, amount, key, ct);
if (!authorization.Approved) return WithdrawalResult.Declined;
var dispense = await cashDispenser.DispenseAsync(amount, ct);
if (!dispense.Completed)
{
await bank.ReverseAuthorizationAsync(authorization.Id, key, ct);
return WithdrawalResult.CashDispenseFailed;
}
await bank.CaptureWithdrawalAsync(authorization.Id, key, ct);
return WithdrawalResult.Completed;
}ده workflow sketch؛ real ATM/payment rails لها protocol and settlement rules مختلفة. لا تفترض أن reversal ينجح دائمًا؛ سجّل unresolved state و reconciliation. اختبر crash بعد authorization وقبل dispense، partial cash dispense، timeout بعد dispense، duplicate command، card removal، power loss و audit redaction. لا تسجل PIN أو full card number.
Kata 5 — Elevator System
المطلوب: مبنى بعدة أدوار ومصاعد؛ طلبات داخلية وخارجية، اتجاه الحركة، الأبواب، emergency، وتوزيع الطلبات. لا تبدأ بأقرب مصعد فقط؛ عرّف safety constraints أولًا.
التصميم: Elevator يملك current floor/direction/state، ElevatorController يوزع الطلبات، RequestScheduler policy قابلة للتبديل، و Door/Motor hardware abstractions. امنع فتح الباب أثناء الحركة وتجاوز حدود الأدوار.
public enum Direction { Up, Down, Idle }
public enum ElevatorState { Idle, Moving, DoorOpen, OutOfService }
public sealed class Elevator(int minFloor, int maxFloor)
{
public int CurrentFloor { get; private set; } = minFloor;
public ElevatorState State { get; private set; } = ElevatorState.Idle;
public Direction Direction { get; private set; } = Direction.Idle;
public void OpenDoor()
{
if (State == ElevatorState.Moving)
throw new DomainException("Door cannot open while moving.");
State = ElevatorState.DoorOpen;
Direction = Direction.Idle;
}
}اختبر: طلبات متعاكسة، ضغط أزرار كثيرة، overload، emergency stop، door obstruction، مصعد خارج الخدمة وإعادة جدولة الطلبات. قارن FCFS و SCAN-like scheduling وسياسة أقرب مصعد؛ السلامة تتقدم على throughput.
Elevator — Scheduler و Safety Constraints
افصل safety controller عن dispatch optimization. Safety invariants: لا تتحرك الأبواب مفتوحة، لا تتجاوز floor bounds، emergency stop يوقف الحركة، overload يمنع التشغيل. Scheduler يختار المصعد بناءً على direction/current floor/queue، لكن لا يستطيع تجاوز safety checks.
public sealed class ElevatorDispatcher(IReadOnlyList<ElevatorSnapshot> elevators)
{
public ElevatorSnapshot? Select(int requestedFloor, Direction requestedDirection) =>
elevators
.Where(e => e.State != ElevatorState.OutOfService && !e.IsOverloaded)
.OrderBy(e => Cost(e, requestedFloor, requestedDirection))
.FirstOrDefault();
private static int Cost(ElevatorSnapshot e, int floor, Direction direction)
{
var distance = Math.Abs(e.CurrentFloor - floor);
var movingAway = e.Direction != Direction.Idle && e.Direction != direction;
return distance + (movingAway ? 100 : 0) + e.PendingStops * 5;
}
}الـ score هنا تعليمي فقط وليس scheduler إنتاجي. real system تحتاج fairness، capacity، aging، group requests، fire/emergency mode، sensor failures و safety-certified controller. اختبر deadlock/starvation، ضغط requests، out-of-service transition، door obstruction، وطلب دور غير صالح.
Kata 6 — Notification Service
المطلوب: Email/SMS/Push، templates متعددة اللغات، user preferences، retry، delivery status ومنع التكرار. افصل «ما الرسالة؟» عن «كيف نرسلها؟».
التصميم: Notification، INotificationChannel، TemplateRenderer، PreferencePolicy، DeliveryAttempt و RetryPolicy. لا تجعل فشل SMS provider يوقف Email إذا القنوات مستقلة.
public interface INotificationChannel
{
string Name { get; }
Task<DeliveryResult> SendAsync(RenderedMessage message, CancellationToken ct);
}
public sealed class NotificationDispatcher(
IEnumerable<INotificationChannel> channels)
{
public Task<DeliveryResult> SendAsync(
string name, RenderedMessage message, CancellationToken ct)
{
var channel = channels.SingleOrDefault(x => x.Name == name)
?? throw new InvalidOperationException("Unknown channel.");
return channel.SendAsync(message, ct);
}
}اختبر: opt-out، throttling، transient timeout، عنوان غير صالح، retry exhaustion، duplicate event، template missing و secret rotation. استخدم exponential backoff مع jitter و dead-letter handling؛ لا تعِد محاولة permanent failures.
Notification Service — Delivery State و Retry Policy
صمم Notification كـ durable record بحالة Pending/Processing/Sent/Failed، وعدد المحاولات و next attempt time. TemplateRenderer يخرج message content، PreferencePolicy يتحقق من opt-out، ChannelAdapter يتعامل مع provider. لا تجعل HTTP request ينتظر كل القنوات؛ enqueue command ثم worker ينفذ.
public sealed class NotificationDelivery
{
public Guid Id { get; private set; }
public DeliveryStatus Status { get; private set; } = DeliveryStatus.Pending;
public int Attempts { get; private set; }
public DateTimeOffset? NextAttemptAt { get; private set; }
public void MarkAttempt(DateTimeOffset now)
{
if (Status is DeliveryStatus.Sent or DeliveryStatus.Cancelled)
throw new DomainException("Delivery is terminal.");
Attempts++;
Status = DeliveryStatus.Processing;
}
public void MarkSent() => Status = DeliveryStatus.Sent;
public void ScheduleRetry(DateTimeOffset next)
{
Status = DeliveryStatus.Pending;
NextAttemptAt = next;
}
}استخدم idempotency key per notification/provider، واحفظ provider message id عند النجاح. لا retry لـ invalid email أو opt-out؛ retry لـ timeout/429/5xx وفق provider guidance. اختبر provider timeout بعد نجاح الإرسال، duplicate event، template missing، user preference changes، dead-letter و manual replay.
Kata 7 — Rate Limiter
المطلوب: حد requests لكل user/API key/IP. قارن Fixed Window و Sliding Window و Token Bucket و Concurrency Limiter. الـ rate limit يحد المعدل؛ concurrency limiter يحد العمليات المتزامنة لا requests لكل فترة.
التصميم: RateLimitPolicy، IRateLimitStore، IClock للاختبار و RateLimiter. في multi-instance deployment، counter في الذاكرة لكل instance لا يفرض global quota؛ تحتاج shared atomic store أو gateway-level enforcement.
public sealed record RateLimitDecision(bool Allowed, int Remaining,
DateTimeOffset ResetAt);
public interface IRateLimitStore
{
Task<int> IncrementAsync(string key, DateTimeOffset windowStart,
CancellationToken ct);
}اختبر: boundary عند reset، آلاف requests متزامنة، spoofed keys، anonymous users، عدة instances، clock drift و storage outage. Increment لازم تكون atomic؛ read ثم write منفصلان ينتجان race condition.
Rate Limiter — Token Bucket Implementation Kata
Token Bucket state: capacity، current tokens، last refill time. عند كل request، احسب elapsed seconds، أضف refill rate * elapsed حتى capacity، ثم اسحب token لو متاح. داخل process، lock/semaphore يحمي state؛ في distributed system استخدم atomic script/shared store. استخدم monotonic time للـ elapsed durations حتى لا يتأثر الحساب بتغيير ساعة النظام.
public sealed class TokenBucket(int capacity, double tokensPerSecond, TimeProvider time)
{
private readonly object _gate = new();
private double _tokens = capacity;
private DateTimeOffset _last = time.GetUtcNow();
public bool TryConsume(int amount = 1)
{
lock (_gate)
{
var now = time.GetUtcNow();
var elapsed = Math.Max(0, (now - _last).TotalSeconds);
_tokens = Math.Min(capacity, _tokens + elapsed * tokensPerSecond);
_last = now;
if (_tokens < amount) return false;
_tokens -= amount;
return true;
}
}
}الكود تعليمي ويستخدم wall-clock TimeProvider؛ production elapsed measurement قد يفضل monotonic timestamp APIs. validate capacity/rate/amount، وتجنب overflow/NaN. اختبر burst، refill، exact boundary، parallel calls، cancellation/queue policy، memory cardinality و multiple instances.
Kata 8 — Splitwise-style Expenses
المطلوب: مجموعة أصدقاء تسجل مصروفًا دفعه شخص، وتقسمه بالتساوي أو بالنسب أو بمبالغ، ثم تحسب مين عليه لمين. أهم invariant: مجموع shares يساوي إجمالي المصروف بعد rounding policy، والعملة موحدة.
التصميم: Group و Expense و ExpenseShare و Money و SettlementCalculator. لا تجعل mutable balance لكل عضو مصدر الحقيقة إذا كان ledger قابلًا لإعادة الحساب. سجل المصروفات ثم احسب net balances أو materialized view قابلة لإعادة البناء.
public static IReadOnlyList<decimal> Split(decimal total, int people)
{
if (people <= 0) throw new ArgumentOutOfRangeException(nameof(people));
var cents = decimal.ToInt64(total * 100m);
var each = cents / people;
var remainder = cents % people;
return Enumerable.Range(0, people)
.Select(i => (each + (i < remainder ? 1 : 0)) / 100m)
.ToArray();
}اختبر: تقسيم 100 على 3، payer خارج المجموعة، تعديل/حذف مصروف، عملات مختلفة، مبلغ سالب، rounding و settlement optimization. أكثر من settlement قد يكون صحيحًا؛ وثّق معيار تقليل التحويلات الذي تختاره.
Splitwise — Expense Splitting و Settlement
Expense aggregate يحفظ payer، participants، total، currency، split method، shares. في equal split، وزع minor units (cents/piastres) integer ثم وزع remainder deterministic على أول participants حسب ترتيب ثابت. لا تستخدم double للأموال. Net balance لكل user = total owed minus total paid وفق ledger semantics؛ positive يعني له مستحقات أو عليه مستحقات حسب تعريفك، وثبّت convention في code/tests.
public static IReadOnlyDictionary<Guid, long> SplitEvenly(
long totalMinorUnits, IReadOnlyList<Guid> participants)
{
if (totalMinorUnits < 0 || participants.Count == 0)
throw new ArgumentException("Invalid split.");
var ordered = participants.Distinct().Order().ToArray();
if (ordered.Length != participants.Count)
throw new DomainException("Duplicate participant.");
var each = totalMinorUnits / ordered.Length;
var remainder = totalMinorUnits % ordered.Length;
return ordered.Select((id, index) =>
new KeyValuePair<Guid, long>(id, each + (index < remainder ? 1 : 0)))
.ToDictionary(x => x.Key, x => x.Value);
}Settlement algorithm يمكن أن يستخدم greedy pairing بين أكبر debtor وأكبر creditor لتقليل عدد التحويلات غالبًا، لكن optimal minimum transactions problem له تعقيد أعلى في general case. وضح هل تريد simple deterministic settlement أم mathematically minimal. اختبر rounding، participant leaves group، expense edit/delete، currency mismatch، negative adjustment و replay.
Kata 9 — Chess / Tic-Tac-Toe
المطلوب: board، players، legal moves، turn order، win/draw detection وسجل الحركات. Tic-Tac-Toe بداية مناسبة؛ الشطرنج توسعها إلى قواعد وحركات خاصة. لا تضع القواعد في UI أو controller.
التصميم: Game aggregate، Board و Position value objects، Move، RuleEngine و GameState. اجعل move command immutable وطبق validation ثم transition. في chess افصل pseudo-legal moves عن legal moves التي لا تترك الملك في check.
public enum Mark { Empty, X, O }
public sealed class TicTacToeBoard
{
private readonly Mark[] cells = new Mark[9];
public void Place(int index, Mark mark)
{
if (index is < 0 or >= 9) throw new ArgumentOutOfRangeException(nameof(index));
if (mark == Mark.Empty || cells[index] != Mark.Empty)
throw new DomainException("Invalid move.");
cells[index] = mark;
}
public bool HasWon(Mark mark)
{
int[][] lines = [[0,1,2],[3,4,5],[6,7,8],[0,3,6],[1,4,7],[2,5,8],[0,4,8],[2,4,6]];
return lines.Any(line => line.All(i => cells[i] == mark));
}
}اختبر: index خارج board، خلية مشغولة، لاعب يلعب مرتين، الفوز بكل اتجاه، draw، move بعد النهاية، replay من event history و concurrent moves لنفس turn. استخدم property-based tests لتوليد sequences والتحقق من invariants.
Tic-Tac-Toe — Game Aggregate و Rule Engine
Game aggregate يملك board، current player، move history، state InProgress/Won/Draw. Move command يجب يتحقق من turn، cell bounds، cell empty، وعدم انتهاء اللعبة. RuleEngine يحسب win/draw، و UI مجرد client يعرض state. في chess، افصل generation of candidate moves عن legality (king safety) وعن game state (check/checkmate/stalemate/castling/en passant).
public sealed class TicTacToeGame
{
private readonly Mark[] _cells = new Mark[9];
public Mark CurrentPlayer { get; private set; } = Mark.X;
public GameStatus Status { get; private set; } = GameStatus.InProgress;
public void Play(int index, Mark player)
{
if (Status != GameStatus.InProgress) throw new DomainException("Game ended.");
if (player != CurrentPlayer) throw new DomainException("Wrong turn.");
if (index is < 0 or >= 9 || _cells[index] != Mark.Empty)
throw new DomainException("Illegal move.");
_cells[index] = player;
if (HasWon(player)) Status = GameStatus.Won;
else if (_cells.All(x => x != Mark.Empty)) Status = GameStatus.Draw;
else CurrentPlayer = player == Mark.X ? Mark.O : Mark.X;
}
}اختبر all win lines، draw، move after terminal، wrong player، duplicate move، invalid index، replay from move history و concurrent moves. Property-based tests يمكنها توليد sequences والتحقق أن عدد X/O يظل منطقيًا وأن game terminal لا تقبل moves.
Kata 10 — Document Q&A Pipeline
المطلوب: رفع مستند، استخراج النص، تقسيمه إلى chunks، embedding، تخزين metadata/vector، retrieval، ثم إجابة مع citations. افصل orchestration عن مزودي OCR/Embedding/Vector DB/LLM.
التصميم: Document aggregate بحالات Uploaded/Processing/Indexed/Failed، IDocumentParser، IChunker، IEmbeddingProvider، IVectorStore، IRetriever، ILLMClient و AnswerComposer. الـ application service ينسق pipeline ولا يحمل تفاصيل provider.
public interface IDocumentParser
{
Task<ParsedDocument> ParseAsync(Stream content, string mediaType,
CancellationToken ct);
}
public interface IEmbeddingProvider
{
Task<IReadOnlyList<float[]>> EmbedAsync(
IReadOnlyList<string> texts, CancellationToken ct);
}
public interface IVectorStore
{
Task UpsertAsync(IReadOnlyList<EmbeddedChunk> chunks, CancellationToken ct);
Task<IReadOnlyList<RetrievedChunk>> SearchAsync(
float[] queryVector, int topK, CancellationToken ct);
}نقاط أمان وجودة: ingestion async مع idempotency؛ chunk IDs مستقرة؛ metadata تحفظ tenant/document/page؛ ACL filtering قبل retrieval؛ citations تربط الإجابة بمصدر؛ لا تثق في prompt injection داخل المستند؛ لا ترسل secrets أو بيانات tenant آخر إلى model context. اختبر PDF تالفًا، duplicate upload، timeout، حذف document و chunks، cross-tenant leakage، no relevant context وإجابة بلا citation.
Document Q&A — Pipeline و Security Boundaries
قسّم workflow إلى stages مستقلة: upload validation → malware/type check → parsing/OCR → chunking → embedding → vector upsert → indexing complete. Query path: authenticate → resolve tenant/document ACL → embed query → retrieve filtered chunks → rerank → build bounded context → call model → validate output/citations → return answer. لا تضع كل شيء داخل AskAsync ضخمة بلا checkpoints.
public sealed class AskDocumentsHandler(
IQueryEmbedder embedder,
IDocumentRetriever retriever,
IAnswerGenerator generator,
IAccessPolicy access)
{
public async Task<GroundedAnswer> Handle(
AskDocuments query, UserContext user, CancellationToken ct)
{
await access.EnsureCanSearchAsync(user, query.CollectionId, ct);
var vector = await embedder.EmbedAsync(query.Question, ct);
var chunks = await retriever.SearchAsync(
user.TenantId, query.CollectionId, vector, topK: 8, ct);
if (chunks.Count == 0) return GroundedAnswer.NoContext();
var answer = await generator.GenerateAsync(query.Question, chunks, ct);
return AnswerValidator.RequireValidCitations(answer, chunks);
}
}Tenant/ACL filter يجب أن يدخل في retrieval نفسه، لا بعد إرسال chunks إلى LLM. Retrieved documents untrusted content وقد تحتوي prompt injection؛ model لا يقرر permissions. tool calls تتطلب server-side authorization مستقل. اختبر cross-tenant leakage، deleted document، stale vector index، malicious instructions داخل PDF، no context، hallucinated citation، model timeout، provider outage، PII redaction و prompt/version regression.
مراجعة التصميم قبل التنفيذ
- هل كل use case لها happy path و failure/alternate paths؟
- هل أسماء classes تمثل business concepts أم مجرد طبقات تقنية؟
- هل لكل class مسؤولية متماسكة وسبب تغيير واضح؟
- هل invariants محمية في domain model و database عند الحاجة؟
- هل اخترت composition/inheritance بناءً على substitutability؟
- هل interfaces عند boundaries مفيدة وليست لكل class؟
- هل concurrency و idempotency و transaction boundaries واضحة؟
- هل domain logic قابلة للاختبار دون شبكة أو database؟
- هل الرسومات تشرح decisions ويمكن تحديثها؟
- هل abstraction أضافت قيمة أم سبقت الحاجة؟
تسليم أي Kata لا يكتمل بالـ class diagram: اكتب requirements و assumptions، ارسم use-case/sequence/state عند الحاجة، اعرض domain model، نفذ invariant أساسيًا، واكتب tests للحالات الطبيعية والحدية والمتزامنة. ثم اشرح trade-offs والبدائل المرفوضة ولماذا.
اختبر فهمك
هل كل noun في requirement يتحول إلى class؟
ما الفرق بين Entity و Value Object؟
لماذا composition غالبًا أكثر مرونة من inheritance؟
هل private setters وحدها تحقق encapsulation؟
هل in-memory lock يحمي حجز غرفة في عدة API replicas؟
لماذا ACL filtering قبل retrieval مهم في Document Q&A؟
المشروعات العشرة القابلة للتشغيل والاختبار
حوّلت الـ10 OOD katas إلى مشروعات .NET 8 مستقلة داخل مجلد EXAMPLES/OOD، ومعها Solution واحدة و Test Project موحد يحتوي اختبارات لكل kata. شغّل الأمثلة من terminal، ثم غيّر requirement أو اكسر invariant واكتب test جديدة قبل refactor.
افتح دليل تشغيل المشروعات العشرة — ستجد Parking Lot و Hotel Reservation و Library Management و ATM و Elevator و Notification Service و Rate Limiter و Splitwise و Tic-Tac-Toe و Document Q&A.
الأمثلة تستخدم in-memory state حتى تركز على OOD. ليست بديلًا عن database transaction أو distributed locks أو outbox أو authentication في production. الـ README يحدد ما يجب تغييره عند تحويل كل kata إلى application حقيقية.
المراجع والقراءة الإضافية
الدرس بيشرح الفكرة نفسها؛ الروابط دي للتحقق والتعمق والرجوع لتفاصيل الـ API. (محتاجة إنترنت.)
التوثيق الرسمي — Official documentation
مصادر تعليمية ومتقدمة — Third-party & advanced reading
خريطة التغطية: 36 عنصر من الـ Roadmap ومكان شرحه في الدرس
خلصت الدرس وحليت الأسئلة؟ علّم عليه عشان يتحسب في تقدّمك.