Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Selitve kode in ogrodij

Lekcija 10 od 20 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Varno selite s Codexom
  2. Selitve ogrodij
  3. Selitve glavnih različic
  4. Selitve podatkovnih baz
  5. Selitve knjižnic
  6. Strategija postopne selitve
  7. Ključne ugotovitve

Varno selite s Codexom

Selitve ogrodij, knjižnic in glavnih različic so med najbolj tveganimi nalogami v razvoju: vplivajo na celoten projekt naenkrat, ne morejo biti narejene le na pol in se vedno zgodijo ob najslabšem možnem času v četrtletju. Codex skrajša večdnevno selitev na nekaj ur z sistematičnim obravnavanjem sprememb API-ja in nezdružljivosti – točno tistega dela, kjer človeška pozornost začne popuščati že okoli tridesete datoteke.

Selitve ogrodij

Zamenjava ogrodja je najbolj ambiciozen scenarij in običajno tisti, ki se konča kot opuščen projekt v dve leti starem listku.

"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."

Seznam na vrhu poziva ni okras: zagotavlja, da nobeno vmesno programje ne ostane za vami. Codex nato nadaljuje po vrstnem redu – analizira obstoječo konfiguracijo Express, ustvari enakovredno konfiguracijo Fastify, seli vsako pot s prilagojeno sintakso, zamenja vmesna programja z njihovimi ekvivalenti, posodobi teste in preveri, ali vse deluje. Navodilo „pot za potjo” vam kot bonus prinese berljivo razliko (diff), kjer lahko vsako pot pregledate ločeno, ne da bi se pomikali skozi ostalih štirinajst.

Selitve glavnih različic

Posodobitve glavnih različic so pogostejše, vendar nič manj zapletene, saj so prelomne spremembe razpršene namesto skoncentrirane.

"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 pri tem naslanja na uradna opomba o selitvi v svojem kontekstu in spremembe uporablja sistematično. Vzemite si čas, da te ključne točke zapišete sami: vodijo njegovo iskanje med izvajanjem in služijo kot vaš kontrolni seznam med pregledom, kar podvoji vrednost dela.

Selitve podatkovnih baz

Pri spremembah sheme težava nikoli ni sama selitev SQL, temveč vse v kodi aplikacije, kar je odvisno od nje.

"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 obravnava vse tri plasti v eni sami nalogi: shemo Prisma, selitev SQL in vse reference v aplikaciji. Preprosto preimenovanje iz email v primaryEmail običajno prizadene približno trideset datotek, vključno z nekaj takšnimi, ki jih naivno besedilno iskanje ne bo našlo – dinamično zgrajeno polje, ključ za serializacijo, preslikavo razvrščanja.

Selitve knjižnic

Zamenjava ene knjižnice z drugo zahteva izrecno poimenovanje tega, kar mora ostati nespremenjeno.

"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 časovnih pasovih je tista, ki reši selitve datumov: dve knjižnici lahko na vašem računalniku proizvedeta identičen izhod, na strežniku UTC pa se razlikujeta za eno uro. Pri tovrstnem delu se obseg prihranka kaže v spodnji tabeli.

Pogosta selitevTrajanje ročnoTrajanje s Codexom
JavaScript v TypeScript1–2 tedna2–4 ure
REST v GraphQL2–3 tedne1–2 dni
Webpack v Vite2–5 dni2–4 ure
moment.js v date-fns1–3 dni30 minut – 2 uri

Strategija postopne selitve

Ta trajanja predpostavljajo izvedbo v enem prehodu, kar je smiselno le za skromne projekte. Povsod drugje razbijte nalogo na dele. Namerno omejena prva faza vzpostavi konvencije, ki jim bodo sledile naslednje faze:

"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."

Ko je ta faza potrjena in združena, se naslednja izrecno naslanja nanjo:

"Phase 2: Migrate src/components/ from JavaScript to 
strict TypeScript. Use the same typing patterns as 
src/lib/ (phase 1 already migrated)."

Korist je dvojna. Tveganje ostaja omejeno, saj lahko neuspešno fazo povrnete, ne da bi razveljavili preostalo delo. In vsaka faza ustvari zahtevek za združitev (pull request), ki ga človek dejansko lahko pregleda – to je odločilno merilo, saj selitve, dostavljene kot ena sama razlika s šeststo datotekami, nihče ne pregleda; odobrijo se iz izčrpanosti, kar poniči večino pričakovane koristi.

Ključne ugotovitve

  • Selitve so naloge, pri katerih Codex prinaša največji dvig produktivnosti.
  • V svoja navodila vključite ključne točke, specifične za vaš projekt.
  • Pri večjih selitvah napredujte v postopnih fazah.
  • Codex v eni sami nalogi posodobi kodo, teste in odvisnosti.
  • Po selitvi vedno preverite delovanje s polnim gradnjem in testi.