Keď vyvíjate pre klienta na Ecommio, obchod beží v jednom z dvoch modelov infraštruktúry. Tento článok zhŕňa rozdiel, ako funguje vlastná doména na zdieľanom modeli a čo použiť namiesto formálneho staging prostredia, ktoré platforma sama neponúka.
1. Zdieľané nasadenie (bežný prípad)
Každý e-shop je samostatný tenant: vlastná PostgreSQL databáza (tenant_{slug}), zdieľaná aplikácia aj infraštruktúra platformy. ResolveTenant middleware pri každom requeste rozpozná obchod podľa subdomény alebo pripojenej vlastnej domény a prepne databázové spojenie — v strednej vrstve aplikácie sa dva obchody nikdy nestretnú, cache kľúče aj cesty k súborom sú per-tenant.
Toto je model, na ktorý sa pripája headless klient aj MCP integrácia — pozri Headless Storefront API a MCP server — pripojenie Claude k obchodu.
2. Dedikované nasadenie
Pre klienta, ktorý potrebuje vlastnú infraštruktúru (napr. z compliance dôvodov), existuje dedicated mode — samostatná inštancia na klientovom serveri (Docker), nezávislá od SaaS prostredia platformy. Beh je viazaný na licenčný kľúč, ktorý sa 2× denne overuje voči platformovému API; pri výpadku platformy nastupuje grace perióda (predvolene 7 dní), po ktorej sa e-shop zobrazí ako dočasne nedostupný, kým sa licencia znovu neoverí. Bez nastaveného licenčného kľúča beží inštancia bez obmedzenia.
Rozhodnutie medzi zdieľaným a dedikovaným modelom robí obchodník podľa plánu a požiadaviek — pre bežný e-shop je zdieľaný model jednoduchší a nevyžaduje vlastnú prevádzku serverov.
3. Vlastná doména na zdieľanom modeli
Vlastnú doménu pripája majiteľ e-shopu v platformovom účte (Moje e-shopy > [obchod] > Nastavenia), nie v administrácii samotného e-shopu:
- Zadá doménu — dostupnosť funkcie závisí od plánu (
custom_domainlimit). - Platforma vygeneruje DNS záznamy, ktoré treba nastaviť u registrátora domény.
- Po nastavení DNS sa spustí overenie (asynchrónna kontrola cez frontu); pri úspechu sa doména aktivuje a SSL certifikát sa vystaví automaticky.
- Doménu možno kedykoľvek odpojiť — obchod potom opäť beží na pridelenej subdoméne.
Pozor: Zmena plánu na taký, ktorý vlastnú doménu nepodporuje, môže ponechať rozbehnuté overenie domény z predošlého plánu — platforma pri potvrdení overenia limit plánu prekontroluje znovu, takže aktivácia zlyhá, kým sa plán nevráti alebo nezmení.
4. Náhrada za staging prostredie
Platforma neponúka samostatné "staging" prostredie ako prepínateľnú kópiu obchodu. V praxi to rieši jeden z dvoch spôsobov podľa modelu:
- Zdieľaný model: pracujte na pridelenej subdoméne (
<slug>.<platforma>), kým nie je obchod pripravený — subdoména funguje bez ohľadu na to, či je vlastná doména už pripojená. Vlastnú doménu pripojte až tesne pred spustením, keď je katalóg, doprava, platby a testovacia objednávka overená (postup je v Prvý týždeň — checklist spustenia). - Dedikovaný model: keďže inštancia beží na infraštruktúre klienta, nič nebráni spustiť dve samostatné inštancie (staging + produkcia) s vlastnými doménami a licenčnými kľúčmi — je to však réžia, ktorú si klient zabezpečuje sám.
Pre demo/testovacie prostredie na zdieľanom modeli slúži samostatný demo e-shop popísaný v Demo e-shop a testovanie — nie je to však staging kópia konkrétneho obchodu, ale samostatný ukážkový tenant.
Časté problémy
- Vlastná doména sa neaktivuje. Skontrolujte, že DNS záznamy presne zodpovedajú tým, ktoré platforma vygenerovala pri iniciácii — overenie beží asynchrónne, po zmene DNS treba počkať na jeho dobehnutie a znova spustiť overenie.
- Overenie domény zlyháva po zmene plánu. Aktuálny plán už nepodporuje vlastnú doménu; buď sa vráťte na pôvodný plán, alebo doménu odstráňte a pripojte znova po prípadnej zmene plánu.
- Dedikovaná inštancia hlási vypršanú licenciu. Platformový server bol dočasne nedostupný dlhšie než grace perióda — spustite
php artisan license:verifymanuálne po obnovení pripojenia. - Potrebujem oddeliť testovanie od živého obchodu. Zdieľaný model nemá formálne staging prostredie — testujte na subdoméne pred pripojením vlastnej domény, prípadne použite demo e-shop na overenie funkcií bez zásahu do živých dát.