Software Engineer Encyclopedia
0%
Domain 05 · Security & Software Testing · Topic 5.7

Unit Testing في .NET: من AAA إلى Integration وTestcontainers

Unit Testing — Practical Testing Strategy for .NET

منهج اختبار عملي: test cases، AAA، assertions، isolation، fixtures، data, mocks/stubs، xUnit، Testcontainers، Respawn، TDD، coverage، contract/mutation وAI evaluation.

  • Intermediate
  • ~16 min read
  • 16 sections
  • 11 code examples
  • 1 diagrams
  • 5 questions
  • Priority L1 · Essential
  • .NET 10 · xUnit · Testcontainers for .NET

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

Web API شغال بقاعدة بيانات (المجالات 03 و04).

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

DEEP PRACTICALWrite meaningful tests, not just tests to increase coverage numbers.

01

ليه بنكتب Tests؟

Confidence, regression protection and design feedback
Deep dive

الاختبار مش هدفه رفع coverage percentage؛ هدفه يثبت behavior مهم ويكشف regression بسرعة. Test جيدة توضح contract: input، expected output/state، edge cases، failure behavior. الاختبار الذي يمر دائمًا لكنه لا يفشل عند bug لا يقدم حماية حقيقية.

اختَر مستوى الاختبار حسب boundary: Unit test سريع يعزل class/function أو domain behavior؛ Integration test يتحقق من تعاون مكونات حقيقية مثل EF Core مع SQL Server؛ Contract test يتحقق من اتفاق بين consumer/provider؛ End-to-end test يغطي user flow كاملًا لكنه أبطأ وأكثر هشاشة. لا تستخدم test واحدة لإثبات كل شيء.

02

Arrange–Act–Assert و Test Naming

Make each test tell a story
Deep dive

Arrange جهز inputs/dependencies/state. Act نفذ behavior واحدًا. Assert تحقق من النتيجة أو side effect. Test name يصف scenario والنتيجة، مثل Withdraw_WhenBalanceIsInsufficient_RejectsWithoutChangingBalance. تجنب أسماء عامة مثل Test1 أو ShouldWork.

C#A focused domain unit test
[Fact]
public void Withdraw_WhenBalanceIsInsufficient_LeavesBalanceUnchanged()
{
    // Arrange
    var account = new BankAccount(new Money(50m, "EGP"));

    // Act
    var result = account.TryWithdraw(new Money(80m, "EGP"));

    // Assert
    Assert.False(result.Succeeded);
    Assert.Equal(50m, account.Balance.Amount);
}

اختبر observable behavior، مش private methods أو تفاصيل implementation. لو refactor بسيط كسر عشرات tests رغم إن behavior لم يتغير، غالبًا tests tightly coupled للكود الداخلي. في المقابل لا تختبر implementation details فقط لأن assertion سهلة.

03

Assertions و Test Cases و Edge Cases

What exactly should be asserted?
Deep dive

Assertion يجب أن تكون محددة: result، state transition، emitted event، repository call عند الضرورة، أو عدم حدوث side effect. لا تكتفِ بـ Assert.NotNull لو المطلوب أن total يساوي قيمة محددة. تجنب assertions كثيرة غير مرتبطة في test واحدة؛ خلي كل test يركز على scenario واحد.

صمم test cases من decision table: happy path، empty input، null/invalid، boundary values، duplicate، concurrency، timeout، unauthorized، dependency failure. لا تكرر كل combination عشوائيًا؛ استخدم equivalence classes و boundary value analysis لتقليل العدد مع تغطية المخاطر.

C#Theory for boundaries
[Theory]
[InlineData(0, false)]
[InlineData(-1, false)]
[InlineData(1, true)]
[InlineData(100, true)]
public void Quantity_must_be_positive_and_within_limit(int quantity, bool expected)
{
    var result = Quantity.TryCreate(quantity, out _);
    Assert.Equal(expected, result);
}
04

Test Isolation و Fixtures و Test Data

Independent, deterministic tests
Deep dive

كل test يجب أن تقدر تتنفذ منفردة وبأي ترتيب. لا تعتمد على test سابقة أو shared mutable static state أو ساعة حقيقية أو random غير مضبوط. Fixture تشارك setup ثقيلًا بحذر، لكن مشاركة database state بين tests قد تسبب flaky behavior. أنشئ data مميزة لكل test أو استخدم transaction/cleanup strategy واضحة.

استخدم builders/factories لإنشاء valid domain objects بدل constructors طويلة في كل test. Test data يجب أن تكون minimal: لا تملأ 40 property لا تؤثر في scenario. استخدم deterministic clock/ID generator عندما time/IDs جزء من behavior.

C#Inject a clock to make time deterministic
public interface IClock { DateTimeOffset UtcNow { get; } }
public sealed class FakeClock(DateTimeOffset now) : IClock
{
    public DateTimeOffset UtcNow { get; private set; } = now;
    public void Advance(TimeSpan by) => UtcNow = UtcNow.Add(by);
}

[Fact]
public void Expired_hold_cannot_be_confirmed()
{
    var clock = new FakeClock(DateTimeOffset.Parse("2026-11-12T08:00:00Z"));
    var hold = ReservationHold.Create(clock.UtcNow, TimeSpan.FromMinutes(10));
    clock.Advance(TimeSpan.FromMinutes(11));
    Assert.False(hold.CanConfirm(clock.UtcNow));
}

xUnit Fixtures و Parallel Execution

xUnit ينشئ test class instance لكل test، و class fixture تشارك expensive resource داخل class. Collection fixture تشارك resource بين عدة classes في نفس collection. الاختبارات قد تعمل parallel بين collections؛ لو fixture تشارك database أو port، تأكد أن tests لا تتداخل. لا تجعل static fixture تحتفظ DbContext مشترك.

C#Collection fixture concept
public sealed class DatabaseFixture : IAsyncLifetime
{
    public string ConnectionString { get; private set; } = "";
    public async Task InitializeAsync()
    {
        // Start isolated database/container and apply migrations.
        ConnectionString = await TestDatabase.StartAsync();
    }
    public Task DisposeAsync() => TestDatabase.StopAsync();
}

[CollectionDefinition("database")]
public sealed class DatabaseCollection : ICollectionFixture<DatabaseFixture>;

الكود sketch؛ تأكد من fixture lifecycle في xUnit version المستخدم. لو tests تحتاج نفس DB لكن data مستقلة، استخدم schema/database per test أو unique IDs. لا تعمل global cleanup بين tests parallel على نفس schema.

Flaky Tests: الوقت والشبكة والتزامن

أسباب flaky: real clock، timezone/DST، random IDs، shared mutable state، parallel tests، network calls، eventual consistency، thread scheduling، external rate limits، cleanup race. استبدل الوقت بـ TimeProvider/fake clock، random seed ثابت عند الحاجة، local test server، fake external provider، bounded polling، و isolated data.

لو test تفشل 1/100 مرة، اعتبرها defect في test/system. إعادة المحاولة قد تقلل noise لكنها لا تصلح السبب. اجمع failure artifacts/logs/traces، شغل test وحدها وبالتوازي، ثم صمم synchronization صريحًا بدل Thread.Sleep.

Deterministic Tests: Clock و Random و External Dependencies

اختبر الوقت عبر injected TimeProvider أو clock abstraction بدل DateTime.UtcNow داخل business rule؛ هذا يسمح بتجربة expiry و DST و month boundaries دون انتظار. مرر random generator/seed عندما output تعتمد على randomness. لا تعتمد على ترتيب tests أو current culture/timezone في machine. استخدم fixed culture عند اختبار formatting.

Test fixture مشتركة تقلل setup لكنها قد تخلق state leakage؛ نظف database per test أو استخدم transaction rollback إذا semantics تسمح. Parallel tests قد تتعارض على static state أو نفس database rows/ports. لا تضع test order dependency. سجل input/seed و diagnostics عند failure حتى يمكن إعادة إنتاجه.

05

Mocks و Stubs و Fakes و Moq/NSubstitute

Choose the right test double
Deep dive

Test doubles أنواع: Stub يرجع response محدد؛ Mock يتحقق من interaction متوقع؛ Fake implementation مبسطة تعمل فعلًا (in-memory repository). استخدم mock عند boundary side effect مهم، وليس لكل dependency. كثرة mocks قد تثبت ترتيب calls بدل business outcome وتخلي tests brittle.

C#NSubstitute-style interaction test
var gateway = Substitute.For<IPaymentGateway>();
gateway.ChargeAsync(Arg.Any<Money>(), Arg.Any<string>(), Arg.Any<CancellationToken>())
    .Returns(new PaymentResult.Approved("payment-123"));

var service = new CheckoutService(gateway);
var result = await service.PayAsync(order, CancellationToken.None);

Assert.True(result.Succeeded);
await gateway.Received(1).ChargeAsync(
    order.Total, Arg.Is<string>(key => key.Length > 0), Arg.Any<CancellationToken>());

لا تعمل mock لـ EF Core DbSet كأنه database؛ query translation و constraints وال transactions لن تتصرف بنفس الطريقة. استخدم fake repository لو بتختبر domain/application logic، واستخدم real relational database integration tests للـ EF queries المهمة. Shouldly/AwesomeAssertions مجرد assertion libraries؛ لا تغير جودة test design.

اختيار Test Double: Mock ولا Stub ولا Fake؟

Stub مناسب لما تحتاج response ثابتة: payment approved/declined. Fake مناسب لما تحتاج behavior مبسط لكنه حقيقي مثل in-memory repository يحفظ objects في dictionary. Mock مناسب لما interaction نفسها contract مهم: gateway يجب تستدعى مرة واحدة بـ idempotency key. لا تستخدم mock للتحقق من كل getter/setter؛ ده يربط الاختبار بال implementation.

C#Fake repository for an application unit test
public sealed class InMemoryOrderRepository : IOrderRepository
{
    private readonly Dictionary<Guid, Order> _orders = [];
    public Task<Order?> GetAsync(Guid id, CancellationToken ct) =>
        Task.FromResult(_orders.GetValueOrDefault(id));
    public Task AddAsync(Order order, CancellationToken ct)
    {
        _orders.Add(order.Id, order);
        return Task.CompletedTask;
    }
}

Fake لا يثبت SQL behavior أو transaction isolation؛ هو مناسب لاختبار orchestration. استخدم real database integration test للـ persistence. إذا fake بدأت تقلد EF Core بالكامل، فأنت تبني database ثانية للاختبار.

06

اختبار Business Logic و Validation و Errors

Protect invariants and failure paths
Deep dive

اختبر domain invariants مباشرة: لا يمكن تأكيد order فارغ، لا يمكن حجز date range غير صالح، لا يمكن خصم مبلغ بعملة مختلفة. اختبر application services على orchestration: هل استدعت gateway؟ هل حفظت state؟ هل أصدرت event بعد نجاح العملية فقط؟ اختبر validation errors على boundary response shape/status.

في error handling اختبر transient failure مقابل permanent failure، cancellation، timeout، concurrency conflict، not found، unauthorized/forbidden. تأكد أن rollback/compensation حصل عند الفشل وأن logs لا تسجل secrets. لا تكتب test تتوقع أي Exception وخلاص؛ تحقق من النوع والسبب والنتيجة.

07

Async Tests و Cancellation

Avoid timing-based flaky tests
Practical

استخدم async Task في xUnit ولا تستخدم async void. لا تستخدم Thread.Sleep كآلية مزامنة؛ استخدم TaskCompletionSource أو fake clock أو test hook. اختبر CancellationToken يمر إلى dependency ويتسبب في cancellation متوقعة، ولا تعتبر كل OperationCanceledException خطأ business.

C#Test cancellation propagation
[Fact]
public async Task Search_passes_cancellation_to_repository()
{
    using var cts = new CancellationTokenSource();
    cts.Cancel();
    var repository = Substitute.For<IProductRepository>();
    repository.SearchAsync(Arg.Any<string>(), Arg.Any<CancellationToken>())
        .Returns(call => Task.FromCanceled<IReadOnlyList<Product>>(call.Arg<CancellationToken>()));

    var service = new ProductSearch(repository);
    await Assert.ThrowsAnyAsync<OperationCanceledException>(
        () => service.SearchAsync("keyboard", cts.Token));
}
08

xUnit و Test Organization

Facts, theories, collections and fixtures
Practical

[Fact] لسيناريو ثابت، و [Theory] لعدة input cases. Constructor setup ينفذ لكل test instance في xUnit؛ class fixtures تشارك expensive setup، collection fixtures تشارك على مستوى collection. افهم parallel execution؛ لا تشارك نفس DbContext أو mutable state بين tests متوازية.

رتب tests حسب feature/behavior، وخلي أسماء test methods واضحة. لا تضع test database initialization في static constructor غير قابل للتحكم. استخدم output helpers فقط للتشخيص وليس كبديل عن assertions.

09

Integration Tests و Testcontainers

Test against real dependencies
Deep dive

Integration test يتحقق من boundary حقيقية: EF Core مع SQL Server/PostgreSQL، Redis serialization، filesystem/object storage adapter، أو HTTP client contract. InMemory EF provider لا يمثل relational provider: لا يختبر SQL translation أو constraints أو transactions بنفس behavior. Testcontainers يشغل dependency حقيقية في Docker أثناء test suite، مع isolation وإعداد reproducible.

C#Testcontainers SQL Server — illustrative fixture
var container = new MsSqlBuilder()
    .WithPassword("Your_strong_Test_Password!123")
    .Build();

await container.StartAsync();
var connectionString = container.GetConnectionString();
// Build DbContext options with UseSqlServer(connectionString),
// apply migrations, run integration tests, then dispose container.

في التطبيق الفعلي استخدم package/provider version متوافقًا، password test-only، port isolation، readiness wait، و cleanup. لا تستخدم production credentials أو production data. لو tests بطيئة، شغل container مرة لكل collection أو test suite مع database/schema isolation.

Testcontainers Workflow كامل

Integration test workflow: build container image/provider config، start container، انتظر readiness، استخرج connection string، أنشئ test database/context، طبق migrations، seed minimal data، نفذ assertions، ثم dispose. container startup تكلفة، لذلك reuse per collection أو suite مع isolation قد يكون أفضل من container لكل test.

C#Fixture lifecycle outline
public async Task InitializeAsync()
{
    await _container.StartAsync();
    var options = new DbContextOptionsBuilder<AppDbContext>()
        .UseSqlServer(_container.GetConnectionString())
        .Options;

    await using var db = new AppDbContext(options);
    await db.Database.MigrateAsync();
}

public async Task DisposeAsync()
{
    await _container.DisposeAsync();
}

لا تستخدم credentials production. تأكد من image tag محدد وليس latest عشوائيًا، و CI runner يدعم Docker. لو SQL Server container ثقيل على pipeline، شغل integration suite في job منفصل أو استخدم managed ephemeral database. اختبر migrations نفسها كجزء من release process.

Unit vs Integration vs Contract Tests في ‎.NET

Unit test يثبت behavior مع dependencies معزولة، لكنه لا يثبت SQL translation أو HTTP serialization أو broker semantics. Integration test يشغل عدة components حقيقية مثل EF Core مع SQL provider أو ASP.NET Core TestServer. Contract test يثبت أن adapter يلتزم بعقد external provider أو أن consumer/provider متوافقان. E2E يثبت user journey كاملة لكنه أغلى وأبطأ.

لا تستخدم EF Core InMemory لتأكيد relational behavior؛ لا يحاكي constraints و transactions و SQL dialect. SQLite in-memory أفضل لبعض tests لكنه ليس مطابقًا لـ SQL Server/PostgreSQL. استخدم Testcontainers أو database instance مناسبة عند الحاجة، مع isolation per test/fixture وتنظيف reliable. لا تجعل test order يعتمد على state مشترك.

Test Boundaries: Unit vs Integration vs Contract

Arrange Controlled state Act Call public behavior Assert Observable outcome Repeat Fast deterministic test
Testing feedback loop

Unit test يختبر سلوكًا صغيرًا بسرعة مع dependencies معزولة، لكنه لا يثبت أن EF query أو SQL translation أو middleware configuration يعمل فعلًا. Integration test يختبر عدة مكونات حقيقية معًا، مثل API + database provider. Contract test يتحقق من توافق consumer/provider عند وجود boundaries مستقلة.

لا تختبر implementation details مثل عدد مرات استدعاء private helper إذا لم يكن ذلك contract مهمًا. اختبر observable behavior: status code، persisted state، emitted event، أو returned result. Fake و Mock ليسا interchangeable: fake implementation بسيطة تعمل، mock يسجل interactions؛ استخدم كلًا في مكانه.

C#Practical engineering example
[Fact]
public async Task ApplyDiscount_UsesConfiguredRate()
{
    var policy = new DiscountPolicy(rate: 0.10m);
    var result = policy.Apply(100m);
    Assert.Equal(90m, result);
}

[Theory]
[InlineData(100, 0.10, 90)]
[InlineData(0, 0.10, 0)]
[InlineData(50, 0, 50)]
public void ApplyDiscount_HandlesBoundaries(
    decimal amount, decimal rate, decimal expected)
{
    Assert.Equal(expected, new DiscountPolicy(rate).Apply(amount));
}

اختبر boundaries و invalid inputs، وليس happy path فقط. لو discount rate يمكن أن تكون خارج 0..1، أضف validation واختبارًا يثبت الرفض. لا تجعل test تعتمد على current time أو random أو ترتيب تنفيذ tests؛ استخدم injected clock/seed data عند الحاجة.

Database Integration Tests و Testcontainers و Determinism

EF Core InMemory provider ليس relational database؛ لا يطبق SQL constraints ولا transactions ولا translation بنفس semantics. SQLite in-memory أقرب لبعض السلوك relational لكنه ليس SQL Server أو PostgreSQL. لو correctness تعتمد على provider-specific behavior مثل filtered indexes أو rowversion أو JSON operators، اختبر على نفس engine/provider في container أو بيئة مخصصة.

اجعل tests deterministic: database جديدة أو schema isolation، seed واضح، cleanup مضمون، وتجنب مشاركة state بين tests متوازية. لا تستخدم production database ولا secrets حقيقية. اختبر migrations من empty database، واختبر upgrade path من schema version سابقة عند الحاجة.

C#Practical engineering example
[Fact]
public async Task CreateOrder_PersistsOrderAndItems()
{
    await using var db = await fixture.CreateDbContextAsync();
    var order = new Order { CustomerId = 7 };
    order.Items.Add(new OrderItem { ProductId = 12, Quantity = 2, UnitPrice = 25m });

    db.Orders.Add(order);
    await db.SaveChangesAsync();

    var saved = await db.Orders
        .Include(x => x.Items)
        .SingleAsync(x => x.Id == order.Id);

    Assert.Single(saved.Items);
    Assert.Equal(50m, saved.Items.Sum(x => x.Quantity * x.UnitPrice));
}

المثال يفترض fixture تنشئ database حقيقية مع schema جاهزًا. لا تستخدم نفس DbContext بين Arrange و Act و Assert إذا كان ذلك يخفي bug في persistence؛ أعد فتح context للتحقق من البيانات المخزنة. تأكد أن كل test تحصل على بيانات مستقلة حتى لا تعتمد على execution order.

10

Respawn و Database Reset

Repeatable integration test state
Practical

Respawn يساعد في حذف data من tables وإعادة database إلى حالة نظيفة بين integration tests، مع احترام FK order حسب configuration. لا يعيد schema/migrations؛ جهز schema أولًا ثم reset rows. اختَر هل test واحدة تملك database منفصلة أم schema/tenant منفصل.

لا تشغل tests متوازية على نفس database إذا كل واحدة تعمل reset شامل؛ ستتداخل. استخدم database per worker/test collection أو disable parallelization لمجموعة الاختبارات التي تشترك في state. seed data تكون minimal ومقصودة.

Database Reset: Respawn vs Transaction Rollback

Transaction rollback حول test واحدة سريع، لكنه لا يناسب كل tests إذا الكود نفسه يفتح transaction/connection أو background worker يحتاج رؤية البيانات من connection أخرى. Respawn يحذف rows ويترك schema، مناسب لما كل test تحتاج transaction commit حقيقي. Database per test أقوى isolation لكنه أبطأ. اختَر بناءً على concurrency/parallelism ومتطلبات provider.

Respawn configuration يجب تعرف tables التي لا تريد حذفها (مثل reference data) والـ schemas وال FK dependencies. لا تستخدم reset مشترك مع parallel tests. seed data يجب أن تكون deterministic ومحدودة، ولا تعتمد على ترتيب تنفيذ tests.

11

TDD: Red → Green → Refactor

Let tests drive design
Practical

TDD cycle: اكتب test تفشل (Red)، اكتب أقل كود يجعلها تمر (Green)، ثم refactor مع بقاء tests خضراء. الهدف feedback سريع وتصميم behavior-driven، وليس كتابة tests قبل كل سطر بلا تفكير. ابدأ بسلوك صغير قابل للملاحظة، ثم أضف edge case.

لو test صعبة جدًا، اسأل هل dependency boundaries واضحة؟ هل class مسؤولياتها كثيرة؟ هل domain rule مختلطة بـ IO؟ TDD قد يكشف design friction مبكرًا. لكن لا تجعل testability وحدها تفرض interfaces لكل شيء؛ استخدمها كإشارة ووازنها مع بساطة التصميم.

12

Code Coverage و Mutation Testing

Coverage is a map, not proof
Deep dive

Line/branch coverage توضح أي كود تم تنفيذه أثناء tests، لكنها لا تثبت أن assertions صحيحة. 100% coverage ممكن مع tests ضعيفة لا تكشف bug. ركز على risk-based coverage: money, permissions, concurrency, retries, data integrity، والـ edge cases.

Mutation testing يغير الكود عمدًا (مثل > إلى >= أو حذف شرط) ثم يرى هل tests تفشل. لو mutation عاشت، قد تكون test assertions غير كافية. Stryker.NET أداة mutation testing لـ ‎.NET، لكنها قد تكون مكلفة زمنيًا؛ استخدمها على critical projects/modules أو في scheduled pipeline.

Mutation Testing و Contract Tests بالتفصيل

Mutation tool تغيّر operators/conditions أو تحذف statements. Surviving mutant يعني إما behavior غير مهم أو tests لم تلتقط الفرق. راجع mutant يدويًا؛ بعض mutations equivalent ولا يمكن تمييزها. لا تجعل mutation score KPI وحيدًا. استخدمه على domain logic critical مثل discounts/authorization/financial calculations.

Contract tests مهمة عند API consumers/providers. عرّف schema/semantics: required fields، nullable behavior، status codes، error codes، idempotency، pagination. Consumer-driven contract يوضح ما يعتمد عليه consumer، لكن provider verification يجب أن يعمل في CI قبل deploy. OpenAPI diff checks تكشف breaking changes لكنها لا تثبت semantic compatibility وحدها.

Property-Based و Boundary Testing

بجانب example-based tests، اختبر properties مثل: مجموع allocations لا يتجاوز amount، pagination لا تكرر IDs عند stable ordering، normalization idempotent، discount بين صفر و subtotal، و serialization round-trip يحافظ على القيمة. Property-based tools تولد inputs كثيرة وتساعد على اكتشاف edge cases، لكن يجب أن تكون property نفسها صحيحة ومحددة.

اختبر boundaries: empty/null، الحد الأدنى والأقصى، overflow، duplicate requests، concurrent updates، cancellation، timeout، malformed payload، clock boundary، timezone/DST، و unexpected provider response. لا تختبر happy path فقط. لكل bug production أضف regression test يحاكي السبب لا العرض فقط.

13

Contract و Snapshot Testing

Verify boundaries and serialized output
Practical

Contract testing يتحقق من اتفاق consumer/provider: route، schema، status codes، required fields، error semantics. مفيد مع microservices و external integrations حتى لا يكسر provider consumer بصمت. Snapshot testing يقارن output كبيرًا ب baseline، لكنه يحتاج review واعي؛ لا تقبل تحديث snapshot تلقائيًا من غير فهم سبب التغيير.

اختبر serialization contracts و OpenAPI schema و webhook payloads. لا تجعل snapshot يتضمن timestamps/random IDs غير مستقرة؛ استخدم deterministic values أو normalization. Contract tests لا تغني عن end-to-end smoke tests في deployment.

14

Testing AI Features with Golden Datasets

Evaluate probabilistic behavior
Deep dive

LLM output probabilistic وقد يتغير مع model/provider/prompt version. Unit test لا ينبغي أن تتوقع نصًا حرفيًا كاملًا من model call حي. افصل deterministic orchestration عن model integration: اختبر prompt construction/tool authorization/schema validation باستخدام fake model responses، ثم استخدم evaluation suite على golden dataset لقياس behavior الحقيقي.

Golden dataset تحتوي inputs و expected criteria/rubrics/reference answers/citations. قِس correctness، groundedness، citation precision/recall، refusal behavior، latency، cost، PII leakage، tool misuse و prompt-injection resistance. ضع thresholds و human review للحالات الحساسة. سجل model/version/prompt/retrieval config لكل run حتى تفسر regression.

لا تجعل exact-string snapshot هو المقياس الوحيد. استخدم structured assertions و semantic rubric/LLM-as-judge بحذر مع calibration ومراجعة بشرية؛ judge model نفسه قد يخطئ أو يتحيز. قيّم RAG retrieval منفصلًا عن answer generation.

15

Test Pyramid و Maintainable Test Suite

Balance speed and confidence
Deep dive

Test Pyramid heuristic: عدد كبير من unit tests سريعة، عدد أقل من integration tests، وعدد صغير من end-to-end tests. مش قانون أرقام؛ الهدف feedback سريع وتغطية boundaries الحقيقية. لو عندك آلاف unit tests وولا integration test على SQL queries، عندك blind spot. ولو كل شيء E2E، suite هتبقى بطيئة وهشة.

حافظ على test suite: إزالة duplication، helper names واضحة، عدم مشاركة state، failures actionable، وقت تنفيذ مراقب، flaky tests تعامل كـ defect. لا تعمل retry للـ flaky test لإخفاء السبب؛ شخّص race/time/network dependency.

CI Test Pipeline و Test Data Strategy

Pipeline مقترح: format/analyzers → build → fast unit tests → architecture tests → integration tests → contract tests → security/dependency scans → package/image → smoke tests after deployment. لا تشغل full E2E suite لكل local edit لو بطيئة؛ لكن critical tests لازم تكون gate قبل release. افصل flaky quarantine مؤقتًا مع owner/deadline، ولا تعتبرها green.

Test data strategy: synthetic data أفضل من production PII. لو تحتاج production-like distribution للأداء، استخدم anonymized/synthetic datasets. لا تنسخ user passwords/tokens أو payment data إلى CI. كل test artifact/log له retention/access policy.

16

اختبر فهمك

Knowledge check
Practical
هل 100% line coverage تعني عدم وجود bugs؟
لا؛ coverage لا تثبت صحة assertions أو اكتمال الحالات. Mutation/risk-based testing يساعدان على تقييم الجودة.
لماذا EF Core InMemory لا يكفي لاختبار SQL Server queries؟
لأنه لا ينفذ relational SQL semantics ولا يطابق constraints/transactions/provider translation.
متى تستخدم Mock ومتى Fake؟
Mock للتحقق من interaction مهم عند boundary؛ Fake implementation مبسطة تعمل فعليًا. لا mock لكل dependency.
ما فائدة Testcontainers؟
تشغيل dependency حقيقية معزولة أثناء tests، مثل SQL Server أو Redis، لاختبار integration behavior.
كيف تختبر LLM feature من غير توقع exact text؟
اختبر deterministic orchestration بفakes، واستخدم golden datasets و rubrics/metrics للـ model behavior الفعلي.
↗

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

References & further reading

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

مصادر تعليمية ومتقدمة — Third-party & advanced reading

خريطة التغطية: 31 عنصر من الـ Roadmap ومكان شرحه في الدرس
RoadmapTest Cases§01
RoadmapArrange-Act-Assert§02
RoadmapAssertions§02
RoadmapTest Naming§02
RoadmapTest Isolation§04
RoadmapFixtures§04
RoadmapTest Data§03
RoadmapParameterized Tests§04
RoadmapMocks and Stubs§04
RoadmapDependency Injection and Testability§04
RoadmapBusiness Logic Testing§04
RoadmapValidation Testing§04
RoadmapError Handling Tests§03
RoadmapEdge Cases§03
RoadmapCode Coverage§01
RoadmapIntegration Tests vs Unit Tests§01
RoadmapTest Doubles§04
RoadmapAsynchronous Tests§04
RoadmapWhen Not to Mock§04
RoadmapMaintainable Test Suites§04
SuggestedxUnit (and NUnit awareness)§04
SuggestedNSubstitute / Moq§05
SuggestedShouldly / AwesomeAssertions§16
SuggestedTestcontainers§09
SuggestedRespawn for DB reset§10
SuggestedTDD red-green-refactor§11
SuggestedSnapshot testing (Verify)§12
SuggestedTest pyramid§01
SuggestedContract testing (awareness)§13
SuggestedMutation testing (Stryker.NET)§12
SuggestedTesting AI features with golden datasets§14

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

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