Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Migrace kódu a frameworků

Lekce 10 z 20 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Bezpečná migrace s Codexem
  2. Migrace frameworků
  3. Migrace hlavních verzí
  4. Migrace databází
  5. Migrace knihoven
  6. Strategie progresivní migrace
  7. Klíčové poznatky

Bezpečná migrace s Codexem

Migrace frameworků, knihoven a hlavních verzí patří mezi nejrizikovější úkoly ve vývoji: zasahují celý projekt najednou, nelze je udělat napůl a vždy přijdou v tu nejhorší možnou chvíli čtvrtletí. Codex zkrátí migraci trvající několik dní na pár hodin tím, že systematicky řeší změny v API a nekompatibility – přesně tu část, kde lidská pozornost kolem třicátého souboru začíná slábnout.

Migrace frameworků

Přechod na jiný framework je nejambicióznější scénář a obvykle ten, který skončí jako opuštěný projekt v dvouletém ticketu.

"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ář v horní části promptu není jen ozdoba: zaručuje, že žádný middleware nezůstane pozadu. Codex poté postupuje krok za krokem – analyzuje stávající konfiguraci Express, vytvoří ekvivalentní konfiguraci pro Fastify, migruje každou trasu s upravenou syntaxí, nahradí middlewary jejich ekvivalenty, aktualizuje testy a ověří, že vše prochází. Pokyn „trasu po trase“ ti navíc poskytne přehledný diff, kde lze každou trasu zkontrolovat izolovaně, aniž bys musel procházet ostatních čtrnáct.

Migrace hlavních verzí

Častější upgrady hlavních verzí nejsou o nic méně záludné, protože kritické změny jsou rozptýlené místo toho, aby byly soustředěné.

"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 spoléhá na oficiální poznámky k migraci ve svém kontextu a změny aplikuje systematicky. Vezmi si čas a tyto klíčové body si napiš sám: řídí jeho hledání během provádění a slouží ti jako kontrolní seznam při revizi, čímž zdvojnásobíš jejich hodnotu.

Migrace databází

U změn schématu není obtížnost nikdy v samotné SQL migraci, ale ve všem kódu aplikace, který na ní 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šechny tři vrstvy v rámci jednoho úkolu: schéma Prisma, SQL migraci a všechny reference v aplikaci. Prosté přejmenování z email na primaryEmail se typicky dotkne asi třiceti souborů, včetně několika, které naivní textové hledání nenajde – dynamicky vytvářeného pole, klíče serializace nebo mapování řazení.

Migrace knihoven

Nahrazení jedné knihovny jinou vyžaduje explicitní pojmenování toho, co musí zůstat neměnné.

"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ávě bod týkající se časových pásem zachraňuje migrace dat: dvě knihovny mohou na tvém stroji produkovat identický výstup, ale na serveru UTC se mohou lišit o hodinu. U tohoto typu práce se měřítko zisku projeví v následující tabulce.

Běžná migraceRuční doba trváníDoba trvání s Codexem
JavaScript na TypeScript1–2 týdny2–4 hodiny
REST na GraphQL2–3 týdny1–2 dny
Webpack na Vite2–5 dní2–4 hodiny
moment.js na date-fns1–3 dny30 minut – 2 hodiny

Strategie progresivní migrace

Tyto časy předpokládají provedení v jediném průchodu, což je rozumné pouze pro malé projekty. Všude jinde úkol rozděl. První fáze s cíleným rozsahem stanoví konvence, kterými se budou řídit následné fáze:

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

Jakmile je tato fáze ověřena a sloučena, další na ni explicitně navazuje:

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

Výhoda je dvojnásobná. Riziko zůstává ohraničené, protože neúspěšnou fázi lze vrátit zpět, aniž by se zrušila zbytek práce. A každá fáze vytvoří pull request, který člověk skutečně zkontroluje – což je rozhodující kritérium, protože migrace dodaná jako jeden diff o šesti stech souborech se nereviduje; schvaluje se z vyčerpání, což ruší většinu očekávaného přínosu.

Klíčové poznatky

  • Migrace jsou úkoly, kde Codex přináší největší nárůst produktivity
  • Do svých pokynů uveď klíčové body specifické pro tvůj projekt
  • U velkých migrací postupuj v progresivních fázích
  • Codex aktualizuje kód, testy a závislosti v rámci jednoho úkolu
  • Po migraci vždy proveď ověření pomocí úplného buildu a testů