Architektura e-shopu, namodelovaná

Obchod je příklad, po kterém sáhne každý, a důvod, proč je většina diagramů obchodu zbytečná, je ten, že se snaží být jedním obrázkem. Slovník, hranice služeb a stroje jsou tři rozdílná témata a kresba, která je míchá, neodpoví ani na jedno - je to ten diagram s třídou Order, logem Kubernetes a frontou na jednom plátně.

Rozdělte podle otázky a každá se dá ověřit:

1. Jaká jsou podstatná jména? Diagram tříd domény. Čím je objednávka, z čeho se skládá, bez čeho nesmí existovat.
2. Kdo smí koho volat? Diagram komponent služeb a kontraktů mezi nimi.
3. Kde to běží? Diagram nasazení uzlů a artefaktů na nich.

Nic z toho není diagram front, sekvenční diagram ani výpis infrastruktury jako kódu, a je to záměrné. Ty existují a jsou užitečné; jsou také místem, kde dokumentační sada zemře, pokud první tři nejsou v pořádku.

Tohle je diagram, který usadí slovník, a slovník je místo, kde se obchody pokazí nejdřív. Je "košík" objednávka, která nebyla zadaná, nebo jiná věc? Drží OrderLine cenu v čase nákupu, nebo ji čte z Product? Druhá otázka je na obrázku zodpovězená - unitPrice žije na položce - a právě ten jediný atribut je rozdílem mezi obchodem, jehož staré faktury zůstanou po změně cen správné, a obchodem, jehož ne.

Obrázek v hlavičce tohohle článku. Dva klienti, jedna objednávková služba a dva kontrakty, na kterých závisí - sklad a platby. Čtěte ho zakrýváním boxů: zakryjte objednávkovou službu a zbude IOrders, IStock a IPayment, což je přesně ta specifikace, kterou by musela naplnit náhrada.

Adaptér je ten kus, který se vyplatí okopírovat. IPaymentje kontrakt, který vlastní obchod; realizuje ho adaptér Stripe. Nic v objednávkové službě nepojmenovává poskytovatele, takže "co by stál přechod na Adyen?" má odpověď, na kterou vidíte - jeden box a cokoli, co se ukáže, že adaptér propustil. Nakreslené naopak, s objednávkovou službou závislou přímo na komponentě Stripe, potřebuje tatáž otázka hledání v kódu.

Co záměrně chybí: košík, vyhledávací index, doporučovací engine, odesílač e-mailů. Každé z nich je skutečné a ani jedno nemění odpověď na otázku "kdo smí koho volat na cestě pokladny". Jdou na vlastní diagram, až na ně někdo bude mít otázku.

Tohle je diagram, který nikdo nekreslí až do prvního incidentu, a ten, který odpovídá na otázky, na které ty druhé dva neumí: co je dosažitelné z internetu, co mluví s databází a kde sedí hranice ke třetí straně. Stripe API je nakreslené jako externí uzel právě proto, že není vaše - ten box je připomínkou, že jeho dostupnost je závislostí, kterou neřídíte.

Je to zároveň jediný z těch tří, který zastará v obyčejné úterý. Doménový model přežije přechod na jinou platformu nedotčený a pohled na komponenty také; diagram nasazení zneplatní migrace clusteru. Ta asymetrie je dobrým důvodem držet ho odděleně místo zabalení "běží na Kubernetes" do boxů komponent.

Notace za prostředním diagramem, s pěti dalšími topologiemi, je v příkladech diagramů komponent. Na vytvoření prvního návrhu kteréhokoli z těch tří z popisu místo ručního kreslení koukněte na generování UML pomocí AI.