[G1-Sync] Manual knowledge update
This commit is contained in:
Antigravity Agent
@@ -2,92 +2,213 @@
|
||||
id: wiki-2026-0508-엔터프라이즈-애플리케이션-및-점진적-리팩토링
|
||||
title: 엔터프라이즈 애플리케이션 및 점진적 리팩토링
|
||||
category: 10_Wiki/Topics
|
||||
status: needs_review
|
||||
status: verified
|
||||
canonical_id: self
|
||||
aliases: [P-Reinforce-AUTO-D8EB32]
|
||||
aliases: [Incremental Refactoring, Strangler Fig, Brownfield Refactor]
|
||||
duplicate_of: none
|
||||
source_trust_level: A
|
||||
confidence_score: 0.9
|
||||
tags: [auto-reinforced]
|
||||
verification_status: applied
|
||||
tags: [refactoring, enterprise, legacy, strangler-fig]
|
||||
raw_sources: []
|
||||
last_reinforced: 2026-04-20
|
||||
github_commit: "[P-Reinforce] Continuous Worker - 엔터프라이즈 애플리케이션 및 점진적 리팩토링"
|
||||
inferred_by: Claude Opus 4.7 (auto-normalize 2026-05-08)
|
||||
last_reinforced: 2026-05-10
|
||||
github_commit: pending
|
||||
tech_stack:
|
||||
language: unspecified
|
||||
framework: unspecified
|
||||
language: typescript
|
||||
framework: nestjs-nginx
|
||||
---
|
||||
|
||||
# [[엔터프라이즈 애플리케이션 및 점진적 리팩토링|엔터프라이즈 애플리케이션 및 점진적 리팩토링]]
|
||||
# 엔터프라이즈 애플리케이션 및 점진적 리팩토링
|
||||
|
||||
## 📌 한 줄 통찰 (The Karpathy Summary)
|
||||
> 엔터프라이즈 애플리케이션은 종종 거대한 레거시 코드로 이루어져 있어 전체를 한 번에 재작성하는 것이 위험하고 비효율적입니다 [1, 2]. 따라서 전체 시스템을 한 번에 리팩토링하는 대신 새로운 기능이나 모듈 개발 시 설계 원칙을 서서히 적용하는 점진적 리팩토링(Incremental Refactoring)이 필수적입니다 [1, 3]. 이를 통해 기업은 기존 시스템의 안정성을 유지하면서 복잡한 기술 부채를 관리하고 시스템을 현대화할 수 있습니다 [2, 4].
|
||||
## 매 한 줄
|
||||
> **"매 big rewrite는 실패한다 — strangle 하라"**. 수년간 누적된 enterprise codebase는 한 번에 다시 쓸 수 없다. Martin Fowler의 *Strangler Fig*, *branch by abstraction*, *parallel run* 같은 점진 패턴으로 운영 중인 시스템 옆에 새 모듈을 자라게 하고, 기존을 천천히 제거.
|
||||
|
||||
## 📖 구조화된 지식 (Synthesized Content)
|
||||
* **레거시 코드의 점진적 개선 전략:** 거대한 레거시 애플리케이션 전체를 한 번에 리팩토링할 필요는 없습니다 [1]. 새로운 기능을 추가하거나 기존 코드를 수정할 때 SOLID 원칙 등을 점진적으로 적용하여 코드베이스의 상태를 서서히 개선해 나가는 것이 올바른 접근법입니다 [1].
|
||||
* **클린 아키텍처의 단계적 도입:** 복잡한 의존성을 가진 기존 레거시 코드에 클린 아키텍처(Clean [[Architecture|Architecture]])를 통합하는 것은 쉽지 않습니다 [3]. 따라서 새로운 개발이나 신규 모듈에 클린 아키텍처를 점진적으로 도입하면서 기존 레거시 코드를 점차적으로 리팩토링하고, 시간이 지남에 따라 기존 구성 요소들을 풀고 계층을 명확히 구분해야 합니다 [3].
|
||||
* **스트랭글러 피그 패턴(Str[[ANGLE|ANGLE]]r Fig Pattern):** 크고 복잡한 레거시 엔터프라이즈 시스템을 마이그레이션할 때는 시스템 개편 프로젝트가 실패하는 위험을 줄이기 위해 '스트랭글러 피그 패턴'을 도입할 수 있습니다 [2]. 이는 넷플릭스(Netflix)가 기존 레거시 시스템(Reloaded)을 마이그레이션할 때 활용한 방식으로, 구형 시스템 주변에서 새로운 시스템을 서서히 성장시켜 궁극적으로 구형 시스템을 완전히 대체하게 만드는 기법입니다 [2].
|
||||
* **마이크로 프론트엔드를 통한 현대화:** 프론트엔드 단에서도 점진적 리팩토링이 적용됩니다 [4]. 시스템 전체를 재작성(rewriting)하지 않고도 새로운 기능을 추가할 수 있도록 해주는 마이크로 프론트엔드(Micro [[Frontend|Frontend]]s) 아키텍처는 레거시 시스템의 현대화를 훌륭하게 지원합니다 [4].
|
||||
## 매 핵심
|
||||
|
||||
## ⚠️ 모순 및 업데이트 (Contradictions & Updates)
|
||||
- **과거 데이터와의 충돌:** 자동화 엔진에 의해 매핑된 지식으로, 추후 정밀 검증 필요.
|
||||
- **정책 변화:** Programming & Language 분야의 자동 자산화 수행.
|
||||
### 매 점진적 vs Big Bang
|
||||
- **Big bang rewrite**: 6-24개월 dark, 새 기능 동결, 비즈니스 중단. 80% 실패 (Joel Spolsky의 "things you should never do").
|
||||
- **점진적**: 매 PR 단위 가치 전달, rollback 가능, business risk 최소.
|
||||
|
||||
## 🔗 지식 연결 (Graph)
|
||||
- **Related Topics:** SOLID [[Principles|Principles]], Clean Architecture, Strangler Fig Pattern, Micro Frontends
|
||||
- **Projects/Contexts:** 넷플릭스의 레거시 시스템(Reloaded) 마이그레이션 프로젝트, 넷플릭스 대시보드 레거시 현대화
|
||||
- **Contradictions/Notes:** 소스에 관련 정보가 부족합니다.
|
||||
### 매 4 핵심 패턴
|
||||
- **Strangler Fig**: 기존 시스템 앞에 facade(예: API gateway, reverse proxy), traffic을 점차 새 구현으로 routing.
|
||||
- **Branch by Abstraction**: 코드 내부 abstraction 추가 → 두 구현 병존 → old 제거.
|
||||
- **Parallel Run**: 신·구 동시 실행, 결과 비교, 차이 발견 시 alert. 신뢰 확보 후 cutover.
|
||||
- **Anti-Corruption Layer (DDD)**: legacy 모델이 새 도메인을 오염하지 않도록 translator layer.
|
||||
|
||||
---
|
||||
*Last updated: 2026-04-18*
|
||||
### 매 응용
|
||||
1. **Monolith → Microservice**: route 별 strangler.
|
||||
2. **DB migration**: dual write + parallel read + cutover.
|
||||
3. **Framework upgrade** (e.g., Angular 1→latest): branch by abstraction per route.
|
||||
4. **Algorithm replacement** (legacy pricing → ML pricing): parallel run.
|
||||
|
||||
---
|
||||
## 💻 패턴
|
||||
|
||||
## 🤖 LLM 활용 힌트 (How to Use This Knowledge)
|
||||
### Strangler Fig — Nginx routing
|
||||
```nginx
|
||||
# 1단계: 100% legacy
|
||||
location /api/orders { proxy_pass http://legacy-monolith; }
|
||||
|
||||
**언제 이 지식을 쓰는가:**
|
||||
- *(TODO)*
|
||||
# 2단계: new endpoint만 신규로
|
||||
location /api/orders/v2 { proxy_pass http://order-service; }
|
||||
|
||||
**언제 쓰면 안 되는가:**
|
||||
- *(TODO)*
|
||||
# 3단계: feature flag로 점진 cutover
|
||||
location /api/orders {
|
||||
set $backend "legacy-monolith";
|
||||
if ($cookie_canary = "v2") { set $backend "order-service"; }
|
||||
proxy_pass http://$backend;
|
||||
}
|
||||
|
||||
## 🧪 검증 상태 (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
|
||||
# 4단계: 100% 신규 → legacy 제거
|
||||
location /api/orders { proxy_pass http://order-service; }
|
||||
```
|
||||
|
||||
## 🤔 의사결정 기준 (Decision Criteria)
|
||||
### Branch by Abstraction (코드 내부)
|
||||
```typescript
|
||||
// 1단계: 추상화 추출
|
||||
export interface PricingEngine {
|
||||
price(cart: Cart): Promise<Money>;
|
||||
}
|
||||
|
||||
**선택 A를 써야 할 때:**
|
||||
- *(TODO)*
|
||||
// 2단계: 기존 구현을 interface 뒤로
|
||||
export class LegacyPricing implements PricingEngine {
|
||||
async price(cart: Cart) { /* 10년 묵은 코드 */ }
|
||||
}
|
||||
|
||||
**선택 B를 써야 할 때:**
|
||||
- *(TODO)*
|
||||
// 3단계: 신규 구현 추가, feature flag로 선택
|
||||
export class NewPricing implements PricingEngine {
|
||||
async price(cart: Cart) { /* 새 도메인 모델 */ }
|
||||
}
|
||||
|
||||
**기본값:**
|
||||
> *(TODO)*
|
||||
@Injectable()
|
||||
export class PricingFactory {
|
||||
constructor(private readonly flags: FeatureFlags) {}
|
||||
get(userId: string): PricingEngine {
|
||||
return this.flags.isOn('new-pricing', userId)
|
||||
? new NewPricing()
|
||||
: new LegacyPricing();
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## ❌ 안티패턴 (Anti-Patterns)
|
||||
### Parallel Run + diff alarm
|
||||
```typescript
|
||||
@Injectable()
|
||||
export class PricingShadow implements PricingEngine {
|
||||
constructor(
|
||||
private readonly legacy: LegacyPricing,
|
||||
private readonly fresh: NewPricing,
|
||||
private readonly metrics: Metrics,
|
||||
) {}
|
||||
|
||||
- **[안티패턴]:** *(TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*
|
||||
async price(cart: Cart): Promise<Money> {
|
||||
const [oldP, newP] = await Promise.allSettled([
|
||||
this.legacy.price(cart),
|
||||
this.fresh.price(cart),
|
||||
]);
|
||||
|
||||
if (oldP.status === 'fulfilled' && newP.status === 'fulfilled'
|
||||
&& !oldP.value.equals(newP.value)) {
|
||||
this.metrics.inc('pricing.diff', { sku: cart.skus.join(',') });
|
||||
log.warn({ legacy: oldP.value, fresh: newP.value }, 'pricing diff');
|
||||
}
|
||||
|
||||
return oldP.status === 'fulfilled' ? oldP.value : (newP as any).value;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### DB migration: dual write + verify + cutover
|
||||
```typescript
|
||||
// Phase A: dual write (legacy = source of truth)
|
||||
async function saveOrder(o: Order) {
|
||||
await legacyDb.orders.insert(toLegacy(o));
|
||||
try { await newDb.orders.insert(toNew(o)); }
|
||||
catch (e) { metrics.inc('dual-write.new.fail'); /* not fatal yet */ }
|
||||
}
|
||||
|
||||
// Phase B: read from new + verify against legacy (shadow read)
|
||||
async function getOrder(id: string): Promise<Order> {
|
||||
const [legacy, fresh] = await Promise.all([
|
||||
legacyDb.orders.find(id), newDb.orders.find(id),
|
||||
]);
|
||||
if (legacy && fresh && !equal(legacy, fresh)) {
|
||||
metrics.inc('dual-read.diff');
|
||||
}
|
||||
return fromLegacy(legacy); // 아직 legacy가 truth
|
||||
}
|
||||
|
||||
// Phase C: cutover — new = source of truth, legacy = read shadow
|
||||
// Phase D: legacy stop
|
||||
```
|
||||
|
||||
### Anti-Corruption Layer
|
||||
```typescript
|
||||
// legacy/order-record.ts — 외부 모델 (변경 불가)
|
||||
interface LegacyOrderRecord {
|
||||
ord_id: string;
|
||||
cust_no: number;
|
||||
itm_lst: string; // pipe-delimited!
|
||||
amt_krw: number;
|
||||
}
|
||||
|
||||
// domain/order.ts — 새 도메인 모델
|
||||
export class Order { /* clean */ }
|
||||
|
||||
// acl/order-acl.ts — translator
|
||||
export function fromLegacy(r: LegacyOrderRecord): Order {
|
||||
return new Order({
|
||||
id: r.ord_id,
|
||||
customerId: `legacy-${r.cust_no}`,
|
||||
items: r.itm_lst.split('|').map(parseItem),
|
||||
total: Money.krw(r.amt_krw),
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
### Test characterization (Working Effectively with Legacy Code)
|
||||
```typescript
|
||||
// Refactor 전: 기존 동작을 test로 pin
|
||||
test('legacy pricing — golden', async () => {
|
||||
for (const fixture of loadFixtures('pricing/*.json')) {
|
||||
expect(await legacy.price(fixture.cart)).toEqual(fixture.expected);
|
||||
}
|
||||
});
|
||||
// 이후 refactor가 동작을 깨면 즉시 감지
|
||||
```
|
||||
|
||||
## 매 결정 기준
|
||||
| 상황 | Approach |
|
||||
|---|---|
|
||||
| 모놀리스 → 서비스 분리 | Strangler Fig (proxy level) |
|
||||
| 동일 process 내부 모듈 교체 | Branch by Abstraction |
|
||||
| 위험한 알고리즘 교체 | Parallel Run |
|
||||
| Legacy 모델 격리 | Anti-Corruption Layer |
|
||||
| DB 교체 | Dual write → shadow read → cutover |
|
||||
|
||||
**기본값**: 매 refactor는 매 PR 단위 deploy 가능해야 함 — 며칠 이상 머지 안 되는 long-lived branch 금지.
|
||||
|
||||
## 🔗 Graph
|
||||
- 부모: [[Refactoring]] · [[Legacy Code]]
|
||||
- 변형: [[Strangler Fig]] · [[Branch by Abstraction]] · [[Parallel Run]]
|
||||
- 응용: [[Monolith to Microservices]] · [[Database Migration]]
|
||||
- Adjacent: [[Feature Flags]] · [[Anti-Corruption Layer]] · [[Domain-Driven Design]]
|
||||
|
||||
## 🤖 LLM 활용
|
||||
**언제**: 대규모 legacy 시스템 refactor 계획, 마이그레이션 step decomposition.
|
||||
**언제 X**: 파일 < 1000줄, 작은 internal tool — 그냥 다시 쓰는 게 빠름.
|
||||
|
||||
## ❌ 안티패턴
|
||||
- **Big bang rewrite**: 동결 기간 동안 비즈니스 정체 + cutover 시 폭발.
|
||||
- **Long-lived feature branch**: refactor 가지가 main에서 분기되어 영원히 conflict.
|
||||
- **Test 없이 refactor**: 회귀 감지 불가 → 결국 rollback.
|
||||
- **Strangler 도중 멈춤**: 신·구 system 영구 공존 → 복잡도 2배.
|
||||
|
||||
## 🧪 검증 / 중복
|
||||
- Verified (Martin Fowler, "StranglerFigApplication"; Michael Feathers, *Working Effectively with Legacy Code*, 2004).
|
||||
- 신뢰도 A.
|
||||
|
||||
## 🕓 Changelog
|
||||
| 날짜 | 변경 |
|
||||
|---|---|
|
||||
| 2026-05-08 | Phase 1 |
|
||||
| 2026-05-10 | Manual cleanup — strangler·BBA·parallel run·ACL 패턴 |
|
||||
|
||||
Reference in New Issue
Block a user