CQRS

Administrátor e-shopu odešle ChangeOrderStatus s ID objednávky a cílovým stavem. ChangeOrderStatusHandler načte objednávku, ověří povolený přechod, oprávnění a další pravidla, provede změnu a uloží ji v databázové transakci. Command popisuje záměr; nemusí vracet celý aktualizovaný detail objednávky.

GetOrderDetailHandler naopak nic nemění. Jedním dotazem může načíst údaje o objednávce, zákazníkovi, platbě a dopravě přímo do OrderDetail DTO. V jednoduché variantě oba handlery používají tutéž databázi. Až když má čtení jiné nároky, může GetOrderDetail používat samostatnou projekci aktualizovanou asynchronně.

PHP

final readonly class ChangeOrderStatus
{
    public function __construct(
        public string $orderId,
        public OrderStatus $newStatus,
    ) {}
}

final class ChangeOrderStatusHandler
{
    public function __invoke(ChangeOrderStatus $command): void
    {
        $order = $this->orders->get($command->orderId);
        $order->changeStatusTo($command->newStatus);
        $this->orders->save($order);
    }
}

final readonly class GetOrderDetail
{
    public function __construct(public string $orderId) {}
}

final class GetOrderDetailHandler
{
    public function __invoke(GetOrderDetail $query): OrderDetail
    {
        return $this->orderDetails->find($query->orderId);
    }
}