47 lines
1.8 KiB
Markdown
47 lines
1.8 KiB
Markdown
# 아키텍처
|
|
|
|
> 이 파일은 `fe-common-rules/templates/project/architecture.md` 에서 복사된 양식입니다.
|
|
> 프로젝트의 레이어 구조와 데이터 흐름을 간단히 설명해주세요.
|
|
|
|
## 레이어 구조
|
|
|
|
<프로젝트의 레이어 구조를 그림 또는 텍스트로 그려주세요>
|
|
|
|
```
|
|
┌───────────────────────────────┐
|
|
│ presentation │ ← pages / components
|
|
├───────────────────────────────┤
|
|
│ logic │ ← composables / hooks / stores
|
|
├───────────────────────────────┤
|
|
│ data access │ ← api wrapper / queries
|
|
├───────────────────────────────┤
|
|
│ server │ ← 서버 라우트 / BFF
|
|
└───────────────────────────────┘
|
|
```
|
|
|
|
## 의존 규칙
|
|
|
|
- 상위 → 하위 **단방향 의존**만 허용
|
|
- 같은 레이어 간 순환 import 금지
|
|
- <프로젝트 고유 규칙 추가>
|
|
|
|
## 데이터 흐름
|
|
|
|
1. <이벤트 발생부터 응답까지의 흐름을 간단히>
|
|
2. ...
|
|
3. ...
|
|
|
|
## 상태 관리 가이드
|
|
|
|
| 상태 종류 | 권장 위치 |
|
|
| -------------------- | ------------------------ |
|
|
| 컴포넌트 로컬 상태 | <예: ref / useState> |
|
|
| 페이지 단위 공유 상태| <예: provide/inject> |
|
|
| 앱 전역 상태 | <예: Pinia / Zustand> |
|
|
| 서버 데이터 | <예: useFetch / TanStack Query> |
|
|
|
|
## 외부 의존성
|
|
|
|
- 반드시 알아야 할 외부 서비스나 내부 API 를 나열
|
|
- 장애 발생 시 fallback 정책이 있다면 함께 기술
|