NPv.Domain.Core 3.0.0

NPv.Domain.Core

Lightweight and reusable building blocks for modeling domain entities in .NET

📌 Breaking changes

v2.0.0

• Target framework updated to net10.0 (dropped net9.0 support).

This is a personal library that focuses on the latest .NET runtime to keep maintenance simple and enjoyable.

✨ Overview

NPv.Domain.Core provides a minimal and consistent base for defining domain entities across services and layers.
It supports clean modeling practices without introducing infrastructure or persistence concerns.

Designed for use in domain-driven applications following clean architecture, this library ensures your domain models stay framework-agnostic and clear.

🚀 Features

• ✅ Base Entity class (with Guid identity)
• 🔖 IEntity interface for generic modeling
• 🏷 Optional [LongText] attribute for marking large text fields
• 🔌 Compatible with EF Core and repository abstractions (e.g., IGenericRepository)
• 🧼 No dependencies on infrastructure or frameworks
• 📛 OperationException - a standardized base entity for logging failed operations or events to persistent storage.

🔧 Usage

Define your entity class:

public class Customer : Entity
{
    public string Name { get; set; } = default!;
}

Use the [LongText] attribute to mark a string property as nvarchar(max):

[LongText]
public string Description { get; set; } = null!;

🧩 EF Core Integration

To apply domain-related conventions automatically in Entity Framework Core, consider using NPv.DataAccess.Ef, which includes:

• DefaultString256MaxLengthMapping — applies default string length mapping
• GuidV7ValueGenerator — for optimized sequential GUIDs

📦 Installation

This package is published as part of the NPv.Foundation.Net architectural set.

To install via NuGet:

dotnet add package NPv.Domain.Core

🧩 Related Packages

NPv.DataAccess.Abstractions – generic repository contracts

Author's Note

This library grew out of my long-standing personal interest in structuring and publishing open source packages. Over time, I’ve revisited and refined earlier internal utilities and ideas, giving them a more consistent shape and preparing them for wider reuse. Along the way, I’ve also taken the opportunity to explore how open source distribution and licensing work in the .NET ecosystem.

It’s a small step toward something I’ve always wanted to try — sharing practical, minimal tools that reflect years of learning, experimentation, and refinement.

Hopefully, someone finds it useful.

Nikolai 😛

⚖️ License

MIT — you are free to use this in commercial and open-source software.