🐋 난다고래: 고래의 어깨를 빌리다

"수익률의 숫자에 속지 마세요."

상승장에서는 누구나 돈을 법니다. 하지만 진짜 고수는 하락장에서 증명됩니다. 단순히 돈을 많이 번 지갑이 아니라, 살아남는 법을 아는 지갑을 찾아야 합니다.

난다고래는 AI를 이용해 수익률 뒤에 숨겨진 리스크까지 꿰뚫어 봅니다. MDD, 샤프 지수, 승률 등 다양한 지수를 포함해 입체적으로 분석된 AI Score로 진짜 실력자를 감별해 드립니다.

시장 1% 거인의 어깨에 올라타세요. 오늘부터 당신의 투자는 운이 아닌 데이터가 됩니다.

---

| Frontend Repo | Backend Repo | Figma |

FE 기술 스택

이 프로젝트의 백엔드 기술 스택은 여기에서 확인할 수 있습니다.

구분	기술
Frontend
Styling
State Mgt
Chart

환경 변수 설정 및 실행 방법

이 프로젝트를 정상적으로 실행하려면 백엔드 API 서버 주소 설정이 필요합니다.

1. 환경 변수 파일 생성

프로젝트 루트 경로에 있는 .env.example 파일을 복사하여 .env 파일을 생성합니다.

cp .env.example .env

2. API 서버 주소 설정

생성된 .env 파일을 열고 VITE_API_URL 값을 실제 백엔드 서버 주소로 변경합니다.

# .env 파일 예시
VITE_API_URL=http://localhost:8080

# 또는
VITE_API_URL=[https://api.your-deployed-server.com](https://api.your-deployed-server.com)

3. 패키지 설치 및 실행

필요한 라이브러리를 설치하고 개발 서버를 시작합니다.

# 의존성 패키지 설치
npm install

# 개발 서버 실행 (http://localhost:5173)
npm run dev

프로젝트 구조

src/
├── 📂 apis/          # Axios 인스턴스 및 API 호출 함수
├── 📂 assets/        # 아이콘(SVG), 이미지, 로고 리소스
├── 📂 components/    # 재사용 가능한 UI 컴포넌트
│   ├── 📂 common/    # 버튼, 로딩, 에러 바운더리 등 공통 컴포넌트
│   ├── 📂 graph/     # Recharts 기반 차트 컴포넌트들
│   └── 📂 page/      # 페이지별 특화 컴포넌트 (Header, List Item 등)
├── 📂 hooks/         # 커스텀 훅 (useWhaleList, useRankHistory)
├── 📂 pages/         # 주요 페이지 (Main, Detail)
├── 📂 types/         # TypeScript 타입 정의 (Whale, API Response)
└── 📂 mocks/         # 테스트용 목업 데이터

팀원 소개

• 박준석(Frontend)
• 이민재(AI/Data Scientist)
• 이상현(Backend)
• 이정민(Designer)
• 정지호(Frontend)