AccountSubSystem.Aggregators 1.0.0

AccountSubSystem.Aggregators

Domain Aggregate Roots and business logic for the BDJobs Account SubSystem.

This package contains the core domain objects (Aggregate Roots) of the Account SubSystem. These classes own all business rules, validations, and state transitions related to accounts and users — following Clean Architecture and DDD (Domain-Driven Design) principles.

📦 Installation

.NET CLI

dotnet add package AccountSubSystem.Aggregators --version 1.0.0

Package Manager Console

NuGet\Install-Package AccountSubSystem.Aggregators -Version 1.0.0

PackageReference (add to your .csproj)

<PackageReference Include="AccountSubSystem.Aggregators" Version="1.0.0" />

📋 Requirements

📁 What's Inside

The Aggregators layer is the heart of the domain. Each Aggregate Root in this package:

• Holds the domain state (loaded from the database via Repositories)
• Applies business rules via methods like ApplyBusinessRules()
• Converts entities to response DTOs via ToResponseDto() / ToGroupedResponseDto()
• Is constructed from raw entities using FromEntities() static factory methods

🚀 Usage

Step 1 — Inject via Handler

Aggregate Roots are typically constructed inside your Handlers after loading data from the Repository:

using AccountSubSystem.Aggregators;

Step 2 — Load and apply business rules

// In your Handler:
var entities = await _repository.GetUsersByFilterAsync(query);

var aggregateRoot = UserAggregateRoot.FromEntities(entities);
aggregateRoot.ApplyBusinessRules();

var response = aggregateRoot.ToResponseDto();
return response;

Step 3 — Static factory pattern

Aggregate Roots use a static FromEntities() method to keep construction clean and testable:

var root = AccountAggregateRoot.FromEntities(rawUserList, requestDto);

🔗 Dependencies

AccountSubSystem.DTOs is installed automatically.

🏗️ Architecture

AccountSubSystem.Aggregators sits in the domain layer — above DTOs, below Handlers and Repositories.

AccountSubSystem.Handlers
    └── AccountSubSystem.Aggregators  ← YOU ARE HERE
    └── AccountSubSystem.Repositories
        └── AccountSubSystem.Aggregators  ← YOU ARE HERE

AccountSubSystem.Aggregators
    └── AccountSubSystem.DTOs

Data flow:

API Controller
    → Handler
        → Repository  (fetches raw data from DB)
        → AggregateRoot.FromEntities()  ← HERE
            → ApplyBusinessRules()
            → ToResponseDto()
        → returns DTO to Controller

👤 Author

BDJobs — Internal NuGet package for the BDJobs Conveyance Billing System.