Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Migrácia kódu a frameworkov

Lekcia 10 z 20 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Bezpečná migrácia s Codexom
  2. Migrácie frameworkov
  3. Migrácie hlavných verzií
  4. Migrácie databáz
  5. Migrácie knižníc
  6. Stratégia postupnej migrácie
  7. Kľúčové poznatky

Bezpečná migrácia s Codexom

Migrácie frameworkov, knižníc a hlavných verzií patria medzi najrizikovejšie úlohy vo vývoji: zasahujú celý projekt naraz, nedajú sa urobiť napoly a vždy prídu v najnevhodnejšom možnom čase štvrťroka. Codex skracuje niekoľkodňovú migráciu na niekoľko hodín tým, že systematicky rieši zmeny v API a nekompatibility – presne tú časť, kde ľudská pozornosť začne po tridsiatom súbore poľavovať.

Migrácie frameworkov

Prechod na iný framework je najambicióznejší scenár a zvyčajne ten, ktorý skončí ako opustený projekt v dvojročnom tickete.

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

Inventár na začiatku promptu nie je len ozdoba: garantuje, že nezostane žiadny middleware позаду. Codex potom postupuje krok za krokom – analyzuje existujúcu konfiguráciu Express, vytvorí ekvivalentnú konfiguráciu pre Fastify, migruje každú trasu s upravenou syntaxou, vymení middlewary za ich ekvivalenty, aktualizuje testy a overí, že všetko prejde. Inštrukcia „trasu po trase“ ti navyše poskytne čitateľný diff, kde môžeš každú trasu skontrolovať izolovane bez rolovania cez ostatných štrnásť.

Migrácie hlavných verzií

Častejšie, no nemenej záludné sú aktualizácie hlavných verzií, pretože kritické zmeny nie sú sústredené, ale rozptýlené.

"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 sa spolieha na oficiálne poznámky k migrácii vo svojom kontexte a zmeny aplikuje systematicky. Venuj čas napísaniu týchto kľúčových bodov sám: počas vykonávania usmerňujú jeho vyhľadávanie a počas revízie slúžia ako tvoj kontrolný zoznam, čo zdvojnásobuje ich hodnotu.

Migrácie databáz

Pri zmenách schémy nie je problémom samotná SQL migrácia, ale všetok kód aplikácie, ktorý na nej závisí.

"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 zvládne všetky tri vrstvy v rámci jednej úlohy: schému Prisma, SQL migráciu a všetky referencie v aplikácii. Jednoduché premenovanie z email na primaryEmail sa typicky dotkne asi tridsiatich súborov, vrátane niekoľkých, ktoré nájdeš len ťažko naivným textovým vyhľadávaním – dynamicky zostavené pole, kľúč serializácie, mapovanie triedenia.

Migrácie knižníc

Nahradenie jednej knižnice inou si vyžaduje explicitné pomenovanie toho, čo musí zostať nezmenené.

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

Práve bod týkajúci sa časových pásiem zachraňuje migrácie dátumov: dve knižnice môžu na tvojom stroji produkovať identický výstup, no na UTC serveri sa môžu líšiť o hodinu. Pri tomto type práce sa rozsah zisku prejaví v nasledujúcej tabuľke.

Bežná migráciaManuálna dĺžkaDĺžka s Codexom
JavaScript na TypeScript1 – 2 týždne2 – 4 hodiny
REST na GraphQL2 – 3 týždne1 – 2 dni
Webpack na Vite2 – 5 dní2 – 4 hodiny
moment.js na date-fns1 – 3 dni30 minút – 2 hodiny

Stratégia postupnej migrácie

Tieto časové odhady predpokladajú jednopriechodové vykonanie, čo je rozumné len pre skromné projekty. Všade inde rozdeľ prácu na časti. Prvá fáza s úmyselne vymedzeným rozsahom stanoví konvencie, ktorými sa budú riadiť nasledujúce fázy:

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

Akonáhle je táto fáza overená a zlúčená, ďalšia fáza na ňu explicitne nadväzuje:

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

Výhody sú dvojaké. Riziko zostáva ohraničené, keďže neúspešnú fázu môžeš vrátiť späť, bez toho aby si zrušil zvyšok práce. A každá fáza vytvorí pull request, ktorý človek skutočne dokáže skontrolovať – rozhodujúce kritérium, pretože migrácia doručená ako jeden diff so šiestimi stovkami súborov sa nerekontroluje; schvaľuje sa z vyčerpania, čím sa zruší väčšina očakávaného prínosu.

Kľúčové poznatky

  • Migrácie sú úlohy, pri ktorých Codex prináša najväčší nárast produktivity
  • Do inštrukcií uveď kľúčové body špecifické pre tvoj projekt
  • Pri veľkých migráciách postupuj v postupných fázach
  • Codex aktualizuje kód, testy a závislosti v rámci jednej úlohy
  • Po migrácii vždy over funkčnosť plným zostavením a testami