Jak zavést efektivní git workflow pro váš tým

Git sám o sobě je jen nástroj. Skutečná hodnota se objeví až ve chvíli, kdy celý tým sdílí stejná pravidla práce s větvemi, commity a revizemi. Bez jasného workflow vzniká chaos: konflikty se řeší ukvapeně, historie se stává nepřehlednou a nasazování do produkce je riskantní. Základním kamenem je proto dohoda na jednom modelu, který všichni dodržují.

Když už zvládáš jednoduché volání, zkus přidat parametry dotazu. Třeba pro filtr nebo stránkování. To je častý bod, kde začátečníci tápou – nevědí, jestli parametry patří do URL, nebo do těla. Pro GET je používej v URL za otazníkem, pro POST je dej do těla jako JSON. Vždy si přečti dokumentaci konkrétního API, protože formát se liší. A hlavně: nikdy neposílej citlivé údaje v URL – může se ti to vymstít v logách.

Nejdůležitější dovednost: číst chybové odpovědi Chyby nejsou nepřítel, ale zpětná vazba. Když server vrátí status 404, neznamená to „selhal jsem", ale „adresa neexistuje". Status 401 nebo 403 zase říká, že nemáš oprávnění. Místo paniky se nauč číst hlavičky odpovědi a tělo chyby. Mnoho API vrací detailní popis problému v JSON. Zkopíruj si chybovou hlášku do vyhledávače (ale pozor, ne sem) a najdeš řešení. Typická začátečnická chyba je ignorovat status a rovnou zpracovávat data, která možná ani nepřišla.

Důležité je také pochopit, jak funguje rozložení. Naučte se používat základní komponenty jako textová pole, tlačítka a seznamy. Nebojte se experimentovat s různými typy rozložení, ale začněte s jednoduchým lineárním uspořádáním. Pozor na to, že příliš složité rozložení může způsobit pomalé vykreslování. Vždy se snažte o jednoduchost a čitelnost kódu.

Častým začátečnickým omylem je zapomínat na oprávnění. Pokud vaše aplikace potřebuje přístup k internetu, fotoaparátu nebo úložišti, musíte tato oprávnění deklarovat v konfiguračním souboru manifestu. Bez toho aplikace spadne nebo nebude fungovat podle očekávání. Vyzkoušejte si na malém projektu, jak oprávnění přidat a jak je správně vyžádat.

Při psaní první aplikace se vyhněte běžné chybě – kopírování kódu bez pochopení. Místo toho si zkuste upravit text na obrazovce, přidat tlačítko a nastavit mu akci. Tím pochopíte, jak funguje propojení mezi rozložením a kódem. Užitečné je také naučit se používat logování, protože vám pomůže odhalit, co se v aplikaci děje. Pokud narazíte na chybu, čtěte pozorně hlášení – obvykle přesně říká, kde je problém.

Další past je přeposílání požadavků stále dokola. Mnoho API má limity – kolikrát za minutu můžeš volat. Pokud je překročíš, dostaneš status 429 (příliš mnoho požadavků). Řešení? Přidej do svého kódu čekání mezi požadavky, nebo implementuj zpětné čekání, když server odpoví 429. Nezapomeň také na to, že některé API potřebují hlavičku s autorizačním tokenem. Bez ní ti vrátí 401, i když je adresa správná. Ukládej token neveřejně, ideálně do proměnné prostředí, ne přímo do zdrojového kódu.

Začni s voláním GET na veřejné API, které nevyžaduje registraci ani klíč. Otevři si terminál a použij nástroj pro příkazovou řádku, nebo si vytvoř malý skript v jazyce, který už znáš. Tvůj první požadavek může být jen načtení dat ve formátu JSON. Odpověď si vytiskni na obrazovku. Důležité je sledovat, jakou strukturu data mají – jestli je to pole, objekt, nebo vnořený objekt. To je základ pro to, abys uměl data zpracovat dál.

Typickou chybou je čekat s napojením na hlavní větev až do konce úkolu. To vede k velkým konfliktům, které se špatně řeší. Místo toho si větev aktualizujte průběžně, klidně každý den. Druhým častým problémem je nedostatečná granularita commitů. Každý commit by měl být samostatnou logickou jednotkou – oprava překlepu, přidání testu, nová funkce. Vyhnete se tomu, že v jednom commitu smícháte tři nesouvisející věci, které pak nejdou snadno vrátit.

Skryté činnosti nejde odstranit, ale lze je odhadnout. Začněte si je zapisovat, počítejte s nimi a kontrolujte zpětně. Po třech až pěti úkolech uvidíte strukturu, která vám umožní dělat odhady, na které se dá spolehnout. Výsledkem nebude dokonalý plán, ale mnohem menší stres z nepředvídaných prodlev a lepší komunikace s ostatními.

Code review by mělo být povinné a rychlé. Ideálně do 24 hodin, jinak se práce zablokuje. Recenzent se zaměřuje na logiku, čitelnost a na to, zda změna skutečně řeší daný úkol. Nenechte se unést stylem a drobnostmi – to odvádí pozornost. Pokud narazíte na větší problém, rovnou to napište do komentáře a nechte autora opravit. Po schválení slučte větev pomocí merge commitu, který zachovává kontext celé větve.