54 lines
1.1 KiB
Markdown
54 lines
1.1 KiB
Markdown
|
# 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}` 헤더 (로그인 후)
|
||
|
|
|
||
|
|
자세한 내용은 프로젝트 문서를 참고하세요.
|