Thanks to visit codestin.com
Credit goes to github.com

Skip to content

gayoungyeom/stock-log

Repository files navigation

Stock Log 📈

주식 가격 분석 및 퍼센트 기반 가격 계산을 위한 웹 애플리케이션 ☞ 링크

프로젝트 개요

  • Stock Log는 투자자들이 주식의 52주 최고가를 기준으로 하락폭에 따른 매수 가격과 포트폴리오 비중을 계산할 수 있는 도구입니다.
  • 일별 주식 데이터(종가)를 활용하여 체계적인 투자 전략 수립을 지원합니다.

주요 기능

실시간 주식 데이터

  • NASDAQ 시총 상위 종목 (NVDA, MSFT, AAPL, GOOGL, AMZN) 데이터 제공
  • 52주 최고가/최저가, 현재가, 전일 대비 변동률
  • 시가총액 정보

퍼센트 기반 가격 계산

  • 52주 최고가 대비 하락률별 매수 가격 계산
  • 2.5% 또는 5% 단위로 계산 범위 설정 가능
  • 커스텀 퍼센트 범위 설정 (시작/끝/단위 조정)

포트폴리오 비중 관리

  • 하락폭에 따른 현금/주식 비중 자동 계산
  • 10% 단위로 비중 증가하는 분산투자 전략

기술 스택

  • 프레임워크: Next.js 14 (App Router)
  • 언어: TypeScript
  • 스타일링: Tailwind CSS + shadcn/ui
  • 상태관리: TanStack Query (React Query)
  • HTTP 클라이언트: Axios
  • 날짜 처리: Day.js
  • 기타 도구: ESLint + Prettier + Husky
  • API: Alpha Vantage Stock API (실시간 주식 데이터)

배포 환경

로컬 개발 환경 설정

1. 레포지토리 클론

git clone https://github.com/yourusername/stock-log.git
cd stock-log

2. 의존성 설치

yarn install

3. 환경 변수 설정

.env.local 파일을 생성하고 Alpha Vantage API 키를 설정하세요:

NEXT_PUBLIC_ALPHA_VANTAGE_API_KEY=your_api_key_here

4. 개발 서버 실행

yarn dev

http://localhost:3000에서 애플리케이션을 확인할 수 있습니다.

사용 가능한 스크립트

yarn dev        # 개발 서버 실행
yarn build      # 프로덕션 빌드
yarn start      # 프로덕션 서버 실행
yarn lint       # ESLint 실행
yarn add:ui     # shadcn/ui 컴포넌트 추가

프로젝트 구조

src/
├── app/                   # Next.js App Router
├── components/
│   ├── ui/                # shadcn/ui 컴포넌트
│   └── stock-log/         # 비즈니스 로직 컴포넌트
├── apis/                  # API 레이어
├── hooks/                 # 커스텀 React 훅
└── lib/                   # 유틸리티 함수

라이선스

이 프로젝트는 MIT 라이선스를 따릅니다.

About

Percentage 별 계산된 가격 확인 서비스

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published