Repository Pattern: إيه المشكلة اللي بتحلها؟
Repository abstraction تقدم للـ application/domain طريقة للتعامل مع aggregates من غير ما تعرف تفاصيل persistence. هي مش مجرد class تلف كل DbSet method. Repository له معنى لما يمثل collection-like boundary حول aggregate root، ويخفي query/persistence strategy التي لا ينبغي أن تتسرب للداخل.
في EF Core، DbContext نفسه يوفر identity map/change tracking/unit-of-work behavior، و DbSet يوفر query/add/remove. لذلك إضافة generic repository يكرر كل method في DbContext قد لا تضيف قيمة. اسأل: هل abstraction تحمي domain boundary؟ هل تخفي persistence-specific details؟ هل تعبر عن use-case query مفهومة؟
Repository عملي من Endpoint إلى SQL: من يملك الـ Query؟
ابدأ من use case واضح: عرض طلبات عميل مع pagination. هل هذا aggregate access لتعديل Order؟ أم read query هدفها جدول شاشة؟ في الحالة الثانية لا تجبر نفسك على تحميل Aggregate كامل. استخدم query contract يرجع DTO projection، واترك repository الخاص بالـ aggregate للتحميل بغرض تنفيذ business behavior.
public sealed record OrderRow(Guid Id, DateTime CreatedAt,
decimal Total, string Status);
public sealed record Page<T>(IReadOnlyList<T> Items,
int Page, int PageSize, int TotalCount);
public interface IOrderQueries
{
Task<Page<OrderRow>> GetCustomerOrdersAsync(
Guid customerId, int page, int pageSize, CancellationToken ct);
}public async Task<Page<OrderRow>> GetCustomerOrdersAsync(
Guid customerId, int page, int pageSize, CancellationToken ct)
{
page = Math.Max(1, page);
pageSize = Math.Clamp(pageSize, 1, 100);
var query = db.Orders.AsNoTracking()
.Where(o => o.CustomerId == customerId);
var total = await query.CountAsync(ct);
var items = await query
.OrderByDescending(o => o.CreatedAt)
.ThenByDescending(o => o.Id)
.Skip((page - 1) * pageSize)
.Take(pageSize)
.Select(o => new OrderRow(o.Id, o.CreatedAt,
o.Total, o.Status.ToString()))
.ToListAsync(ct);
return new Page<OrderRow>(items, page, pageSize, total);
}لاحظ أن OrderBy يحتوي tie-breaker ثابتًا (Id)؛ بدون ترتيب فريد قد تتكرر أو تختفي rows بين الصفحات. AsNoTracking مناسب للقراءة. Select يمنع تحميل كل navigation graph. لو البيانات ضخمة والصفحات عميقة، Keyset Pagination غالبًا أفضل من Skip/Take. لو العدد الإجمالي مكلف، قد تعرض next-page indicator بدل exact count.
لا تمرر IQueryable من repository إلى Controller ثم تضيف filters هناك؛ هذا يسرّب EF query composition إلى presentation layer. كذلك لا تجعل Generic Repository يخفي Include و ExecuteUpdate و transactions لدرجة تجبرك على حلول أبطأ. الـ abstraction الجيدة تعبر عن intent وتترك provider-specific optimization داخل Infrastructure.
اختبر هذا query على SQL Server الفعلي إذا كان production SQL Server: collation و translation و indexes و execution plan لا يضمنها EF InMemory. راجع index يبدأ بـ CustomerId ثم مفاتيح الترتيب إذا workload يدعم ذلك، لكن قرر من execution plan وقياس حقيقي لا من قاعدة آلية.
Repository لا يجب أن يصبح API عامًا للـ Database
لو كل consumer يقدر يطلب `IQueryable أو يمرر ExpressionDbContext أو DbSet خارج Infrastructure، ولا تسمح للـ Controller أن يقرر Include و transaction isolation. في المقابل، لا تخفِ إمكانات EF التي تحتاجها فعليًا خلف CRUD interface فقيرة. الهدف هو توازن: intent واضح للمستهلك، وحرية تحسين SQL داخل adapter، واختبارات تحمي semantics.
Repository في رسمة: مين بيملك الـ query؟
Repository Interface: Generic ولا Specific؟
Generic repository مثل IRepository<T> قد يناسب CRUD بسيطًا متكررًا، لكنه غالبًا يصبح مليئًا بـ GetAll/Find/Update/Include/Filter/Sort/Specification methods ويكشف تفاصيل ORM. Specific repository يعبر عن domain/use-case needs: IOrderRepository.GetForCheckoutAsync أو GetOpenReservationsAsync.
public interface IOrderRepository
{
Task<Order?> GetForModificationAsync(Guid id, CancellationToken ct);
Task AddAsync(Order order, CancellationToken ct);
}
public sealed class EfOrderRepository(AppDbContext db) : IOrderRepository
{
public Task<Order?> GetForModificationAsync(Guid id, CancellationToken ct) =>
db.Orders.Include(x => x.Items)
.SingleOrDefaultAsync(x => x.Id == id, ct);
public Task AddAsync(Order order, CancellationToken ct) =>
db.Orders.AddAsync(order, ct).AsTask();
}اختيار specific repository يقلل leakage: caller لا يقرر arbitrary Include chain أو raw IQueryable على Domain. لكن لو application query تحتاج projection معقدة، read query object أو direct query service قد يكون أنسب من إجبار كل شيء على aggregate repository.
Repository و Aggregate Root: لا تعمل Repository لكل Table
في DDD، Repository غالبًا يمثل Aggregate Root، وليس كل table. OrderRepository يرجع Order مع items اللازمة لتعديل aggregate. OrderItemRepository منفصل قد يسمح بتعديل child خارج root ويكسر invariants. لكن لو النظام CRUD بسيط ولا يستخدم aggregates، لا تفرض DDD repository rules عليه؛ اختَر abstraction متناسبة.
Repository لا ينبغي أن يعرض تفاصيل persistence مثل DbSet أو IQueryable إلى domain. لو caller يكتب repository.Query().Include(...).Where(...) فقد خرجت EF Core من Infrastructure وصارت abstraction شكلية. الأفضل method intent واضح أو query service مخصصة.
Generic Repository: متى يفيد ومتى يتحول إلى مشكلة؟
Generic CRUD repository يمكن أن يقلل boilerplate في CRUD متكرر بسيط، لكنه لا يعبر عن business intent. interface عامة مثل GetAll/Find/Update/Delete/Include/Sort/Page غالبًا تكبر لتصبح ORM جديدًا ناقصًا. لو احتجت Include graph خاص بكل use case، projection، raw SQL أو ExecuteUpdate، تبدأ تضيف escape hatches وتخسر قيمة التجريد.
اختيار عملي: specific repositories للـ write aggregates؛ query services/read models للقراءة المعقدة؛ DbContext مباشرة داخل Infrastructure/Application boundary في تطبيق صغير. لا يوجد شرط أن كل مشروع يستخدم Repository pattern فوق EF Core.
Repository لكل Aggregate Root وليس Generic CRUD لكل Table
في DDD repository غالبًا يمثل collection-like access إلى Aggregate Root. لو Order aggregate يحتوي OrderItems، غالبًا تحفظ aggregate من خلال IOrderRepository بدل repository مستقل لكل child table يسمح بتعديل item وتجاوز قواعد الطلب. أما read models والتقارير فقد تحتاج query services متخصصة لا تتظاهر أنها aggregate repositories.
Generic repository مفيد فقط لو يقدم semantics مشتركة حقيقية، مثل GetById و Add مع قواعد موحدة. Generic CRUD ضخم يكشف IQueryable و Include و DbSet لكل consumer قد لا يعزل persistence أصلًا. EF Core DbContext بالفعل Unit of Work و DbSet يشبه Repository؛ أضف wrapper عندما يملك قيمة مثل domain-oriented queries أو test seam أو provider abstraction مفيدة.
public interface IOrderRepository
{
Task<Order?> GetForChangeAsync(Guid id, CancellationToken ct);
Task AddAsync(Order order, CancellationToken ct);
Task<bool> ExistsWithNumberAsync(string number, CancellationToken ct);
}اجعل method names تصف use-case query shape أو aggregate access، ولا تسمح للمستدعي بتمرير arbitrary expression إذا كان ذلك يكشف EF/provider. في read-heavy use cases قد تستخدم IOrderQueries ترجع DTO projections مباشرة. افصل command persistence عن optimized read model عندما يكون ذلك أوضح.
Unit of Work: هل EF Core بالفعل Unit of Work؟
Unit of Work يجمع تغييرات متعددة ثم يحفظها كوحدة منطقية. EF Core DbContext يتتبع Added/Modified/Deleted entities و SaveChanges يرسل التغييرات. غالبًا ده يحقق Unit of Work بالفعل. إضافة IUnitOfWork.SaveChangesAsync قد تفيد لعزل Application عن EF Core أو تسهيل architecture tests، لكنها لا ينبغي أن تتحول إلى transaction abstraction عامة تخفي semantics.
Repository عادة لا يعمل SaveChanges داخل كل Add/Update؛ use case يحدد commit boundary بعد تنفيذ التغييرات كلها. لو كل repository يحفظ وحده، نقلت transaction boundary بعيدًا عن application workflow وقد تفشل atomicity.
public sealed class TransferService(
IAccountRepository accounts, IUnitOfWork unitOfWork)
{
public async Task TransferAsync(int fromId, int toId,
Money amount, CancellationToken ct)
{
var from = await accounts.GetAsync(fromId, ct);
var to = await accounts.GetAsync(toId, ct);
from.Withdraw(amount);
to.Deposit(amount);
await unitOfWork.SaveChangesAsync(ct);
}
}لو DbContext واحد Scoped، التغييرات الاثنين تدخل transaction واحدة في SaveChanges غالبًا عند provider يدعمها. لكن external payment أو message broker لا يدخل تلقائيًا في نفس DB transaction؛ تحتاج outbox/saga/compensation حسب العملية.
Unit of Work و Transaction Scope بعمق
Unit of Work concept يجمع changes التي تنتمي إلى use case واحد. في EF Core، DbContext يحتفظ tracked changes، و SaveChanges ينفذها. لو تحتاج عدة SaveChanges في نفس transaction، افتح transaction صريحة، لكن لا تمدها عبر external network call. لو عندك أكثر من DbContext أو database، EF local transaction لا تجعلها atomic تلقائيًا.
لا تجعل repository تعمل SaveChanges من غير ما توثق contract؛ ده قد يؤدي إلى commit جزئي قبل أن تكمل service باقي العمل. ولا تجعل UnitOfWork interface تكرر كل methods في DbContext بلا فائدة. abstraction مفيدة لو Application تريد commit boundary مستقلة، وإلا استخدم DbContext داخل Infrastructure-facing application service.
DbContext Lifetime و Repository Lifetime
DbContext عادة Scoped في web request، وكل repository تستخدم نفس context instance عبر DI scope. ده يسمح بتتبع entities وحفظ عدة تغييرات معًا. لا تسجل DbContext أو repository كـ Singleton. DbContext غير thread-safe؛ لا تنفذ عدة queries متزامنة على نفس context، ولا تحتفظ به بعد انتهاء scope.
في background job، لا تخزن repository/DbContext في job arguments. أنشئ DI scope لكل job execution أو استخدم IDbContextFactory عند الحاجة. لو use case يحتاج parallel queries، استخدم contexts منفصلة مع فهم أن كل context transaction مستقلة، أو أعد تصميم query.
Repository لا يساوي Transaction: حدود الحفظ والـ Outbox
لو كل repository ينفذ SaveChangesAsync داخليًا، يصبح تجميع التغييرات عبر أكثر من aggregate صعبًا. غالبًا DbContext scoped هو Unit of Work، و SaveChanges واحدة تنفذ transaction محلية للعمليات المدعومة في relational provider. لكن هذا لا يجعل HTTP call أو broker publish جزءًا من نفس transaction.
لو use case يحفظ Order وينشر OrderPlaced، لا تحفظ Order ثم تنشر مباشرة ثم تتوقع ضمانًا كاملًا. crash بعد commit وقبل publish يفقد الحدث؛ publish قبل commit قد يجعل consumer يرى حدثًا لبيانات لم تثبت. Outbox يحفظ row للحدث مع بيانات الطلب في نفس transaction، ثم worker ينشره ويعلّم row. المستهلك يحتاج idempotency لأن النشر قد يتكرر.
Repository contract يجب أن يوضح هل Add يضيف فقط أم يحفظ فورًا. اكتب tests تثبت rollback عند فشل SaveChanges، و concurrency conflict، و cancellation. لا تخفِ transaction semantics وراء method اسمها SaveAsync دون توثيق.
Query Composition و Read Models
Repository للـ aggregates يركز على consistency boundary، وليس شرطًا أن يكون مصدر كل read model. شاشة تقرير قد تحتاج join و projection و pagination ولا تحتاج تحميل aggregate كامل. استخدم query service/read repository يعيد DTO projection. ده يقلل over-fetching ويمنع application من الاعتماد على IQueryable خارج Infrastructure.
public sealed class OrderReadQueries(AppDbContext db)
{
public Task<List<OrderRow>> GetRecentAsync(Guid customerId, CancellationToken ct) =>
db.Orders.AsNoTracking()
.Where(o => o.CustomerId == customerId)
.OrderByDescending(o => o.CreatedAt)
.Select(o => new OrderRow(o.Id, o.Status, o.Total, o.CreatedAt))
.Take(50)
.ToListAsync(ct);
}Repository Query Shape: لا تخفِ IQueryable بلا قرار
أكبر خلاف في Repository مع EF Core هو هل ترجع IQueryable أم لا. إرجاع IQueryable يسمح للـ caller بإضافة Where/OrderBy/Select قبل التنفيذ، لكنه يسرّب EF provider ويفتح الباب لتمرير expressions غير متوقعة أو تنفيذ query بعد انتهاء DbContext lifetime. إرجاع List يحسم التنفيذ داخل repository لكنه قد يمنع projection و pagination المناسبة.
اختر contract حسب use case. لو تريد حماية aggregate write model، استخدم methods محددة مثل GetForUpdateAsync. لو عندك read-heavy screens متنوعة، Query Object أو read service يرجع DTO projection غالبًا أوضح. Specification مفيدة عندما criteria قابلة لإعادة الاستخدام ولها semantics واضحة، لكنها ليست رخصة لبناء query framework كامل.
public Task<ProductListItem[]> SearchAsync(
string? term, int page, int pageSize, CancellationToken ct) =>
_db.Products.AsNoTracking()
.Where(p => term == null || p.Name.Contains(term))
.OrderBy(p => p.Name).ThenBy(p => p.Id)
.Skip((page - 1) * pageSize).Take(pageSize)
.Select(p => new ProductListItem(p.Id, p.Name, p.Price))
.ToArrayAsync(ct);الكود يحتاج validation لـ page/pageSize، و Contains قد يترجم إلى pattern search لا يستفيد من index تقليدي حسب collation/provider. استخدم stable ordering مع unique tie-breaker لتقليل تكرار/فقد الصفوف بين الصفحات، وفكر في keyset pagination عند datasets كبيرة. لا تستخدم AsNoTracking على entity ستعدلها في نفس unit of work.
Specification Pattern مع EF Core
Specification encapsulates a reusable predicate/query intent مثل ActiveProducts أو OrdersForCustomer. في EF Core، تنفيذ specification يحتاج يترجم expression إلى query. تجنب تجميع كل filtering/sorting/include في generic abstraction ضخمة. استخدمها عندما نفس query rule تتكرر فعلًا أو تحتاج compose/test؛ لا تستخدمها لمجرد أن pattern موجود.
public interface ISpecification<T>
{
Expression<Func<T, bool>> Criteria { get; }
}
public sealed class ActiveProductsSpec : ISpecification<Product>
{
public Expression<Func<Product, bool>> Criteria =>
product => product.IsActive && product.Stock > 0;
}
var spec = new ActiveProductsSpec();
var products = await db.Products
.Where(spec.Criteria)
.AsNoTracking()
.ToListAsync(ct);ده شكل مبسط؛ production specification قد تدعم ordering/paging/includes/projection. افصل query semantics عن provider execution، واختبر SQL الناتج للـ specs الحرجة. لا تحوّل expression إلى Func قبل EF Core وإلا قد تنقل filtering إلى memory.
Specification Pattern مع Repository: فلترة قابلة للتركيب بدون تسريب EF
Specification مناسبة عندما business/query criteria تتكرر فعلًا وتحتاج تركيبًا واختبارًا مستقلًا. لكن implementation التي تخزن `FuncInclude و sorting و projection و pagination وكل شيء في abstraction واحدة ضخمة. ابدأ بالـ predicate، ثم أضف query options فقط عندما تظهر حاجة واضحة.
public sealed class ActiveProductsSpec : ISpecification<Product>
{
public Expression<Func<Product, bool>> Criteria =>
p => p.IsActive && p.Stock > 0;
}
public interface ISpecification<T>
{
Expression<Func<T, bool>> Criteria { get; }
}
public async Task<List<T>> ListAsync<T>(
ISpecification<T> spec, CancellationToken ct)
where T : class
{
return await db.Set<T>()
.Where(spec.Criteria)
.ToListAsync(ct);
}لا تنفذ Compile() قبل Where لأن ذلك يحول التعبير إلى delegate ويجبر filtering في الذاكرة أو يفشل في translation. اختبر SQL الناتج وسلوك provider. لو specification تحتاج projection مختلفة لكل شاشة، query object أو query handler غالبًا أوضح من generic specification framework.
اختَر بين repository method و specification حسب reuse: GetActiveProductsForCatalog method صريحة سهلة الفهم. أما شروط متكررة مثل active + category + price range يمكن تركيبها إذا فعلاً تتكرر. تجنب building a framework قبل وجود 2-3 use cases تثبت أن التركيب مفيد.
Specification Composition و Query Translation
Specification قد تجمع criteria و sorting و paging و includes، لكن expression يجب تظل قابلة للترجمة إلى SQL. تحويلها إلى delegate Func<T,bool> يجعل filtering في memory بعد materialization. لا تستخدم compiled delegate داخل EF query. لو تحتاج combine specifications، استخدم expression composition صحيحة أو provider يدعمها، واختبر SQL generated.
Expression<Func<Product, bool>> active = p => p.IsActive;
Expression<Func<Product, bool>> inStock = p => p.Stock > 0;
// Conceptually combine expressions into one expression tree before Where.
// Do not call Compile() and then use the delegate in EF Core query.
var query = db.Products.Where(active).Where(inStock);في كثير من الحالات chaining Where أوضح من Specification class. استخدم specification عندما هناك business query concept يتكرر، وليس لكل filter combination من UI.
Testing و Transactions و Common Traps
Unit tests للـ application service يمكنها استخدام fake repository للتحقق من use case. Integration tests للـ EF repository تستخدم provider حقيقيًا للتحقق من SQL translation، FK constraints، transaction behavior و tracking. لا mock DbSet وتعتبر ده test للـ database behavior.
- لا تحفظ داخل كل repository method إلا لو contract يطلب ذلك بوضوح.
- لا ترجع IQueryable من Infrastructure إلى Domain/Application إذا كان ذلك يكشف provider/lifetime.
- لا تجعل generic repository يكرر DbContext دون قيمة.
- لا تحمل aggregate كاملًا لتقرير read-only.
- لا تخلط transaction DB مع HTTP call في نفس transaction الطويلة.
- حدد ownership: من ينشئ DbContext ومن يتخلص منه؟ DI غالبًا يدير scoped lifetime.
Concurrency و Optimistic Concurrency داخل Repository
Repository مجرد abstraction؛ لا يضمن concurrency safety. لو اتنين users حملوا نفس Order وعدلوا status، آخر SaveChanges قد يكتب فوق الأول إذا لم يوجد concurrency token. استخدم rowversion/ETag/conditional update أو business status predicate. تعامل مع DbUpdateConcurrencyException كـ conflict يحتاج إعادة قراءة وقرار، لا retry أعمى.
public async Task<bool> TryMarkPaidAsync(Guid orderId, CancellationToken ct)
{
var affected = await db.Orders
.Where(x => x.Id == orderId && x.Status == OrderStatus.Pending)
.ExecuteUpdateAsync(setters => setters
.SetProperty(x => x.Status, OrderStatus.Paid), ct);
return affected == 1;
}ده set-based update يتجاوز domain method و change tracker؛ استخدمه فقط لو transition بسيط ومحمى بشرط SQL واضح، وسجل event/audit بما يتناسب. لو domain logic معقدة، load aggregate tracked واستخدم concurrency token.
اختبار Repository وقرارات Persistence
Unit test لـ application service تختبر use case عبر fake repository، ولا تثبت EF SQL. Integration test لـ repository تستخدم provider حقيقيًا وتتحقق من mapping/query/constraints/transaction/concurrency. Architecture test تتحقق من أن Domain/Application لا تعتمد على Infrastructure/EF types إذا كانت هذه boundary مطلوبة.
اكتب tests لحالات: aggregate graph loading، missing entity، duplicate key، soft delete filter، tenant scoping، concurrency conflict، transaction rollback، pagination ordering، query projection، و raw SQL mapping. لا تعتمد على EF InMemory provider لإثبات behavior خاص بـ SQL Server.
Repository Tests: اختبر SQL الحقيقي لا Mock متخيل
Unit test لخدمة تستخدم repository يمكنه mock contract، لكن اختبارات repository نفسها تحتاج database provider حقيقي قريب من production. EF Core InMemory لا يحاكي relational constraints أو SQL translation أو transactions أو collation. SQLite in-memory أفضل لبعض السيناريوهات لكنه ليس SQL Server/PostgreSQL؛ احتفظ باختبارات provider-specific للـ queries الحساسة.
اختبر unique constraints و foreign keys و cascade behavior و concurrency tokens و transaction rollback و query pagination ordering. اختبر أن projection لا تجلب navigation graph كاملًا، وأن cancellation يصل إلى EF async methods. راقب SQL generated باستخدام logging/ToQueryString في بيئة الاختبار، لكن لا تربط tests بكل whitespace أو alias في SQL لأن provider قد يغير صياغته.
Concurrency و Transactions: Repository مش بديل عن Database Guarantees
Repository method مثل SaveAsync لا يعني أن العملية أصبحت atomic عبر أكثر من resource. لو use case تعدل Order وتحجز Stock في نفس SQL database، استخدم transaction واحدة أو atomic SQL operation مع constraint مناسب. لو Stock في service/database أخرى، لا تتظاهر أن Unit of Work محلية تحمي النظام كله؛ تحتاج reservation workflow و compensation أو saga.
للتعامل مع concurrent updates، استخدم optimistic concurrency token مثل SQL Server rowversion أو concurrency stamp. EF Core يرمي DbUpdateConcurrencyException عند conflict إذا تم إعداد token. لا تبتلع الاستثناء وتعيد save بلا مراجعة؛ أعد تحميل الحالة وقرر هل ترفض التعديل أو تدمج أو تطلب من المستخدم حل التعارض. في inventory، `UPDATE Products SET Stock = Stock - @q WHERE Id = @id AND Stock >= @q` مع فحص affected rows قد يكون أوضح وأقوى من read-then-write في كود التطبيق.
try
{
await db.SaveChangesAsync(ct);
}
catch (DbUpdateConcurrencyException)
{
throw new ConflictException(
"The order changed while you were editing it. Reload and retry.");
}Unit of Work في EF Core غالبًا هو DbContext: يجمع tracked changes ثم يحفظها. إضافة IUnitOfWork wrapper قد تكون مفيدة لتحديد application boundary أو تسهيل testing، لكنها قد تكون duplicate abstraction لو لا تضيف contract مستقل. لا تفتح transaction داخل كل repository method؛ transaction ownership عادة للـ use case لأن use case يعرف ما الذي يجب أن ينجح أو يفشل معًا.
راقب lifetime: DbContext scoped لكل request/work unit، لا singleton. لا تشارك instance واحدة بين parallel tasks. Repository scoped يتبع lifetime نفسه. Background job ينشئ scope لكل execution أو يستخدم IDbContextFactory عند الحاجة. هذه قرارات correctness وليست تفاصيل DI شكلية.
Decision: هل أحتاج Repository؟
استخدم Repository عندما domain aggregate يحتاج persistence abstraction واضحة، أو infrastructure تتغير/تُختبر عبر boundary، أو query semantics لها business meaning. استخدم DbContext مباشرة داخل Application/Infrastructure boundary في تطبيق بسيط عندما abstraction لا تضيف قيمة. استخدم read query service للـ reporting/projection. استخدم Unit of Work منفصل فقط لو عندك سبب architecture واضح، لا لمجرد تكرار اسم pattern.
Decision Table: أي Abstraction تختار؟
| Need | Choice | Reason |
|---|---|---|
| CRUD بسيط داخل API صغيرة | DbContext مباشرة في application boundary | أقل boilerplate |
| Aggregate write model | Specific repository | يحمي aggregate boundary |
| Complex read/report projection | Query service/read model | لا يحمل aggregate كاملًا |
| Repeated business query criteria | Specification عند الحاجة | إعادة استخدام query intent |
| Commit عدة تغييرات معًا | DbContext/UoW | Transaction boundary واضحة |
مراجعة Repository قبل اعتمادها في مشروع حقيقي
راجع الـ contract من منظور consumer: هل method names تصف business intent؟ هل ترجع tracked aggregate عند التعديل و DTO عند القراءة؟ هل CancellationToken يصل إلى كل async database call؟ هل pagination لها ordering فريد وحد أقصى للـ page size؟ هل filters تترجم SQL أم تنفذ في الذاكرة؟ هل transaction owner واضح؟
راجع implementation من منظور provider: هل query تستخدم projection بدل Include غير ضروري؟ هل index مناسب للـ filter/order؟ هل unique constraints موجودة في database وليس validation فقط؟ هل concurrency token مضبوط؟ هل cascade delete مقصود؟ هل repository يخفي DbUpdateConcurrencyException بطريقة تفقد caller القدرة على التعامل؟
راجع الاختبارات: unit tests للـ use case مع fake contract، integration tests للـ query translation والقيود والمعاملات، واختبار cancellation/concurrency للمسارات الحساسة. لا تكتب test واحدًا لكل CRUD method وتعتبر persistence boundary مضمونة. correctness في database تتضمن schema و provider و transaction isolation، وهي لا تظهر كلها في mock.
اختبر فهمك
هل DbContext يشبه Unit of Work؟
لماذا specific repository قد يكون أفضل من generic repository؟
هل كل read يجب أن يرجع aggregate؟
هل SaveChanges داخل كل repository method قرار جيد دائمًا؟
المراجع والقراءة الإضافية
الدرس بيشرح الفكرة نفسها؛ الروابط دي للتحقق والتعمق والرجوع لتفاصيل الـ API. (محتاجة إنترنت.)
التوثيق الرسمي — Official documentation
مصادر تعليمية ومتقدمة — Third-party & advanced reading
خريطة التغطية: 14 عنصر من الـ Roadmap ومكان شرحه في الدرس
خلصت الدرس وحليت الأسئلة؟ علّم عليه عشان يتحسب في تقدّمك.