---
type: template
domain: product
role: Frontend
status: active
last-reviewed: 2026-07-27
---

# 컴포넌트·상태 설계

> 화면을 작고 재사용 가능한 컴포넌트와 명시적인 상태 소유권으로 분해한다. 동작의 정본은 기능사양서 — 여기서 어긋나면 검수에서 어긋난다.

## 입력

| 항목 | 작성 |
|---|---|
| 관련 화면 ID |  |
| 기능사양서 기준 버전 |  |
| 기존 재사용 후보 |  |
| 디자인 토큰·컴포넌트 라이브러리 |  |
| Backend API 정의서 버전 |  |

## 컴포넌트 구조

| 컴포넌트 | 책임 | 입력 props | 출력 event | 재사용·신규 | 상태 보유 여부 | 오류 경계 |
|---|---|---|---|---|---|---|
|  |  |  |  |  |  |  |

## 상태 소유권

| 상태 | 초기값 | 소유 레이어 | 변경 주체 | 지속 범위 | 동기화·무효화 | 화면 표시 |
|---|---|---|---|---|---|---|
|  |  | 서버 / 클라이언트 / URL / 폼 |  |  |  |  |

## 상태 전이

| 시작 상태 | 사용자·시스템 이벤트 | 진행 상태 | 성공 | 실패 | 재시도·복구 |
|---|---|---|---|---|---|
|  |  |  |  |  |  |

## 결정 기록

| 결정 ID | 선택지 | 채택안·근거 | 트레이드오프 | 영향 파일·화면 | 승인자 |
|---|---|---|---|---|---|
| FE-COMP-001 |  |  |  |  |  |

## 작성 질문

- [ ] 한 컴포넌트가 UI, 데이터 요청, 도메인 판단을 동시에 떠안지 않는가?
- [ ] 파생 가능한 값을 중복 상태로 저장하지 않는가?
- [ ] 로딩·오류·낙관적 업데이트의 되돌리기가 정의됐는가?
- [ ] 기존 토큰과 컴포넌트를 우선 사용했는가?
- [ ] 기능사양서·화면정의서에 없는 동작을 선의로 확장하지 않았는가? (필요하면 CR로 회부)

## 인계

- 다음 문서: [[03_API 의존성 계약]]
- 미결·후속 작업: