dotnet-domain-primitives

Overview

Prevent primitive obsession by enforcing strongly typed identifiers and value objects in domain models. Conversions to/from primitives are permitted only at explicit boundaries (persistence, transport, serialization), ensuring type safety and validation throughout the domain layer.

When to Use

• Designing or reviewing domain models (entities, aggregates, commands/events)
• Introducing new entity identifiers (CustomerId, OrderId, TenantId, etc.)
• Working with meaningful primitives that carry validation (EmailAddress, Money, Percentage)
• Reviewing code where primitive types (Guid, string, int) are used for domain concepts
• Implementing API boundaries, persistence layers, or serialization

Core Workflow