Osm hodin na opravy chyb, nebo jejich odkládání?

Z Mazovia

Než sáhneš po rollbacku, zjisti, co přesně je v produkci. Porovnej aktuální stav s posledním známým dobrým vydáním: který tag nebo commit je nasazený, jaké migrace databáze proběhly a zda se změnila konfigurace mimo repozitář. Častá chyba je vrátit kód, ale zapomenout na migraci nebo na nové proměnné prostředí. Výsledkem je stav, který nikdy neexistoval, a chyba se jen posune jinam.

Konkrétní krok na závěr: jednou za čas projděte testy, které nikdy neselhaly, a zvažte, zda ještě něco ověřují. Smažte testy, které kopírují implementaci a brzdí refaktoring. Pokrytí berte jako orientační signál, ne jako známku. Když přestane říkat něco o riziku a chování systému, je čas ho opustit a měřit jiné věci.

Před zveřejněním si přečtěte celý text licence, ne jen zkratku. Většina běžných licencí má srozumitelné shrnutí, ale právně závazný je vždy plný text. Zaměřte se na to, co licence vyžaduje při distribuci: zda stačí přiložit text licence, zda je nutné uvádět změny, jak je to s patentovými doložkami a co se stane při kombinaci s jiným kódem. Právě tyto detaily rozhodují o tom, zda váš projekt budou moci ostatní bez problémů používat.

Typy pište tam, kde šetří práci, ne všude U parametrů funkcí a návratových hodnot se explicitní typy vyplatí, protože tvoří dokumentaci, kterou kompilátor vynucuje. Naopak u lokální proměnné stačí odvození: const pocet = 5 je číslo bez psaní anotace. Častá chyba je psát typy u všeho a pak je duplikovat s implementací. Když se změní struktura dat, anotace na mnoha místech zastarají. Držte typy na hranicích modulů — u exportovaných funkcí, veřejných rozhraní a dat z API.

Na konci bloku si zapiš, co zůstalo nedokončené a proč. Krátká poznámka pro příští blok ušetří půl hodiny znovuobjevování souvislostí. Osm hodin na opravy není o hrdinství, ale o rytmu: vybrat, opravit, ověřit, zapsat. Kdo tento rytmus dodrží, tomu se počet otevřených chyb začne skutečně snižovat, místo aby jen měnil strukturu seznamu.

Začněte minimálně. Do existujícího projektu přidejte TypeScript přes správce balíčků, vygenerujte tsconfig.json a nastavte strict: true. Pak přejmenujte jeden soubor na .ts a spusťte překlad. Typické první chyby bývají dva: zapomenutá konfigurace moduleResolution u importů z balíčků a volání any všude, kde kompilátor protestuje. any chybu ztiší, ale zároveň vypne kontrolu — používejte ho jen jako dočasnou záchrannou brzdu s komentářem, proč tam je.

Produkční chyba se neřeší tím, že se začne upravovat kód. První krok je zastavit škody: vypnout postiženou funkci přepínačem, vrátit konfiguraci nebo zablokovat problematickou cestu. Teprve potom se rozhoduje o rollbacku. Zapiš si čas, kdy chyba vznikla, jaký commit nebo konfigurační změna mu předcházela a kdo ji nasadil. Bez této kotvy se bude hledat příčina dvakrát tak dlouho.

Postupná migrace je realistická: zapněte allowJs, nechte staré soubory být a nové pište v TypeScriptu. Po každém kroku spouštějte testy i překlad, ať se chyby nehromadí. TypeScript se vyplatí tam, kde kód žije déle než jeden sprint a potkává se na něm víc lidí.

Pro data z vnějšího světa (odpovědi serveru, obsah souborů) nestačí typová anotace. as MojeData je jen tvrzení pro kompilátor, za běhu nic neověří. Pokud server pošle jiný tvar, aplikace spadne až při použití pole. Řešením je validace při vstupu: nebo knihovna pro schémata, která typ odvodí z validatoru. Potom máte jistotu, že data odpovídají typu, a nemusíte psát as.

Pozor na dvě věci, které odhad nafouknou zbytečně. První je započítávání review do každé dílčí položky zvlášť — vznikají malé rezervy, které se sčítají a ve výsledku přestřelí. Lepší je držet jednu rezervu na celý blok práce. Druhá je ignorování režie na přepínání kontextu: každé přečtení komentáře a návrat do kódu něco stojí, a pokud na zapracování nemáte souvislý blok, trvá déle, než by muselo. Naplánujte si na zapracování připomínek klidné okno, ne pětiminutové mezery mezi schůzkami.

Co sledovat místo jednoho procenta Užitečnější je kombinace několika pohledů. Sledujte, kolik rizikových cest je pokryto, kolik testů selhalo při poslední změně a jak dlouho běží celá sada. Pokud testy běží příliš dlouho, vývojáři je přestanou spouštět a pokrytí ztrácí hodnotu. Dobré je také zavést mutační testování na kritických modulech: to odhalí testy, které projdou, i když kód úmyslně rozbijete. Právě tam se ukáže, že vysoké pokrytí může být jen iluze.

Na závěr si napiš krátké pravidlo pro příští rollback: kdo rozhoduje, podle čeho pozná dobrý stav a co se ověří po návratu. Drž ho u sebe v repozitáři, ne v hlavě jednoho člověka. Když je postup napsaný a vyzkoušený, rollback přestane být improvizace a stane se rutinní operací, která zabere minuty místo hodin.