Správné verzování kódu při práci na více větvích

Pokud přecházíte z JavaScriptu na TypeScript, první dny bývají směsicí nadšení a frustrace. Nadšení přichází s tím, jak kompilátor začne chytat chyby dřív, než se dostanou do prohlížeče. Frustrace pak z toho, že se musíte učit nové syntaxi a občas bojovat s typovým systémem. Tento průvodce vám ukáže, jak začít efektivně, na co si dát pozor a jak se vyhnout nejčastějším nástrahám.

Typickou chybou je dlouhodobé ignorování hlavní větve. Pokud vaše feature větev žije déle než pár dní, riziko konfliktů roste exponenciálně. Stejně problematické je i nevhodné používání force push, které může přepsat historii sdílené větve a rozbít práci kolegům. Pokud musíte force push použít, vždy to oznamte týmu a ujistěte se, že nikdo jiný s danou větví nepracuje. Pro sdílené větve (např. develop) force push nepoužívejte vůbec — místo toho vytvořte novou větev a požádejte o merge request.

Při řešení konfliktů se zaměřte na to, co je skutečně potřeba změnit. Než začnete konflikt ručně upravovat, podívejte se na obě verze kódu a pochopte, proč ke konfliktu došlo. Často se stává, že konflikt je pouze zdánlivý — obě větve dělají stejnou věc jiným způsobem. V takovém případě je lepší konzultovat s autorem druhé změny a domluvit se na jednotném řešení. Po vyřešení konfliktů vždy spusťte testy a zkontrolujte, že vaše změny nezpůsobily regresi.

Samotné zpracování požadavku obvykle zahrnuje práci s daty. Pokud nepoužíváte žádnou databázi, alespoň si data ukládejte do paměti nebo do souboru. V praxi ale narazíte na problém, že po restartu serveru všechna data zmizí. Proto je lepší od začátku použít nějakou perzistentní vrstvu, třeba SQLite pro lokální vývoj. Při práci s daty nezapomínejte na validaci vstupů. Nikdy nevěřte datům, která přijdou z venku. Bez validace riskujete neošetřené chyby, které mohou shodit celý server, nebo dokonce umožnit neoprávněný přístup.

Praktická rada pro každodenní práci: používejte užitečné nástroje, které TypeScript nabízí. Například klíčové slovo satisfies od verze 4.9 umožňuje ověřit, že výraz odpovídá typu, aniž byste měnili jeho odvozený typ. To se hodí, když potřebujete zachovat přesný typ literálu, ale zároveň chcete kontrolu. Také se naučte používat vlastnosti readonly pro pole a objekty, které by se neměly měnit. To zabrání nechtěným mutacím v kódu. Častou chybou je ignorování chyb v editoru – pokud vidíte červenou vlnovku, neodkládejte opravu na později. Většinou to znamená, že někde voláte funkci se špatným typem, a oprava je rychlá.

Monitoring je třetí pilíř, na který se často zapomíná. Bez měření nevíte, jestli vaše změny něco zlepšily. Nastavte si základní metriky: dostupnost služby, odezvu API, vytížení CPU a paměti. K tomu přidejte logování, které vám umožní dohledat příčinu problému. Užitečné je i sledování chyb v aplikaci – nemusíte čekat, až to nahlásí uživatel. Typická chyba: sbírat data, ale nikdo se na ně nedívá. Stanovte si pravidelnou kontrolu (např. týdenní revizi) a reagujte na anomálie.

Při zavádění DevOps se vyhněte častým omylům. Nepřeskakujte kulturu a spolupráci – bez důvěry mezi vývojem a provozem automatizace nepomůže. Nezavádějte příliš mnoho nástrojů najednou, začněte s jedním a osvojte si ho. A hlavně neberte DevOps jako práci jednoho člověka – je to odpovědnost celého týmu. Vytvořte si společné cíle, například čas od commitu k nasazení, a pravidelně je vyhodnocujte.

Kde začít: od automatizace po monitoring Prvním praktickým krokem je zavedení verzování kódu, pokud ho už nemáte. Všichni členové týmu musí pracovat s větvemi a pravidelně mergovat změny. Následně nastavte automatizované testy – spouštějte je při každém commitu, abyste chyby odhalili co nejdříve. Důležité je také sjednotit prostředí: použijte kontejnery, aby vývojář, tester i produkce běželi na stejném základu. Tím eliminujete klasický problém „u mě to funguje".

Jak správně typovat funkce a objekty Největší sílu TypeScriptu využijete při definování funkcí a objektů. U funkcí vždy explicitně typujte parametry a návratovou hodnotu. Například místo function add(a, b) napište function add(a: number, b: number): number. Tím zajistíte, že funkci nelze zavolat s řetězcem, i kdyby se to na první pohled zdálo v pořádku. U objektů použijte rozhraní (interface) nebo typové aliasy (type). Rozhraní je vhodnější pro definici tvaru objektu, který se bude rozšiřovat, zatímco typové aliasy se hodí pro uniony a komplexnější typy. Typickým začátečnickým omylem je použití typu any všude, kde si nejste jistí. To obchází celý systém kontroly a v podstatě se vracíte k JavaScriptu. Místo toho zkuste použít unknown a pak pomocí kontrol typu (tzv. type guards) zúžit, co skutečně chcete povolit.