Jak zorganizovat práci s více jazyky v jednom projektu
První praktický krok je rozložit úkol na menší části. Neodhadujte celkovou dobu jako jeden blok, ale napište si seznam všech kroků, které vás napadnou. Může to vypadat takto: návrh datového modelu, implementace logiky, integrace s API, ošetření chybových stavů, testy, manuální kontrola a nasazení. Ke každému kroku si přidejte časový odhad. Uvidíte, že součet dílčích položek bude vyšší, než by byl vaše prvotní intuice – a to je přesně to, co potřebujete.
Retrospektiva týmu často sklouzne do frází jako „bylo to dobré" nebo „příště to zkusíme líp". Bez struktury se ale ztrácí podstata – konkrétní situace, fakta a návrhy na změnu. Vyzkoušejte strukturovanou zpětnou vazbu, která dává každému členu prostor mluvit o tom, co opravdu ovlivňuje jeho práci. Klíčem je rozdělit reflexi na tři jasné oblasti: co fungovalo, co nefungovalo a co s tím uděláme.
Na závěr – testujte. Není nutné psát stovky testů, ale pokryjte alespoň hlavní endpointy a ošetření chyb. K tomu se hodí nástroje jako Supertest, které vám umožní simulovat HTTP požadavky bez spuštění serveru. Pozor si dejte na time-outy u asynchronních operací a na správné ukončení serveru po testech, jinak se vám procesy zablokují. S trochou disciplíny a dodržováním těchto zásad bude vaše REST API stabilní a snadno rozšiřitelné.
Prvním krokem je nastavit prostředí, ve kterém se váš kód sestaví. Použijte předpřipravené akce, jako je checkout pro získání zdrojového kódu a setup-node, pokud pracujete s JavaScriptem. Důležité je pinout verze akcí na konkrétní commit nebo tag, jinak se vám může stát, že se pipeline náhle rozbije kvůli změnám v externí akci. Místo pouhého uvedení názvu akce použijte přesnou verzi, kterou jste testovali. To je častý zdroj chyb, který se projeví až po čase.
Jak na první pohovor a co si připravit Když máte hotový projekt, je čas začít posílat životopisy. Životopis by měl být stručný – ideálně jedna stránka. Pište do něj jen to, co souvisí s IT: používání Git, znalost konkrétních technologií, odkazy na váš GitHub nebo portfolio. Nepište věci jako „umím pracovat v týmu" – to je fráze. Místo toho uveďte konkrétní příklad, kdy jste něco spolupracovali nebo řešili problém. Školy a kurzy uvádějte, ale nechte je na konci.
Návrh routes a práce se status kódy Při návrhu routes se držte REST konvencí. Používejte podstatná jména v množném čísle (například /users), vyhněte se slovesům a akce odvozujte od HTTP metod. GET pro čtení, POST pro vytvoření, PUT nebo PATCH pro úpravu a DELETE pro mazání. Zásadní je vracet správné HTTP status kódy – 200 pro úspěch, 201 pro vytvoření, 400 pro chybný požadavek, 404 pro nenalezený zdroj a 500 pro interní chybu. Častou chybou je vracet 200 i při chybě, což klientovi znemožní rozlišit úspěch od selhání.
Další praktický tip: sledujte si dobu běhu jednotlivých kroků. Pokud se pipeline prodlužuje, může to být způsobeno tím, že máte příliš mnoho kroků, které by šly paralelizovat. Použijte klíč jobs s vhodnými závislostmi (needs), abyste oddělili sestavení od testování a nasazení. Mějte na paměti, že každý job běží v čistém prostředí, takže pokud potřebujete přenést artefakt z jednoho jobu do druhého, musíte použít akci upload-artifact a download-artifact.
Když odhadujete čas na vývojový úkol, obvykle si představíte samotné psaní kódu. Většina chyb v odhadech ale nevzniká kvůli špatnému odhadu složitosti algoritmu, ale kvůli opomenutí činností, které s kódem přímo nesouvisí, přesto jsou nezbytné. Skryté činnosti – jako je konfigurace prostředí, řešení závislostí, testování napříč prohlížeči, psaní dokumentace nebo komunikace s týmem – mohou zabrat klidně třetinu až polovinu celkového času. Pokud je do odhadu nezahrnete, termín se posune a vy budete muset vysvětlovat, proč jste „jen" neupravili pár řádků.
Základní kostra serveru je jednoduchá: vytvoříte instanci Expressu, definujete middleware a routes. Klíčové je správně používat middleware pro parsování JSON těla – bez něj vám příslušné požadavky přijdou s prázdným objektem. Nezapomeňte také na zpracování chyb. Express sice umí zachytit synchronní chyby automaticky, ale asynchronní operace (například práci s databází) musíte ošetřit sami. Ideálně pomocí wrapperu, který předá chybu do dalšího middleware pro zpracování chyb.
Při samotném psaní zdrojových textů myslete na délku. Česká věta je často delší než anglická, a pokud máte tlačítko s pevnou šířkou, text se ořízne. Vždy testujte, jak se překlad chová v extrémních případech — nejdelší slovo, nejdelší věta, nejdelší číslo s jednotkou. Stejně tak pozor na složené výrazy. V češtině skloňujeme, takže věta „Máte 3 nové zprávy" se nedá jednoduše poskládat z částí „Máte" + číslo + „nové zprávy". Používejte raději celé věty s placeholdery, než abyste spojovali kusy textu podle počtu.