Refaktoring, alebo prepísať od nuly? Ako sa rozhodnúť

Refaktoring je úprava kódu, ktorá zlepší jeho štruktúru a nezmení, čo softvér robí. Refaktoring, alebo prepis od nuly, je rozhodnutie o tom, koľko mesiacov roadmapy ste ochotní zastaviť. Väčšinou vyhrá refaktoring po malých krokoch, lebo produkt počas neho ďalej zarába.

Prepis od nuly dáva zmysel v troch prípadoch: kód robí nesprávnu vec, nevlastníte ho, alebo stojí na technológii bez podpory. Nižšie je rozhodovacia tabuľka a postup, ako refaktorovať bez zastavenia roadmapy.

AI dnes píše všetok náš kód a za výsledok ručí senior. Filip predtým roky vyvíjal SaaS, ktorý denne používalo 60 000+ ľudí. Ani raz sa neprepisoval od nuly. Menil sa malými zmenami cez review, priamo v živom produkte.

Prečo je veľký prepis takmer vždy drahší, ako sa zdá?

Prepis vyzerá čisto, lebo nový kód ešte nemá históriu. Tú históriu však potrebujete. Za každou čudnou podmienkou v starom kóde býva niečia reklamácia.

Najčastejšie dôvody, prečo sa prepis predraží:

Kedy refaktorovať a kedy prepísať: rozhodovacia tabuľka

Pozor na posledný riadok. „Nikto tomu nerozumie“ je najčastejší argument za prepis. Zároveň najhorší. Nový tím, ktorý starému kódu nerozumie, ho prepíše bez opráv, ktoré v ňom sú.

Prepis býva aj najjednoduchší upsell. Pri audite produktu jedného zakladateľa sa ponúkali monorepo a prepis backendu do TypeScriptu. Napísali sme opak: repozitáre sú v poriadku, TypeScript pridávajte po moduloch a začnite prihlásením a právami.

Ako refaktorovať bez zastavenia roadmapy?

AI tu robí to, čo je pomalé a nudné. Testy na existujúce správanie, presuny kódu, premenovania. Senior rozhoduje, čo sa mení a v akom poradí. Aké pravidlá na to AI dávame, opisujeme v článku Pravidlá pre AI kód v tíme.

Bez testov a review vám AI dlh len zrýchli. Preto hovoríme, že agent je model plus rámec. Rámec je to, čo zlú zmenu zastaví.

Kedy je prepis od nuly správna voľba?

Keď kód nevlastníte. Ak pôvodný systém nepatrí vám, nie je čo refaktorovať: postaví sa nový a dáta sa presunú.

Aj pri prepise platí rovnaké poradie. Najprv dáta a pochopenie, čo systém naozaj robí. Potom obrazovka po obrazovke, nie všetko v jeden deň.

Pred rozhodnutím si prejdite šesť bodov. Zaškrtnite, čo o vašom systéme platí:

Najviac váži štvrtý bod. Ak kód robí správnu vec, len zle, refaktorujte.

Kedy to neodporúčame

• Máte seniora, ktorý systém pozná a má naň čas. Refaktorujte sami. Tabuľka vyššie vám stačí.
• Systém sa o pár mesiacov vypína. Neinvestujte do kódu, ktorý končí. Investujte do presunu dát.

Chcete rozhodnúť s niekým, kto to robí denne?

Senior sa zapojí do vášho repozitára a pull requestov od prvého týždňa. Najprv testy, potom zmeny po malých krokoch a roadmapa beží ďalej. Takto pracujeme ako externý vývojár pre produktový tím.

Napíšte nám, ktorá časť kódu vás brzdí. Ozveme sa do dvoch pracovných dní a spolu vyberieme, čo vyriešime ako prvé.

Ak sa chcete najprv porozprávať, dohodnite si meeting na 15 minút s Filipom.

Ktorú časť vášho kódu by ste najradšej zahodili, a prečo?

Časté otázky

Kedy refaktorovať a kedy prepísať kód od nuly?

Refaktorujte, keď kód robí správnu vec, ale ťažko sa mení. Prepíšte, keď robí nesprávnu vec, kód nevlastníte alebo technológia stratila podporu. Aj vtedy prepisujte po častiach, nie naraz.

Dá sa refaktorovať bez testov?

Dá, ale je to hazard. Najprv napíšte testy na súčasné správanie, aj s jeho chybami. Až potom meňte kód. Bez testov sa o chybe dozviete od zákazníka.

Ako dlho trvá refaktoring?

Nemá pevný koniec a to je v poriadku. Robí sa priebežne v bežných pull requestoch, tam, kde práve pracujete. Samostatný refaktoringový projekt na mesiace sa väčšinou nedokončí.

Pomôže AI s refaktoringom?

Áno, pri písaní testov, presunoch kódu a premenovaniach. Rozhodnutie, čo meniť a v akom poradí, ostáva na seniorovi. Bez testov a review AI chyby len zrýchli.