Architektúra e-shopu, namodelovaná

Obchod je príklad, po ktorom siahne každý, a dôvod, prečo je väčšina diagramov obchodu zbytočná, je ten, že sa snažia byť jedným obrázkom. Slovník, hranice služieb a stroje sú tri rozdielne témy a kresba, ktorá ich mieša, neodpovie ani na jednu - je to ten diagram s triedou Order, logom Kubernetes a frontou na jednom plátne.

Rozdeľte podľa otázky a každá sa dá overiť:

1. Aké sú podstatné mená? Diagram tried domény. Čím je objednávka, z čoho sa skladá, bez čoho nesmie existovať.
2. Kto smie koho volať? Diagram komponentov služieb a kontraktov medzi nimi.
3. Kde to beží? Diagram nasadenia uzlov a artefaktov na nich.

Nič z toho nie je diagram front, sekvenčný diagram ani výpis infraštruktúry ako kódu, a je to zámerné. Tie existujú a sú užitočné; sú tiež miestom, kde dokumentačná sada zomrie, ak prvé tri nie sú v poriadku.

Toto je diagram, ktorý usadí slovník, a slovník je miesto, kde sa obchody pokazia najskôr. Je "košík" objednávka, ktorá nebola zadaná, alebo iná vec? Drží OrderLine cenu v čase nákupu, alebo ju číta z Product? Druhá otázka je na obrázku zodpovedaná - unitPrice žije na položke - a práve ten jediný atribút je rozdielom medzi obchodom, ktorého staré faktúry zostanú po zmene cien správne, a obchodom, ktorého nie.

Obrázok v hlavičke tohto článku. Dvaja klienti, jedna objednávková služba a dva kontrakty, od ktorých závisí - sklad a platby. Čítajte ho zakrývaním boxov: zakryte objednávkovú službu a zostane IOrders, IStock a IPayment, čo je presne tá špecifikácia, ktorú by musela naplniť náhrada.

Adaptér je ten kus, ktorý sa oplatí okopírovať. IPaymentje kontrakt, ktorý vlastní obchod; realizuje ho adaptér Stripe. Nič v objednávkovej službe nepomenúva poskytovateľa, takže "čo by stál prechod na Adyen?" má odpoveď, na ktorú vidíte - jeden box a čokoľvek, čo sa ukáže, že adaptér prepustil. Nakreslené naopak, s objednávkovou službou závislou priamo od komponentu Stripe, potrebuje tá istá otázka hľadanie v kóde.

Čo zámerne chýba: košík, vyhľadávací index, odporúčací engine, odosielač e-mailov. Každé z nich je skutočné a ani jedno nemení odpoveď na otázku "kto smie koho volať na ceste pokladne". Idú na vlastný diagram, keď na ne niekto bude mať otázku.

Toto je diagram, ktorý nikto nekreslí až do prvého incidentu, a ten, ktorý odpovedá na otázky, na ktoré tie druhé dva nevedia: čo je dosiahnuteľné z internetu, čo hovorí s databázou a kde sedí hranica k tretej strane. Stripe API je nakreslené ako externý uzol práve preto, že nie je vaše - ten box je pripomienkou, že jeho dostupnosť je závislosťou, ktorú neriadite.

Je to zároveň jediný z tých troch, ktorý zastará v obyčajný utorok. Doménový model prežije prechod na inú platformu nedotknutý a pohľad na komponenty tiež; diagram nasadenia zneplatní migrácia klastra. Tá asymetria je dobrým dôvodom držať ho oddelene namiesto zabalenia "beží na Kubernetes" do boxov komponentov.

Notácia za prostredným diagramom, s piatimi ďalšími topológiami, je v príkladoch diagramov komponentov. Na vytvorenie prvého návrhu ktoréhokoľvek z tých troch z popisu namiesto ručného kreslenia pozrite generovanie UML pomocou AI.