Selitve kode in ogrodij
Na tej strani
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 selitev | Trajanje ročno | Trajanje s Codexom |
|---|---|---|
| JavaScript v TypeScript | 1–2 tedna | 2–4 ure |
| REST v GraphQL | 2–3 tedne | 1–2 dni |
| Webpack v Vite | 2–5 dni | 2–4 ure |
| moment.js v date-fns | 1–3 dni | 30 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.