2nd/10_Wiki/Topics/Programming & Tools/Refactoring.md

## 📌 Brief Summary
리팩토링(Refactoring)은 소프트웨어의 외부 동작을 유지하면서 내부 구조를 개선하여 코드베이스의 건강함과 유지보수성을 확보하는 전문적인 개발 과정이다. 낡은 패러다임을 현대화하고 책임을 분리하며, 강력한 테스트 안전망을 구축함으로써 기술 부채를 상환하고 시스템의 복잡도를 제어하는 것을 목표로 한다.

## 📖 Core Content
1. **리팩토링 철학: 점진적 마이그레이션**
   - 위험이 큰 전면 재작성 대신, 기능 단위로 하나씩 새로운 아키텍처로 옮기는 점진적 방식을 취한다.
   - 이를 통해 시스템 현대화 중에도 신규 기능 개발을 지속할 수 있다.
2. **React 리팩토링의 핵심: 커스텀 훅**
   - 비대한 UI 컴포넌트에서 비즈니스 로직을 추출하여 커스텀 훅으로 분리한다.
   - UI와 로직의 분리를 통해 모듈성을 높이고, 독립적이고 빠른 단위 테스트(Unit Testing) 환경을 확보한다.
3. **실무적 개선 기법**
   - 클래스형 컴포넌트의 함수형 전환, JavaScript의 TypeScript 마이그레이션.
   - 불필요한 `useEffect` 제거 및 서버 상태 관리(TanStack Query) 도입.
   - DRY(중복 제거) 및 YAGNI(불필요 기능 제거) 원칙을 통한 코드 정리.
4. **표준화 및 거버넌스**
   - CSS 작성 방식 표준화, 폴더 구조(FSD 등) 재정렬, 직관적 네이밍 적용.
   - ESLint 등 자동화 도구를 통해 팀의 모범 사례를 강제한다.

## ⚖️ Trade-offs & Caveats
- **마이그레이션 과도기 복잡성**: 구형과 신규 패턴이 공존하는 기간 동안 시스템의 일관성이 일시적으로 깨질 수 있으며, 개발자의 인지 부하가 증가한다.
- **테스트 부재의 위험**: 충분한 테스트 안전망 없이 진행되는 리팩토링은 오히려 예기치 못한 회귀(Regression) 오류를 유발할 수 있다.
- **과도한 추상화**: 중복 제거(DRY)에 너무 집착할 경우, 오히려 코드가 복잡해져 이해하기 어려워지는 'KISS 원칙 위반' 사례가 발생할 수 있다.

## 🔗 Knowledge Connections
### Related Concepts
- **Incremental Migration**: 안전한 아키텍처 전환 전략 (관계: 핵심 방법론)
- **Custom Hooks**: 로직 분리의 기본 단위 (관계: 실천 도구)
- **Unit Testing**: 리팩토링의 안정성 보장 (관계: 필수 전제 조건)
- **Feature-Sliced Design (FSD)**: 캡슐화를 통한 부작용 차단 (관계: 구조적 목표)

### Deeper Research Questions
1. 대규모 리팩토링 시 구/신규 아키텍처 공존 기간을 최소화하기 위한 'Feature Toggle' 활용 방안은?
2. 테스트 코드가 전혀 없는 레거시 시스템에서 '안전한 리팩토링'을 시작하기 위한 최소한의 테스트 전략은?
3. 순환 복잡도를 줄이기 위한 조건문 리팩토링(Guard Clauses 등)이 React JSX 내부 구조에 미치는 영향은?
4. 리팩토링 중 발견된 '기존의 의도된 버그(Legacy Bug)'를 처리하는 아키텍처적 의사결정 기준은?
5. AI 도구(LLM)를 활용한 대규모 코드 리팩토링 시, 로직 변질 여부를 자동으로 검증하는 파이프라인 구축 방법은?

### Practical Application Contexts
- **기술 부채 상환**: 스파게티 코드로 변한 레거시 프로젝트의 구조 개선 및 현대화.
- **시스템 안정성 강화**: 잦은 에러가 발생하는 모듈을 SRP 원칙에 따라 분해하고 테스트 코드를 보강.

### Adjacent Topics
- **Technical Debt Management**
- **Clean Code & Code Smells**
- **SOLID Principles**