프론트엔드 기본 원칙 리뷰
"컴포넌트는 하나의 일만 잘 해야 합니다. '그리고'로 설명하고 있다면 분리하세요."
적용 시점
이 스킬은 다음을 검토할 때 활성화하세요:
- React/Vue/Svelte 컴포넌트
- UI 렌더링 로직
- 상태 관리 코드
- CSS/스타일링 결정
- 클라이언트 사이드 라우팅
리뷰 체크리스트
컴포넌트 아키텍처
- 단일 책임: 각 컴포넌트가 하나의 작업만 수행합니까?
- 크기 확인: 컴포넌트가 200줄 미만입니까?
- Props 개수: props가 7개 미만입니까?
- 이름 짓기: '그리고'를 사용하지 않고 컴포넌트를 설명할 수 있습니까?
상태 관리
- 위치 최적화: 상태가 사용되는 위치와 최대한 가깝게 있습니까?
- 상태 끌어올리기: 형제 컴포넌트 간에 부모를 통해 상태가 적절히 공유됩니까?
- Context vs Props: prop drilling이 방지되었습니까? (최대 3단계)
- 서버 상태: 서버 데이터가 별도로 관리됩니까? (React Query/SWR)
성능
- 메모이제이션: 비용이 많이 드는 계산이 useMemo로 감싸졌습니까?
- 콜백: 이벤트 핸들러가 필요한 곳에 useCallback으로 감싸졌습니까?
- 리렌더링: 이 코드가 불필요한 리렌더링을 유발합니까?
- 지연 로딩: 무거운 컴포넌트가 코드 스플리팅 되었습니까?
접근성
- 시맨틱 HTML: 적절한 요소가 사용되었습니까? (button vs div)
- ARIA: 상호작용 요소에 접근성이 보장됩니까?
- 키보드: 사용자가 마우스 없이 탐색할 수 있습니까?
흔한 실수 (안티패턴)
1. God 컴포넌트
❌ UserDashboard.tsx (1000줄)
- 데이터 가져오기, 상태 관리, UI 렌더링, 라우팅 처리
✅ 다음과 같이 분할:
- UserDashboardPage.tsx (컨테이너)
- UserStats.tsx (프레젠테이션)
- UserActivity.tsx (프레젠테이션)
- useUserData.ts (훅)
2. 렌더 내 로직
❌ return <div>{users.filter(u => u.active).map(u => ...)}</div>
✅ const activeUsers = useMemo(() => users.filter(u => u.active), [users]);
return <div>{activeUsers.map(u => ...)}</div>
3. Prop Drilling
❌ <App user={user}>
<Layout user={user}>
<Main user={user}>
<Widget user={user} />
✅ const user = useUser(); // Widget.tsx 내부
4. Boolean Prop 남발
❌ <Button primary secondary large small disabled loading />
✅ <Button variant="primary" size="large" state="loading" />
소크라테스 질문
주니어 개발자에게 답을 주는 대신 다음 질문을 하세요:
- 아키텍처: "이 컴포넌트의 유일한 작업은 무엇인가요?"
- 분할: "헤더 부분만 다른 곳에서 사용하라고 한다면 가능할까요?"
- 상태: "이 데이터가 필요한 사람은 누구인가요? 여기에 있어야 할까요, 아니면 더 위에 있어야 할까요?"
- 성능: "부모가 리렌더링되면 어떤 일이 발생하나요?"
- 복잡성: "새로운 개발자가 5분 안에 이 코드를 이해할 수 있을까요?"
표준 참조
자세한 패턴은 다음에서 확인하세요:
/standards/frontend/component-architecture.md
지적해야 할 위험 신호
| 신호 | 질문할 내용 |
|---|---|
| 파일 > 200줄 | "이것을 더 작은 조각으로 나눌 수 있을까요?" |
| > 5개의 useState 호출 | "이 중 일부 상태는 끌어올리거나 결합해야 할까요?" |
| 외부 값을 사용하는 useEffect의 [] 의존성 | "의존성이 누락된 것은 아닌가요?" |
| 직접 DOM 조작 | "이 작업을 React 방식으로 할 수 있나요?" |
| 모든 곳에 인라인 스타일 | "일관된 스타일링 방식을 사용해야 할까요?" |