DomainCore 1.14.0

DomainCore

Domain primitives, base entities, aggregate roots, and domain events for building Domain-Driven Design applications with .NET.

📦 Installation

dotnet add package DomainCore

🚀 Features

• Base Entities: BaseEntity with Id, ExternalId, and audit fields
• Tenant Entities: BaseTenantEntity for multi-tenant applications
• Aggregate Roots: IAggregateRoot marker interface
• Domain Events: DomainEventBase and HasDomainEventsBase for event-driven design
• Value Objects: Base classes for implementing value objects
• Audit Fields: Built-in CreatedAt, CreatedBy, UpdatedAt, UpdatedBy tracking

📖 Usage

Basic Entity

using DomainCore.Entities;

public class Product : BaseEntity
{
    public string Name { get; set; }
    public decimal Price { get; set; }

    public Product(string name, decimal price, Guid userId)
    {
        Name = name;
        Price = price;
        SetUser(userId);
    }
}

Multi-Tenant Entity

using DomainCore.Entities;

public class Order : BaseTenantEntity
{
    public Guid ProductId { get; set; }
    public int Quantity { get; set; }
    public decimal TotalPrice { get; set; }

    public Order(Guid productId, int quantity, decimal totalPrice, Guid tenantId, Guid userId)
    {
        ProductId = productId;
        Quantity = quantity;
        TotalPrice = totalPrice;
        SetTenant(tenantId);
        SetUser(userId);
    }
}

Domain Events

using DomainCore.Events;

public class OrderPlacedEvent : DomainEventBase
{
    public Guid OrderId { get; }
    public decimal TotalAmount { get; }

    public OrderPlacedEvent(Guid orderId, decimal totalAmount)
    {
        OrderId = orderId;
        TotalAmount = totalAmount;
    }
}

public class Order : BaseTenantEntity
{
    public void Place()
    {
        // Business logic...
        IsPlaced = true;
        UpdateTimestamp();

        // Raise domain event
        RegisterDomainEvent(new OrderPlacedEvent(ExternalId, TotalPrice));
    }
}

🏗️ Base Classes

BaseEntity

Provides common entity properties:

• Guid Id - Internal database ID
• Guid ExternalId - Public-facing UUID
• DateTime CreatedAt - Creation timestamp
• Guid? CreatedBy - User who created the entity
• DateTime? UpdatedAt - Last update timestamp
• Guid? UpdatedBy - User who last updated the entity

BaseTenantEntity

Extends BaseEntity with multi-tenancy:

• Guid TenantId - Tenant identifier for data isolation
• void SetTenant(Guid tenantId) - Set the tenant ID

HasDomainEventsBase

For entities that raise domain events:

• List<DomainEventBase> DomainEvents - Collection of events
• void RegisterDomainEvent(DomainEventBase domainEvent) - Add event
• void ClearDomainEvents() - Clear all events

🤝 Contributing

Contributions are welcome! Please open an issue or submit a pull request.

📝 License

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

🔗 Related Packages

• Security.Claims - Security claims and roles
• MultiTenancy.EntityFrameworkCore - Multi-tenant EF Core support
• Identity.Abstractions - Authentication abstractions

💬 Support

• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions

How to Publish

cd C:\desktopContents\projects\SaaS\NuGetPackages\DomainCore
.\publish.ps1 -ApiKey XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -Bump patch  # Bug fixes
.\publish.ps1 -ApiKey XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -Bump minor  # New features
.\publish.ps1 -ApiKey XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -Bump major  # Breaking changes