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

Three-Tier Architecture: Presentation وBusiness وData Access

Three-Tier Architecture — Practical Layering

شرح الثلاث طبقات ومسؤولياتها واتجاه الاعتماد والـ DTOs والvalidation والفروق بينها وبين N-Tier وClean Architecture.

  • Advanced
  • ~14 min read
  • 9 sections
  • 5 code examples
  • 2 diagrams
  • 7 questions
  • Priority L3 · Optional
  • .NET 10 · ASP.NET Core

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

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

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

STRONG BASICSUnderstand the differences; these terms are related but not interchangeable.

01

Three-Tier يعني إيه؟

Presentation, business logic and data access
Basics

Three-Tier Architecture تقسيم شائع إلى Presentation Layer و Business Logic Layer و Data Access Layer. Presentation تستقبل interaction (HTTP/UI)، Business Logic تنفذ use cases والقواعد، Data Access تتعامل مع storage. كلمة Tier أحيانًا تستخدم للدلالة على physical deployment tier، بينما Layer تعني logical separation داخل codebase؛ لا تخلط بين الاثنين.

PresentationHTTP / UI / DTOsBusiness LogicUse cases / rulesData AccessSQL / EF CoreKeep responsibilities separate; do not move business rules into controllers or SQL by accident
Logical three-tier flow

في simple ASP.NET Core app، Presentation قد تكون controllers/minimal endpoints، Business Logic services، Data Access repositories/DbContext. ممكن تكون كلها projects منفصلة أو folders داخل project واحد. التقسيم المنطقي أهم من عدد assemblies.

تتبع Request عبر الثلاث طبقات

تخيل POST /orders. Presentation تعمل model binding، تتحقق من DTO shape، وتقرأ authenticated user context. Business layer تتحقق من customer status، وتحول request إلى Order، وتطبق pricing/stock rules. Data Access تنفذ query/update عبر EF Core وتعيد result. Presentation تحول النتيجة إلى 201 Created أو Problem Details. كل طبقة تستقبل contract مناسبًا ولا تعرف تفاصيل الطبقة الداخلية.

C#Presentation DTO is not a database entity
public sealed record CreateOrderRequest(
    Guid CustomerId,
    IReadOnlyList<CreateOrderLineRequest> Items);
public sealed record CreateOrderLineRequest(Guid ProductId, int Quantity);
public sealed record OrderResponse(Guid Id, string Status, decimal Total);
C#Data access owns persistence details
public sealed class EfOrderStore(AppDbContext db) : IOrderStore
{
    public async Task AddAsync(Order order, CancellationToken ct)
    {
        await db.Orders.AddAsync(order, ct);
        await db.SaveChangesAsync(ct);
    }
}

في مثال production، قد يكون SaveChanges مسؤولية use case/Unit of Work وليس repository method؛ ده قرار transaction boundary. المثال هنا فقط يوضح أن Data Access يعرف EF Core بينما Presentation لا تعرف DbContext.

مثال عملي: Request من Controller إلى SQL والعودة

في Three-Tier، الـ Presentation تستقبل HTTP وتحوّل input إلى command/query، والـ Business Logic تنفذ قواعد الاستخدام، والـ Data Access تتعامل مع SQL. الفكرة فصل المسؤوليات، وليس بالضرورة نشر كل Tier على server مستقل. في تطبيق صغير قد تكون الثلاث طبقات مشاريع أو namespaces داخل process واحدة.

C#
 service -> repository">
[ApiController]
[Route("api/products")]
public sealed class ProductsController(IProductService service) : ControllerBase
{
    [HttpGet("{id:guid}")]
    public async Task<ActionResult<ProductResponse>> Get(
        Guid id, CancellationToken ct)
    {
        var product = await service.GetAsync(id, ct);
        return product is null ? NotFound() : Ok(product);
    }
}

public sealed class ProductService(IProductRepository repository)
    : IProductService
{
    public Task<ProductResponse?> GetAsync(Guid id, CancellationToken ct) =>
        repository.GetResponseAsync(id, ct);
}

المثال يفترض repository يعيد response projection؛ يمكن بدل ذلك أن يعيد domain entity ثم application service يحولها إلى DTO. المهم ألا يخرج EF entity إلى API مباشرة، لأن serialization قد يكشف أعمدة داخلية أو navigation cycles أو يربط API schema بقاعدة البيانات. استخدم async I/O و CancellationToken، ولا تضع SQL أو business rules داخل Controller.

تطبيق 3-Tier على ASP.NET Core Endpoint

C#Endpoint delegates to an application service
app.MapPost("/orders", async (CreateOrderRequest request,
    IOrderService service, CancellationToken ct) =>
{
    var result = await service.CreateAsync(request, ct);
    return Results.Created($"/orders/{result.Id}", result);
});

public sealed class OrderService(IOrderRepository repository)
{
    public async Task<OrderResponse> CreateAsync(CreateOrderRequest request, CancellationToken ct)
    {
        var order = Order.Create(request.CustomerId, request.Items);
        await repository.AddAsync(order, ct);
        return new OrderResponse(order.Id, order.Total);
    }
}

هذا مثال تعليمي مختصر؛ في التطبيق الفعلي يجب أن يحدد transaction ownership، validation، authorization، concurrency، و error mapping. الفكرة أن endpoint تتعامل مع HTTP، service تنسق use case، repository يتعامل مع persistence. لا تجعل المثال يتحول إلى قاعدة أن كل مشروع يحتاج service/repository لكل جدول.

02

مسؤوليات كل Layer

What belongs where?
Practical
  • Presentation: HTTP binding، authentication metadata، validation shape، status codes، response DTOs، OpenAPI. لا تضع حساب خصم أو workflow معقد هنا.
  • Business Logic: use cases، business rules، orchestration، transaction intent، decisions. لا تعتمد مباشرة على HTTP types أو UI concerns.
  • Data Access: EF Core/ADO.NET، SQL mapping، repository implementation، persistence-specific concerns. لا تجعلها المكان الوحيد الذي توجد فيه business rules.

مثال: endpoint يستقبل CreateOrderRequest، ينادي OrderService، الخدمة تتحقق من business rules وتحسب الإجمالي، repository يحفظ. لو endpoint بدأت تحسب total وتخصم stock وترسل email وتكتب SQL، الحدود ضاعت.

C#Thin endpoint + application service
app.MapPost("/orders", async (
    CreateOrderRequest request, OrderService service, CancellationToken ct) =>
{
    var id = await service.CreateAsync(request, ct);
    return Results.Created($"/orders/{id}", new { id });
});

public sealed class OrderService(IOrderRepository orders)
{
    public async Task<Guid> CreateAsync(CreateOrderRequest request, CancellationToken ct)
    {
        var order = Order.Create(request.CustomerId, request.Items);
        await orders.AddAsync(order, ct);
        return order.Id;
    }
}

Layer Leakage: أخطاء شائعة

  • Controller يحتوي business rules و SQL query.
  • Business service يرجع IActionResult أو HttpContext، فيعتمد على Presentation.
  • Repository يرجع EF entity إلى frontend contract مباشرة.
  • Data Access يقرر HTTP status code.
  • Presentation تتجاوز service وتستخدم DbContext مباشرة في بعض endpoints.
  • Business layer تنفذ SMTP/Redis concrete client داخل method.

هذه الأخطاء تجعل اختبار business logic صعبًا وتربط الطبقات ببعضها. راجع dependencies من منظور compile-time، وليس فقط folder names. لو كل project references بعضها في الاتجاهين، عندك circular dependency حتى لو أسماء layers تبدو صحيحة.

Service Layer: Application Service vs Domain Service

كلمة Service واسعة وقد تخفي مسؤوليات مختلفة. Application Service تنفذ use case وتنسق repositories/gateways/transactions. Domain Service تحتوي business operation لا تنتمي طبيعيًا إلى entity واحدة. Infrastructure Service تنفذ technical capability مثل email/storage. لا تجعل كل class اسمها SomethingService بلا تحديد؛ الاسم يجب يوضح capability.

مثال: CheckoutService ينسق load order، payment authorization، persistence. PricingPolicy تحسب business price. PdfRenderer implementation تقنية في Infrastructure. لو خلطت الثلاثة في class واحدة، تغيير tax policy أو PDF library أو payment provider يجبرك تعدل نفس المكان.

Layered Architecture Anti-Patterns

Pass-through service لا تفعل إلا return repository.Get() في كل method قد لا تضيف abstraction مفيدة. لكن لو الخدمة تمثل use case وتملك authorization أو orchestration أو transaction boundary، فهي ليست pass-through. Fat service تجمع كل business logic وتصبح god object. Anemic DTOs ليست مشكلة؛ أما domain entities التي لا تحمي أي invariant وتُعدل من أي مكان فقد تشير إلى domain model ضعيف في business domain معقد.

لا تجعل Data Access Layer تعرف API DTOs أو HTTP status codes. ولا تجعل Presentation تبني SQL أو تتصل بقاعدة البيانات. لا تستخدم static global repository أو service locator. تجنب circular dependencies بين الطبقات. لو كل طبقة تعتمد على كل الطبقات الأخرى، فالتقسيم شكلي. حافظ على اتجاه واحد ووثّق الاستثناءات.

03

Dependencies و DTOs و Validation

Prevent layer leakage
Practical

Presentation تعتمد على business/application API، والـ business تتعامل مع data abstraction أو data access حسب بساطة التطبيق. تجنب circular references. DTOs تمنع تسريب database entity schema إلى HTTP contract. Validation تقسم: shape/format عند boundary، business invariants داخل domain/service، integrity constraints في database.

لا ترجع EF entity مباشرة؛ ممكن تكشف navigation properties أو sensitive fields أو تسبب over-posting. استخدم explicit response projection. ولا تجعل Data Access ترجع HTTP-specific ProblemDetails؛ error mapping مسؤولية boundary layer.

DTOs و Validation و Over-posting

DTO يسمح لك تتحكم في الحقول التي يقبلها API. لو استقبلت Entity مباشرة، قد يستطيع caller إرسال IsAdmin أو IsPaid أو CreatedAt وتغيير fields لا ينبغي أن يتحكم فيها. DTO allow-list تقلل mass assignment. Response DTO تمنع تسريب password hash/internal navigation أو database schema.

Validation shape مثل required/length/range في Presentation boundary. Business validation مثل «لا يمكن cancel بعد shipment» في business/domain. Data integrity مثل unique email و FK في database. كل طبقة تحمي نوعًا مختلفًا من correctness؛ لا تكرر نفس regex في كل مكان بلا سبب.

Data Contracts بين الطبقات

عندك غالبًا ثلاثة أشكال بيانات مختلفة: API request/response DTOs، domain entities/value objects، persistence mapping/schema. مش لازم يكون عندك 3 نسخ لكل concept؛ لو الـ domain entity مناسبة للـ EF mapping يمكن استخدام نفس type داخل Domain/Infrastructure مع configuration منفصلة. لكن لا تجعل API contract يساوي DB schema تلقائيًا.

DTO يحمي من over-posting ويتيح API versioning. Domain model يحمي invariants. Persistence model قد يحتاج shadow properties/concurrency fields/index mapping. لو عندك legacy database، يمكن Infrastructure يترجم schema إلى domain. قرار duplication vs reuse يعتمد على change boundaries.

Transaction Boundary ومين يملك SaveChanges؟

لو عملية business تحدث Order و Inventory و PaymentRecord، حدد ما الذي يجب أن يكون atomic داخل نفس database. غالبًا use case/application layer تملك transaction boundary، repositories تضيف/تقرأ فقط، و Unit of Work ينفذ commit. لا تجعل كل repository تحفظ وحدها لو ذلك يكسر العملية المركبة.

لو workflow تشمل payment provider أو email، لا تبقي SQL transaction مفتوحة أثناء HTTP. استخدم state machine/hold/outbox/saga. Three-tier architecture لا تحل distributed transaction تلقائيًا؛ هي فقط تفصل المسؤوليات.

04

Three-Tier vs N-Tier vs Clean Architecture

Related but not interchangeable
Deep dive

N-Tier توسع التقسيم إلى طبقات أو خدمات إضافية مثل API gateway، application server، data services، integration layer. أحيانًا Tiers تشير إلى physical deployment منفصل، بينما Layers code organization. Three-Tier يصف تقسيم responsibility؛ Clean Architecture تركز على اتجاه dependencies واستقلال domain/application عن infrastructure. ممكن تطبيق Three-Tier مع dependencies عكسية أو مباشرة؛ Clean Architecture تفرض قاعدة اتجاه أكثر صرامة.

Three-Tier التقليدية قد تسمح Business Layer references Data Access مباشرة. Clean Architecture تضع interface في الداخل و implementation في الخارج. لا تساوي المصطلحين. اختَر structure بناءً على complexity/change boundaries.

Logical Layers vs Physical Tiers

ثلاث layers داخل ASP.NET Core process واحدة لا تعني ثلاثة servers. Physical tiers قد تكون browser، API service، database server، أو API gateway + services + database. N-tier يزيد network boundaries، فيضيف latency، retries، serialization، availability و security concerns. لا تفصل طبقة إلى server مستقل لمجرد أنها layer في code.

Three-Tier مناسبة عندما تحتاج وضوح responsibilities من غير تعقيد كبير. Clean Architecture تضيف Dependency Rule نحو الداخل. N-Tier deployment قرار infrastructure. يمكن أن يكون عندك Three logical layers في monolith واحد، أو Clean Architecture داخل كل microservice، أو N-tier physical deployment. المصطلحات تصف أبعادًا مختلفة.

Logical Layers مش معناها Physical Tiers

ثلاث طبقات منطقية قد تعمل داخل عملية واحدة: browser يرسل إلى API، والـ API يستدعي service، والـ service تستدعي repository داخل نفس process. أما Three-Tier physical deployment فقد يعني web server و application server و database server منفصلين. الفصل الفيزيائي يضيف network hops و authentication بين الخدمات و firewall و deployment complexity و failure modes.

لا تنقل Business Logic إلى service منفصلة لمجرد أن الرسم فيه ثلاث صناديق. افصل deployment عندما تحتاج scaling مستقل أو isolation أو team ownership أو security boundary واضحة. أما لو التطبيق صغير، Monolith منظم غالبًا أبسط في التشغيل والـ debugging والـ transactions.

Logical Tiers مقابل Physical Tiers و Transaction Flow

Layer تعني فصل مسؤولية داخل codebase؛ Tier تعني غالبًا process أو deployment boundary. يمكن أن يكون Presentation و Business و Data Access ثلاث projects داخل API process واحد، وهذا 3-layer logical architecture وليس ثلاثة servers. فصل كل layer إلى machine مستقلة يضيف network latency و authentication و deployment failure و distributed tracing؛ لا تفعل ذلك إلا لسبب scaling/security/ownership واضح.

في request flow، HTTP endpoint يربط input ويحوّله إلى command/query، application service تنفذ use case، domain model يحمي invariants، repository يتعامل مع persistence، ثم response mapper يحول النتيجة إلى HTTP contract. لا تجعل Business Layer ترجع IActionResult؛ هذا يربط business policy بـ ASP.NET Core. ولا تجعل Data Layer تقرر status code أو localization.

05

إمتى تستخدم Layered Architecture؟

Simple, maintainable boundaries
Practical

مناسبة لتطبيق business متوسط، فريق صغير/متوسط، CRUD مع قواعد واضحة، وحاجة لفصل UI عن persistence. تصبح مؤلمة لو layers مجرد pass-through methods بلا قيمة أو كل تغيير يتطلب تعديل كل الطبقات. لا تفرض interface لكل service أو repository لكل DbSet. أضف الحدود عندما تقلل coupling أو تحسن الاختبار.

اختبار ونشر تطبيق Three-Tier

Unit tests للـ business rules لا تحتاج database؛ استخدم pure domain objects أو fake ports. Integration tests للـ Data Access تستخدم DB provider حقيقيًا. API tests تتحقق من DTO binding/status/auth. End-to-end smoke test يتحقق من flow كامل. هذا التوزيع يعطي feedback سريعًا مع تغطية integration risks.

Physical deployment قد يكون process واحدة تضم API + business + data access libraries وتتصل بـ SQL Server منفصل. لا تحتاج deploy كل logical layer في container منفصل. لو فصلت business layer إلى service عبر network، أصبحت service boundary وتحتاج versioned contracts، retries/timeouts، authentication، observability و failure handling. لا تحول in-process method call إلى HTTP call بلا سبب.

اختبار الطبقات: Unit مقابل Integration

اختبر Business Service كـ unit test عندما تستطيع حقن repository fake أو mock وتختبر قواعد واضحة. اختبر Data Access بـ integration tests على قاعدة حقيقية أو container لأن LINQ translation و constraints و transactions لا تظهر في mock. واختبر API بـ WebApplicationFactory للتحقق من routing و serialization و validation و status codes. لا تستخدم mock لـ DbSet كأنه بديل مضمون لـ SQL.

اختبر أن Controller لا يحتوي business rule، وأن Service لا تعتمد على HttpContext، وأن Repository لا يرجع HTTP response. هذه boundaries قابلة للمراجعة في tests أو analyzers. لكن لا تجعل كل layer لها test project مستقل إذا كان ذلك يضيف maintenance أكثر من القيمة؛ المهم أن نوع الاختبار يطابق نوع المخاطرة.

مصفوفة التغيير والاختبار لكل Layer

Layerمسؤوليةاختبار مناسبخطر شائع
PresentationHTTP binding, auth boundary, serializationWebApplicationFactory / API testsBusiness rules داخل controller
ApplicationUse case orchestrationUnit tests مع ports fakesService locator و fat service
DomainInvariants و business decisionsPure unit testsEF/HTTP dependency
InfrastructureSQL, files, external SDKsIntegration/contract testsMocks لا تحاكي provider

الاختبار يجب يطابق الخطر: mock repository مفيد لعزل use case، لكنه لا يثبت أن SQL query تترجم أو transaction تعمل. API test يثبت routing/serialization/auth middleware لكنه لا يغني عن domain tests. لا تجعل عدد tests لكل layer هدفًا؛ اختبر behavior و failure boundaries.

06

من Three-Tier لـ Clean: refactoring تدريجي

Evolving a layered app
Practical

أغلب الشركات عندها تطبيق Three-Tier شغال. القرار مش «نعيد كتابته Clean Architecture»، القرار «إيه أصغر تغيير بيحل الألم الحالي؟». الألم المعتاد: business logic في الـ controllers، الـ services متربطة بـ EF مباشرة فالـ unit tests صعبة، وكل feature بتلمس 6 ملفات في 3 مشاريع.

Classic three-tierPresentationBusiness (BLL)Data (DAL + EF)Inverted (Clean/Onion/Hexagonal)APIInfrastructure (EF)Application + Domaindefines interfaceseverything points inward; EF implements the core's interfaces
Dependency direction: classic three-tier vs the inverted version
  1. اسحب الـ logic من الـ controllers للـ BLL (لو موجودة هناك). ده بيكسب أكتر من أي إعادة تنظيم.
  2. حدد الـ interfaces اللي الـ BLL محتاجها (IOrderReader، IClock، IEmailSender) وخليها في مشروع الـ BLL نفسه — ده قلب الاتجاه (DIP) من غير ما تغيّر عدد المشاريع.
  3. الـ DAL بيعمل implement للـ interfaces دي. دلوقتي الـ BLL ما بيعتمدش على EF، والـ unit tests بقت ممكنة.
  4. Features جديدة تتكتب بالشكل الجديد (vertical slice لو مناسب)، والقديم يتنقل لما يتلمس (Boy Scout) — مش migration شاملة.

التفاصيل والمقارنة الكاملة بين Clean و Onion و Hexagonal في Clean Architecture.

07

أخطاء شائعة وأسئلة إنترفيو

Mistakes and interview questions
Basics
  • «Pass-through» services: OrderService.Get(id) => repo.Get(id) لكل حاجة — طبقة بتكلّف من غير قيمة. لو مفيش logic، الـ query ممكن تبقى في الـ read side مباشرة.
  • Entities بترجع للـ UI: أي تغيير في الـ DB بيكسر الـ API، وبيكشف حقول حساسة.
  • Transaction بتتفتح في الـ DAL لكل method، فـ use case فيه 3 عمليات بيبقى 3 transactions — لازم يتحكم فيها الـ use case.
  • Logical layers متلخبطة مع physical tiers: 3 مشاريع في نفس الـ process مش «3-tier deployment».
(Junior) إيه الفرق بين layer و tier؟
Layer = تقسيم منطقي للكود حسب المسؤولية (presentation/business/data) ممكن كله يشتغل في process واحد. Tier = فصل فيزيائي على أجهزة/processes مختلفة (browser، app server، DB server) بيتكلموا عبر الشبكة، وده بيضيف latency و failure modes.
(Mid) الـ BLL محتاج يبعت email بعد الطلب. فين الكود؟
الـ BLL بيعرّف INotificationSender ويستدعيه (أو أحسن: يسجل domain event/outbox)، والتنفيذ (SMTP/SendGrid) في infrastructure. كده الـ BLL قابل للاختبار، والإرسال ممكن يبقى async وموثوق.
08

Knowledge check

Check your understanding
Basics

الـ Presentation layer بتستدعي الـ Data layer مباشرة عشان «أسرع». المشكلة الأساسية؟

09

اختبر فهمك

Knowledge check
Practical
هل Tier تعني دائمًا server منفصل؟
لا؛ قد تشير إلى logical layer أو physical deployment tier حسب السياق.
أين يتم HTTP status mapping؟
في Presentation/API boundary.
أين يجب حماية business invariant؟
في business/domain model، مع database constraints عند الحاجة.
هل Three-Tier هي نفسها Clean Architecture؟
لا؛ الأولى تقسيم مسؤوليات، والثانية تضبط dependency direction نحو الداخل.
↗

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

References & further reading

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

خريطة التغطية: 10 عنصر من الـ Roadmap ومكان شرحه في الدرس
RoadmapPresentation Layer§01
RoadmapBusiness Logic Layer§01
RoadmapData Access Layer§01
RoadmapLayer Responsibilities§01
RoadmapDependencies Between Layers§01
RoadmapDTOs§01
RoadmapValidation§01
RoadmapThree-Tier vs N-Tier Architecture§01
RoadmapThree-Tier vs Clean Architecture§01
RoadmapWhen to Use Layered Architecture§01

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

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