Předmluva

P.01 Pro koho je tato kniha#

Kniha předpokládá zkušenost s PHP a Symfony, objektově orientovaným programováním a základními designovými vzory. Nepředpokládá zkušenost s DDD. Pokud znáte Symfony Controller, Doctrine entitu, Dependency Injection a chápete rozdíl mezi interface a abstraktní třídou, máte vše potřebné.

Kniha je psaná pro pět typických rolí:

• Senior PHP developer, který v projektu narazil na limity klasické vrstvené architektury. OrderService má 1500 řádků, každá nová feature způsobí regresi jinde a onboarding nového kolegy trvá měsíce.
• Junior/mid Symfony developer, který si všiml, že větší projekty „rostou“ jinak než malé, a hledá strukturovanější přístup než jen Controller-Service-Repository.
• Architekt, který volí přístup k modelování doménové logiky: DDD, klasické CRUD, modulární monolit, nebo microservices.
• Tech lead, který musí svému týmu vysvětlit, proč a jak DDD zavést, a hledá argumenty pro management opřené o DORA metriky a obchodní hodnotu.
• Poslední je vývojář migrující z CRUD aplikace na DDD. V produkci má spaghetti kód a hledá inkrementální cestu ven.

Pro každou roli kniha nabízí jinou doporučenou cestu čtení; popisuje je P.03 Jak číst tuto knihu.

Co tato kniha není

• Ne úvod do PHP nebo Symfony. Pokud Symfony vidíte poprvé, projděte nejprve oficiální Symfony dokumentaci.
• Ne kuchařka „kopíruj-vlož“. Kód v knize ilustruje vzory v kontextu, ne hotová řešení pro váš konkrétní projekt. DDD vyžaduje úsudek nad doménou, ne mechanickou aplikaci šablon.
• Ne kompletní reference DDD. Pro hlubší teoretický základ čtěte Evanse (2003), Vernona (2013) a Khononova (2021). Odkazy na konkrétní pasáže najdete přímo v textu kapitol a v přehledu zdrojů.
• Ne záruka, že DDD u vedení prosadíte. Měřitelné argumenty kniha dodává, DORA metriky a komunikace s managementem mají vlastní sekci. Výsledek jednání ale závisí na kontextu organizace, ne na kvalitě argumentu.
• Ne referenční příručka Doctrine ani Messengeru. Obě komponenty text používá v rozsahu, který DDD vyžaduje. Detaily mapování, DQL nebo transportů hledejte v dokumentaci knihoven.

Předpoklady

Kniha předpokládá tyto výchozí znalosti:

• PHP 8.4+: atributy (#[Attribute]), enums, readonly properties, named arguments, match a asymetrická viditelnost (public private(set)). Na novějším PHP kód běží beze změny.
• Symfony 8+: Service Container, Dependency Injection, Doctrine ORM 3, Symfony Messenger, atributy #[Route], #[AsMessageHandler].
• Objektově orientované programování: dědičnost vs. kompozice, polymorfismus, zapouzdření, SOLID principy.
• Designové vzory: Repository, Factory, Strategy, Observer. Není nutné je znát formálně, ale měli byste je v kódu poznat.
• Relační databáze: ACID, transakce, indexy, JOIN, optimistický a pesimistický zámek.

Ke stacku ještě poznámka, která se hodí při zakládání projektu. Symfony vydává minor verze každých šest měsíců a udržuje je krátce; dlouhou podporu má vždy až poslední minor v major řadě. Je to volba mezi čerstvostí a klidem, ale pro tuhle knihu ji nemáte.

Aktuální LTS je v září 2026 Symfony 7.4 s PHP 8.2, a tam část ukázek neběží: asymetrická viditelnost public private(set) vyžaduje PHP 8.4 a Doctrine ORM 3 se chová jinak než dvojka. První LTS v řadě 8 se čeká až koncem roku 2027. Do té doby platí, že kdo chce jít podle knihy, jde po aktuální stabilní verzi a počítá s upgradem přibližně jednou za půl roku. Vzory samotné se mezi minor verzemi nemění; mění se API kolem nich.

Pokud některý z bodů „nesedí“, knihu i tak přečtete. Jen u některých kapitol budete potřebovat víc soustředění. Obtížnost nese v hlavičce každá kapitola. Nejvyšší stupeň má osm z nich, mimo jiné Návrh agregátu, Event Sourcing, Ságy, DDD a microservices a závěrečná případová studie.

P.02 Co kniha pokrývá#

Kniha se dělí do osmi tematických částí. Pořadí kapitol je promyšlené a každá staví na předchozích.

Strategie stojí před taktikou záměrně. Evans na QCon London 2009 shrnul, co by ve své knize udělal jinak: stavební bloky přecenil, zatímco hranice kontextů a Core Domain měly přijít mnohem dřív. Toto uspořádání z jeho revize vychází.

Část 1 – Strategický design (kap. 1–5)

Strategický design rozhoduje, kde DDD vůbec aplikovat. Pokrývá filozofii DDD, Ubiquitous Language, identifikaci subdomén (Core, Supporting, Generic), Bounded Contexts a Context Mapping. Doplňují ho dvě praktické techniky: Event Storming Alberta Brandoliniho a Team Topologies (Skelton & Pais, 2019), bez kterých strategický design nefunguje v reálné organizaci.

Zde se rozhoduje, jestli má smysl pokračovat. První signál dají kapitoly 1 a 2: jestli má váš projekt dost komplexní doménu a kde leží jeho Core. Úplný rámec s rozhodovacím stromem obsahuje kapitola Kdy DDD nepoužívat. Než kvůli signálu „ne“ odložíte zbytek knihy, ověřte ho právě tam.

Část 2 – Taktický design (kap. 6–9)

Taktický design pokrývá konkrétní stavební bloky doménového modelu: entity, hodnotové objekty, agregáty, repozitáře, doménové služby, doménové události. Slovník k nim zavádějí Základní koncepty. Středobodem taktické části je kapitola 7 o návrhu agregátu. Hranice agregátu je nejtěžší rozhodnutí v taktickém DDD a chyba zde stojí násobně víc než chyba v jednotlivé třídě.

Doplňující taktické vzory (Specification Pattern, Factory, Module) a srovnání architektonických stylů (Hexagonal, Onion, Clean Architecture) uzavírají taktickou část.

Část 3 – Implementace v Symfony (kap. 10–11)

Konkrétní mapování DDD do Symfony 8: adresářová struktura podle Bounded Contexts, vlastní Doctrine typy pro hodnotové objekty, Symfony Messenger jako Command/Query Bus, Dependency Injection a autowiring.

Kapitola 11 řeší autorizaci ve čtyřech vrstvách: Edge (firewall), Use Case (Voter), Aggregate (doménový invariant), Field (read model filtrace).

Část 4 – Pokročilé vzory (kap. 12–15)

CQRS (oddělení čtení a zápisu), Event Sourcing (stav jako sekvence událostí), Ságy a Process Managery (dlouho běžící procesy s kompenzací), Outbox Pattern (spolehlivé doručení doménových událostí).

Tyto vzory nejsou pro každý projekt. Kapitoly začínají rozhodovacím rámcem „kdy ano a kdy ne“.

Část 5 – Výkon a testování (kap. 16–17)

Výkonové aspekty (N+1 problém, lazy loading, read modely, snapshoty, hot aggregates) a testovací strategie (unit testy doménové vrstvy, integrační testy s Doctrine, architektonické testy s Deptrac).

Část 6 – Migrace a microservices (kap. 18–19)

Postupný přechod z CRUD architektury na DDD pomocí Strangler Fig Pattern. Vztah Bounded Context vs. microservice. Kdy 1:1 dává smysl, kdy modulární monolit poráží distribuované služby a jak rozeznat distributed monolith včas.

Část 7 – Provozní problémy a anti-vzory (kap. 20–22)

Tři kapitoly s odlišným úhlem na to, co se v DDD pokazí. Kapitola 20 pokrývá konkrétní provozní třenice s Doctrine, Messenger a Symfony Form. Kapitola 21 je katalog kódových anti-vzorů (anémický model, Primitive Obsession, God Aggregate, sdílená databáze). Kapitola 22 odpovídá na otázku, kdy DDD vůbec nepoužívat.

Část 8 – Praktické příklady (kap. 23–24)

Tři krátké příklady (e-shop, blog, správa uživatelů) jako shrnující průřez. Závěrečná případová studie popisuje implementaci systému pro správu projektů krok za krokem, od doménové analýzy přes architekturu, agregáty a CQRS až po read modely s reconciliation.

Pozn.: Mimo hlavní řadu kapitol existuje na webu ještě DDD a umělá inteligence. Kapitola shrnuje, co o vztahu DDD a AI říkají Eric Evans, Martin Fowler, Kent Beck a další. V tištěné a EPUB verzi knihy tato kapitola není, protože téma se v posledních letech intenzivně vyvíjí a aktualizace na webu jsou pružnější.

P.03 Jak číst tuto knihu#

Lineární čtení od první do poslední kapitoly funguje, ale málokdo ho potřebuje. Většina čtenářů má konkrétní bolest, kvůli které knihu otevřela. Pět doporučených cest podle role:

Pro junior/mid Symfony developera

Cíl: pochopit, co DDD je, a naučit se ho rozeznat v cizím kódu. Na implementaci si zatím netroufnete. Přijde až s druhým a třetím projektem. Doporučená cesta v pořadí čtení:

• Co je DDD – filozofie, základní pojmy, kdy DDD pomůže.
• Základní koncepty DDD – entity, hodnotové objekty, agregáty, repozitáře. Nejdůležitější mentální model celé knihy.
• Návrh agregátu – jak agregát udělat dobře. Nejtěžší kapitola taktického designu, ale stojí to za to.
• Implementace v Symfony – konkrétní kód, který můžete dnes použít.
• Testování DDD – jak ověřit, že to funguje.

Volitelně po měsíci praxe: CQRS a Anti-vzory.

Pro senior PHP developera

Rychlejší návratnost než čtení od první kapitoly má vstup podle problému, který vás sem přivedl.

• Služba na 1500 řádků bez jasných hranic: Návrh agregátu, pak Doplňující taktické vzory a Anti-vzory.
• Regrese napříč featurami po každém releasu: Subdomény a Bounded Context a Context Mapping, teprve pak taktika.
• Čtení a zápis se perou o stejný model: CQRS, volitelně Read modely, projekce a výkon.
• Události se ztrácejí mezi službami: Outbox Pattern a Ságy a Process Managery.
• Onboarding trvá měsíce: Základní koncepty jako společný slovník, pak Implementace v Symfony jako závazná struktura projektu.

Souvislé čtení od kapitoly 1 do 24 dává smysl, pokud DDD zavádíte poprvé na zelené louce. Průřez celou knihou v jednom příkladu nabízí Případová studie.

Pro architekta

Strategie a velký obraz. Méně kódu, víc rozhodnutí.

• Co je DDD – pro kontext.
• Subdomény: Core, Supporting, Generic – první strategický filtr.
• Bounded Context a Context Mapping – jak nakreslit mapu vztahů mezi kontexty.
• Conway's Law a Team Topologies – architektura kopíruje organizaci.
• Migrace z CRUD – Strangler Fig pro postupný přechod.
• DDD a microservices – fyzické hranice nasazení.
• Anti-vzory – jak se vyhnout klasickým chybám.
• Kdy DDD nepoužívat – věcný rozhodovací rámec.
• Případová studie – inspirace pro vlastní projekt.

Pro tech leada

Kombinace organizační optiky a praktických problémů. Cesta začíná u kapitoly Conway's Law a Team Topologies, tedy u otázky, jak týmovou strukturou ovlivnit architekturu. Navazuje Event Storming a Domain Storytelling s workshopem, který zavedete do týmu, a Migrace z CRUD s postupným přechodem bez zastavení vývoje. Realistická očekávání dodá DDD v praxi – kde to bolí. Zbývají dvě kapitoly: Anti-vzory jako přehled kódových signálů, které v code review hledat, a Kdy DDD nepoužívat pro chvíle, kdy je namístě říct ne.

Pro vývojáře migrujícího z CRUD

Konkrétní cesta, jak existující projekt postupně transformovat.

• Co je DDD – ujistit se, že vůbec dává smysl.
• Kdy DDD nepoužívat – věcná kontrola, jestli to není chyba.
• Subdomény – kde investovat modelovací úsilí.
• Základní koncepty – výchozí slovník.
• Návrh agregátu – nejdůležitější taktický vzor.
• Migrace z CRUD na DDD – Strangler Fig Pattern v Symfony.
• DDD v praxi – kde to bolí – realistická očekávání.

Po této sekvenci selektivně další kapitoly podle konkrétní bolesti, kterou v aplikaci pociťujete.

P.04 Konvence v knize#

Konvence v této sekci platí napříč všemi kapitolami.

Hlas a tón

Kniha používá vykání. Věty jsou krátké a každá říká jednu věc. Žádný marketingový jazyk – místo „mocný framework“ stojí v textu konkrétně, co Symfony Messenger umí a co ne. Žádné osobní komentáře autora, žádné nadsázky.

Styl kódu

Kód cílí na PHP 8.4 a Symfony 8 s Doctrine ORM 3. Které rysy jazyka příklady předpokládají, shrnuje sekce Předpoklady. Pokud váš projekt běží na starší verzi, princip zůstává platný, jen syntaxe je jiná.

Atributy Doctrine (#[ORM\Entity]) jsou na doménových třídách jako pragmatická výchozí volba. Striktní oddělení doménové vrstvy od ORM nabízí Persisted Object Pattern, tedy samostatná persistence třída plus mapper. Většina příkladů v knize používá první variantu, protože v reálných Symfony projektech je rozšířenější.

Ukázky navíc sdílejí jeden slovník, se kterým se poprvé potkáte v Základních konceptech:

• Agregáty dědí z bázové třídy AggregateRoot s metodami record() a releaseEvents().
• Doménové události nesou jména v minulém čase bez sufixu Event, tedy OrderPlaced, ne OrderPlacedEvent.
• Hodnotové objekty vystavují public readonly vlastnosti, čtou se jako $email->value.
• Identifikátory vznikají přes symfony/uid a Uuid::v7().
• Agregáty se odkazují jen přes ID. Celá instance jednoho agregátu se nikdy nepředává do metody jiného.
• Zprávy pro command bus nesou sufix Command (PlaceOrderCommand), jejich obsluha sufix Handler.
• Peníze a další sdílené hodnotové objekty žijí v App\SharedKernel\Domain, stejně jako AggregateRoot.

Průběžným příkladem je objednávka. Vzniká přes Order::place(), položky přijímá metodou addItem() a částky drží v hodnotovém objektu Money. Stejná trojice Order, Money, Email se objevuje napříč kapitolami, takže si při čtení nemusíte pamatovat novou doménu ke každému vzoru.

Každý PHP blok v knize prochází kontrolou php -l v CI. Ukázky jsou tedy syntakticky platné, ale zůstávají ilustrací vzoru v kontextu. Před nasazením je doladíte na vlastní doménu.

Prvky stránky

Hlavička kapitoly uvádí odhadovanou dobu čtení a obtížnost na škále 1 až 4. Text končí blokem častých otázek, někde následuje ještě sekce se zdroji a další četbou. Napříč knihou pak vedou dvě navigační stránky: Cheat Sheet a Glosář.

Callouty

Kniha používá čtyři typy callout boxů. Modrý note přidává kontext nebo odkaz na hlubší zdroj. Zelený pattern doporučuje vzor s konkrétním kódem, oranžový warn upozorňuje na riziko nebo častou chybu. Červený anti označuje anti-vzor, kterému je lépe se vyhnout.

Diagramy

Diagramy vznikají z PlantUML zdrojů a do textu se vkládají jako SVG. Pokud chcete diagram převzít, .puml zdroje najdete v repozitáři knihy.

Vnitřní odkazy

Vnitřní odkazy mezi kapitolami používají cesty (/co-je-ddd, /zakladni-koncepty), ne čísla kapitol. Přečíslování tak odkazy nezneplatní. Externí odkazy na knihy a články používají plný URL.

Citace

Knihy a referenční články cituje text přímo (např. „Vernon, Implementing DDD, kap. 8“), u řady kapitol pak souhrnně v závěrečné sekci s další četbou. Hlavní zdroje, na které kniha staví:

• Eric Evans, Domain-Driven Design: Tackling Complexity in the Heart of Software (Addison-Wesley, 2003).
• Vaughn Vernon, Implementing Domain-Driven Design (Addison-Wesley, 2013) a Domain-Driven Design Distilled (2016).
• Vlad Khononov, Learning Domain-Driven Design (O'Reilly, 2021).
• Sam Newman, Building Microservices, 2nd ed. (O'Reilly, 2021).
• Chris Richardson, Microservices Patterns (Manning, 2018).
• Matthew Skelton & Manuel Pais, Team Topologies (IT Revolution, 2019; druhé vydání 2025).
• Martin Fowler, Patterns of Enterprise Application Architecture (Addison-Wesley, 2002).

P.05 Co dál#

Pokud jste tu poprvé, otevřete kapitolu 1: Co je DDD. Po přečtení byste měli mít jasno, jestli má smysl pokračovat. Rozhodovací rámec pro opačný závěr nabízí kapitola Kdy DDD nepoužívat.

Pokud DDD už znáte a hledáte konkrétní téma, projděte si Cheat Sheet, jednostránkový přehled vzorů s odkazy na příslušné kapitoly. Pro definice termínů slouží Glosář.

Kniha je živý dokument. Aktuální verzi textu najdete vždy na ddd-v-symfony.katuscak.cz, kontakt pro opravy a připomínky je na stránce O autorovi.