Architektura nopCommerce
Úvod
nopCommerce je vysoce přizpůsobitelné a flexibilní, plnohodnotné open-source e-commerce řešení s podporou více obchodů a více dodavatelů, optimalizované pro SEO. Je postaveno na frameworku Microsoft ASP.NET Core. nopCommerce drží krok s nejnovějšími technologiemi a dodržuje osvědčené postupy.
Přehled
Tento dokument poskytuje ucelený přehled architektury systému nopCommerce. Dokumentace je určena novým vývojářům nopCommerce. Projdeme v ní jednotlivé projekty v řešení (solution) nopCommerce, závislosti mezi nimi atd.
Přehled architektury nopCommerce
nopCommerce je jedním z nejpopulárnějších a nejúspěšnějších open-source e-commerce řešení založených na .NET. Úspěch nopCommerce nespočívá jen v tom, že obsahuje většinu funkcí, které moderní e-commerce řešení vyžaduje, hned po instalaci a že jeho uživatelské rozhraní je vysoce přizpůsobitelné a uživatelsky přívětivé, ale také v tom, že řešení nopCommerce je stejně dobře organizované a přívětivé k vývojářům. Hlavní silou nopCommerce je jeho flexibilní, rozšiřitelná architektura a dobře organizovaný zdrojový kód. Architektura nopCommerce má velmi blízko k cibulové architektuře (onion architecture), která se zaměřuje především na řízení provázanosti kódu. Podle této architektury může veškerý kód záviset na vrstvách blíže středu, ale nemůže záviset na vrstvách vzdálenějších od jádra. Jinými slovy, veškerá provázanost směřuje ke středu.

To znamená, že projekty mohou záviset pouze na jiných projektech, které leží směrem dovnitř od aktuálního projektu. Například na výše uvedeném diagramu může projekt Nop.Data záviset na projektu Nop.Core a mít Nop.Core jako závislost, ale Nop.Core nemůže záviset na Nop.Data; podobně může mít Nop.Services jako závislosti Nop.Data a Nop.Core, ale ani Nop.Core, ani Nop.Data nemohou mít jako závislost Nop.Service. Projekt tedy může mít jiný projekt jako závislost pouze tehdy, pokud tento projekt leží směrem dovnitř, blíže středu, než vrstva, ve které se nachází aktuální projekt. To je klíčem k oddělení kódu. Hlavní výhodou tohoto přístupu/architektury je, že pokud chceme otestovat jádro aplikace (Application Core), můžeme tak učinit, i když pro naši aplikaci nemáme žádné UI, protože jádro aplikace nezávisí na vrstvě UI. Nebo můžeme změnit náš UI framework z view enginu Razor a JQuery na Angular, React nebo Vue, aniž bychom ovlivnili jádro aplikace, a stejné jádro můžeme použít k vytvoření mobilních nebo desktopových aplikací. To vše bez změny jediného řádku kódu v jádru aplikace.
Projekty v řešení nopCommerce
Jádro aplikace (Application Core)
Toto je nejvnitřnější vrstva architektury nopCommerce. Je to jádro aplikace. V této vrstvě se nacházejí všechny třídy logiky přístupu k datům a obchodní logiky. V řešení nopCommerce najdeme všechny projekty této vrstvy v adresáři „Libraries“. Tato vrstva obsahuje tři projekty.
Nop.Core
Tento projekt obsahuje sadu základních tříd nopCommerce. Projekt je ve středu architektury a nemá žádné závislosti na jiných projektech v řešení. Obsahuje základní třídy sdílené celým řešením, jako jsou doménové entity, cache, události a další pomocné třídy.
Nop.Data
Projekt Nop.Data závisí na projektu Nop.Core, který je ve středu architektury. Nezávisí na žádném jiném projektu v řešení. Projekt Nop.Data obsahuje třídy a funkce pro čtení z databáze nebo jiného úložiště dat a zápis do nich. Odděluje logiku přístupu k datům od obchodních objektů.
Nop.Services
Projekt Nop.Services je nejvzdálenější vrstvou jádra aplikace v architektuře nopCommerce. Závisí na dalších dvou projektech jádra aplikace. Obsahuje základní služby, obchodní logiku, validace a výpočty nad daty. Někdo jej nazývá vrstvou obchodního přístupu (Business Access Layer, BAL) nebo vrstvou obchodní logiky (Business Logic Layer, BLL). Slouží jako fasáda pro všechny ostatní vrstvy. Obsahuje třídy služeb a ke zpřístupnění svých funkcí využívá návrhový vzor repository. Tento přístup odděluje jádro od ostatních vrstev mimo jádro. Zároveň zabraňuje změnám kódu v ostatních vrstvách nebo je omezuje, pokud se změní logika jádra aplikace. Tento přístup je ideální pro vkládání závislostí (dependency injection).
Vrstva UI
Tato vrstva leží mimo „jádro aplikace“. V řešení nopCommerce najdeme všechny projekty této vrstvy v adresáři „Presentation“. V této vrstvě se nachází veškerá prezentační logika a uživatelské rozhraní. Je to vrstva, ve které se nachází UI, se kterým mohou uživatelé interagovat. V nopCommerce se tato vrstva dělí na dvě další vrstvy.
Nop.Web.Framework
Projekt Nop.Web.Framework je vnitřní vrstvou prezentační vrstvy a závisí na vrstvě jádra aplikace. Jedná se o projekt knihovny tříd, který slouží jako framework pro prezentační vrstvu. Obsahuje sdílenou logiku pro veřejný web nopCommerce i pro administrační panel.
Nop.Web
Projekt Nop.Web je nejvzdálenější vrstvou prezentační vrstvy v architektuře nopCommerce. Obsahuje uživatelské rozhraní e-commerce webu (front end), se kterým mohou uživatelé interagovat. Jde o aplikaci ASP.NET Core, která závisí na Nop.Web.Framework a na jádru aplikace. Nop.Web.Framework využívá pro logiku sdílenou s administračním panelem. Jádro aplikace využívá pro přístup k datům a jejich zpracování.
Admin
V nopCommerce patří do stejné vrstvy jako projekt Nop.Web. Nachází se uvnitř projektu Nop.Web jako oblast (area). Jde rovněž o UI (uživatelské rozhraní), ale tato část prezentační vrstvy obsahuje UI administračního panelu. Administrační panel je místo, kde se spravuje veškerý obsah veřejného webu a odkud můžeme sledovat aktivity na veřejném webu. Veřejný web je přístupný bez jakýchkoli omezení, ale „administrační panel“ vyžaduje pro přístup ověření a autorizaci, protože obsahuje informace, ke kterým má právo přistupovat pouze administrátor webu.
Testovací vrstva
Tato vrstva leží ve stejné vrstvě jako „prezentační vrstva“, hned vně „jádra aplikace“. Tato vrstva se celá týká testování různých částí aplikace. Testování v nopCommerce je díky architektuře, kterou systém používá, snadné a spolehlivější. V řešení nopCommerce najdeme všechny projekty této vrstvy v adresáři „Tests“. nopCommerce používá pro jednotkové testy testovací framework NUnit.
Nop.Tests
Tato vrstva je vnitřní vrstvou „testovací vrstvy“ a má závislost na vrstvě „jádra aplikace“. Tento projekt obsahuje základní logiku pro testování.
Nop.Core.Tests
Tyto testy jsou vytvořeny pro jednotkové testování projektu Nop.Core; testují cache, doménové entity a podobně.
Nop.Data.Tests
Tyto testy jsou vytvořeny pro jednotkové testování projektu Nop.Data; testují práci různých poskytovatelů dat s operacemi nad entitou, jako je vložení, odstranění atd.
Nop.Services.Tests
Tyto testy jsou vytvořeny pro jednotkové testování projektu Nop.Service. Obsahují logiku pro testování každé třídy služeb pro každou operaci.
Nop.Web.Tests
Tyto testy lze použít k testování prezentační vrstvy nopCommerce, která obsahuje „veřejný web“ a „administrační panel“.