Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Koodi ja raamistike migratsioonid

Õppetund 10 / 20 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Migreeri turvaliselt Codexiga
  2. Raamistike migratsioonid
  3. Põhiversioonide migratsioonid
  4. Andmebaaside migratsioonid
  5. Teekide migratsioonid
  6. Progressiivne migratsioonistrateegia
  7. Peamised punktid

Migreeri turvaliselt Codexiga

Raamistike, teekide ja põhiversioonide migratsioonid on arenduse ühed riskantseimad ülesanded: need mõjutavad korraga kogu projekti, neid ei saa teha poolikult ja need juhtuvad alati kvartali kõige ebasobivamal ajal. Codex vähendab mitu päeva kestva migratsiooni mõne tunnini, hallates süstemaatiliselt API muudatusi ja kokkusobimatust – täpselt seda osa, kus inimese tähelepanu hakkab umbes kolmekümnenda faili juures hajuma.

Raamistike migratsioonid

Raamistiku vahetamine on kõige ambitsioonikam stsenaarium ja tavaliselt see, mis lõpeb kaheaastase piletina seisva mahajäetud projektina.

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

Viiba ülaosas olev inventar ei ole iluasi: see garanteerib, et ükski vahevara (middleware) ei jääks maha. Codex jätkab seejärel järjekorras – analüüsib olemasolevat Expressi konfiguratsiooni, loob samaväärse Fastify konfiguratsiooni, migreerib iga marsruudi kohandatud süntaksiga, vahetab vahevarad nende ekvivalentide vastu, uuendab teste ja veendub, et kõik läbib. Juhis „marsruut marsruudi haaval“ annab boonuseks loetava diffi, kus iga marsruuti saab üksteisest sõltumatult üle vaadata, ilma et peaks läbi kerima ülejäänud neliteist.

Põhiversioonide migratsioonid

Sagedasemad põhiversiooni uuendused pole vähem keerulised, kuna pöördumatud muudatused on hajutatud, mitte koondatud.

"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 tugineb oma kontekstis ametlikele migratsioonimärkmetele ja rakendab muudatusi süstemaatiliselt. Võta aega, et kirjutada need põhipunktid ise: need suunavad selle otsingut täitmise ajal ja toimivad sinu kontrollnimekirjana ülevaatamisel, mis kahekordistab väärtust.

Andmebaaside migratsioonid

Skeemi muudatuste puhul ei peitu raskus kunagi SQL-i migratsioonis endas, vaid kogu rakenduse koodis, mis sellest sõltub.

"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 haldab kõiki kolme kihti ühe ülesandena: Prisma skeemi, SQL-i migratsiooni ja kõiki rakenduse viiteid. Lihtne ümbernimetamine email-ist primaryEmail-iks puudutab tüüpiliselt umbes kolmekümmet faili, sealhulgas mõnda, mida naiivne tekstiotsing ei leia – dünaamiliselt loodud väli, serialiseerimise võti, järjestuse kaardistus.

Teekide migratsioonid

Ühe teegi asendamine teisega nõuab selgesõnalist nimetamist, mis peab jääma muutumatuks.

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

Ajavööndite punkt on see, mis päästab kuupäevade migratsioonid: kaks teeki võivad sinu masinas toota identset väljundit ja lahknevad UTC-serveris tunni võrra. Seda tüüpi töö puhul ilmneb kasu ulatus allolevas tabelis.

Levinud migratsioonKäsitsi kestusKestus Codexiga
JavaScriptist TypeScripti1–2 nädalat2–4 tundi
REST-ist GraphQLi2–3 nädalat1–2 päeva
Webpackist Vite’i2–5 päeva2–4 tundi
moment.js-ist date-fns-i1–3 päeva30 minutit – 2 tundi

Progressiivne migratsioonistrateegia

Need kestused eeldavad ühekordset täitmist, mis on mõistlik vaid tagasihoidlike projektide puhul. Mujal tuleb see osadeks jagada. Tahtlikult piiratud esimene etapp kehtestab konventsioonid, mida järgmised etapid järgivad:

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

Kui see etapp on valideeritud ja liidetud, tugineb järgmine sellele sõnaselgelt:

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

Kasu on kahekordne. Risk jääb piiratuks, kuna ebaõnnestunud etapi saab tühistada, ilma et peaks ülejäänud töö tagasi pöörama. Ja iga etapp toodab tõmbetaotluse (pull request), mida inimene tegelikult üle vaadata saab – otsustav kriteerium, sest migratsiooni, mis esitatakse ühe kuuesaja failiga diffina, ei vaadata üle; see kinnitatakse kurnatusest, mis tühistab suurema osa oodatavast kasust.

Peamised punktid

  • Migratsioonid on ülesanded, kus Codex pakub suurimat tootlikkuse kasvu
  • Loetle oma juhistes oma projekti põhipunktid
  • Tegutse suurte migratsioonide korral progressiivsetes etappides
  • Codex uuendab koodi, teste ja sõltuvusi ühe ülesandena
  • Kontrolli pärast migratsiooni alati täieliku buildi ja testidega