Čo je to agregát?

Agregát v objektovo orientovanom návrhu (DDD) je klaster prepojených objektov, ktoré sú považované za jednotný celok z hľadiska integrity dát. Každý agregát má koreňový objekt-entitu (Aggregate Root), ktorý je jediným prístupovým bodom k ostatným objektom v rámci agregátu. Všetky zmeny vnútri agregátu by mali prebiehať cez koreňový objekt, aby sa zachovali invariants (pravidlá integrity).

Kľúčové vlastnosti:

• Koreňový objekt (Aggregate Root): Jediný prístupový bod ku komponentom agregátu.
• Zapúzdrenie: Vnútorné objekty agregátu by nemali byť priamo dostupné zvonku.
• Hranica zhody: Agregát definuje hranicu, vnútri ktorej sa udržiavajú invariants. Zmeny vnútri agregátu sú transakčne zosúladené.
• Izolácia: Nie je možné priamo komunikovať s objektmi iného agregátu, len cez ich koreňové objekty alebo cez doménové služby.

Príklad:

<?php

// Koreňový objekt agregátu "Objednávka"
class Order
{
    private OrderId $id;
    private CustomerId $customerId;
    /** @var OrderItem[] */
    private array $items = [];
    private OrderStatus $status;

    public function __construct(OrderId $id, CustomerId $customerId)
    {
        $this->id = $id;
        $this->customerId = $customerId;
        $this->status = OrderStatus::Pending;
    }

    public function addItem(ProductId $productId, int $quantity, Money $price): void
    {
        // Kontrola invariants, napr. množstvo > 0
        if ($quantity <= 0) {
            throw new InvalidArgumentException("Množstvo musí byť väčšie ako nula.");
        }

        $this->items[] = new OrderItem($productId, $quantity, $price);
    }

    public function confirm(): void
    {
        // Kontrola invariants pred zmenou stavu
        if ($this->status !== OrderStatus::Pending) {
            throw new DomainException("Objednávka už nie je v stave 'Čaká'.");
        }

        // Logika potvrdenia, napr. kontrola dostupnosti tovaru
        $this->status = OrderStatus::Confirmed;
    }

    public function getId(): OrderId
    {
        return $this->id;
    }

    public function getStatus(): OrderStatus
    {
        return $this->status;
    }

    /** @return OrderItem[] */
    public function getItems(): array
    {
        return $this->items;
    }
}

// Vnútorný objekt agregátu "Riadok objednávky"
class OrderItem
{
    private ProductId $productId;
    private int $quantity;
    private Money $price;

    public function __construct(ProductId $productId, int $quantity, Money $price)
    {
        $this->productId = $productId;
        $this->quantity = $quantity;
        $this->price = $price;
    }

    public function getProductId(): ProductId
    {
        return $this->productId;
    }

    public function getQuantity(): int
    {
        return $this->quantity;
    }

    public function getPrice(): Money
    {
        return $this->price;
    }
}

// Hodnotové objekty (napríklad)
final class OrderId {}
final class CustomerId {}
final class ProductId {}
final class Money {}
enum OrderStatus { case Pending; case Confirmed; case Cancelled; }