sam-react/README.md

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 파일을 생성하고 다음 내용을 설정하세요:

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

의존성 설치

npm install

개발 서버 실행

npm run dev

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

API 연동

SAM API는 2단계 인증을 사용합니다:

1. API Key: X-API-Key 헤더 (모든 요청)
2. Bearer Token: Authorization: Bearer {token} 헤더 (로그인 후)

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