first commit

README.md

@@ -0,0 +1,53 @@
+# 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}` 헤더 (로그인 후)
+
+자세한 내용은 프로젝트 문서를 참고하세요.