fe-common-rules/examples/sample-nuxt-project/.claude/common/templates/project/architecture.md

아키텍처

이 파일은 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 정책이 있다면 함께 기술