Migracije koda i frameworka
Na ovoj stranici
Sigurne migracije uz Codex
Migracije frameworka, knjižnica i glavnih verzija spadaju među najrizičnije zadatke u razvoju: zahvaćaju cijeli projekt odjednom, ne mogu se obaviti napola i uvijek se dogode u najgorem mogućem trenutku u kvartalu. Codex smanjuje višednevnu migraciju na nekoliko sati sustavnim rješavanjem promjena API-ja i nekompatibilnosti – točno onim dijelom gdje ljudska pažnja počinje popuštati oko tridesete datoteke.
Migracije frameworka
Zamjena frameworka najambiciozniji je scenarij i obično onaj koji završi kao napušteni projekt u ticketu starom dvije godine.
"Migrate the application from Express.js to Fastify.
The project uses Express with:
- 15 routes in src/routes/
- JWT authentication middleware
- Morgan logging middleware
- CORS middleware
- Centralized error handling
Migrate route by route, preserving existing tests."
Inventar na vrhu prompta nije ukras: jamči da nijedan middleware neće biti izostavljen. Codex zatim napreduje redom – analizira postojeću Express konfiguraciju, stvara ekvivalentnu Fastify konfiguraciju, migrira svaku rutu s prilagođenom sintaksom, zamjenjuje middlewaree njihovim ekvivalentima, ažurira testove i provjerava prolaze li svi. Uputa „ruta po ruta“ donosi bonus u obliku čitljive razlike (diff), gdje se svaka ruta može pregledati izolirano bez listanja kroz ostalih četrnaest.
Migracije glavnih verzija
Češće, nadogradnje glavnih verzija nisu ništa manje nezgodne jer su kritične promjene raspršene umjesto koncentrirane.
"Migrate the project from React 18 to React 19.
Key points:
- Replace forwardRef with native ref props
- Migrate useContext usage to the new pattern
- Update TypeScript types (@types/react)
- Verify third-party library compatibility"
Codex se oslanja na službene bilješke o migraciji u svom kontekstu i sustavno primjenjuje promjene. Odvoji vrijeme da sam napišeš ove ključne točke: one usmjeravaju njegovo pretraživanje tijekom izvršavanja i služe ti kao kontrolni popis tijekom pregleda, čime se vrijednost udvostručuje.
Migracije baza podataka
Kod promjena sheme, težina nikada nije u samoj SQL migraciji, već u svemu u kodu aplikacije što ovisi o njoj.
"The User model needs restructuring:
- Separate address into an Address model (1-N relationship)
- Rename email to primaryEmail
- Add an optional phone field
- Create the Prisma migration
- Update all services and routes using User
- Update tests"
Codex obrađuje sva tri sloja u jednom zadatku: Prisma shemu, SQL migraciju i sve reference u aplikaciji. Jednostavno preimenovanje iz email u primaryEmail obično zahvaća oko trideset datoteka, uključujući nekoliko onih koje naivno tekstualno pretraživanje neće pronaći – dinamički izgrađeno polje, ključ serijalizacije, mapiranje sortiranja.
Migracije knjižnica
Zamjena jedne knjižnice drugom zahtijeva eksplicitno navođenje onoga što mora ostati nepromijenjeno.
"Replace moment.js with date-fns throughout the project.
Ensure that:
- All date formats are preserved
- Duration calculations remain correct
- Date comparisons work properly
- Time zones are handled the same way"
Točka o vremenskim zonama je ono što spašava migracije datuma: dvije knjižnice mogu proizvesti identičan izlaz na tvojem računalu, a razilaziti se za sat vremena na UTC poslužitelju. Za ovakav rad, razmjera dobiti vidljiva je u donjoj tablici.
| Uobičajena migracija | Ručno trajanje | Trajanje uz Codex |
|---|---|---|
| JavaScript u TypeScript | 1-2 tjedna | 2-4 sata |
| REST u GraphQL | 2-3 tjedna | 1-2 dana |
| Webpack u Vite | 2-5 dana | 2-4 sata |
| moment.js u date-fns | 1-3 dana | 30 minuta - 2 sata |
Strategija progresivne migracije
Ova trajanja pretpostavljaju izvršavanje u jednom prolazu, što je razumno samo za skromne projekte. Svugdje drugdje, razbij zadatak na manje cjeline. Namjerno ograničena prva faza uspostavlja konvencije kojih će se kasnije faze držati:
"Phase 1: Migrate only src/lib/ from JavaScript to
strict TypeScript. Do not touch React components or
API routes. Add necessary types and fix typing errors."
Kada se ova faza validira i spoji, sljedeća se eksplicitno nadograđuje na nju:
"Phase 2: Migrate src/components/ from JavaScript to
strict TypeScript. Use the same typing patterns as
src/lib/ (phase 1 already migrated)."
Prednost je dvostruka. Rizik ostaje ograničen jer se neuspjela faza može vratiti bez poništavanja ostatka rada. Svaka faza proizvodi pull request koji čovjek stvarno može pregledati – odlučujući kriterij, jer migracija isporučena kao jedna razlika od šeststo datoteka ne biva pregledana; biva odobrena iz iscrpljenosti, čime se poništava većina očekivane koristi.
Ključne točke
- Migracije su zadaci u kojima Codex donosi najveći porast produktivnosti
- U svoje upute uključi ključne točke specifične za tvoj projekt
- Kod velikih migracija napreduj u progresivnim fazama
- Codex ažurira kod, testove i ovisnosti u jednom zadatku
- Nakon migracije uvijek izvrši potpunu izgradnju i testove za provjeru