Thiết Kế Hướng Miền (DDD) trong ASP.NET Core: Xây Dựng Hệ Thống Mạnh Mẽ, Dễ Bảo Trì (Lộ Trình .NET)

Hầu hết dự án tự nhận “áp dụng DDD” thực chất chỉ đổi tên thư mục thành Domain, Application, Infrastructure. Đó là Clean Architecture. DDD bắt đầu ở chỗ khác: bạn và chuyên gia nghiệp vụ dùng cùng một bộ từ, và bộ từ đó xuất hiện nguyên văn trong code. Không có ngôn ngữ chung thì aggregate chỉ là một bảng có thêm vài phương thức, còn domain event chỉ là log viết bằng class.

Cập nhật 2026

  • .NET 10 LTS (10.0.14) với EF Core 10 LTS là nền của bài; .NET 8 và .NET 9 hết hỗ trợ ngày 2026-11-10.
  • EF Core 10 map value object bằng owned type hoặc complex type, và cột JSON native trên SQL Server 2025 cho phép ToJson() khi bạn thật sự cần một cột thay vì nhiều cột.
  • MediatR 14.3.0 là dependency thương mại, nên domain event trong bài tự dispatch sau SaveChanges — domain không phụ thuộc thư viện ngoài.

Ubiquitous language: đặt tên bằng từ của người nghiệp vụ

Nếu kế toán nói “phiếu xuất kho”, class là StockIssue, không phải InventoryTransaction. Nếu họ nói “đơn hàng nháp”, trạng thái là Draft, không phải Status1. Quy tắc kiểm tra rất rẻ: đưa một entity cho PO xem, và yêu cầu anh ta đọc tên class cùng tên method mà không cần dev giải thích. Chỗ nào phải giải thích, chỗ đó bạn đang dịch sai.

Cách duy trì: một file docs/glossary.md trong repo, mỗi khái niệm một dòng gồm từ nghiệp vụ, nghĩa, và tên tương ứng trong code. Review file này khi có yêu cầu mới. Nó rẻ hơn nhiều so với đổi tên lớp sau sáu tháng, khi bảng đã có dữ liệu và dashboard đã trỏ vào cột cũ.

Một cảnh báo: đừng dịch máy móc. Cùng một từ tiếng Việt có thể là hai khái niệm khác nhau ở hai phần của hệ thống — đó là lý do bounded context tồn tại.

Bounded context: cùng một từ, hai mô hình

Trong một sàn thương mại điện tử, “Product” ở context Catalog có tên, mô tả, ảnh, danh mục. Ở context Inventory, “Product” là SKU, số lượng khả dụng, vị trí kệ. Gộp hai cái vào một class 30 thuộc tính là cách nhanh nhất để có một mô hình không ai hiểu và không ai dám sửa.

Bounded context là ranh giới mà bên trong nó một mô hình và một ngôn ngữ được áp dụng nhất quán. Trong code, nó là một project hoặc một module với namespace riêng, và quan trọng hơn: hai context không chia sẻ entity class. Chia sẻ nghĩa là bạn có một lớp phục vụ hai mục đích, và mọi thay đổi ở một bên sẽ kéo theo bên kia.

Giữa các context, tích hợp qua hợp đồng rõ ràng — message, API, hoặc anti-corruption layer. Context map ghi lại ai là upstream, ai là downstream, shared kernel nằm ở đâu. Bốn đường là đủ cho hầu hết hệ thống; đừng vẽ sơ đồ 40 hộp rồi không ai cập nhật.

Entity và Value Object

Tiêu chí Entity Value Object
Danh tính Có Id, tồn tại theo thời gian Không có Id, xác định bằng giá trị
So sánh Theo Id Theo toàn bộ thuộc tính
Vòng đời Trạng thái đổi qua hành vi Bất biến, thay bằng giá trị mới
Ví dụ Order, Customer Money, Address, Sku

Value object là nơi validation rẻ nhất. Nếu Money không thể tồn tại với số âm, thì không method nào phải kiểm tra số âm nữa. Invariant sống trong constructor, một lần, thay vì rải ở mọi nơi gọi tới.

// File: src/Shop.Domain/Money.cs
public sealed record Money
{
    public decimal Amount { get; }
    public string Currency { get; }

    public Money(decimal amount, string currency)
    {
        if (currency is not ("VND" or "USD"))
            throw new DomainException($"Đơn vị tiền tệ không hỗ trợ: {currency}");
        Amount = decimal.Round(amount, 2);
        Currency = currency;
    }

    public static Money Vnd(decimal amount) => new(amount, "VND");

    public Money Add(Money other) => Currency != other.Currency
        ? throw new DomainException("Không cộng được hai đơn vị tiền tệ khác nhau.")
        : new Money(Amount + other.Amount, Currency);
}

record cho bạn equality theo giá trị miễn phí; constructor giữ invariant. Cẩn thận với decimal.Round: mặc định là banker’s rounding, nên hãy chọn rõ ràng và ghi comment, đừng để người sau đoán ý bạn.

Aggregate và invariant

Aggregate là ranh giới nhất quán: mọi thứ bên trong phải đúng cùng một lúc. Nếu một quy tắc cần hai aggregate cùng đúng, quy tắc đó không thuộc aggregate nào — nó là domain service hoặc saga, và bạn phải chấp nhận nhất quán eventual giữa hai lần ghi.

Quy tắc thực hành: aggregate tham chiếu aggregate khác bằng Id, không bằng object reference. Một lần load một aggregate, một transaction ghi một aggregate. Nghe khắt khe, nhưng đây là thứ giữ cho hệ thống không tự khóa mình khi lưu lượng tăng.

// File: src/Shop.Domain/Orders/Order.cs
public sealed class Order : IHasDomainEvents
{
    private readonly List<OrderLine> _lines = [];
    private readonly List<IDomainEvent> _domainEvents = [];

    private Order() { } // EF Core

    public Guid Id { get; private set; }
    public Guid CustomerId { get; private set; }
    public OrderStatus Status { get; private set; }
    public IReadOnlyList<OrderLine> Lines => _lines;
    public Money Total => _lines.Aggregate(Money.Vnd(0), (sum, line) => sum.Add(line.LineTotal));

    public static Order Create(Guid customerId) => new()
    {
        Id = Guid.CreateVersion7(),
        CustomerId = customerId,
        Status = OrderStatus.Draft
    };

    public void AddLine(string sku, Money unitPrice, int quantity)
    {
        if (Status != OrderStatus.Draft)
            throw new DomainException("Chỉ sửa được đơn ở trạng thái Draft.");

        var existing = _lines.FirstOrDefault(l => l.Sku == sku);
        if (existing is null) _lines.Add(new OrderLine(sku, unitPrice, quantity));
        else existing.Increase(quantity);
    }

    public void Submit(DateTimeOffset at)
    {
        if (_lines.Count == 0)
            throw new DomainException("Đơn hàng phải có ít nhất một dòng.");

        Status = OrderStatus.Submitted;
        _domainEvents.Add(new OrderSubmitted(Id, CustomerId, Total, at));
    }

    public IReadOnlyList<IDomainEvent> PopDomainEvents()
    {
        var events = _domainEvents.ToList();
        _domainEvents.Clear();
        return events;
    }
}

Điểm quan trọng: Submit kiểm tra invariant và phát domain event trong cùng một method. Không có setter công khai, nên trạng thái chỉ đổi qua hành vi có tên nghiệp vụ. Đây là khác biệt lớn nhất giữa DDD và CRUD: chi phí sửa một trạng thái là phải đặt tên cho hành động sửa nó.

Domain events: thông báo cái đã xảy ra

Domain event là sự thật đã xảy ra trong miền: OrderSubmitted, PaymentCaptured. Nó không phải lệnh “gửi email”, nó là mô tả. Người nghe quyết định làm gì, và bạn thêm người nghe mà không sửa aggregate.

Thu thập event trong aggregate, dispatch sau khi commit:

// File: src/Shop.Infrastructure/Persistence/ShopDbContext.cs
public sealed class ShopDbContext(DbContextOptions<ShopDbContext> options, IDomainEventDispatcher dispatcher)
    : DbContext(options)
{
    public DbSet<Order> Orders => Set<Order>();

    public override async Task<int> SaveChangesAsync(CancellationToken ct = default)
    {
        var events = ChangeTracker.Entries<Order>()
            .SelectMany(e => e.Entity.PopDomainEvents())
            .ToList();

        var affected = await base.SaveChangesAsync(ct);

        foreach (var domainEvent in events)
            await dispatcher.DispatchAsync(domainEvent, ct);

        return affected;
    }
}

Hai cảnh báo. Thứ nhất, dispatch sau SaveChanges vẫn nằm trong transaction bao ngoài nếu bạn dùng transaction của EF Core — handler chạy trước khi commit thật. Thứ hai, handler trong process là best-effort: app crash ngay sau commit là event mất, không ai biết. Với side effect quan trọng, ghi event vào outbox trong cùng transaction rồi một worker đọc outbox và publish. Message broker chỉ nhận event sau khi dữ liệu đã bền vững.

Repository: một aggregate, một cửa vào

Repository không phải lớp DAO. Nó là tập hợp các aggregate root: Add, GetById, và vài method truy vấn có tên nghiệp vụ. Không generic repository, không GetAll() trả về mọi thứ, không IQueryable ra ngoài — mỗi thứ đó biến repository thành DbContext đổi tên.

Với màn hình đọc, đừng nhồi truy vấn vào repository. Query handler đọc thẳng bằng projection hoặc Dapper; repository chỉ phục vụ luồng ghi cần invariant. Trộn hai nhu cầu này là cách nhanh nhất để có một interface 20 method, trong đó 15 method chỉ dùng ở một trang admin.

Map value object với EF Core 10

Có hai lựa chọn. Owned type là entity type phụ thuộc, có identity ẩn và có thể map sang bảng riêng. Complex type không có identity, map thành cột phẳng trong bảng cha và không track riêng. Với value object một thuộc tính như Money đơn vị tiền, value converter là cách gọn nhất:

// File: src/Shop.Infrastructure/Persistence/OrderConfiguration.cs
builder.Property(o => o.Total)
    .HasConversion(money => money.Amount, amount => Money.Vnd(amount))
    .HasPrecision(18, 2);

Converter đánh đổi khả năng truy vấn lấy sự đơn giản: bạn chỉ còn một cột số, nên không lọc được theo currency. Với value object nhiều thuộc tính như Address, dùng OwnsOne hoặc ComplexProperty để giữ từng cột; nhớ kiểm tra migration vì tên cột sinh theo convention, thường có prefix như ShippingAddress_Street. Nếu bạn cần một cột JSON duy nhất, EF Core 10 cho phép ToJson() trên SQL Server 2025, nhưng truy vấn trên JSON không dùng index quan hệ — chỉ chọn khi bạn thật sự đọc cả khối.

Anti-corruption layer

Khi tích hợp hệ thống cũ hoặc đối tác, mô hình của họ sẽ chui vào code của bạn nếu bạn map trực tiếp. Anti-corruption layer là lớp dịch: DTO bên ngoài vào, khái niệm miền ra, và không có kiểu lạ nào vượt qua ranh giới.

// File: src/Shop.Infrastructure/Pricing/PricingAntiCorruptionLayer.cs
internal sealed class PricingAntiCorruptionLayer(HttpClient http) : IPricingPort
{
    public async Task<Money> GetPriceAsync(string sku, CancellationToken ct)
    {
        var dto = await http.GetFromJsonAsync<LegacyPriceDto>($"/prices/{sku}", ct)
            ?? throw new InvalidOperationException($"Không có giá cho {sku}.");

        // Dịch "cents" + "currency_code" của hệ cũ sang khái niệm của miền
        return new Money(dto.Cents / 100m, dto.CurrencyCode.ToUpperInvariant());
    }
}

internal sealed record LegacyPriceDto(long Cents, string CurrencyCode);

ACL là nơi duy nhất biết “cents” và “currency_code” là gì; domain chỉ thấy Money. Nếu một trường của hệ cũ không có nghĩa trong miền, đừng mang nó vào mô hình — mang vào bảng phụ nếu cần audit, hoặc bỏ.

Anemic domain model: dấu hiệu và cách sửa

Dấu hiệu: entity không có method nào, mọi logic nằm trong service hoặc handler; setter công khai cho mọi thuộc tính; validation rải rác ở DTO, ở controller và ở database constraint; không có domain event vì không ai đặt tên cho việc đã xảy ra.

Sửa theo thứ tự này, đừng làm ngược. Đóng setter trước, thêm factory method sau, rồi chuyển các điều kiện if thành method có tên nghiệp vụ, cuối cùng mới thêm domain event. Thêm event trước khi có hành vi chỉ tạo thêm một lớp trung gian không ai dùng.

Khi DDD là overkill

DDD giải quyết phức tạp trong miền, không giải quyết phức tạp kỹ thuật. Nếu nghiệp vụ đơn giản, mô hình sẽ là chi phí thuần túy. Bỏ qua tactical DDD khi:

  • Ứng dụng chủ yếu đọc/ghi bảng; số quy tắc ít hơn số màn hình.
  • Team không tiếp cận được chuyên gia nghiệp vụ — không có ubiquitous language thì DDD chỉ còn là ceremony.
  • Hệ thống sống ngắn, hoặc miền chưa ổn định và bạn biết sẽ đổi mô hình vài lần trong năm nay.
  • Bạn chưa có CI và test — invariant không được kiểm chứng chỉ là comment.

Nhưng strategic design thì nên áp dụng gần như mọi lúc: vẽ bounded context, viết glossary, đặt ranh giới module. Tactical pattern — aggregate, value object, domain event, repository — chỉ cần cho core domain, phần thường chiếm khoảng 20% code nhưng tạo ra phần lớn giá trị. Phần còn lại dùng CRUD đơn giản và đừng ép nó mặc áo DDD. DDD cũng không yêu cầu microservices; modular monolith với module rõ ràng là lựa chọn hợp lý hơn cho phần lớn team.

Checklist

  • Viết glossary trước khi viết class; review cùng PO mỗi sprint.
  • Mỗi aggregate một repository; tham chiếu aggregate khác bằng Id.
  • Invariant nằm trong entity, không nằm trong handler hay database trigger.
  • Domain event là sự thật đã xảy ra; side effect quan trọng đi qua outbox.
  • Map value object bằng converter, owned type hoặc complex type — chọn theo nhu cầu truy vấn, không theo sở thích.
  • Đo độ phức tạp của miền trước khi quyết định tactical DDD; CRUD không phải tội.

Hướng 2027: .NET 11 GA tháng 11/2026 là bản STS, .NET 12 LTS đến năm 2027; EF Core 11 tiếp tục mở rộng truy vấn JSON và vector. Không có gì trong đó thay đổi cách bạn đặt tên cho một aggregate. Việc AI-assisted scaffolding sinh ra entity nhanh hơn, nhưng ngôn ngữ chung với người nghiệp vụ vẫn là phần con người phải làm.

Đọc tiếp trong series