# SAM React Frontend

React 기반 SAM 프론트엔드 애플리케이션입니다.

## 기술 스택

- **Build Tool**: Vite 7.x
- **Framework**: React 19.x
- **Language**: TypeScript 5.x
- **Styling**: Tailwind CSS 4.x
- **State Management**:
  - Zustand (전역 상태)
  - React Query / TanStack Query v5 (서버 상태)
- **Routing**: React Router v7
- **Form**: React Hook Form + Zod
- **HTTP Client**: Axios
- **UI Components**: shadcn/ui (Radix UI 기반)
- **Icons**: Lucide React
- **Date**: date-fns
- **Table**: TanStack Table

## 개발 환경 설정

### 환경변수 설정

`.env.local` 파일을 생성하고 다음 내용을 설정하세요:

```env
VITE_API_BASE_URL=http://api.sam.kr
VITE_API_KEY=your-api-key-here
```

### 의존성 설치

```bash
npm install
```

### 개발 서버 실행

```bash
npm run dev
```

개발 서버는 `http://localhost:5173`에서 실행됩니다.

## API 연동

SAM API는 2단계 인증을 사용합니다:
1. **API Key**: `X-API-Key` 헤더 (모든 요청)
2. **Bearer Token**: `Authorization: Bearer {token}` 헤더 (로그인 후)

자세한 내용은 프로젝트 문서를 참고하세요.