Objednávka projde od košíku přes účetnictví až po spárovanou platbu, aniž by se jí kdokoliv dotkl

Tohle není zakázka. Je to můj vlastní web a zároveň moje pracovní laboratoř. Patnáct let chodím po provozech jako bezpečnostní technik a tu agendu znám zevnitř: dokumentace, školení, hodnocení rizik, evidence úrazů. Věci, které firmy dělají v Excelu a v šanonech, protože jim nikdo nepostavil nástroj.

Původní weby běžely na WordPressu, e-shop na jeho nákupní nadstavbě. V dnešní databázi po tom zůstaly stopy, sloupce s původními identifikátory. Roky to stačilo, pak přestalo. Web byl pomalý, administrace nepříjemná na ovládání a s každým dalším doplňkem přibyla věc, kterou jsem musel hlídat a aktualizovat, aniž bych viděl dovnitř.

Pak mi jedním z těch doplňků e-shop napadli a udělali nepořádek v objednávkách. Data jsem nakonec narovnal, ale stálo to spoustu hodin, které nikdo nezaplatil, a po celou dobu jsem nemohl zákazníkům s jistotou říct, co se s jejich objednávkou stalo. Tohle je zkušenost, kvůli které dnes nestavím na cizích zásuvných modulech. Každý z nich je cesta dovnitř, kterou neovládám a za kterou nemůžu ručit.

K tomu provoz. Každá objednávka znamenala ruční vystavení faktury, ruční kontrolu výpisu z banky a ruční odeslání souborů. Školení se prodávalo jako soubor ke stažení, takže zákazník neměl doklad o proškolení, který by obstál před kontrolou.

Rozhodl jsem se to postavit znovu a od základu. Ne jako web s doplňky, ale jako jednu aplikaci nad jednou databází, kde vím o každém řádku kódu, proč tam je.

Web běží na Next.js, obsah i obchodní data jsou v PostgreSQL a stránky se skládají na serveru. Jedna aplikace přitom obsluhuje tři domény: podle adresy se přepne režim a pustí se jen odpovídající část.

Přihlášení nepatří téhle aplikaci. Postavil jsem k němu samostatný server, který funguje jako jediná identita pro všechno, co provozuji: web, e-learning, evidenci úrazů i odborné fórum. Bezpečák je vůči němu jen klient, který se přihlašuje přes OAuth2 a OpenID Connect s PKCE. Session cookie je sdílená napříč doménami a platnost přihlášení se ověřuje proti databázi každých patnáct vteřin, takže odhlášení nebo změna hesla platí všude okamžitě. Zákazník tak má jeden účet a jedny fakturační údaje, i když nakupuje ve třech různých aplikacích.

Peněžní okruh. Platba kartou přes bránu vystaví ostrou fakturu v účetním systému. Platba převodem vystaví nejdřív zálohovou fakturu a po připsání peněz ji na ostrou konvertuje. Bankovní výpis se stahuje každých patnáct minut a páruje podle variabilního symbolu s tolerancí jednoho haléře, protože zaokrouhlení daně je legitimní rozdíl, zatímco tolerance jedné koruny už je náplast. Dvě částečné platby se sečtou, nedoplatek se eviduje a zákazník o něm ví.

Dokončení objednávky je fronta dvaceti kroků, každý s vlastním identifikátorem a pěti pokusy. Opakovací úloha běží každých pět minut. Objednávka se uzavře jen tehdy, když prošla faktura i všechny kritické kroky, takže stav dokončeno vždycky něco znamená.

Školení nejsou videa ke stažení. Průchod hlídá pořadí lekcí, minimální čas nad lekcí, povinné checklisty a složené kvízy. Otázky se v okamžiku pokusu zmrazí i s otiskem, takže je zpětně vidět, na co student odpovídal. Certifikát nese otisk SHA-256 a QR kód, přes který si pravost ověří kdokoliv bez přihlášení.

Provoz běží v Dockeru za Caddy, ven nevede žádný port. Nasazení má tři úrovně podle rizika, od kompletního s povinnou zálohou po rychlé za třicet vteřin. Skript odmítne poslat na produkci necommitnutý strom. Záloha databáze se ověřuje čtením zpátky a existuje skript na cvičnou obnovu.