Migrace kódu a frameworků
Na této stránce
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á migrace | Ruční doba trvání | Doba trvání s Codexem |
|---|---|---|
| JavaScript na TypeScript | 1–2 týdny | 2–4 hodiny |
| REST na GraphQL | 2–3 týdny | 1–2 dny |
| Webpack na Vite | 2–5 dní | 2–4 hodiny |
| moment.js na date-fns | 1–3 dny | 30 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ů