Kassen-Dashboard: pénztárgép szinkronizálása a Shopifyhoz

504-es hiba az első teljes katalógus feltöltésekor. Nem kódhiba volt: a VPS reverse proxyja időtúllépéssel szakította meg a jogosan hosszú szinkront. Először azt kellett felfedeznem, hogy a szerver egyáltalán nem szabványos nginx elrendezést használ. aaPanel kezeli, és a valódi konfiguráció egy panel által generált proxy könyvtárban van, amit egy grep az /etc/nginx alatt sosem talált volna meg. Csak ezután lehetett alkalmazni a javítást: egy célzott timeout-felülírást olyan fájlban, amelyet a panel saját felülete nem ír felül.

Három Shopify Admin API szerződésváltozás egymás után. Egy mező, amely a dokumentáció szerint jónak tűnt (ignoreCompareQuantity), az input típuson egyáltalán nem létezett. A helyére lépő mező (changeFromQuantity) kötelező compare-and-set előfeltétel, nem opcionális metaadat. Ezután a mutation minden kérést elutasított, mert hiányzott egy újonnan kötelezővé tett @idempotent direktíva. Mindegyiket a nyers GraphQL hibaüzenetből és a Shopify changelogjából diagnosztizáltam. A második javítása maga is defenzív tervezés: a szinkron közvetlenül írás előtt lekéri az élő mennyiséget a helyi gyorsítótár helyett, ami véd a közben történt eladás felülírása ellen is.

Egy gyorsítótár, amely egy terméket örökre hibássá tehetett. Egy terméket töröltek és újra létrehoztak a Shopifyban, ami rutin, és új belső azonosítót kap. A szinkronnak nem volt visszaútja a „a gyorsítótárazott azonosító már nem létezik” állapotból, csak az, hogy minden későbbi futásnál hibát dob arra az SKU-ra. Mostantól öngyógyító: a „nem található” törli az elavult gyorsítótárat, és friss SKU-keresésre vált, így egy rossz azonosító nem válik tartós, csendes lyukká a katalógusban.

Sikert jelenteni egy meg nem történt írásra. Egy sikertelen Shopify-írás egy pillanatra mégis eltárolta helyben a szándékolt új készletet, még mielőtt az írás megerősítést kapott volna. Egy átmeneti hiba miatt a következő futás gyorsítótár-ellenőrzése hamis egyezést láthatott, kihagyta az újrapróbálkozást, és „Erfolg”-ot jelentett olyan készletre, amelyet a Shopify sosem kapott meg. Javítva: a helyi állapot csak megerősített távoli írás után kerül mentésre.

Windows SmartScreen egy nem technikai felhasználó gépén. Az .exe első átadásakor az a súrlódás jött elő, amit egy aláíratlan program előre jelez: blokkoló biztonsági ablakot látott, úgy értelmezte, hogy „a gép nem engedi”, és bezárta. Az ablakot vakon diagnosztizálni, egy kétsoros magyar üzenetből, a programot magam nem futtathatva, azt jelentette, hogy az útmutatót az ő nyelvén és az ő konkrét képernyőjére kellett megírnom, nem általános hibaelhárítási dokumentumként.