최초 프로젝트 업로드 (Script Auto Commit)

This commit is contained in:
2025-12-03 22:36:00 +09:00
commit 4745ab3c28
33 changed files with 4251 additions and 0 deletions

33
docs/PRD.md Normal file
View File

@@ -0,0 +1,33 @@
<!-- 기획 및 로직 설계서 -->
<!-- PRD.md -->
# Product Requirements Document (PRD)
## 1. Project Overview
- **프로젝트명:** (예: Stock-Finder-AI)
- **목적:** (예: 미국/한국 주식 시장에서 특정 조건에 맞는 종목을 필터링하고, 매수/매도 신호를 포착하여 알림을 보낸다.)
- **주요 사용자:** 퀀트 투자자, 개인 트레이더
## 2. Core Features (User Stories)
1. **데이터 수집:** 야후 파이낸스 API 및 한국투자증권 API를 통해 일봉/분봉 데이터를 수집한다.
2. **지표 계산:** 수집된 데이터로 RSI, Bollinger Bands, MACD를 계산한다.
3. **필터링 로직:** PBR < 1.0 이면서 RSI < 30인 종목을 추출한다.
4. **알림 발송:** 추출된 종목을 텔레그램 봇으로 전송한다.
## 3. Data Flow & Architecture
- **Input:** 종목 리스트 (Ticker List), 설정된 파라미터 (config.json)
- **Process:**
1. Data Fetcher -> (Raw Data) -> DB 저장
2. Indicator Engine -> (Calculated Data)
3. Screener -> (Filtered List)
- **Output:** JSON 리포트 및 메신저 알림
## 4. File Structure Plan
- /src/data_loader.py : API 연동 및 데이터 수집
- /src/indicators.py : 기술적 지표 계산 로직
- /src/screener.py : 필터링 및 종목 선정 핵심 로직
- /src/notifier.py : 메시지 발송 처리
## 5. Non-Functional Requirements
- **성능:** 2000개 종목 스캔을 3분 이내 완료할 것 (멀티스레딩/비동기 필수).
- **안정성:** API 호출 제한(Rate Limit) 도달 시 자동으로 Backoff/Retry 수행.