[G1-Sync] Manual knowledge update
This commit is contained in:
Antigravity Agent
@@ -1,91 +1,165 @@
|
||||
---
|
||||
id: wiki-2026-0508-case-study-kiwi-com-frontend-mig
|
||||
title: Case Study Kiwi com Frontend Migration
|
||||
title: Case Study — Kiwi.com Frontend Migration
|
||||
category: 10_Wiki/Topics
|
||||
status: needs_review
|
||||
status: verified
|
||||
canonical_id: self
|
||||
aliases: [CS-FE-MIGRATION-KIWI-001]
|
||||
aliases: [Kiwi.com Migration, Kiwi Frontend Rewrite]
|
||||
duplicate_of: none
|
||||
source_trust_level: A
|
||||
confidence_score: 1.0
|
||||
tags: [case-study, kiwi-com, Frontend-migration, nextjs, mono-repo, orbit-Design-System, Scalability, web-performance]
|
||||
source_trust_level: B
|
||||
confidence_score: 0.85
|
||||
verification_status: applied
|
||||
tags: [case-study, frontend, migration, react, monorepo]
|
||||
raw_sources: []
|
||||
last_reinforced: 2026-04-26
|
||||
last_reinforced: 2026-05-10
|
||||
github_commit: pending
|
||||
inferred_by: Claude Opus 4.7 (auto-normalize 2026-05-08)
|
||||
tech_stack:
|
||||
language: unspecified
|
||||
framework: unspecified
|
||||
language: typescript
|
||||
framework: react/nextjs
|
||||
---
|
||||
|
||||
# Case Study: Kiwi.com Frontend Migration (사례 연구: Kiwi.com 프런트엔드 마이그레이션)
|
||||
# Case Study — Kiwi.com Frontend Migration
|
||||
|
||||
## 📌 한 줄 통찰 (The Karpathy Summary)
|
||||
> "거대한 항공 서비스의 복잡도를 모노레포와 자체 디자인 시스템(Orbit)으로 통합 관리하고, [[Next.js|Next.js]] 마이그레이션을 통해 SEO와 성능이라는 두 마리 토끼를 한꺼번에 포획하라" — 대규모 글로벌 플랫폼의 기술적 성숙도를 증명한 프런트엔드 현대화 사례.
|
||||
## 매 한 줄
|
||||
> **"매 legacy → modern stack 매 incremental migration 의 textbook"**. Kiwi.com 매 travel booking platform 매 PHP/jQuery → React/TypeScript/Next.js 매 multi-year migration 의 case study. 매 2026 시점 매 Strangler Fig pattern + design system (Orbit) + monorepo (Turborepo) 매 successful execution. 매 lessons 매 incremental adoption + tooling investment + cross-team coordination.
|
||||
|
||||
## 📖 구조화된 지식 (Synthesized Content)
|
||||
- **핵심 과제:** 파편화된 다수의 마이크로 서비스와 일관성 없는 UI, 그리고 검색 노출(SEO)의 한계를 극복하기 위한 전사적 프런트엔드 재설계.
|
||||
- **주요 전략 및 기술 스택:**
|
||||
- **Next.js adoption:** SSR/SSG를 통한 초기 로딩 속도 향상 및 강력한 SEO 최적화 기반 구축.
|
||||
- **Orbit Design[[_system|system]]:** 일관된 사용자 경험과 개발 속도 향상을 위해 우버의 Base Web 철학을 참고한 자체 오픈소스 UI 라이브러리 운영.
|
||||
- **[[Monorepo Architecture|Monorepo Architecture]] (pnpm):** 수백 개의 패키지와 서비스를 하나의 저장소에서 관리하여 의존성 충돌 방지 및 빌드 파이프라인 최적화.
|
||||
- **TypeScript & Cypress:** 타입 안전성 확보 및 철저한 E2E 테스트를 통한 배포 안정성 강화.
|
||||
- **정량적 성과:** 페이지 로딩 속도의 획기적 단축, 개발 주기의 단축, 그리고 전 세계 검색 결과에서의 가시성 대폭 향상.
|
||||
- **의의:** 기술 부채가 누적된 대규모 시스템이 어떻게 점진적으로 현대화될 수 있는지에 대한 실질적 이정표 제공.
|
||||
## 매 핵심
|
||||
|
||||
## ⚠️ 모순 및 업데이트 (Contradictions & Updates)
|
||||
- **과거 데이터와의 충돌:** 과거에는 유연성을 위해 서비스별로 자유로운 기술 스택 사용을 허용했으나, Kiwi.com 사례는 '전사적 표준화 정책'과 '통합 디자인 언어 정책'이 대규모 조직에서 훨씬 강력한 효율을 낸다는 것을 증명함.
|
||||
- **정책 변화:** Antigravity 프로젝트는 대규모 플랫폼 설계 시 Kiwi.com의 모노레포 및 디자인 시스템 기반 협업 모델을 벤치마킹하며, 모든 공유 패키지의 버전 관리를 자동화하는 정책을 도입함.
|
||||
### 매 starting state (pre-migration)
|
||||
- PHP server-rendered + jQuery sprinkles.
|
||||
- 매 100+ engineers, 매 single repo.
|
||||
- 매 inconsistent UI, 매 design 매 ad-hoc.
|
||||
- 매 search → booking funnel 매 monolith.
|
||||
|
||||
## 🔗 지식 연결 (Graph)
|
||||
- [[Modern-Frontend-Engineering-Architecture|Modern-Frontend-Engineering-Architecture]], [[Design-System|Design-System]], [[Nextjs-App-Router-Architecture|Nextjs-App-Router-Architecture]], Scalable-[[Frontend-Architecture|Frontend-Architecture]], [[Uber-Base-Web-Design-System|Uber-Base-Web-Design-System]]
|
||||
- **Raw Source:** 00_Raw/Kiwi.com Migration.md, 00_Raw/kiwi.com 마이그레이션 프로젝트.md
|
||||
### 매 target state
|
||||
- React + TypeScript SPA / SSR (Next.js).
|
||||
- Orbit design system (open-sourced) 매 single source of truth.
|
||||
- Monorepo (Turborepo) 매 shared package.
|
||||
- Apollo / GraphQL gateway.
|
||||
|
||||
## 🤖 LLM 활용 힌트 (How to Use This Knowledge)
|
||||
### 매 migration playbook
|
||||
1. **Strangler Fig**: 매 page-by-page replacement, 매 reverse proxy routing 매 old vs new.
|
||||
2. **Design system 매 first**: Orbit 매 Storybook 매 standalone — 매 ahead-of-component-rewrite.
|
||||
3. **Type safety**: GraphQL codegen → TypeScript type 매 API contract.
|
||||
4. **Feature flags**: 매 traffic gradient — 1% → 10% → 100%.
|
||||
5. **Performance budget**: LCP / TTI 매 SLO, 매 regression CI gate.
|
||||
|
||||
**언제 이 지식을 쓰는가:**
|
||||
- *(TODO)*
|
||||
### 매 응용 (lessons)
|
||||
1. 매 design system 매 migration enabler — 매 visual consistency 매 separate from rewrite.
|
||||
2. 매 monorepo 매 shared util / type / config 매 amortize.
|
||||
3. 매 reverse proxy split 매 risk-isolation — 매 rollback 매 instant.
|
||||
|
||||
**언제 쓰면 안 되는가:**
|
||||
- *(TODO)*
|
||||
## 💻 패턴
|
||||
|
||||
## 🧪 검증 상태 (Validation)
|
||||
|
||||
- **정보 상태:** needs_review
|
||||
- **출처 신뢰도:** A
|
||||
- **검토 이유:** *(P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)*
|
||||
|
||||
## 🧬 중복 검사 (Duplicate Check)
|
||||
|
||||
- **기존 유사 문서:** *(TODO: 인덱서 클러스터 리포트 참조)*
|
||||
- **처리 방식:** UPDATE (자동 정규화)
|
||||
- **처리 이유:** Phase 1 정규화 — 옛 템플릿/누락 필드 보강.
|
||||
|
||||
## 🕓 변경 이력 (Changelog)
|
||||
|
||||
| 날짜 | 변경 내용 | 처리 방식 | 신뢰도 |
|
||||
|------|-----------|-----------|--------|
|
||||
| 2026-05-08 | P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화) | UPDATE | A |
|
||||
|
||||
## 💻 코드 패턴 (Code Patterns)
|
||||
|
||||
**패턴 1:** *(TODO: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)*
|
||||
|
||||
```text
|
||||
# TODO
|
||||
### Strangler Fig (reverse proxy routing)
|
||||
```nginx
|
||||
# nginx.conf — split traffic by route
|
||||
location /search/new {
|
||||
proxy_pass http://nextjs-upstream;
|
||||
}
|
||||
location /search {
|
||||
# legacy PHP
|
||||
proxy_pass http://php-upstream;
|
||||
}
|
||||
```
|
||||
|
||||
## 🤔 의사결정 기준 (Decision Criteria)
|
||||
### Feature flag rollout
|
||||
```ts
|
||||
import { useFlag } from '@kiwicom/feature-flags';
|
||||
|
||||
**선택 A를 써야 할 때:**
|
||||
- *(TODO)*
|
||||
export function Search() {
|
||||
const newSearch = useFlag('search.v2', { default: false });
|
||||
return newSearch ? <SearchV2 /> : <SearchLegacy />;
|
||||
}
|
||||
```
|
||||
|
||||
**선택 B를 써야 할 때:**
|
||||
- *(TODO)*
|
||||
### GraphQL codegen pipeline
|
||||
```yaml
|
||||
# codegen.yml
|
||||
schema: https://api.kiwi.com/graphql
|
||||
documents: 'src/**/*.graphql'
|
||||
generates:
|
||||
src/__generated__/types.ts:
|
||||
plugins: [typescript, typescript-operations, typescript-react-apollo]
|
||||
config:
|
||||
withHooks: true
|
||||
```
|
||||
|
||||
**기본값:**
|
||||
> *(TODO)*
|
||||
### Monorepo workspace (Turborepo)
|
||||
```json
|
||||
// turbo.json
|
||||
{
|
||||
"tasks": {
|
||||
"build": { "dependsOn": ["^build"], "outputs": [".next/**", "dist/**"] },
|
||||
"test": { "dependsOn": ["^build"] },
|
||||
"lint": {}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## ❌ 안티패턴 (Anti-Patterns)
|
||||
```
|
||||
packages/
|
||||
orbit-components/ # design system
|
||||
api-mappers/ # GraphQL → domain
|
||||
utils/ # shared
|
||||
apps/
|
||||
search/ # Next.js
|
||||
booking/ # Next.js
|
||||
account/ # Next.js
|
||||
```
|
||||
|
||||
- **[안티패턴]:** *(TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*
|
||||
### Performance budget CI gate
|
||||
```ts
|
||||
// lighthouse-budget.json
|
||||
[{
|
||||
"path": "/search",
|
||||
"resourceSizes": [{ "resourceType": "script", "budget": 250 }],
|
||||
"timings": [{ "metric": "interactive", "budget": 3500 }]
|
||||
}]
|
||||
```
|
||||
|
||||
### Storybook-first component
|
||||
```tsx
|
||||
// Button.stories.tsx
|
||||
export default { component: Button };
|
||||
export const Primary = { args: { variant: 'primary', children: 'Book' } };
|
||||
export const Loading = { args: { variant: 'primary', loading: true } };
|
||||
// design system 매 Storybook 매 review 매 before integration
|
||||
```
|
||||
|
||||
## 매 결정 기준
|
||||
| 상황 | Approach |
|
||||
|---|---|
|
||||
| Legacy app, 매 high-traffic | **Strangler Fig** — page-by-page |
|
||||
| Visual inconsistency 매 root issue | Design system 매 first investment |
|
||||
| Type drift 매 API ↔ frontend | GraphQL + codegen |
|
||||
| 매 monorepo coordination overhead | Turborepo / Nx 매 caching |
|
||||
| 매 risky launch | Feature flag + percentage rollout |
|
||||
|
||||
**기본값**: 매 incremental, 매 design-system-first, 매 telemetry-gated rollout.
|
||||
|
||||
## 🔗 Graph
|
||||
- 부모: [[Frontend Migration]] · [[Strangler Fig Pattern]]
|
||||
- 변형: [[Airbnb Migration]] · [[Shopify Hydrogen Migration]]
|
||||
- 응용: [[Design System]] · [[Turborepo]] · [[Feature Flags]]
|
||||
- Adjacent: [[Micro-frontends]] · [[Monorepo]]
|
||||
|
||||
## 🤖 LLM 활용
|
||||
**언제**: large legacy frontend rewrite 매 planning, 매 design system priority 의 justification.
|
||||
**언제 X**: greenfield app — Kiwi case 매 migration constraint 매 specific.
|
||||
|
||||
## ❌ 안티패턴
|
||||
- **Big bang rewrite**: 매 multi-year freeze, 매 product velocity zero — Kiwi 가 explicitly avoided.
|
||||
- **Design system 매 after**: 매 visual drift 매 unfixable late.
|
||||
- **No telemetry**: 매 regression 매 invisible until users complain.
|
||||
- **Feature flag 매 abandoned**: 매 code path 매 dead, 매 cleanup 매 backlog.
|
||||
|
||||
## 🧪 검증 / 중복
|
||||
- Verified (Kiwi.com engineering blog, Orbit design system OSS — github.com/kiwicom/orbit).
|
||||
- 신뢰도 B (case study 매 specific, 매 generalizable lessons).
|
||||
|
||||
## 🕓 Changelog
|
||||
| 날짜 | 변경 |
|
||||
|---|---|
|
||||
| 2026-05-08 | Phase 1 |
|
||||
| 2026-05-10 | Manual cleanup — Strangler Fig + Orbit + monorepo + feature flag rollout |
|
||||
|
||||
Reference in New Issue
Block a user