84 lines
2.6 KiB
Plaintext
84 lines
2.6 KiB
Plaintext
# 🚀 전략 실행 컨트롤러 개념 정리 (`run_strategy.py`)
|
|
|
|
---
|
|
|
|
## ✅ 목적
|
|
|
|
`run_strategy.py`는 SightRay 전략 엔진의 실행 진입점(entrypoint)으로,
|
|
**전략 실행의 전체 흐름을 자동화**하여 사용자가 단일 명령으로 전략 결과를 생성할 수 있게 합니다.
|
|
|
|
> 📌 이 스크립트는 `selector → strategy template → position manager`까지의 모든 과정을 통합합니다.
|
|
|
|
---
|
|
|
|
## 🔁 전체 실행 흐름 요약
|
|
|
|
```plaintext
|
|
[risk_filtered_result.csv]
|
|
↓
|
|
selector.py
|
|
→ tradable 종목 + 전략 조건 만족 종목 추출
|
|
↓
|
|
templates/basic_strategy.py
|
|
→ TP/SL 기준 설정, 매수 여부 결정
|
|
↓
|
|
position_manager.py
|
|
→ 자금 배분 및 포지션 크기 계산
|
|
↓
|
|
[final_strategy_result.csv] 저장
|
|
```
|
|
|
|
---
|
|
|
|
## 🧩 주요 역할별 연결 구조
|
|
|
|
| 순서 | 파일 | 역할 |
|
|
|------|------|------|
|
|
| 1 | `selector.py` | 전략 조건 만족 종목 선택 (확률, risk_score 기준) |
|
|
| 2 | `basic_strategy.py` | 전략 템플릿 적용: 진입가, 목표가, 손절가 설정 |
|
|
| 3 | `position_manager.py` | 자금 배분 및 포지션 수량 계산 |
|
|
| 4 | `run_strategy.py` | 전체 흐름 통합 및 실행 CLI 제공 |
|
|
|
|
---
|
|
|
|
## ⚙️ CLI 실행 인자
|
|
|
|
```bash
|
|
python run_strategy.py \
|
|
--input risk_filtered_result.csv \
|
|
--capital 1000000 \
|
|
--output final_strategy_result.csv
|
|
```
|
|
|
|
| 인자 | 설명 |
|
|
|------|------|
|
|
| `--input` | 필수: 분석 + 리스크 필터링 결과 파일 경로 |
|
|
| `--capital` | 필수: 총 투자 자본 (ex. 1,000,000) |
|
|
| `--output` | 선택: 결과 저장 경로 (기본값: `final_strategy_result.csv`) |
|
|
|
|
---
|
|
|
|
## ✅ 출력 예시
|
|
|
|
| symbol | entry_price | target_price | stop_loss | position_size | capital_allocated |
|
|
|--------|-------------|--------------|-----------|----------------|--------------------|
|
|
| AAPL | 186.5 | 195.8 | 180.0 | 1340 | 250000 |
|
|
| TSLA | 245.2 | 257.5 | 237.8 | 1020 | 250000 |
|
|
|
|
---
|
|
|
|
## 📌 특징
|
|
|
|
- 사용자 중심 구조: 자본 입력만으로 실행 가능
|
|
- 확장 가능: 향후 다른 전략 템플릿과의 교체 용이
|
|
- CLI 환경, 자동화 배치, 대시보드 API 연동까지 고려된 진입점 설계
|
|
|
|
---
|
|
|
|
## ✅ 정리
|
|
|
|
`run_strategy.py`는 SightRay 전략 엔진의 핵심 실행 도구로,
|
|
**분석-리스크 결과 → 실전 전략 실행**을 연결하는 완전 자동화 인터페이스입니다.
|
|
|
|
> 🎯 운영자가 이 파일 하나만 실행하면 전략이 전부 적용된 결과를 받을 수 있습니다.
|