Foundation.Domain.Models 1.1.0

Foundation.Domain.Models

Core domain models and base entities for the Foundation framework, implementing Domain-Driven Design patterns.

📦 Package Contents

This package provides the foundational building blocks for domain-driven applications:

• Base Entities: BaseEntity with audit fields (Id, CreatedAt, UpdatedAt, DeletedAt)
• Domain Events: Event interfaces and base implementations for event-driven architecture
• Value Objects: Common value objects (Email, Money, Address, etc.)
• Specifications: Specification pattern implementation for complex queries
• Enumerations: Base enumeration class for type-safe enums
• Exceptions: Domain-specific exceptions

🚀 Installation

dotnet add package Foundation.Domain.Models

📖 Usage

Base Entity

All domain entities should inherit from BaseEntity:

public class Product : BaseEntity
{
    public string Name { get; private set; }
    public decimal Price { get; private set; }
    
    public Product(string name, decimal price)
    {
        Name = name;
        Price = price;
        
        RaiseDomainEvent(new ProductCreatedEvent(Id, name, price));
    }
}

Domain Events

Implement domain events for decoupled communication:

public record ProductCreatedEvent(Guid ProductId, string Name, decimal Price) : IDomainEvent
{
    public DateTime OccurredAt { get; } = DateTime.UtcNow;
}

Value Objects

Use value objects for domain concepts without identity:

public class Email : ValueObject
{
    public string Value { get; }
    
    public Email(string value)
    {
        if (!IsValid(value))
            throw new DomainException("Invalid email format");
            
        Value = value.ToLowerInvariant();
    }
    
    protected override IEnumerable<object> GetEqualityComponents()
    {
        yield return Value;
    }
}

Specifications

Build complex queries with the specification pattern:

public class ActiveProductsSpecification : Specification<Product>
{
    public override Expression<Func<Product, bool>> ToExpression()
    {
        return product => product.DeletedAt == null && product.IsActive;
    }
}

// Usage
var activeProducts = await repository.GetAsync(new ActiveProductsSpecification());

🏗️ Architecture

This package follows Clean Architecture principles:

• No external dependencies: Pure domain logic only
• Immutability: Value objects are immutable by design
• Encapsulation: Entities protect their invariants
• Event-driven: Domain events for loose coupling

📋 Requirements

• .NET 8.0 or higher
• C# 12.0 or higher

🤝 Contributing

This package is part of the Foundation framework. See the main repository for contribution guidelines.

📄 License

MIT License - see LICENSE file for details.