StockBackTester/docs/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 수행.