ElementStore × SAIMON

Implementační zadání

Stručné technické shrnutí pro vývojáře a technického projektového manažera.

1. Jak to technicky funguje

Feed je zdroj pravdy

Vše se řídí přes produktový feed:

https://www.elementstore.cz/saimon-products.xml

Popup po přidání do košíku

Použije se element WIDGET_CART_POPUP.

  • vyplňuje se u produktu, po jehož přidání do košíku se má doporučení zobrazit
  • hodnota = 1 nebo více product ID
  • formát = stringy oddělené čárkou
<WIDGET_CART_POPUP>687a254dd02d13-64227096,987a254dd02d13-64227012</WIDGET_CART_POPUP>

Příslušenství

Použije se element PRISLUSENSTVI_PRODUCT_IDS.

  • vyplňuje se u produktu, ke kterému chceme natvrdo definovat konkrétní příslušenství
  • hodnota = 1 nebo více product ID
  • formát = stringy oddělené čárkou
<PRISLUSENSTVI_PRODUCT_IDS>687a254dd02d13-64227096,987a254dd02d13-64227012</PRISLUSENSTVI_PRODUCT_IDS>

Potvrzená logika od Saimonu

  • Pokud existuje PRISLUSENSTVI_PRODUCT_IDS, použijí se produkty z tohoto pole.
  • Pokud pole neexistuje nebo obsahuje málo produktů, Saimon doplní z PRISLUSENSTVI_CAT_IDS.
  • Pokud existuje WIDGET_CART_POPUP, Saimon použije produkt nebo produkty z tohoto pole.
  • Podporovaný je i seznam více ID oddělených čárkou.

Implementační pravidla

  • obě pole jsou optional
  • pokud nejsou vyplněná, ideálně element do feedu vůbec negenerovat
  • doporučeno zapisovat bez mezer za čárkou
  • hodnoty musí být product ID, která Saimon zná
  • ideálně validovat existenci ID a deduplikovat
2. Co je třeba udělat z pohledu UI

Admin / detail produktu

Na detail produktu přidat 2 nová volitelná pole.

Produkty pro popup po přidání do košíku

  • optional pole u produktu
  • uživatel zde nastaví, které produkty se mají doporučit v popupu po add-to-cart
  • výsledkem bude naplnění WIDGET_CART_POPUP

Produkty pro příslušenství

  • optional pole u produktu
  • uživatel zde nastaví, které produkty se mají natvrdo zobrazit jako příslušenství
  • výsledkem bude naplnění PRISLUSENSTVI_PRODUCT_IDS

Doporučení pro UX adminu

  • ideálně výběr produktů přes produkt picker, ne ruční psaní ID
  • interně se uloží vazba na produkty, do XML se pak serializují správná ID
  • pokud chceme zachovat pořadí v exportu, měl by picker umožnit řazení
Obojí je optional. Pokud nebude nic vyplněno, feed daný element vůbec nevygeneruje.
3. Hromadné úpravy

Bulk edit je nutný

Obě vazby musí být možné spravovat i přes hromadné úpravy.

  • hromadně upravovat produkty pro popup po přidání do košíku
  • hromadně upravovat produkty pro příslušenství
  • minimálně přidat / přepsat hodnoty
  • ideálně i hromadně smazat hodnoty
  • chování sladit s bulk edit řešením, které se řeší v paralelním mailovém vlákně
4. Shrnutí pro vývoj

Checklist

  • Backend / feed: doplnit export WIDGET_CART_POPUP a PRISLUSENSTVI_PRODUCT_IDS
  • Formát: comma-separated seznam product ID
  • Feed: negenerovat prázdné elementy
  • Admin UI: přidat 2 optional pole na produkt
  • Bulk edit: obě nová pole musí jít upravovat i hromadně