# 🚀 전략 실행 컨트롤러 개념 정리 (`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 전략 엔진의 핵심 실행 도구로,
**분석-리스크 결과 → 실전 전략 실행**을 연결하는 완전 자동화 인터페이스입니다.

> 🎯 운영자가 이 파일 하나만 실행하면 전략이 전부 적용된 결과를 받을 수 있습니다.