# [도메인명] 컨텍스트 (Domain Profile)

> 이 문서는 특정 도메인(앱, 패키지, 또는 복잡한 기능 모듈) 내에서만 적용되는 "지역(Local) 룰 및 컨텍스트"를 정의합니다.
> 루트의 `PROJECT_CONTEXT.md`와 함께 읽어, 이 영역만 작업할 때 컨텍스트 오염을 막고 범위를 좁히는 역할을 합니다.

## 도메인 소개
- **도메인명**: [예: Admin Dashboard / Auth Service / Shared UI]
- **주요 역할**: [예: 사내 운영팀이 시스템 데이터를 분석하고 관리하는 백오피스 인터페이스]

## 주요 의존성 (Key Dependencies)
- `react-hook-form`, `zod` (복잡한 폼 처리에 사용)
- `recharts` (차트 및 데이터 시각화)
- `swr` (데이터 패칭 - 이 도메인 특화)

## 디렉토리 구조 (Local Structure)
- `src/components/`: 이 영역에서만 재사용되는 UI 컴포넌트
- `src/features/`: 비즈니스 로직 단위의 기능별 응집 (Colocation) 폴더
- `src/hooks/`: 로컬 커스텀 훅
- `src/services/`: 외부 API 연동 레이어

## 특이사항 / 도메인 특화 규칙 (Domain Rules)
- **권한 관리**: 모든 라우트는 최상단의 `AuthGuard`를 거쳐야 하며, 역할(Role)에 따라 접근 제어 로직을 작성해야 합니다.
- **상태 공유 제한**: 전역 상태보다 `Provider` 패턴을 이용한 상태 캡슐화를 우선합니다.
- **날짜 처리**: 이 도메인 내부의 모든 날짜 처리는 UTC 기준으로 저장/전달되며, UI 표시 시에만 로컬 타임으로 변환합니다 (`date-fns` 활용).

---
*작업 시 팁: AI 에이전트와 대화할 때 "해당 폴더의 README.md를 기반으로 구조를 파악해줘"라고 먼저 워밍업을 요청하면, 불필요하게 전체 프로젝트 코드를 검색하는 것을 줄일 수 있습니다.*