Modulární e-commerce platforma postavená na Nette Framework — 30 submodulů pro katalog, checkout, platby, dopravu, ERP, marketplace, marketing, analytiku a provozní kvalitu.
Zadání
Klient provozující specializovaný e-shop potřeboval robustní platformu, která zvládne kompletní e-commerce workflow: od produktového katalogu přes objednávky, platby a dopravu až po napojení na ERP systém, marketplace kanály, marketing a analytiku.
Řešení muselo být modulární, aby bylo možné snadno přidávat nebo odebírat funkce bez zásahu do jádra systému. Stávající řešení na míru byla monolitická, obtížně rozšiřitelná a náročná na údržbu.
Řešení
Navrhli a vyvinuli jsme modulární e-commerce platformu postavenou na Nette Framework a PHP. Jádro systému poskytuje katalog, košík, checkout, zákazníky, administraci a provozní služby. Rozšířená funkcionalita je zapouzdřena v 30 submodulech v adresáři app/@Packages.
Každý balíček je izolovaný git submodul s vlastním DI, routingem, šablonami, entitami a překlady. Balíčky lze přidávat nebo odebírat bez dopadu na zbytek systému. Platforma je nasazena na produkci jako order.cz.
Přehled submodulů
Platby
- GoPay — online platby, callbacky, retry payment a per-domain credentialy
- BankTransfer — bankovní převod a potvrzovací stránka s platebními údaji
- Cod — dobírka jako samostatná platební služba
Doprava
- Zásilkovna — výdejní místa Packeta, synchronizace poboček a validace checkoutu
- ParcelShop — univerzální CZ/SK výdejní místa s GPS a mapou
- Wolt — Wolt Drive, promise/cena v košíku, webhooky a live tracking
ERP a provozní integrace
- SyncVarioBridge — obousměrná synchronizace s Vario Bridge a ERP Vario
- UCP — headless a agentní checkout API nad e-shopem
- CustomDomain — doménové nastavení, zavírací dny a provozní kalendář
- Command — webové spouštění Symfony Console příkazů z administrace
Marketplace a feedy
- Marketplace — společná vrstva pro Kaufland, Allegro, eMag, Amazon scaffold a další kanály
- Heureka Marketplace — import objednávek z Heureky a mapování stavů
- Zboží.cz — Ověřený nákup, konverzní tracking a recenze
- Ověřeno zákazníky — Heureka recenze e-shopu i produktů
Zákaznické UX
- SocialLogin — OAuth2 přihlášení přes Google, Facebook, Seznam a Apple
- WatchDog — hlídání dostupnosti a notifikace při naskladnění
- FavouriteProducts — wishlist pro přihlášené i anonymní zákazníky
- SmartForm — našeptávání a validace adres v checkoutu
- AdultTos — ověření plnoletosti pro vybrané kategorie a objednávky
CMS a obsah
- Recipes — recepty, ingredience, produkty, fulltext a sitemap
- Microsites — tematické landing pages, produkty, kupony a dárky
- Snippets — znovupoužitelné obsahové bloky vkládané přes Latte
- NotificationBar — celowebová oznámení a akce
- Translations — databázové překlady, cache a export do NEON
Marketing a analytika
- GA4 Dashboard — interní dashboard nad Google Analytics 4 Data API
- A/B Testing — experimenty, varianty, traffic split a konverze
- LeadHub — marketing automation integrace pro kampaně, profily a odběry
- EshopEvents — e-mail, SMS, flash a MQTT notifikace nad událostmi e-shopu
Projektová vrstva a kvalita
- Modifications — Susi30 theme, search rozšíření, blog search, assets a lokální routy
- Tests — sdílená regresní sada pro checkout, integrace, ERP a marketplace
Marketplace a externí prodejní kanály
Nová marketplace vrstva sjednocuje externí prodejní kanály pod jedním modelem connection, mappingu, produktových assignmentů, objednávek a sync logu. Aktivní konektory pokrývají Kaufland.cz, Allegro a eMag; Amazon EU je připravený jako scaffold pro budoucí rozšíření.
Webhook endpoint kontroluje existenci a publikaci connection, typ konektoru, volitelný IP whitelist a HMAC podpis. Synchronizační úlohy se dispatchují do Redis fronty, takže import objednávek, produktový sync a aktualizace skladů nemusí blokovat běžný provoz e-shopu.
Analytika, experimenty a marketing automation
Rozšířená platforma doplňuje provozní e-commerce funkce o analytiku a marketing. GA4 Dashboard přináší vybrané metriky přímo do administrace, A/B Testing umožňuje řízené experimenty a LeadHub napojuje kampaně, objednávky, profily a odběry.
Komunikační vrstvu doplňuje EshopEvents, který na aplikační události navazuje šablony pro e-mail, SMS, flash zprávy a MQTT.
Headless a agentní checkout
UCP vystavuje .well-known/ucp business profile a REST API /ucp/v1 pro vytvoření, úpravu, dokončení a zrušení checkout session. Dokončená UCP session se převádí na standardní interní objednávku, takže headless klient nebo agentní rozhraní používá stejné objednávkové workflow jako běžný e-shop.
SyncVarioBridge
ERP integrace je řešená přes e-shopový modul SyncVarioBridge a externí Go službu Vario Bridge. E-shop nekomunikuje s databází Varia přímo; používá HTTPS, mTLS a JSON API. Modul řeší produkty, ceny, sklady, zákazníky, export objednávek, import změn dokladů, rozpad slev podle DPH a hlavičkové zaokrouhlení.
Kvalita a provoz
Součástí platformy je také Tests submodul se sdíleným bootstrapem a regresní sadou. Pokrývá checkout, marketplace transformace, Wolt queue, Heureka integrace, SyncVarioBridge export/import, rozpad slev podle DPH i hlavičkové zaokrouhlení objednávky.