Co se stane, když začnete verzovat až pozdě
Na závěr: navrhujte API podle toho, co klient potřebuje, ne podle toho, jak je databáze postavená dnes. Držte stabilní identifikátory, neměňte význam polí, připravte verzování a testujte staré klienty proti novému rozhraní. Tím se změna modelu stane rutinou místo odstávky.
Při výběru nástroje pro práci s daty se často rozhoduje mezi dvěma krajními polohami: grafickým databázovým prostředím a psaním dotazů v SQL. Ve skutečnosti nejde o volbu jednoho z nich, ale o to, jak dobře spolu budou v praxi fungovat. Než začnete cokoli porovnávat, zapište si, co budete dělat nejčastěji. Jiné nároky má člověk, který několikrát denně prochází tabulky a filtruje záznamy, jiné ten, kdo připravuje složitější transformace a kontrolní dotazy. Podle toho se odvíjí, zda má smysl investovat čas do naučení SQL, nebo zda postačí nástroj s vizuálním rozhraním.
Praktický postup je jednoduchý: u každé závislosti si poznamenejte název, verzi, licenci a místo, odkud byla stažena. Tyto údaje udržujte pohromadě s projektem a aktualizujte je při každé změně. Při pochybnostech se ptejte autora nebo právníka, ne kolegů od vedlejšího stolu. A pokud licenci nerozumíte, raději kód nepoužívejte, dokud si podmínky nevyjasníte. Ušetříte si tím pozdější složité vysvětlování.
Začni krátkým shrnutím v první řadě, ideálně do padesáti znaků. Piš v rozkazovacím způsobu a v přítomném čase: „Přidej validaci e-mailu do registrace", „Odstraň duplicitní načítání seznamu". První řada musí dávat smysl sama o sobě, protože právě ji vidíš v logu bez dalšího kontextu. Nedávej na konec tečku a nepíš velkými písmeny celou větu.
Prvním konkrétním krokem je ověření, zda nástroj umožňuje zobrazit vygenerovaný SQL dotaz. Dobré prostředí vám po každé akci v rozhraní ukáže, co přesně poslalo databázi. To je nejrychlejší způsob, jak se učit a zároveň kontrolovat, že vizuální operace nedělá něco jiného, než očekáúložné prostory v malém bytěáte. Pokud nástroj tuto možnost nemá, ztrácíte přehled a při chybě nemáte čím ladit. Druhým krokem je vyzkoušet, zda lze vlastní SQL dotaz vložit přímo a zda se výsledek dá dál filtrovat nebo exportovat. Právě kombinace obojího bývá v praxi nejcennější.
Rozhodující je také to, kdo bude s nástrojem pracovat. Pokud tým tvoří lidé bez zkušeností s SQL, potřebují prostředí, které je nenechá omylem smazat data a které jim ukáže srozumitelné chyby. Tam, kde se pracuje s reporty a opakovanými dotazy, je naopak výhodnější trvat na tom, aby každý uměl alespoň základy SQL a rozuměl tomu, co nástroj posílá do databáze. Výběr tak není otázkou preferencí, ale toho, jaké dovednosti chcete v týmu udržet a rozvíjet.
Nakonec počítejte s tím, že první verze nebude hotová. Cílem není dokonalá aplikace, ale funkční řetězec od nápadu přes kód a test v emulátoru až po běh na skutečném telefonu. Když tento řetězec zvládnete bez výmluv, máte základ, na kterém se dá stavět dál.
Typické chyby: míchání nesouvisejících změn do jednoho commitu, obecné zprávy bez kontextu, odkazy na interní čísla úkolů bez vysvětlení a zprávy psané z pohledu minulosti („opravil jsem"). Vyhni se i commitům, které jen říkají „WIP" a zůstanou v hlavní větvi. Pokud potřebuješ uložit rozdělanou práci, použij dočasnou větev, ne trvalou historii.
Emulátor jako první krok, telefon jako kontrola Emulátor nastavte na zařízení s běžným rozlišením a verzí systému, která pokrývá většinu uživatelů. Spouštění je rychlé, můžete snadno měnit konfiguraci a ladit. Pozor ale na dvě věci: emulátor má jiný výkon a jiné senzory než skutečný přístroj, takže plynulost animací nebo chování vypadat lépe, než ve skutečnosti jsou. Druhá častá chyba je testovat jen na nejnovější verzi systému; aplikace se pak rozbije na starších zařízeních, kde chybí novější rozhraní.
Než commit dokončíš, přečti si zprávu očima někoho, kdo o změně nic neví. Pokud musíš dohledávat souvislosti, zpráva je nedostatečná. Dobrá zpráva šetří čas při hledání příčiny chyby, při code review i při návratu k vlastní práci po měsících.
Repozitář vytvoříte v prázdné složce příkazem git init. Tím vznikne skrytá složka, kam Git ukládá celou historii. Před prvním commitem nastavte jméno a e-mail příkazy git config --global user.name a git config --global user.email. Bez toho Git odmítne commit dokončit. Potom přidejte soubory do přípravy pomocí git add . a uložte snímek příkazem git commit -m "První verze". Zpráva commitu má stručně popsat, co se změnilo, ne co jste měli k obědu.
Verzování řešte dřív, než ho budete potřebovat Verzi nedávejte do cesty, pokud to není nutné, ale mějte připravený mechanismus. Kompatibilní změny – přidání volitelného pole, nová hodnota výčtu, nový koncový bod – se dají dělat přímo. Nekompatibilní změny, jako je odebrání pole nebo změna typu, potřebují novou verzi nebo souběžnou existenci obou podob. Typická chyba je měnit význam existujícího pole: klient, který posílá hodnotu v metrech, ji najednou pošle v centimetrech a nikdo si toho nevšimne. Význam pole se nesmí měnit; místo toho přidejte pole nové a staré označte za zastaralé s jasným datem konce.