Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Refaktoriranje i poboljšanje postojećeg koda

Lekcija 6 od 20 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Transformacija zastarjelog koda u moderni kod
  2. Strukturno refaktoriranje
  3. Modernizacija koda
  4. Poboljšanje kvalitete
  5. Refaktoriranje temeljeno na obrascima
  6. Verifikacija refaktoriranja
  7. Ključne točke

Transformacija zastarjelog koda u moderni kod

Refaktoriranje je jedan od najzahtjevnijih zadataka u razvoju, a rijetko nagrađivan: nitko ti ne čestita što si razbio datoteku od 800 redaka. Upravo se zato taj dug gomila, sprint za sprintom, dok ne postane pravi uzrok tvog usporavanja. Codex smanjuje sate ručnog rada na minute uz očuvanje postojećeg ponašanja – što je jedino što doista bitno kod refaktoriranja.

Strukturno refaktoriranje

Najčešći slučaj je univerzalna datoteka koje se nitko ne usuđuje dotaknuti jer je uvezena posvuda.

"Refactor src/utils/helpers.ts: this file is 800 lines long. 
Split it into thematic modules in src/utils/ (string.ts, 
date.ts, validation.ts, formatting.ts). Update all imports 
across the project."

Codex izvrsno rješava ovu vrstu zadataka: identificira funkcije, grupira ih po temama, stvara nove datoteke, a zatim ažurira sve uvoze u projektu. Taj posljednji korak obično je ono što odvraća od ručnog refaktoriranja – četrdeset datoteka za popravak, jedan propušteni uvoz i build puca u najgorem mogućem trenutku. Rezultat je objektivno provjerljiv: ako su testovi prolazili prije i dalje prolaze, razdvajanje je ispravno.

Modernizacija koda

Drugi veliki slučaj je prijelaz na moderne obrasce, gdje je transformacija mehanička, ali toliko ponavljajuća da se stalno odgađa u backlog.

"Migrate all callbacks in src/lib/database.ts to 
async/await. Preserve existing error handling."

Početna točka je JavaScript temeljen na povratnim pozivima (callbacks) s kaskadnim rukovanjem greškama:

function getUser(id, callback) {
  db.query("SELECT * FROM users WHERE id = ?", [id], 
    (err, rows) => {
      if (err) return callback(err);
      callback(null, rows[0]);
    });
}

Evo što Codex proizvodi:

async function getUser(id: string): Promise<User> {
  const rows = await db.query(
    "SELECT * FROM users WHERE id = ?", 
    [id]
  );
  return rows[0];
}

Tri se stvari dogodile u jednom prolazu: pojavile su se TypeScript vrste, povratni pozivi ustupili su mjesto async/await sintaksi, a rukovanje greškama pojednostavljeno jer se iznimke sada prirodno propagiraju. Poslovna logika ostaje identična – i to je upravo ono što provjeravaš u recenziji, a ne elegancija rezultata.

Poboljšanje kvalitete

Možeš ciljati i specifičnu dimenziju kvalitete umjesto sintaktičke transformacije, pod uvjetom da nabrojiš zahtjeve.

"In src/api/, improve error handling:
- Replace generic try/catch blocks with typed errors
- Add appropriate HTTP error codes
- Add logging with request context
- Ensure Prisma errors are mapped correctly"

Ovako formuliran, zahtjev postaje točka-po-točka provjerljiv tijekom recenzije. Samostalni upit „poboljšaj rukovanje greškama“ proizveo bi nešto uvjerljivo, ali neupotrebljivo, jer ni ti ni agent ne biste znali kada je cilj postignut.

Refaktoriranje temeljeno na obrascima

Najmoćnija varijanta uključuje označavanje već usklađene datoteke i zahtijevanje generalizacije.

"All React components in src/components/ that use 
useState for forms must migrate to react-hook-form. 
Apply the same pattern as src/components/LoginForm.tsx, 
which is already migrated."

Codex čita referentnu komponentu, izvlači obrazac i primjenjuje ga na ciljne komponente, pritom obrađujući rubne slučajeve – prilagođenu validaciju, nuspojave – umjesto da radi slijepu zamjenu. Praktična implikacija je zanimljiva: prva komponenta, koju migriraš sam, „plati“ za sve ostale. Uloži brigu u tu model-datoteku; vrijedi kao specifikacija.

Verifikacija refaktoriranja

Codex pokreće testove nakon svakog refaktoriranja, ali refaktoriranje koje prođe testove nije nužno spremno za isporuku. Četiri provjere čine minimum, a svaka adresira drugačiji rizik.

ProvjeraNaredbaŠto verificira
Jedinični testovinpm run testOčuvano ponašanje
Vrstenpx tsc --noEmitNema grešaka u vrstama
Lintanjenpm run lintPoštivanje konvencija
Buildnpm run buildSpremnost za produkciju

Tipičan slučaj koji opravdava ovaj popis: premještanje datoteka ostavlja testove zelenima jer one uvoze iz „barrel“ datoteke, ali ruši produkcijski build zbog kružnog uvoza koji ništa drugo ne otkriva. Dodaj ove četiri naredbe u svoju AGENTS.md datoteku i Codex će ih pokretati nakon svake promjene, bez da moraš razmišljati o tome ili ga podsjećati.

Ključne točke

  • Refaktoriranje je zadatak u kojem Codex donosi najveću uštedu vremena
  • Referenciraj model-datoteku kako bi vodio obrazac refaktoriranja
  • Codex ažurira uvoze i reference u cijelom projektu
  • Uvijek verificiraj s testovima, provjerom vrsta i buildom nakon refaktoriranja
  • Dokumentiraj naredbe za verifikaciju u AGENTS.md