대본 기획 도우미▸ 
AI 앱 
AI 뉴스 
OpenStock: 무료 오픈소스 및 셀프 호스팅 주식 시장 데이터 플랫폼
OpenStock: 무료 오픈소스 및 셀프 호스팅 주식 시장 데이터 플랫폼소개
OpenStock이란 무엇인가요?
OpenStock은 오픈 소스 주식 시장 도구로, 비싼 상용 플랫폼의 무료 대안으로 볼 수 있습니다. 실시간 시세 조회, 사용자 지정 알림, 기업 상세 정보 등의 기능을 제공하며, 모든 서비스는 영구적으로 무료이며 개인 투자자, 학생, 개발자를 대상으로 합니다.
OpenStock 주요 기능
로그인 시스템: 이메일과 비밀번호로 로그인하며, 데이터는 MongoDB에 저장되고 Next.js 미들웨어를 통해 페이지 접근을 보호합니다.
주식 검색: Finnhub 데이터를 기반으로 한 빠른 검색, 유휴 시 인기 주식 표시, 디바운싱(防抖) 쿼리 지원, 단축키 Ctrl+K로 검색창 열기
관심 종목 관리: 각 사용자의 관심 종목이 데이터베이스에 개별적으로 저장됩니다.
주식 상세 페이지: TradingView 차트, 기술 지표, 회사 기본 정보 및 재무 데이터를 표시합니다.
시장 개요: 주식 히트맵, 시세, 뉴스 정보를 포함합니다.
온보딩: 사용자의 국가, 투자 목표, 위험 성향 등의 정보를 수집합니다.
이메일 알림: 개인화된 환영 이메일과 일일 뉴스 요약을 자동 발송합니다.
OpenStock 기술 스택
프론트엔드: Next.js 15, React 19, TypeScript로 개발되었으며, 인터페이스는 Tailwind CSS로 설계되었고 shadcn/ui 컴포넌트 라이브러리를 사용합니다.
데이터: 주식 데이터는 Finnhub API에서 가져오며, 차트는 TradingView 임베디드 컴포넌트를 사용합니다.
백엔드: MongoDB는 사용자 데이터를 저장하고, Inngest는 자동화 작업을 처리하며, Nodemailer는 이메일을 발송합니다.
OpenStock 사용 시나리오
개인 투자 리서치: 자체 서버에 구축하여 구독료를 절약할 수 있습니다.
교육 프로젝트: 금융, 데이터 시각화 등의课程 실습 프로젝트로 활용할 수 있습니다.
소규모 투자 커뮤니티: 팀원들이 사용할 수 있도록 배포하여 내부 정보 공유에 편리합니다.
OpenStock 배포 방법:
사전 요구 사항: Node.js 20+, pnpm 또는 npm, MongoDB 연결 문자열(Atlas 또는 로컬), Finnhub API Key(무료 등급은 지연이 있을 수 있음), 선택 사항인 Gmail(또는 SMTP), 선택 사항인 Gemini API Key.
로컬 개발:
복제 및 설치: git clone https://github.com/Open-Dev-Society/OpenStock.git && cd OpenStock && pnpm install (또는 npm install)
.env 구성 및 데이터베이스 검증: pnpm test:db
개발 서버 시작: pnpm dev (또는 npm run dev)
Inngest 로컬 실행: npx inngest-cli@latest dev
접속: http://localhost:3000
Docker 배포:
서비스 시작: docker compose up -d mongodb && docker compose up -d --build
로컬 MongoDB 연결 예시: MONGODB_URI=mongodb://root:example@mongodb:27017/openstock?authSource=admin
접속: http://localhost:3000
주요 환경 변수 (예시):
MONGODB_URI、BETTER_AUTH_SECRET、BETTER_AUTH_URL=http://localhost:3000 FINNHUB_API_KEY、FINNHUB_BASE_URL=https://finnhub.io/api/v1（可选 NEXT_PUBLIC_FINNHUB_API_KEY） GEMINI_API_KEY（可选） NODEMAILER_EMAIL、NODEMAILER_PASSWORD（生产建议用专用 SMTP 服务 ）
주의 사항:
OpenStock은 정보 표시용으로만 제공되며 실제 거래 기능은 포함하지 않습니다.
무료 데이터 소스는 지연이 있을 수 있으며, 사용 시 관련 서비스 약관을 준수해야 합니다.
프로덕션 환경에서는 개인 Gmail 계정 대신 전문 이메일 서비스를 사용하는 것을 권장합니다.
OpenStock은 무료 버전의 자체 호스팅 주식 시세 소프트웨어에 해당하며, 코드는 완전한 오픈 소스이고 최신 TypeScript 기술 스택을 기반으로 하며, 로컬에서 간단하게 실행할 수 있으며 필요에 따라 맞춤 수정할 수 있습니다.
