Tiekėjų likučių sinchronizavimas, kuris įrašo tik perskaitytus skaičius

Stocksync niekada neįrašo likučio, jei portale nenurodytas skaičius. Jei tiekėjo portale parašyta „In stock“ be skaičiaus, kiekis išsaugomas kaip nežinomas, o skaičius parduotuvėje nekeičiamas: spėtas nulis paslėptų prekes, kurias parduotuvė gali parduoti.

Būtent dėl šios taisyklės tiekėjų likučių sinchronizavimą galima palikti veikti savarankiškai, todėl šioje atvejo analizėje ją sekame nuo didmenininko prisijungimo puslapio iki kiekio „Shopify“ parduotuvėje.

Tiekėjo likučiai – tinklalapyje, o ne API

Didmenininko, kuriam skirtas Stocksync, likučiai matomi tik puslapyje, į kurį reikia prisijungti: HTML lentelė, sesijos slapukas, o prieinamumas nurodytas žodžiais, pavyzdžiui, „7 in stock“ ar „Out of stock“. Duomenų srauto nėra. Todėl arba kas nors kiekvieną rytą prisijungia ir perrašo skaičius ranka, arba niekas to nedaro, ir parduotuvė parduoda tai, ko tiekėjas nebeturi.

Integracijos per duomenų srautus tinka tik tiems tiekėjams, kurie tokį srautą teikia. Norint automatizuoti žmogų su dviem atvertais naršyklės skirtukais, tenka išspręsti du nemalonius uždavinius: perskaityti žmonėms skirtą puslapį ir pakeisti duomenis svetimoje parduotuvėje jos nesugadinant.

Stocksync – tai naršyklė, eilė ir kiekvienos prekės įrašas

Stocksync per „DevTools“ protokolą valdo „headless“ Chrome, atlieka parduotuvės įrašytus prisijungimo žingsnius, nuskaito kiekvienos prekės kiekį, o pakeitimus įrašo per „Shopify“ Admin GraphQL API. Sinchronizaciją be žmogaus įsikišimo paleidžia užduočių eilė „Postgres“ duomenų bazėje. Kiekvienas paleidimas užfiksuojamas, kiekvienai prekei – po eilutę: kas perskaityta, kas įrašyta ir kodėl.

• Aprašas, o ne atskiras nuskaitymo scenarijus. Keturių tipų žingsniai (atidaryti, užpildyti, spustelėti, palaukti) ir CSS selektoriai eilutei, prekės kodui ir kiekiui. Parduotuvė juos įveda vieną kartą – kiekvienam tiekėjui atskiro kodo nerašome.
• Teksto analizė. „1,430 in stock“ virsta 1 430, „Sold out“ – 0, „In stock“ – nežinomu kiekiu.
• Rezervas. Parduotuvė gauna tiekėjo skaičių atėmus rezervą, bet ne mažiau nei nulį: kai rezervas lygus dviem, 12 virsta 10. Sinchronizuoti galima kas 15 minučių, bet ne rečiau kaip kartą per parą.
• Absoliučios reikšmės. „Shopify“ gauna komandą „nustatyti likutį 10“ paketais po 250 – tai „Shopify“ masyvų riba. Išsiųsta du kartus, ji vis tiek palieka 10. O komanda „atimti 2“, išsiųsta du kartus, atimtų keturis.
• Eilė, kuri atlaiko perkrovimą. Užduotys paimamos su FOR UPDATE SKIP LOCKED; jei užduoties vykdytojas „nukrito“, po 15 minučių užduotis grąžinama į eilę.
• Užšifruoti prisijungimo duomenys. Portalo slaptažodis ir „Shopify“ raktas šifruojami AES-256-GCM, iššifruojami tik foninio proceso sinchronizacijos metu ir niekada nerodomi.

„Nežinoma“ niekada netampa nuliu, o „pavyko“ visada reiškia pakeistą parduotuvę

Dvi taisyklės įdiegtos kode, o testai jas tikrina. Prekei, kurią portalas rodo be skaičiaus, lieka esamas kiekis, portalo tekstas užfiksuojamas, ir ji niekada neįrašoma kaip nulis. O paleidimas laikomas pavykusiu, kai parduotuvę pasiekė kiekvienas numatytas pakeitimas, ir paleidimo puslapyje matyti kiekvienos prekės rezultatas.

Kiekviena prekė paleidimą baigia viena iš keturių įrašytų būsenų, ir tik viena iš jų rašo į parduotuvę.

Sinchronizacija, kuri praneša apie sėkmę nieko nepakeitusi, yra blogesnė nei jokios sinchronizacijos, nes parduotuvė nustoja tikrinti.

Antrąją taisyklę saugo testas: jis sinchronizuoja su tyčia neprijungta parduotuve ir tikrina, ar kiekviena prekė perskaityta, ar nė viena nepriskirta prie atnaujintų, ar kiekviena užskaityta kaip nepavykusi ir ar kiekvienai nurodyta priežastis. Variklio testai jungiasi prie bandomojo portalo, sukurto kaip tikras didmeninės prekybos portalas – su sesijos slapuku ir žodžiais nurodytu prieinamumu. Jie tikrina teksto analizės taisykles, tikslius kiekius, tai, kad kitas nuskaitymas pastebi pokytį nuo 143 iki 4, ir tai, kad neteisingas slaptažodis paleidimą sustabdo.

Parduotuvė gauna tik tiekėjo paskelbtus skaičius

Kiekvienas Stocksync įrašomas skaičius yra tiekėjo portale per paskutinę sinchronizaciją paskelbtas kiekis, atėmus parduotuvės rezervą. Kai portalas pakeičia išdėstymą, parduotuvėje lieka esami skaičiai, o paleidimas įvardija prisijungimo žingsnį ar prekę, kurią reikia pritaikyti, todėl parduotuvėje niekada neatsiranda niekieno neperskaitytas kiekis.

Ta pati taisyklė lemia ir kitus sistemos sprendimus:

• Dėl absoliučių reikšmių kartoti nieko nekainuoja. „Shopify“ apie užklausų ribojimą praneša įprastame atsakyme, ir Stocksync kiekvieną atsakymą tam patikrina. Kadangi reikšmės absoliučios, kitas paleidimas jas išsiunčia dar kartą be rizikos suskaičiuoti dukart.
• Įrašas atsako į klausimą, kurį parduotuvės iš tikrųjų užduoda. Kiekvienas paleidimas išsaugo atliktus prisijungimo žingsnius ir trukmę, o pasiekus likučių puslapį – ir galutinį puslapio adresą bei pavadinimą; šalia – eilutės kiekvienai prekei.
• Prieiga lieka pačios parduotuvės. Stocksync jungiasi su esama parduotuvės didmeninės prekybos paskyra ir skaito tą likučių puslapį, kurį ta paskyra ir taip mato.

Penki klausimai tiekėjų likučių sinchronizavimui įvertinti

Ką galima pritaikyti ir kitur

Su tais pačiais sprendimais susiduria kiekviena integracija, kuri rašo į sistemą, kuria žmonės pasikliauja. Duomenyse laikykite „nežinoma“ ir „nulis“ skirtingomis reikšmėmis. Sėkmę apibrėžkite kaip pasiektą rezultatą ir patikrinkite ją su tyčia atjungta sistema. Rinkitės įrašus, kurie nustato reikšmę, o ne ją keičia, – tada kartojimui nereikės jokio koordinavimo.

Ir kiekvienai prekei užfiksuokite priežastį. Sinchronizacija pasitikima tada, kai ir po kelių savaičių galima atsakyti, kodėl pasikeitė skaičius.

Jei jūsų parduotuvė perka iš didmenininko, kuris likučius rodo tik prisijungus, pažiūrėkite, kaip dirbame su integracijomis ir nedidelėmis, aiškiai apibrėžtomis užduotimis, arba užsisakykite pokalbį – kartu peržiūrėsime jūsų tiekėjo portalą.