nopCommerce Dokumentace

Výchozí schéma databáze

V tomto článku se podíváme na schéma databáze, které se vytváří při počáteční instalaci a které v 90 % případů zůstává beze změny.

Nebudeme uvádět celé schéma jako celek, ale popíšeme výchozí instalaci, která počítá s vytvořením 126 tabulek.

Abychom takové schéma snadno pochopili, rozdělme si ho na části. Níže jsme tabulky seskupili co nejpřirozeněji a nejsrozumitelněji:

Informace o zákaznících

Informace o zákaznících

Tento diagram znázorňuje sadu tabulek, které obsahují základní informace o zákaznících. Uvádí také směr vazeb.

Nebudeme se zabývat účelem tabulek a polí, protože jejich názvy jsou dostatečně výmluvné.

Zvláštnosti (Informace o zákaznících)

  • V tabulce Customer máme tři pole, která by ve skutečnosti měla být definována jako cizí klíče, ale v praxi nejsou:

    1. AffiliateId
    2. VendorId
    3. RegisteredInStoreId

    Je to tak záměrně, aby se systém nezatěžoval zbytečnými vazbami, protože tato pole se nepoužívají v každém internetovém obchodě.

  • Některá uživatelská data jsou uložena v tabulce GenericAttribute. Všechna je najdete v \src\Libraries\Nop.Core\Domain\Customers\NopCustomerDefaults.cs.

    Struktura této tabulky je uvedena níže:

    GenericAttribute

    Kromě zmíněných dat o zákaznících může tato tabulka ukládat libovolná data i pro jiné entity. Tuto tabulku jsme přidali záměrně, abyste mohli rozšířit jakoukoli entitu bez změny struktury tabulek.

    Tato tabulka navíc ukládá vlastní atributy zákazníka a atributy dodavatele se zvolenými hodnotami pro dodavatele a zákazníky ve formátu XML. Podívejte se na následující řádky, abyste pochopili, jak to vypadá:

    Xml

    Na příkladu řetězce XML ze sloupce Value vidíme, jak přesně jsou hodnoty atributů pro určitého dodavatele uloženy:

    <Attributes><VendorAttribute ID="2"><VendorAttributeValue><Value>1</Value></VendorAttributeValue></VendorAttribute></Attributes>
    

    Jak vidíte, dodavatel s ID 1 má vyplněný pouze jeden atribut dodavatele. Tento atribut má ID 2 a jeho hodnota je 1.

    Vlastní atributy zákazníka mají stejnou strukturu jako atributy dodavatele. Následující snímek obrazovky znázorňuje vztahy mezi atributy zákazníka a atributy dodavatele a jejich hodnotami:

    Xml

Informace o produktech

Informace o produktech

V diagramu vidíte základní data produktu (schéma tabulky s informacemi o produktu níže). Tato data se zpravidla používají v 99 % případů.

Tabulka produktu

Zvláštnosti (Informace o produktech)

V závislosti na nastavení obchodu mohou být k tomuto schématu připojeny další tabulky. Například pro rozdělení množství produktu mezi více skladů.

Tabulka produktu

Nebo pokud chcete používat funkci recenzí produktů:

Tabulka produktu

Atributy produktu

Dále se podívejme na schéma atributů a jejich kombinací uvedené níže:

Atributy produktu

Množstevní ceny

Pokud u produktů používáte množstevní ceny, měli byste věnovat pozornost také následujícímu schématu:

Množstevní ceny

Zásoby podle skladů

Přestože se tato funkce nepoužívá často, může být užitečné uvést schéma evidence zboží v konkrétním skladu:

Zásoby podle skladů

Objednávky

objednávky

V tomto diagramu vidíme tabulky související s daty objednávek. Tabulka Order má následující strukturu:

objednávka

Není třeba nic komentovat, protože vše by mělo být jasné z diagramu a názvy polí jsou dostatečně výmluvné. Je třeba pouze poznamenat, že tabulka RewardPointsHistory se používá pouze tehdy, je-li pro obchod aktivován systém věrnostních bodů.

Zásilky

zásilky

Účel všech tabulek v diagramu stejně jako dříve nevyvolává žádné otázky. Přesto se zastavme u několika bodů. Tabulka ShippingMethod slouží ke správě seznamu připojených pluginů a konkrétní způsob dopravy je uložen v polích ShippingRateComputationMethodSystemName a ShippingMethod tabulky Order.

Pole OrderItemId tabulky ShipmentItem je v podstatě odkazem na tabulku OrderItem.

Slevy

slevy

Z výše uvedeného diagramu vidíme, že slevy lze uplatnit na tři skupiny: Produkty, Výrobce, Kategorie a lze je konfigurovat pomocí různých pravidel, která jsou řízena pluginy (IDiscountRequirementRule).

V tabulce DiscountRequirement musí pole InteractionTypeId obsahovat jednu z hodnot uvedených ve výčtu RequirementGroupInteractionType:

/// <summary>
/// Represents an interaction type within the group of requirements
/// </summary>
public enum RequirementGroupInteractionType
{
    /// <summary>
    /// All requirements within the group must be met
    /// </summary>
    And = 0,

    /// <summary>
    /// At least one of the requirements within the group must be met 
    /// </summary>
    Or = 2
}

Nákupní košík

Další důležitou součástí obchodu je nákupní košík. V našem případě je schéma tohoto mechanismu velmi jednoduché:

Nákupní košík

Jediné, co stojí za zmínku, je, že toto schéma se používá také pro seznam přání. K rozlišení těchto dvou typů slouží pole ShoppingCartTypeId. Hodnoty v tomto poli musí odpovídat hodnotám z výčtu ShoppingCartType:

/// <summary>
/// Represents a shopping cart type
/// </summary>
public enum ShoppingCartType
{
    /// <summary>
    /// Shopping cart
    /// </summary>
    ShoppingCart = 1,

    /// <summary>
    /// Wishlist
    /// </summary>
    Wishlist = 2
}

Adresy

Možná vás bude zajímat také schéma tabulek, které se podílejí na ukládání adres, a to jak doručovacích adres, tak adres zákazníků:

adresy

Jak jistě chápete, standardní instalace obsahuje mnohem více tabulek. Nepopisujeme je všechny, protože mnohé z nich nemají žádné vazby a slouží pouze ke specifickému účelu, zatímco jiné se používají velmi zřídka.

Konvence pojmenování v databázi

Možná jste si všimli, že databáze používá k pojmenování tabulek a sloupců smíšený přístup (se znakem _, bez _, CamelCase). Kdysi dávno jsme používali znak _. Nyní jsme však zcela přešli na zápis PascalCase. Rozhodli jsme se neměnit názvy stávajících tabulek ani sloupců, protože mnoho našich uživatelů už napsalo vlastní skripty, které by jinak přestaly fungovat.

Pro zachování zpětné kompatibility s novými standardy jsme zavedli rozhraní INameCompatibility. Umožňuje přejmenovat tabulky a sloupce tak, aby se objekty správně mapovaly na tabulky, které dodržují staré standardy pojmenování. Úplný seznam přepsání obsahuje třída BaseNameCompatibility ve jmenném prostoru Nop.Data.Mapping.

Přispěvatelé: skoshelev mariannk
Upravit na GitHubu