Refaktorování zrychlíte, jen když nepřehlédnete skrytou vazbu
Na závěr: testujte API ještě před tím, než ho napojíte na frontend. Nástroje jako curl nebo testovací frameworky vám ušetří hodiny ladění. Sledujte logy – do produkce neposílejte celé chybové stopy, ale logujte je na serveru. A nezapomeňte na bezpečnostní hlavičky a omezení velikosti těla požadavku. Express je rychlý start, ale bez těchto pěti návyků se z jednoduchého API stane noční můra.
Na co si dát pozor: nemíchej do jednoho commitu refaktorizaci a novou funkci. Když se něco rozbije, nebudeš vědět, která část to způsobila. Další typická chyba je dlouhé odkládání commitu — lidé pracují celý den a pak pošlou jednu obrovskou změnu, kterou nejde rozumně zkontrolovat. Commituj po menších krocích, i když jsou nedokončené, pokud jde o logický celek. Neboj se použít git diff před commitem a git log po něm; oba příkazy odhalí víc než sebelepší paměť.
Měřte jen to, co týmu pomůže rozhodovat. Rychlost v bodech má smysl pouze uvnitř jednoho týmu a jen pro plánování, ne pro srovnávání mezi lidmi. Užitečnější je počet položek, které skutečně prošly do produkce, a doba od zadání po nasazení. Pokud se tým zasekne na testování nebo na čekání na schválení, sprint to ukáže a vy máte data, se kterými lze jít za vedením. Bez tohoto kroku se Scrum zvrhne v nekonečnou diskusi o odhadech.
Verzování se láme i na úrovni tagů a vydaných artefaktů. Když se rollback dělá na produkci, musí být jasné, který tag nebo image odpovídá stavu před chybou. Pokud se tagy přepisují na stejné jméno, nikdo později nedokáže zjistit, co přesně běželo. Tagujte immutable verzí, nikdy nepřesouvejte existující tag na jiný commit. A při rollbacku nasazujte přesně ten artefakt, který byl ověřený, ne nový build z revertovaného commitu. Nový build totiž může obsahovat jiné závislosti a chování se změní i tam, kde jste nic neměnili.
Scrum není sada schůzek, které je potřeba odbýt, ale způsob, jak tým přestane hádat, co má dělat, a začne to skutečně zjišťovat v krátkých cyklech. Pro české vývojářské týmy bývá největší překážkou zvyk rozhodovat všechno na poradě u vedoucího. Scrum tuto roli přesouvá na tým a na produktového vlastníka, což je změna, kterou je potřeba vysvětlit dřív, než se zavede první sprint. Bez toho lidé berou ceremonie jako administrativu navíc.
Většina vývojářů použije refaktorovací nástroj v IDE jako první pomoc: označí metodu, stiskne zkratku pro extrakci a doufá, že to bude stačit. Problém je, že vestavěné nástroje fungují spolehlivě jen tehdy, když přesně vědí, co se v kódu děje. Pokud máte v projektu skryté vazby – třeba volání přes reflexi, řetězce s názvy metod nebo dynamické importy – automatická úprava je ignoruje. Výsledkem je refaktorovaný kód, který se sice zkompiluje, ale za běhu selže. Proto je první krok vždy inventura: projděte si, kde všude se daný prvek používá, a to i mimo statickou analýzu.
Struktura projektu se vyplatí řešit hned na začátku. Neskládejte vše do jednoho souboru. Rozdělte aplikaci na moduly: routes, controllers, services a models. Routy definují jen cesty a metody, controllery obsahují logiku requestu a services byznys logiku. Databázové modely držte oddělené. Tím se vyhnete tomu, že se vám do rout zamíchá přístup k databázi a budete mít problém s testováním. Pro malé API to může vypadat jako overkill, ale jakmile přidáte validaci, autentizaci a zpracování chyb, přehlednost.
Po třech až čtyřech sprintech udělejte krátkou revizi: co tým dělá jinak než na začátku a co mu stále brání. Není potřeba zavádět všechny praktiky najednou; stačí, když každý sprint skončí funkčním přírůstkem a tým ví, proč ho dělá. Czech teams often chtějí rychlý výsledek, ale Scrum potřebuje několik cyklů, než začne být přirozený. Vytrvejte u základů a zbytek se doladí podle skutečných problémů, ne podle šablony.
Poslední věc, kterou si osvoj brzy: záložní větev není ostuda. Když se pustíš do riskantního zásahu, vytvoř si větev a klidně i barvy stěn do obývákučasný commit. Vracení změn přes reset nebo revert je rychlé, ale jen když víš, co který příkaz dělá. Než začneš přepisovat historii, ujisti se, že změny nejsou už odeslané jinam. Verzování se nejlépe učí na malém projektu, kde si můžeš dovolit chybu — a právě tam si vytvoříš návyky, které ti později ušetří nejvíc času.
Validace a ošetření chyb Nikdy nedůvěřujte datům z těla požadavku. Ať už posíláte JSON nebo formulářová data, vždy je validujte. Express sám o sobě validaci nemá, takže buď použijte knihovnu, nebo si napište jednoduchou funkci. Typická chyba je, že vývojář zkontroluje jen přítomnost pole, ale ne jeho typ nebo rozsah. U čísel nezapomeňte na převod z řetězce, protože JSON posílá čísla jako čísla, ale query parametry jsou vždy řetězce. Pokud validace selže, vraťte 400 s konkrétní zprávou. Pro neočekávané chyby nastavte centrální error handler jako poslední middleware. Ten musí mít čtyři parametry (err, req, res, next), jinak ho Express nerozpozná.