## 📌 Brief Summary
'Bulletproof React'는 프로덕션 수준의 React 애플리케이션을 구축하기 위한 확장 가능하고 강력한 아키텍처 가이드라인이다. React의 자유도로 인해 발생하는 일관성 없는 구조 문제를 해결하기 위해 기능(Feature) 기반의 모듈화와 명확한 계층 분리라는 주관적인(Opinionated) 베스트 프랙티스를 제시한다.

## 📖 Core Content
1. **아키텍처 철학 (Scalability & Predictability)**
   - React는 프레임워크가 아닌 라이브러리이므로 구조적 선택의 책임이 개발자에게 있다.
   - Bulletproof React는 팀 규모와 코드베이스가 커져도 유지보수가 가능하도록 명확한 경계(Boundaries)와 일관된 작업 방식을 제공한다.
2. **기능 기반 구조 (Feature-Based Structure)**
   - 기술적 역할(Components, Hooks, Styles)이 아닌 비즈니스 기능(Feature) 단위로 코드를 그룹화한다.
   - 각 기능 폴더 내에 해당 기능에 필요한 컴포넌트, API, 상태, 타입, 유틸리티를 독립적으로 배치하여 응집도를 높인다.
3. **계층화된 아키텍처 (Layered Architecture)**
   - 프로젝트 표준, 프로젝트 구조, 컴포넌트/스타일링, API 계층, 상태 관리, 테스트, 보안 등 프론트엔드 전반의 레이어를 규격화한다.
   - 특정 기술에 얽매이지 않고 원칙(Principles)에 집중하여 라이브러리 교체가 용이한 구조를 지향한다.
4. **유연한 적용 (Guideline, Not Template)**
   - 강제적인 보일러플레이트가 아니며, 팀의 요구사항과 프로젝트 규모에 맞게 선택적으로 적용할 수 있는 가이드라인 역할을 수행한다.

## ⚖️ Trade-offs & Caveats
- **규칙의 파편화 위험**: 프레임워크가 아닌 가이드라인이므로, 팀 내에서 합의된 수준을 넘어서는 자의적인 해석이 발생할 경우 구조적 일관성이 깨질 수 있다.
- **초기 학습 곡선**: 폴더 구조가 깊어지고 관심사 분리가 엄격해짐에 따라, 기존의 플랫한 구조에 익숙한 개발자들에게는 초기 적응 시간이 필요하다.
- **오버헤드**: 매우 작은 규모의 프로젝트나 단순한 MVP 단계에서는 이러한 엄격한 분리가 오히려 과도한 보일러플레이트로 느껴질 수 있다.

## 🔗 Knowledge Connections
### Related Concepts (Auto-Linked)
* [[Architecture]]
* [[Boundaries]]
* [[Clean_Architecture]]
* [[Domain-Driven_Design]]
* [[ESLint]]
* [[Feature-Sliced_Design]]
* [[Frontend]]
* [[Layered_Architecture]]
* [[Management]]
* [[Monorepo]]
* [[Principles]]
* [[React]]
* [[React_Architecture]]
* [[Research]]
* [[Scalability]]

### Related Concepts
- **Feature-Based Structure**: 비즈니스 도메인 단위의 코드 응집도 향상 기법 (관계: 핵심 구현 패턴)
- **Feature-Sliced Design (FSD)**: 기능 기반 구조를 더 체계화한 고급 아키텍처 방법론 (관계: 확장 발전 형태)
- **Scalable React Architecture**: 대규모 시스템을 위한 설계 철학 (관계: 상위 목표)

### Deeper Research Questions
1. 기능 기반 구조에서 여러 기능 간에 공통으로 사용되는 로직(Shared)의 의존성 역전은 어떻게 관리하는가?
2. API 계층과 상태 관리 레이어의 물리적 분리가 단위 테스트의 고립성 확보에 어떤 영향을 미치는가?
3. 대규모 리팩토링 시, 기능 단위로 쪼개진 모듈이 파일 유형 기반 구조보다 안전한 이유는 무엇인가?
4. 아키텍처가 제시하는 '명확한 경계'를 강제하기 위해 ESLint 등의 도구를 어떻게 활용할 수 있는가?
5. 서버 컴포넌트(RSC) 환경에서 Bulletproof React의 폴더 구조 전략은 어떻게 진화해야 하는가?

### Practical Application Contexts
- **신규 프로젝트 셋업**: 초기 폴더 구조 및 레이어링 표준안으로 채택.
- **레거시 리팩토링**: 복잡해진 코드베이스를 기능 단위로 점진적으로 격리 및 구조화.

### Adjacent Topics
- **Clean Architecture in Frontend**
- **Domain-Driven Design (DDD)**
- **Monorepo Management Strategies**
