👁 Image
Wangkanai.Domain 5.0.0

Wangkanai Domain

Domain: Breathtakingly Simple Domain-Driven Design for .NET

👁 .NET
👁 Quality Gate Status

👁 Open Collective
👁 Patreon
👁 GitHub

Welcome to the Wangkanai Domain repository - a comprehensive collection of domain-driven design patterns, auditing capabilities, and Entity Framework utilities for .NET applications.

📦 Packages

This repository produces three NuGet packages:

Wangkanai.Domain

👁 NuGet Version
👁 NuGet Pre Release

Core domain-driven design patterns and building blocks for .NET applications. Provides base classes, interfaces, and utilities for implementing clean domain models.

Features:

• Entity base classes with strongly-typed IDs
• Value objects with equality comparison
• Domain events and handlers
• Result patterns for error handling
• Audit trails and tracking

Wangkanai.Audit

👁 NuGet Version
👁 NuGet Pre Release

Comprehensive auditing capabilities for tracking changes and maintaining data history in your applications.

Features:

• Automatic change tracking
• User audit trails
• Configurable audit policies
• Integration with Entity Framework
• Audit data querying and reporting

Wangkanai.EntityFramework

👁 NuGet Version
👁 NuGet Pre Release

Entity Framework Core utilities and extensions to enhance database operations and development productivity.

Features:

• Database builder extensions
• Value generators for timestamps
• Convention-based configurations
• Migration utilities
• Performance optimizations

🚀 Quick Start

Installation

Install the packages you need via NuGet Package Manager:

# Core domain patterns
dotnet add package Wangkanai.Domain

# Auditing capabilities
dotnet add package Wangkanai.Audit

# Entity Framework utilities
dotnet add package Wangkanai.EntityFramework

Basic Usage

Domain Entities

using Wangkanai.Domain;

public class Customer : Entity<int>
{
 public string Name { get; private set; }
 public string Email { get; private set; }

 public Customer(string name, string email)
 {
 Name = name;
 Email = email;
 }
}

Auditing

using Wangkanai.Audit;
using Microsoft.EntityFrameworkCore;

public class ApplicationDbContext : AuditDbContext
{
 public DbSet<Customer> Customers { get; set; }

 protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
 {
 // Configure audit tracking
 optionsBuilder.EnableAuditing();
 }
}

Entity Framework Extensions

using Wangkanai.EntityFramework;

public void ConfigureServices(IServiceCollection services)
{
 services.AddDbContext<ApplicationDbContext>(options =>
 options.UseSqlServer(connectionString));
}

public void Configure(IApplicationBuilder app)
{
 // Ensure database exists
 app.CreateDatabase<ApplicationDbContext>();
}

🏗️ Architecture

This repository follows a clean architecture approach with the following structure:

src/
├── Domain/ # Core domain patterns and entities
├── Audit/ # Auditing and change tracking
└── EntityFramework/ # EF Core utilities and extensions

tests/
├── Domain/ # Domain module tests
├── Audit/ # Audit module tests
└── EntityFramework/ # EntityFramework module tests

benchmark/
├── Domain/ # Performance benchmarks
├── Audit/ # Audit performance tests
└── EntityFramework/ # EF utilities benchmarks

🧪 Testing

Run all tests with coverage:

dotnet test --collect:"XPlat Code Coverage"

Run benchmarks:

dotnet run --project benchmark/Domain --configuration Release
dotnet run --project benchmark/Audit --configuration Release
dotnet run --project benchmark/EntityFramework --configuration Release

🤝 Contributing

We welcome contributions! Please see our for details.

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Ensure all tests pass
6. Submit a pull request

📋 Requirements

• .NET 9.0 or later
• Entity Framework Core 9.0 or later (for EF-related packages)

📄 License

This project is licensed under the - see the LICENSE file for details.

💝 Support

If this project has helped you, please consider:

• ⭐ Starring the repository
• 🐛 Reporting bugs or requesting features
• 💰 Supporting via Open Collective
• 💰 Supporting via Patreon

📚 Documentation

For detailed documentation, examples, and API references, visit our Documentation.

Built with ❤️ by Sarin Na Wangkanai and the community.