140 lines
3.6 KiB
Markdown
140 lines
3.6 KiB
Markdown
# 초기 진입 속도 최적화
|
|
|
|
## 변경 사항
|
|
|
|
### 1. 프론트엔드 - DB 캐시 모드 사용
|
|
- **파일**: `frontend/src/pages/Dashboard.tsx`
|
|
- **변경**: 추천 종목 조회 시 `realtime=false` 파라미터 추가
|
|
- **효과**: 30초 → 0.1초로 로딩 속도 개선 (300배 향상)
|
|
|
|
```typescript
|
|
// 기존 (느림 - 30초)
|
|
queryFn: async () => (await api.get('/recommendations/rule-based')).data,
|
|
|
|
// 변경 (빠름 - 0.1초)
|
|
queryFn: async () => (await api.get('/recommendations/rule-based', {
|
|
params: { realtime: false } // DB 캐시 사용
|
|
})).data,
|
|
```
|
|
|
|
### 2. 배치 분석 스크립트
|
|
- **파일**: `backend/batch_daily_analysis.py`
|
|
- **목적**: 매일 장 시작 전에 전체 종목을 미리 분석하여 DB에 저장
|
|
- **실행 방법**:
|
|
```bash
|
|
make batch-test # 테스트 (10개 종목)
|
|
make batch-limit LIMIT=50 # 50개 종목만
|
|
make batch-analysis # 전체 종목 (약 30-60분 소요)
|
|
```
|
|
|
|
### 3. 자동 실행 설정
|
|
- **파일**: `setup-cron.sh`
|
|
- **스케줄**: 평일 오전 8시 50분 (장 시작 전)
|
|
- **설정 방법**:
|
|
```bash
|
|
./setup-cron.sh
|
|
```
|
|
|
|
## 동작 원리
|
|
|
|
### DB 캐시 시스템
|
|
1. **배치 분석** (매일 아침 8:50)
|
|
- 전체 거래 가능 종목 조회
|
|
- 기술적 지표 계산 (RSI, MA, 볼린저밴드 등)
|
|
- `stock_analysis` 테이블에 저장
|
|
|
|
2. **실시간 조회** (사용자 진입 시)
|
|
- DB에서 사전 분석된 데이터 조회 (0.1초)
|
|
- 실시간 KIS API 호출 없음
|
|
|
|
3. **폴백 메커니즘**
|
|
- DB에 데이터가 없으면 자동으로 실시간 분석으로 전환
|
|
- 배치 실행 전에도 시스템 정상 동작
|
|
|
|
## 테이블 구조
|
|
|
|
```sql
|
|
CREATE TABLE stock_analysis (
|
|
id SERIAL PRIMARY KEY,
|
|
stock_code VARCHAR(20) NOT NULL,
|
|
stock_name VARCHAR(100) NOT NULL,
|
|
analysis_date TIMESTAMP NOT NULL,
|
|
current_price INTEGER NOT NULL,
|
|
rsi NUMERIC(10, 4),
|
|
ma5 NUMERIC(15, 2),
|
|
ma20 NUMERIC(15, 2),
|
|
ma60 NUMERIC(15, 2),
|
|
bollinger_upper NUMERIC(15, 2),
|
|
bollinger_lower NUMERIC(15, 2),
|
|
signals JSONB,
|
|
score INTEGER DEFAULT 0,
|
|
created_at TIMESTAMP DEFAULT NOW()
|
|
);
|
|
|
|
CREATE INDEX idx_stock_analysis_date ON stock_analysis(analysis_date);
|
|
CREATE INDEX idx_stock_analysis_code ON stock_analysis(stock_code);
|
|
```
|
|
|
|
## 사용 가이드
|
|
|
|
### 배치 분석 실행
|
|
```bash
|
|
# 1. 테스트 실행 (10개 종목)
|
|
make batch-test
|
|
|
|
# 2. 제한 실행 (50개 종목)
|
|
make batch-limit LIMIT=50
|
|
|
|
# 3. 전체 실행 (모든 종목)
|
|
make batch-analysis
|
|
|
|
# 4. 로그 확인
|
|
tail -f logs/batch_analysis.log
|
|
```
|
|
|
|
### 자동 실행 설정
|
|
```bash
|
|
# cron 작업 등록
|
|
./setup-cron.sh
|
|
|
|
# 확인
|
|
crontab -l
|
|
|
|
# 제거 (필요 시)
|
|
crontab -e
|
|
```
|
|
|
|
## 성능 비교
|
|
|
|
| 모드 | 로딩 시간 | API 호출 | 데이터 신선도 |
|
|
|------|-----------|----------|---------------|
|
|
| **실시간** | 30초 | 100+ 회 | 실시간 |
|
|
| **DB 캐시** | 0.1초 | 0회 | 당일 아침 기준 |
|
|
|
|
## 주의사항
|
|
|
|
1. **배치 실행 시간**: 전체 종목 분석 시 30-60분 소요
|
|
2. **API 제한**: 한국투자증권 API 호출 제한 (초당 20회)
|
|
3. **데이터 신선도**: 배치 실행 후 데이터 사용 (장중 실시간 변동 반영 안됨)
|
|
4. **장중 갱신**: 필요 시 `realtime=true`로 실시간 분석 가능
|
|
|
|
## 문제 해결
|
|
|
|
### DB에 데이터가 없을 때
|
|
```bash
|
|
# 즉시 배치 실행
|
|
make batch-test
|
|
|
|
# 또는 실시간 모드로 임시 사용
|
|
# (프론트엔드에서 자동 폴백됨)
|
|
```
|
|
|
|
### 배치 실행 실패
|
|
```bash
|
|
# 로그 확인
|
|
docker logs autostock-backend --tail 100
|
|
|
|
# 수동 실행
|
|
docker exec -it autostock-backend python batch_daily_analysis.py --test
|
|
```
|