diff --git a/.gitignore b/.gitignore index 122341f..7297f8c 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,36 @@ +# Local agent/task workspace .strideterm/ + +# Local secrets and environment overrides api/config.local.php +api/config.local.php* +.env +.env.* +!.env.example + +# Runtime logs +*.log +api/logs/* +!api/logs/.htaccess + +# User-uploaded/generated media +uploads/* +!uploads/.htaccess +!uploads/**/.htaccess + +# Local backups and temporary files +backup_*/ +*_backup.* +*.bak +*.backup +*.tmp +*.temp +*.orig +*.rej + +# OS/editor noise +.DS_Store +Thumbs.db +Desktop.ini +.vscode/ +.idea/ diff --git a/api/logs/.htaccess b/api/logs/.htaccess new file mode 100644 index 0000000..1634c2a --- /dev/null +++ b/api/logs/.htaccess @@ -0,0 +1,8 @@ +# 로그 디렉토리 웹 직접 접근 차단 + + Require all denied + + + Order deny,allow + Deny from all + diff --git a/api/logs/app.log b/api/logs/app.log deleted file mode 100644 index e69de29..0000000 diff --git a/backup_20260517/index.html b/backup_20260517/index.html deleted file mode 100644 index 3e0216b..0000000 --- a/backup_20260517/index.html +++ /dev/null @@ -1,2126 +0,0 @@ - - - - - -이종재 | Game & XR Developer - - - - - - - - -
-

이종재 Portfolio

-

Game & XR 개발자로서의 기술적 도전과 기록을 담은 공간입니다.
Gitea 서버를 통해 실제 소스 코드를 확인하실 수 있습니다.

-
- -
-
-

DEVELOPMENT LOG

-
- -
-
- -
- - - - - - - - - - - - diff --git a/backup_20260517/learning.html b/backup_20260517/learning.html deleted file mode 100644 index 1acaa3b..0000000 --- a/backup_20260517/learning.html +++ /dev/null @@ -1,4184 +0,0 @@ - - - - - -Learning Log | 이종재 - - - - - - - - - - - - - -
-

LEARNING LOG

-

학습한 내용과 현재 공부 중인 주제를 기록하는 공간입니다. 결과물보다 그 과정을 보여주고 싶었습니다.

- -
-
- // ACTIVITY (최근 1년) - - - — posts - -
-
-
- 월수금 -
-
-
-
-
-
-
-
- -
- - - - -
-
-
-

전체

- 0 posts -
-
- - -
-
- -
- - - -
- -
- -
-
-
- - - - -
- - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/backup_20260517/profile.html b/backup_20260517/profile.html deleted file mode 100644 index 7c40a7f..0000000 --- a/backup_20260517/profile.html +++ /dev/null @@ -1,1266 +0,0 @@ - - - - - -Profile | 이종재 - - - - - - - - -
-
-
-
- -
-
-
- // PROFILE -

Loading...

-
-

-
- - -
-
-
- -
-
-

ABOUT

-
- -
-

-
- -
-
-

TECH STACK

-
-
-
-
- -
-
-

JOURNEY

-
-
-
-
- -
-
-

CONTACT

-
-
-
-
- - - - - - - -
- 복사되었습니다 -
- - - - - - - diff --git a/index_backup.html b/index_backup.html deleted file mode 100644 index ff59247..0000000 --- a/index_backup.html +++ /dev/null @@ -1,639 +0,0 @@ - - - - - - 이종재 | Game & XR Developer - - - - - - - - -
-

이종재 Portfolio

-

Game & XR 개발자로서의 기술적 도전과 기록을 담은 공간입니다.
Gitea 서버를 통해 실제 소스 코드를 확인하실 수 있습니다.

-
- -
-
-

DEVELOPMENT LOG

-
- -
- -
- -
-
- - - - - - - - - - - - diff --git a/uploads/BeatSaber/beatsaber.mp4 b/uploads/BeatSaber/beatsaber.mp4 deleted file mode 100644 index a8f016b..0000000 Binary files a/uploads/BeatSaber/beatsaber.mp4 and /dev/null differ diff --git a/uploads/BeatSaber/img_6a193f37360c14.56970202.webp b/uploads/BeatSaber/img_6a193f37360c14.56970202.webp deleted file mode 100644 index b1e9a99..0000000 Binary files a/uploads/BeatSaber/img_6a193f37360c14.56970202.webp and /dev/null differ diff --git a/uploads/BeatSaber/img_6a193f37c56dc7.05489597.webp b/uploads/BeatSaber/img_6a193f37c56dc7.05489597.webp deleted file mode 100644 index 1fa3aa7..0000000 Binary files a/uploads/BeatSaber/img_6a193f37c56dc7.05489597.webp and /dev/null differ diff --git a/uploads/BeatSaber/img_6a193f386123d1.60613240.webp b/uploads/BeatSaber/img_6a193f386123d1.60613240.webp deleted file mode 100644 index 7bb5965..0000000 Binary files a/uploads/BeatSaber/img_6a193f386123d1.60613240.webp and /dev/null differ diff --git a/uploads/WildRoot/WIldRoot.mp4 b/uploads/WildRoot/WIldRoot.mp4 deleted file mode 100644 index 1ace4a2..0000000 Binary files a/uploads/WildRoot/WIldRoot.mp4 and /dev/null differ diff --git a/uploads/WildRoot/img_69f356c02ec8e4.60887672.jpg b/uploads/WildRoot/img_69f356c02ec8e4.60887672.jpg deleted file mode 100644 index 5d3a752..0000000 Binary files a/uploads/WildRoot/img_69f356c02ec8e4.60887672.jpg and /dev/null differ diff --git a/uploads/WildRoot/img_69f356c0354dc0.69476663.jpg b/uploads/WildRoot/img_69f356c0354dc0.69476663.jpg deleted file mode 100644 index b4883d6..0000000 Binary files a/uploads/WildRoot/img_69f356c0354dc0.69476663.jpg and /dev/null differ diff --git a/uploads/WildRoot/img_69f356c037cfb4.05035323.jpg b/uploads/WildRoot/img_69f356c037cfb4.05035323.jpg deleted file mode 100644 index cf0d928..0000000 Binary files a/uploads/WildRoot/img_69f356c037cfb4.05035323.jpg and /dev/null differ diff --git a/uploads/learning/img_69fbebaa899a91.08494186.png b/uploads/learning/img_69fbebaa899a91.08494186.png deleted file mode 100644 index a3ca553..0000000 Binary files a/uploads/learning/img_69fbebaa899a91.08494186.png and /dev/null differ diff --git a/uploads/learning/img_69fc0fc99e4878.90583225.png b/uploads/learning/img_69fc0fc99e4878.90583225.png deleted file mode 100644 index 2698ef8..0000000 Binary files a/uploads/learning/img_69fc0fc99e4878.90583225.png and /dev/null differ diff --git a/uploads/learning/img_69fc1ee3125881.56665647.png b/uploads/learning/img_69fc1ee3125881.56665647.png deleted file mode 100644 index f17a170..0000000 Binary files a/uploads/learning/img_69fc1ee3125881.56665647.png and /dev/null differ diff --git a/uploads/learning/img_69fc4a449dbd03.59040666.png b/uploads/learning/img_69fc4a449dbd03.59040666.png deleted file mode 100644 index d212d1b..0000000 Binary files a/uploads/learning/img_69fc4a449dbd03.59040666.png and /dev/null differ diff --git a/uploads/learning/img_6a03e141ed08a3.31548852.png b/uploads/learning/img_6a03e141ed08a3.31548852.png deleted file mode 100644 index b546a6b..0000000 Binary files a/uploads/learning/img_6a03e141ed08a3.31548852.png and /dev/null differ diff --git a/uploads/learning/img_6a0c199a30c9b5.01614885.webp b/uploads/learning/img_6a0c199a30c9b5.01614885.webp deleted file mode 100644 index 4f19e23..0000000 Binary files a/uploads/learning/img_6a0c199a30c9b5.01614885.webp and /dev/null differ diff --git a/uploads/learning/img_6a0c1a0f63adc3.95162510.webp b/uploads/learning/img_6a0c1a0f63adc3.95162510.webp deleted file mode 100644 index eec8670..0000000 Binary files a/uploads/learning/img_6a0c1a0f63adc3.95162510.webp and /dev/null differ diff --git a/uploads/learning/img_6a0c1a0f93c817.82156909.webp b/uploads/learning/img_6a0c1a0f93c817.82156909.webp deleted file mode 100644 index 0ab2eea..0000000 Binary files a/uploads/learning/img_6a0c1a0f93c817.82156909.webp and /dev/null differ diff --git a/uploads/learning/vid_69faa7131137b6.34828927.mp4 b/uploads/learning/vid_69faa7131137b6.34828927.mp4 deleted file mode 100644 index e555cb2..0000000 Binary files a/uploads/learning/vid_69faa7131137b6.34828927.mp4 and /dev/null differ diff --git a/uploads/learning/종합기획서_단타자동매매_6a041d60084271.93225085.txt b/uploads/learning/종합기획서_단타자동매매_6a041d60084271.93225085.txt deleted file mode 100644 index f36cbf3..0000000 --- a/uploads/learning/종합기획서_단타자동매매_6a041d60084271.93225085.txt +++ /dev/null @@ -1,536 +0,0 @@ -# 단타 자동매매 시스템 종합 기획서 - -> 버전: v1.0 -> 기준: 한국 주식 (코스피/코스닥) / KIS Open API / Synology NAS Docker -> 원칙: 규칙 기반 완전 자동화, 인간 판단 개입 0 - ---- - -## 0. 설계 원칙 (절대 불변) - -1. **감정 0** — 모든 진입/청산은 코드가 결정. 예외 없음 -2. **손절 우선** — 수익 극대화보다 손실 제한이 먼저 -3. **단순함 우선** — 복잡한 전략보다 단순하고 견고한 전략 -4. **검증 후 실거래** — 백테스트 → 모의투자 3개월 → 소액 실거래 순서 필수 -5. **14:50 전량 청산** — 오버나이트는 절대 없음. 하드코딩 - ---- - -## 1. 시스템 전체 구조 - -``` -┌─────────────────────────────────────────────────────────┐ -│ Synology NAS (Docker) │ -│ │ -│ ┌──────────────┐ ┌──────────────┐ │ -│ │ stockbot │ │ kill-switch │ ← 별도 컨테이너 │ -│ │ (메인) │ │ (긴급중단) │ │ -│ └──────┬───────┘ └──────────────┘ │ -│ │ │ -│ ┌──────▼───────────────────────────────────┐ │ -│ │ asyncio Event Loop │ │ -│ │ ┌─────────┐ ┌─────────┐ ┌───────────┐ │ │ -│ │ │Universe │ │Strategy │ │ Risk │ │ │ -│ │ │Scanner │ │Engine │ │ Manager │ │ │ -│ │ └─────────┘ └─────────┘ └───────────┘ │ │ -│ │ ┌─────────┐ ┌─────────┐ ┌───────────┐ │ │ -│ │ │ Data │ │ Order │ │ Notifier │ │ │ -│ │ │Collector│ │Executor │ │(Telegram) │ │ │ -│ │ └─────────┘ └─────────┘ └───────────┘ │ │ -│ └───────────────────────┬──────────────────┘ │ -│ │ │ -│ ┌───────────────────────▼──────────────────┐ │ -│ │ SQLite (체결/포지션/로그) │ │ -│ │ Redis (실시간 시세 캐시) │ │ -│ └──────────────────────────────────────────┘ │ -│ │ -│ ┌──────────────────────────────────────────┐ │ -│ │ Streamlit Dashboard (포트 8501) │ │ -│ └──────────────────────────────────────────┘ │ -└─────────────────────────────────────────────────────────┘ - │ │ - KIS WebSocket KIS REST API - (실시간 시세) (주문/잔고) -``` - ---- - -## 2. 기술 스택 (확정) - -| 항목 | 선택 | 이유 | -|------|------|------| -| 언어 | Python 3.11 | 생태계, KIS 예제 코드 모두 Python | -| 비동기 | asyncio + aiohttp | 초당 20건 rate limit 정밀 제어 | -| DB | SQLite | NAS 메모리 절약, 단일 파일 백업 용이 | -| 캐시 | Redis 7 (Docker) | 실시간 시세 캐시, TTL 관리 | -| 스케줄러 | APScheduler 3.x (AsyncIOScheduler) | 장 시작/마감 이벤트 트리거 | -| 알림 | python-telegram-bot | 단일 채널, 신뢰성 높음 | -| 대시보드 | Streamlit | 설치 단순, NAS 내부망 접근 | -| 컨테이너 | Docker Compose | Synology Container Manager 호환 | -| 백테스트 | vectorbt | pandas 기반, 분봉 데이터 처리 빠름 | -| 데이터 수집 | pykrx + KIS REST | 과거 분봉 백필 | - ---- - -## 3. 디렉토리 구조 - -``` -/volume1/docker/stockbot/ -│ -├── docker-compose.yml -├── .env ← API 키 전용 (Git 제외) -│ -├── app/ -│ ├── main.py ← 진입점, asyncio 루프 -│ ├── config.py ← 전략 파라미터 전용 -│ │ -│ ├── data/ -│ │ ├── collector.py ← KIS WebSocket 시세 수신 -│ │ ├── universe.py ← 종목 풀 갱신 (08:30) -│ │ └── backfill.py ← 과거 분봉 백필 스크립트 -│ │ -│ ├── strategy/ -│ │ ├── base.py ← 전략 추상 클래스 -│ │ └── volatility_breakout.py ← 전략 A (유일한 실전 전략) -│ │ -│ ├── risk/ -│ │ └── manager.py ← 손절/일일한도/강제청산 -│ │ -│ ├── execution/ -│ │ ├── kis_client.py ← KIS REST/WebSocket 래퍼 -│ │ └── order_executor.py ← 주문 전송, 재시도, 슬리피지 -│ │ -│ ├── monitor/ -│ │ ├── notifier.py ← 텔레그램 알림 -│ │ └── dashboard.py ← Streamlit 대시보드 -│ │ -│ └── db/ -│ ├── models.py ← SQLite 스키마 -│ └── repository.py ← DB 접근 레이어 -│ -├── kill_switch/ -│ └── kill.py ← 긴급 전량 청산 단독 실행 -│ -├── backtest/ -│ ├── run_backtest.py ← vectorbt 백테스트 실행 -│ └── results/ ← 백테스트 결과 저장 -│ -├── data/ -│ ├── stockbot.db ← SQLite DB -│ └── universe_cache.json ← 당일 종목 풀 캐시 -│ -└── logs/ - └── trades.log ← 영구 보관 (세금 신고용) -``` - ---- - -## 4. 전략 (확정: 전략 A 단독) - -### 변동성 돌파 전략 (Volatility Breakout) - -**선정 이유:** -- 래리 윌리엄스 실전 검증, 30년 이상 데이터 기반 -- 룰이 단순 → 과적합 위험 최소 -- 분봉 적용 시 한국 장 오전 변동성과 궁합 최적 -- 진입 조건이 명확 → 자동화 구현 난이도 낮음 - -**핵심 파라미터 (config.py에서 관리)** -```python -STRATEGY_K = 0.5 # 변동성 계수 (0.4~0.6 안정 구간) -ENTRY_START = "09:00" # 진입 허용 시작 -ENTRY_END = "14:30" # 진입 허용 마감 -FORCE_EXIT = "14:50" # 강제 청산 시각 (하드코딩) -TP1_PCT = 0.02 # 1차 익절 +2% (50% 매도) -TP2_PCT = 0.03 # 2차 익절 +3% (전량) -SL_PCT = 0.015 # 손절 -1.5% (즉시 시장가) -MAX_HOLD_MIN = 120 # 최대 보유시간 120분 (무수익 시 청산) -``` - -**진입 로직** -``` -목표가 = 당일 시가 + (전일 고가 - 전일 저가) × K - -진입 조건 (전부 충족 시): - 1. 현재가 >= 목표가 - 2. 현재 시각 ENTRY_START ~ ENTRY_END - 3. 당일 KOSPI 등락률 > -1.0% ← 시장 약세 차단 - 4. 전일 거래대금 >= 100억 - 5. 시가총액 1,000억 ~ 3조 - 6. VI 미발동 종목 - 7. 당일 보유 종목 수 < 2 ← 동시 최대 2종목 - 8. 일일 누적 손실 < -3% ← 손실 한도 미도달 -``` - -**청산 로직 (우선순위 순)** -``` -1순위: 강제 청산 → 14:50 시장가 전량 -2순위: 손절 → 현재가 <= 매수가 × (1 - SL_PCT) → 시장가 -3순위: 1차 익절 → 현재가 >= 매수가 × (1 + TP1_PCT) → 50% 지정가 -4순위: 2차 익절 → 현재가 >= 매수가 × (1 + TP2_PCT) → 전량 지정가 -5순위: 시간 청산 → 보유 후 MAX_HOLD_MIN 경과, 수익 없을 시 시장가 -``` - ---- - -## 5. 종목 유니버스 선정 (Universe) - -매일 08:30 자동 갱신. - -**1차 필터 (정적)** -| 조건 | 기준 | -|------|------| -| 시장 | 코스피 + 코스닥 | -| 시가총액 | 1,000억 ~ 3조 | -| 상장 기간 | 6개월 이상 | -| 제외 | 관리종목, 거래정지, 우선주, 스팩, ETF, ETN | - -**2차 필터 (동적, 전일 기준)** -| 조건 | 기준 | -|------|------| -| 전일 거래대금 | 100억 이상 | -| 5일 평균 거래대금 | 50억 이상 | -| 전일 등락률 | -3% ~ +15% | -| 일봉 60일 이평선 | 현재가 위 | - -**결과: 최대 30종목** (KIS WebSocket 안정성 기준으로 50 → 30 축소) - ---- - -## 6. 리스크 관리 - -### 포지션 규칙 -| 항목 | 값 | -|------|-----| -| 1종목 최대 비중 | 총자산 × 20% | -| 동시 보유 최대 | 2종목 | -| 분할매수 | 1차 10%, 신호 유지 시 2차 10% | - -### 손실 한도 (계층별 자동 중단) -| 레벨 | 조건 | 동작 | -|------|------|------| -| L1 | 1회 매매 -1.5% | 즉시 손절 | -| L2 | 일일 누적 -3% | 당일 신규 진입 중단 | -| L3 | 3연속 손절 | 당일 매매 중단 | -| L4 | 주간 누적 -7% | 주말까지 중단 + 텔레그램 경고 | -| L5 | 월간 누적 -15% | 자동 전략 폐기 + 백테스트 재요청 | - -### 안전장치 -- VI(변동성완화장치) 발동 → 즉시 해당 종목 청산 -- 호가 스프레드 > 0.5% → 진입 금지 -- 매수 후 5분 미체결 → 주문 취소 -- WebSocket 끊김 → 보유 포지션 즉시 시장가 청산 -- API 오류 10건/분 → kill-switch 컨테이너 자동 실행 - ---- - -## 7. KIS API 운용 - -### 초당 20건 제한 대응 전략 -``` -WebSocket (실시간 시세) : 30종목 구독 → REST 호출 없음 -REST (주문/잔고) : 주문 시에만 호출 -REST (분봉 조회) : 신호 확인용, 1초 간격 제한 - -asyncio Semaphore(20) 로 초당 20건 보장 -배치 처리: 30종목 ÷ 20건 = 1.5초/1회전 -``` - -### WebSocket 구독 항목 -- 실시간 체결가 (H0STCNT0) -- 실시간 호가 (H0STASP0) -- VI 발동/해제 (H0STVI0) - -### 주문 타입 결정 -| 상황 | 주문 타입 | -|------|----------| -| 진입 | 시장가 (빠른 체결 우선) | -| 1차 익절 | 지정가 (목표가 미리 걸기) | -| 2차 익절 | 지정가 | -| 손절 | 시장가 (슬리피지 감수) | -| 강제청산 | 시장가 | - ---- - -## 8. 스케줄 타임라인 - -``` -08:00 │ 시스템 기동, DB 연결 확인 -08:30 │ Universe 갱신 (pykrx 전일 데이터) -08:50 │ WebSocket 연결, 30종목 구독 시작 - │ 당일 시가 기반 목표가 계산 -09:00 │ ─────────── 진입 허용 시작 ─────────── - │ 1분봉 루프 시작 (asyncio, 1초 단위) -11:30 │ 신규 진입 일시 중단 (점심) -13:00 │ 신규 진입 재개 -14:30 │ 신규 진입 마감 -14:50 │ ─────────── 강제 청산 ─────────────── - │ 보유 포지션 전량 시장가 매도 -15:00 │ WebSocket 연결 종료 -15:10 │ 당일 결산 로그 생성 -15:20 │ 텔레그램 일일 결산 알림 발송 -15:30 │ 시스템 대기 (다음 날 08:00까지) -``` - ---- - -## 9. DB 스키마 (SQLite) - -```sql --- 체결 내역 -CREATE TABLE trades ( - id INTEGER PRIMARY KEY AUTOINCREMENT, - date TEXT NOT NULL, -- YYYY-MM-DD - ticker TEXT NOT NULL, - entry_time TEXT NOT NULL, -- HH:MM:SS - exit_time TEXT, - entry_price REAL NOT NULL, - exit_price REAL, - quantity INTEGER NOT NULL, - side TEXT NOT NULL, -- BUY / SELL - exit_reason TEXT, -- TP1/TP2/SL/FORCE/TIME - pnl REAL, - fee REAL, - slippage REAL, - strategy TEXT DEFAULT 'VB' -); - --- 일일 요약 -CREATE TABLE daily_summary ( - date TEXT PRIMARY KEY, - total_trades INTEGER, - win_trades INTEGER, - lose_trades INTEGER, - gross_pnl REAL, - total_fee REAL, - net_pnl REAL, - max_drawdown REAL, - trading_stopped INTEGER DEFAULT 0 -- L2 발동 여부 -); - --- 포지션 (장중 현황) -CREATE TABLE positions ( - ticker TEXT PRIMARY KEY, - entry_time TEXT, - entry_price REAL, - quantity INTEGER, - tp1_done INTEGER DEFAULT 0, - target_price REAL, - stop_price REAL -); -``` - ---- - -## 10. 알림 설계 (텔레그램) - -| 이벤트 | 메시지 형식 | -|--------|-----------| -| 진입 | `[매수] 삼성전자 74,000원 / 목표 75,480 / 손절 72,890` | -| 1차 익절 | `[익절1] 삼성전자 +2.1% / 잔여 50%` | -| 손절 | `[손절] 삼성전자 -1.5% / 즉시 청산` | -| 강제 청산 | `[14:50 강제청산] 전 포지션 청산 완료` | -| L2 발동 | `[경고] 일일 손실 -3% 도달. 오늘 매매 중단.` | -| 일일 결산 | `[결산] 매매 5회 / 승 3 패 2 / 순손익 +1.2%` | -| 장애 | `[긴급] WebSocket 끊김. kill-switch 실행.` | - ---- - -## 11. 백테스트 계획 - -### 데이터 준비 -``` -수집 대상: 코스피200 + 코스닥150 편입 종목 -기간: 2021-01-01 ~ 2024-12-31 (4년치) -봉: 1분봉 -도구: pykrx (무료, 과거 분봉 제공) -생존편향: 상장폐지 종목 별도 수집 포함 -``` - -### 수수료 시뮬레이션 -``` -매수 수수료: 0.015% -매도 수수료: 0.015% -거래세: 0.18% (매도 시) -슬리피지: 시장가 0.10%, 지정가 0.03% -총 1회전 비용 추정: 약 0.21% -``` - -### 합격 기준 (out-of-sample 1년 기준) -| 지표 | 통과 기준 | 목표 | -|------|----------|------| -| 샤프지수 | > 1.0 | > 1.5 | -| MDD | < 15% | < 10% | -| 승률 | > 45% | > 55% | -| 손익비 | > 1.3 | > 1.8 | -| 일평균 매매 | 1~5회 | 2~3회 | - -### K값 최적화 방법 -``` -1. K = 0.3 ~ 0.8 구간 0.05 단위 그리드 서치 -2. 인샘플(2021~2023) 에서 상위 3개 K값 선별 -3. 아웃샘플(2024) 에서 재검증 -4. 피크 K값 배제 → 샤프지수 안정 구간 채택 -5. 최종 채택: K = 0.5 (사전 기본값, 백테스트로 재확인) -``` - ---- - -## 12. 인프라 (Synology Docker) - -### docker-compose.yml -```yaml -version: "3.9" - -services: - redis: - image: redis:7-alpine - container_name: stockbot-redis - restart: unless-stopped - volumes: - - ./data/redis:/data - - stockbot: - build: ./app - container_name: stockbot-main - restart: unless-stopped - depends_on: - - redis - env_file: .env - volumes: - - ./data:/app/data - - ./logs:/app/logs - environment: - - TZ=Asia/Seoul - logging: - driver: "json-file" - options: - max-size: "10m" - max-file: "5" - - kill-switch: - build: ./kill_switch - container_name: stockbot-killswitch - restart: "no" # 수동 또는 자동 트리거 시에만 실행 - env_file: .env - profiles: ["emergency"] # docker compose --profile emergency up - - dashboard: - build: ./monitor - container_name: stockbot-dashboard - restart: unless-stopped - ports: - - "8501:8501" - volumes: - - ./data:/app/data - environment: - - TZ=Asia/Seoul -``` - -### .env 구조 -``` -# KIS API -KIS_APP_KEY=... -KIS_APP_SECRET=... -KIS_ACCOUNT_NO=... -KIS_MOCK=true # 모의투자: true / 실거래: false - -# 텔레그램 -TELEGRAM_TOKEN=... -TELEGRAM_CHAT_ID=... - -# Redis -REDIS_HOST=stockbot-redis -REDIS_PORT=6379 - -# 운영 모드 -DRY_RUN=true # 주문 실제 전송 여부 -LOG_LEVEL=INFO -``` - ---- - -## 13. 개발 로드맵 - -### Phase 1 — 데이터 기반 구축 (2주) -- [ ] KIS Open API 신청 + 모의투자 계좌 개설 -- [ ] pykrx로 2021~2024 분봉 데이터 백필 -- [ ] SQLite 스키마 생성 -- [ ] Universe 스캐너 구현 (08:30 갱신) -- [ ] Docker Compose 기동 확인 (NAS) - -### Phase 2 — 백테스트 (3주) -- [ ] vectorbt 환경 구성 -- [ ] 변동성 돌파 전략 백테스트 코드 작성 -- [ ] 수수료/슬리피지 반영 -- [ ] K값 그리드 서치 -- [ ] out-of-sample 검증 → 합격 기준 통과 확인 - -### Phase 3 — KIS 연동 + dry-run (2주) -- [ ] KIS REST 클라이언트 구현 (인증/토큰 갱신) -- [ ] KIS WebSocket 클라이언트 구현 (시세 수신) -- [ ] OrderExecutor 구현 (시장가/지정가/IOC) -- [ ] DRY_RUN=true 상태에서 신호 발생 확인 - -### Phase 4 — 리스크 + 알림 + 대시보드 (2주) -- [ ] RiskManager 전 계층 구현 (L1~L5) -- [ ] kill-switch 컨테이너 구현 -- [ ] 텔레그램 Notifier 구현 -- [ ] Streamlit 대시보드 구현 (실시간 PnL) - -### Phase 5 — 모의투자 실운영 (최소 3개월) -- [ ] KIS_MOCK=true, DRY_RUN=false -- [ ] 매일 결산 로그 검토 -- [ ] 주간 샤프지수/MDD 추적 -- [ ] 이상 거동 발생 시 전략 파라미터 재검토 (코드 수정, K값 조정) -- [ ] 3개월 연속 샤프 > 1.0, MDD < 15% 달성 시 Phase 6 진입 - -### Phase 6 — 소액 실거래 (무기한) -- [ ] KIS_MOCK=false -- [ ] 총자산의 5% 한도로 시작 -- [ ] 1개월 단위 성과 검토, 한도 점진 확대 - ---- - -## 14. 보안 체크리스트 - -- [ ] .env → .gitignore 등록 필수 -- [ ] KIS API 키 → GitHub 절대 커밋 금지 -- [ ] Synology 방화벽: 8501 포트 내부망만 허용 -- [ ] 텔레그램 봇: 특정 chat_id만 허용 (화이트리스트) -- [ ] 모든 주문 로그 SQLite + logs/ 이중 보관 -- [ ] 월 1회 .env 파일 암호화 백업 - ---- - -## 15. 절대 금지 항목 (하드코딩) - -```python -# 이 리스트는 코드에서 상수로 관리, 절대 런타임 수정 불가 -BLACKLIST_REASONS = [ - "신규상장 6개월 미만", - "관리종목", - "투자경고", - "거래정지", - "우선주", - "스팩", - "ETF/ETN", -] - -TRADING_BLACKOUT = [ - ("11:30", "13:00"), # 점심 휴식 - ("14:50", "15:30"), # 장 마감 전 - ("08:00", "09:00"), # 동시호가 -] - -HARD_EXIT_TIME = "14:50" # 절대 변경 불가 -``` - ---- - -## 16. 면책 조항 - -> 본 기획서는 시스템 설계 문서이며, 투자 수익을 보장하지 않는다. -> 단타는 통계적으로 개인투자자의 90% 이상이 손실을 보는 영역이다. -> 백테스트 결과는 미래 수익을 보장하지 않으며, 반드시 모의투자 3개월 이상 검증 후 실거래로 전환할 것. -> 시스템 장애, API 오류, 네트워크 단절로 인한 손실에 대해 어떠한 책임도 지지 않는다. diff --git a/uploads/learning/종합기획서_단타자동매매_v2_6a041d600dc6a8.01129668.txt b/uploads/learning/종합기획서_단타자동매매_v2_6a041d600dc6a8.01129668.txt deleted file mode 100644 index 66a3374..0000000 --- a/uploads/learning/종합기획서_단타자동매매_v2_6a041d600dc6a8.01129668.txt +++ /dev/null @@ -1,743 +0,0 @@ -# 단타 자동매매 시스템 종합 기획서 v2.0 - -> 버전: v2.0 (AI 판단 레이어 통합) -> 기준: 한국 주식 (코스피/코스닥) / KIS Open API / Synology NAS Docker -> 핵심 변경: 규칙 기반 실행 + Claude AI 일일 시장 판단 레이어 추가 - ---- - -## 0. 설계 원칙 (절대 불변) - -1. **감정 0** — 실행은 코드가 결정. 단, 판단은 AI가 보조 -2. **속도/판단 역할 분리** — AI는 느리지만 깊게(매일 1회), 실행은 빠르게(수식) -3. **손절 우선** — AI가 긍정 판단해도 손절 룰은 무조건 우선 -4. **검증 후 실거래** — 백테스트 → 모의투자 3개월 → 소액 실거래 -5. **14:50 전량 청산** — 하드코딩, 어떤 상황에서도 예외 없음 - ---- - -## 1. 시스템 전체 구조 (v2.0) - -``` -┌──────────────────────────────────────────────────────────────┐ -│ Synology NAS (Docker) │ -│ │ -│ ┌─────────────────────────────────────────────────────────┐ │ -│ │ [레이어 1] AI 판단 엔진 (08:00) │ │ -│ │ │ │ -│ │ 데이터 수집 │ │ -│ │ ├─ 전일 뉴스 (네이버 금융 크롤링) │ │ -│ │ ├─ KOSPI/KOSDAQ 지수 흐름 (KIS REST) │ │ -│ │ ├─ 외국인/기관 순매수 상위 (KIS 순위분석 API) │ │ -│ │ ├─ 거래량 급증 종목 (KIS 순위분석 API) │ │ -│ │ └─ 섹터별 등락률 (KIS 업종/기타 API) │ │ -│ │ ↓ │ │ -│ │ Claude API 호출 (하루 1회, 약 3,000 토큰) │ │ -│ │ ↓ │ │ -│ │ daily_context.json 생성 │ │ -│ └─────────────────────────────────────────────────────────┘ │ -│ ↓ 읽기만 함 │ -│ ┌─────────────────────────────────────────────────────────┐ │ -│ │ [레이어 2] 규칙 기반 실행 엔진 (09:00~) │ │ -│ │ │ │ -│ │ asyncio Event Loop │ │ -│ │ ┌──────────┐ ┌──────────┐ ┌────────────┐ │ │ -│ │ │Universe │ │Strategy │ │ Risk │ │ │ -│ │ │Scanner │ │Engine │ │ Manager │ │ │ -│ │ └──────────┘ └──────────┘ └────────────┘ │ │ -│ │ ┌──────────┐ ┌──────────┐ ┌────────────┐ │ │ -│ │ │ Data │ │ Order │ │ Notifier │ │ │ -│ │ │Collector │ │Executor │ │(Telegram) │ │ │ -│ │ └──────────┘ └──────────┘ └────────────┘ │ │ -│ └─────────────────────────────────────────────────────────┘ │ -│ ↓ │ -│ ┌─────────────────────────────────────────────────────────┐ │ -│ │ SQLite (체결/포지션/로그) │ Redis (실시간 시세 캐시) │ │ -│ └─────────────────────────────────────────────────────────┘ │ -│ ┌─────────────────────────────────────────────────────────┐ │ -│ │ Streamlit Dashboard (포트 8501) │ │ -│ └─────────────────────────────────────────────────────────┘ │ -│ ┌─────────────────────────────────────────────────────────┐ │ -│ │ kill-switch (별도 컨테이너 / 긴급 청산) │ │ -│ └─────────────────────────────────────────────────────────┘ │ -└──────────────────────────────────────────────────────────────┘ - │ │ - KIS WebSocket KIS REST API - (실시간 시세/VI) (주문/잔고/순위/수급) -``` - ---- - -## 2. 핵심 변경: AI 판단 레이어 상세 - -### 2-1. 수집 데이터 소스 - -| 데이터 | 소스 | 방법 | 수집 시각 | -|--------|------|------|---------| -| 전일 종목 뉴스 헤드라인 | 네이버 금융 | HTTP 크롤링 | 07:30 | -| KOSPI/KOSDAQ 전일 종가·등락률 | KIS REST | API | 07:40 | -| 외국인 순매수 상위 30종목 | KIS 순위분석 API | API | 07:40 | -| 기관 순매수 상위 30종목 | KIS 순위분석 API | API | 07:40 | -| 거래량 급증 상위 30종목 | KIS 순위분석 API | API | 07:40 | -| 업종별 등락률 | KIS 업종/기타 API | API | 07:40 | -| 당일 경제 일정 (FOMC 등) | 네이버 금융 크롤링 | HTTP 크롤링 | 07:30 | - -> KIS API만으로 수급·수치 데이터 대부분 커버 가능. 뉴스는 네이버 금융 크롤링으로 보완. - -### 2-2. Claude API 프롬프트 구조 - -```python -SYSTEM_PROMPT = """ -당신은 한국 주식 단타 전문 AI 분석가입니다. -매일 장 시작 전, 제공된 데이터를 분석해 오늘 단타 매매 전략을 판단합니다. -반드시 JSON 형식으로만 응답하며, 다른 텍스트는 포함하지 않습니다. -""" - -USER_PROMPT = f""" -[전일 시장 요약] -- KOSPI: {kospi_change}% ({kospi_close}pt) -- KOSDAQ: {kosdaq_change}% ({kosdaq_close}pt) - -[외국인 순매수 상위] -{foreign_buy_top10} - -[기관 순매수 상위] -{institution_buy_top10} - -[거래량 급증 상위] -{volume_surge_top10} - -[업종별 등락률] -{sector_changes} - -[주요 뉴스 헤드라인 (상위 20건)] -{news_headlines} - -[오늘 경제 일정] -{economic_calendar} - -위 데이터를 분석해 다음 JSON을 반환하세요: -{{ - "trade_allowed": true/false, - "market_sentiment": "강세/중립/약세", - "sentiment_score": 0~100, - "risk_level": "낮음/보통/높음", - "hot_sectors": ["섹터1", "섹터2"], - "avoid_sectors": ["섹터3"], - "boosted_tickers": ["005930", "000660"], - "blacklist_tickers": ["종목코드"], - "position_size_multiplier": 0.5~1.5, - "reason": "한 줄 판단 이유" -}} -""" -``` - -### 2-3. daily_context.json 구조 - -```json -{ - "date": "2026-05-13", - "generated_at": "08:05:22", - "trade_allowed": true, - "market_sentiment": "중립", - "sentiment_score": 62, - "risk_level": "보통", - "hot_sectors": ["반도체", "2차전지"], - "avoid_sectors": ["금융", "건설"], - "boosted_tickers": ["005930", "000660", "373220"], - "blacklist_tickers": [], - "position_size_multiplier": 1.0, - "reason": "외국인 반도체 순매수 지속, KOSPI 박스권 상단 접근 중립 판단" -} -``` - -### 2-4. 실행 엔진에서의 활용 - -```python -# 진입 조건에 AI 판단 필터 추가 (기존 조건 1~8 + 신규 9~11) -진입 조건 (전부 충족 시): - 1. 현재가 >= 목표가 (변동성 돌파) - 2. 현재 시각 09:00 ~ 14:30 - 3. KOSPI 등락률 > -1.0% - 4. 전일 거래대금 >= 100억 - 5. 시가총액 1,000억 ~ 3조 - 6. VI 미발동 - 7. 보유 종목 수 < 2 - 8. 일일 누적 손실 < -3% - ── AI 판단 필터 (신규) ── - 9. daily_context["trade_allowed"] == true - 10. 해당 종목 섹터가 avoid_sectors에 없음 - 11. 해당 종목이 blacklist_tickers에 없음 - -# 포지션 사이즈 조정 -실제_투자비중 = 기본비중(20%) × position_size_multiplier -# sentiment_score 높을수록 multiplier 증가 (0.5~1.5) - -# boosted_tickers 우선 진입 -boosted 종목은 동일 신호 시 다른 종목보다 먼저 진입 처리 -``` - ---- - -## 3. 기술 스택 (v2.0 확정) - -| 항목 | 선택 | 이유 | -|------|------|------| -| 언어 | Python 3.11 | KIS 예제 코드 모두 Python | -| 비동기 | asyncio + aiohttp | rate limit 정밀 제어 | -| DB | SQLite | NAS 메모리 절약, 백업 단순 | -| 캐시 | Redis 7 (Docker) | 실시간 시세 캐시 | -| 스케줄러 | APScheduler (AsyncIOScheduler) | 장 이벤트 트리거 | -| AI 판단 | Claude claude-sonnet-4-20250514 | 뉴스/수급 분석 | -| 뉴스 수집 | aiohttp + BeautifulSoup4 | 네이버 금융 크롤링 | -| 알림 | python-telegram-bot | 텔레그램 단일 채널 | -| 대시보드 | Streamlit | NAS 내부망 접근 | -| 컨테이너 | Docker Compose | Synology Container Manager | -| 백테스트 | vectorbt | 분봉 데이터 고속 처리 | -| 데이터 수집 | pykrx + KIS REST | 과거 분봉 백필 | - ---- - -## 4. 디렉토리 구조 (v2.0) - -``` -/volume1/docker/stockbot/ -│ -├── docker-compose.yml -├── .env -│ -├── app/ -│ ├── main.py ← 진입점, asyncio 루프 -│ ├── config.py ← 전략 파라미터 -│ │ -│ ├── ai/ ← [신규] AI 판단 레이어 -│ │ ├── context_builder.py ← 데이터 수집 + Claude API 호출 -│ │ ├── news_crawler.py ← 네이버 금융 뉴스 크롤링 -│ │ └── prompts.py ← 프롬프트 템플릿 관리 -│ │ -│ ├── data/ -│ │ ├── collector.py ← KIS WebSocket 시세 수신 -│ │ ├── universe.py ← 종목 풀 갱신 (08:30) -│ │ └── backfill.py ← 과거 분봉 백필 -│ │ -│ ├── strategy/ -│ │ ├── base.py ← 전략 추상 클래스 -│ │ └── volatility_breakout.py ← 변동성 돌파 전략 (AI 필터 포함) -│ │ -│ ├── risk/ -│ │ └── manager.py ← 손절/일일한도/강제청산 -│ │ -│ ├── execution/ -│ │ ├── kis_client.py ← KIS REST/WebSocket 래퍼 -│ │ └── order_executor.py ← 주문 전송, 재시도 -│ │ -│ ├── monitor/ -│ │ ├── notifier.py ← 텔레그램 알림 -│ │ └── dashboard.py ← Streamlit 대시보드 -│ │ -│ └── db/ -│ ├── models.py ← SQLite 스키마 -│ └── repository.py ← DB 접근 레이어 -│ -├── kill_switch/ -│ └── kill.py -│ -├── backtest/ -│ ├── run_backtest.py -│ └── results/ -│ -├── data/ -│ ├── stockbot.db -│ ├── universe_cache.json -│ └── daily_context.json ← [신규] AI 판단 결과 파일 -│ -└── logs/ - ├── trades.log - └── ai_context.log ← [신규] AI 판단 이력 보관 -``` - ---- - -## 5. 전략 (확정: 변동성 돌파 + AI 필터) - -### 핵심 파라미터 (config.py) - -```python -# 변동성 돌파 파라미터 -STRATEGY_K = 0.5 -ENTRY_START = "09:00" -ENTRY_END = "14:30" -FORCE_EXIT = "14:50" -TP1_PCT = 0.02 -TP2_PCT = 0.03 -SL_PCT = 0.015 -MAX_HOLD_MIN = 120 - -# AI 판단 파라미터 (신규) -AI_CONTEXT_PATH = "/app/data/daily_context.json" -AI_MIN_SCORE = 40 # sentiment_score 40 미만 시 trade_allowed=false 강제 -AI_BOOST_MULTI = 1.5 # boosted_tickers 진입 비중 배율 -AI_RISK_SL_MAP = { # risk_level별 손절 강화 - "낮음": 0.015, - "보통": 0.015, - "높음": 0.010 # 고위험 장세엔 손절 타이트하게 -} -``` - -### 진입 로직 (AI 필터 통합) - -``` -목표가 = 당일 시가 + (전일 고가 - 전일 저가) × K - -진입 조건 (전부 충족): - [기술적 조건] - 1. 현재가 >= 목표가 - 2. 09:00 ~ 14:30 - 3. KOSPI 등락률 > -1.0% - 4. 전일 거래대금 >= 100억 - 5. 시가총액 1,000억 ~ 3조 - 6. VI 미발동 - 7. 보유 종목 수 < 2 - 8. 일일 누적 손실 < -3% - - [AI 판단 조건] - 9. trade_allowed == true - 10. 종목 섹터 not in avoid_sectors - 11. 종목 not in blacklist_tickers -``` - -### 청산 로직 (우선순위) - -``` -1순위: 14:50 강제 청산 (시장가) -2순위: 손절 → 현재가 <= 매수가 × (1 - SL_PCT) [risk_level에 따라 조정] -3순위: 1차 익절 → +TP1_PCT 도달 → 50% 지정가 -4순위: 2차 익절 → +TP2_PCT 도달 → 전량 지정가 -5순위: 시간 청산 → MAX_HOLD_MIN 경과 + 무수익 -``` - ---- - -## 6. 종목 유니버스 (Universe) - -매일 08:30 자동 갱신. - -**1차 필터 (정적)** -| 조건 | 기준 | -|------|------| -| 시장 | 코스피 + 코스닥 | -| 시가총액 | 1,000억 ~ 3조 | -| 상장 기간 | 6개월 이상 | -| 제외 | 관리종목, 거래정지, 우선주, 스팩, ETF, ETN | - -**2차 필터 (동적)** -| 조건 | 기준 | -|------|------| -| 전일 거래대금 | 100억 이상 | -| 5일 평균 거래대금 | 50억 이상 | -| 전일 등락률 | -3% ~ +15% | -| 60일 이평선 | 현재가 위 | - -**AI 보정** -- boosted_tickers → 우선 감시 목록 상단 배치 -- blacklist_tickers → 당일 유니버스에서 즉시 제거 -- avoid_sectors → 해당 섹터 전체 진입 금지 - -**최대 감시 종목: 30개** (WebSocket 안정성 기준) - ---- - -## 7. 리스크 관리 - -### 포지션 규칙 -| 항목 | 기본값 | AI 조정 | -|------|--------|--------| -| 1종목 최대 비중 | 총자산 × 20% | × position_size_multiplier | -| 동시 보유 최대 | 2종목 | risk_level=높음 시 1종목 | -| 손절 기준 | -1.5% | risk_level=높음 시 -1.0% | - -### 손실 한도 (계층별) -| 레벨 | 조건 | 동작 | -|------|------|------| -| L1 | 1회 매매 -1.5% | 즉시 손절 | -| L2 | 일일 누적 -3% | 당일 신규 진입 중단 | -| L3 | 3연속 손절 | 당일 매매 중단 | -| L4 | 주간 누적 -7% | 주말까지 중단 + 텔레그램 경고 | -| L5 | 월간 누적 -15% | 전략 폐기 + 백테스트 재실행 | - -### 안전장치 -- VI 발동 → 해당 종목 즉시 청산 -- 호가 스프레드 > 0.5% → 진입 금지 -- 매수 후 5분 미체결 → 주문 취소 -- WebSocket 끊김 → 보유 포지션 즉시 시장가 청산 -- API 오류 10건/분 → kill-switch 자동 실행 -- Claude API 오류 → daily_context 없을 시 보수적 기본값으로 fallback - -```python -# Claude API 장애 시 fallback -DEFAULT_CONTEXT = { - "trade_allowed": True, - "market_sentiment": "중립", - "sentiment_score": 50, - "risk_level": "보통", - "hot_sectors": [], - "avoid_sectors": [], - "boosted_tickers": [], - "blacklist_tickers": [], - "position_size_multiplier": 0.8, # 보수적으로 축소 - "reason": "AI 판단 실패 - 기본값 적용" -} -``` - ---- - -## 8. KIS API 활용 전체 목록 (v2.0) - -### 기존 (실행 레이어) -| API | 용도 | 방식 | -|-----|------|------| -| H0STCNT0 | 실시간 체결가 | WebSocket | -| H0STASP0 | 실시간 호가 | WebSocket | -| H0STVI0 | VI 발동/해제 | WebSocket | -| TTTC0802U | 주식 매수 주문 | REST POST | -| TTTC0801U | 주식 매도 주문 | REST POST | -| TTTC8001R | 잔고 조회 | REST GET | - -### 신규 (AI 판단 레이어) -| API | 용도 | 수집 시각 | -|-----|------|---------| -| FHKST01010100 | 종목 현재가 (KOSPI/KOSDAQ 지수) | 07:40 | -| FHKST03010100 | 업종별 등락률 | 07:40 | -| FHPST01710000 | 거래량 순위 상위 30 | 07:40 | -| FHPST01700000 | 등락률 순위 상위 30 | 07:40 | -| FHKST04430000 | 외국인/기관 순매수 가집계 | 07:40 | - -> 위 API 호출은 모두 장 시작 전 단 1회 → rate limit 부담 없음 - ---- - -## 9. 스케줄 타임라인 (v2.0) - -``` -07:30 │ [AI] 네이버 금융 뉴스 크롤링 (전일 헤드라인 수집) -07:40 │ [AI] KIS REST API → 수급/순위/업종 데이터 수집 -08:00 │ [AI] Claude API 호출 → daily_context.json 생성 - │ 텔레그램 알림: "[AI분석] 오늘 시장: 중립 / 반도체 주목" -08:30 │ Universe 갱신 + AI 블랙리스트 적용 -08:50 │ WebSocket 연결, 30종목 구독 - │ 목표가 계산 (변동성 돌파) -09:00 │ ─────────── 진입 허용 시작 ─────────── - │ 1초 단위 asyncio 루프 시작 -11:30 │ 신규 진입 중단 (점심) -13:00 │ 신규 진입 재개 -14:30 │ 신규 진입 마감 -14:50 │ ─────────── 강제 청산 ─────────────── -15:00 │ WebSocket 종료 -15:10 │ 당일 결산 로그 -15:20 │ 텔레그램 일일 결산 알림 -15:30 │ 대기 -``` - ---- - -## 10. DB 스키마 (SQLite, v2.0) - -```sql --- 기존 체결 내역 -CREATE TABLE trades ( - id INTEGER PRIMARY KEY AUTOINCREMENT, - date TEXT NOT NULL, - ticker TEXT NOT NULL, - entry_time TEXT NOT NULL, - exit_time TEXT, - entry_price REAL NOT NULL, - exit_price REAL, - quantity INTEGER NOT NULL, - side TEXT NOT NULL, - exit_reason TEXT, - pnl REAL, - fee REAL, - slippage REAL, - strategy TEXT DEFAULT 'VB', - ai_boosted INTEGER DEFAULT 0 -- [신규] AI boosted 여부 -); - --- 기존 일일 요약 -CREATE TABLE daily_summary ( - date TEXT PRIMARY KEY, - total_trades INTEGER, - win_trades INTEGER, - lose_trades INTEGER, - gross_pnl REAL, - total_fee REAL, - net_pnl REAL, - max_drawdown REAL, - trading_stopped INTEGER DEFAULT 0 -); - --- 포지션 (장중 현황) -CREATE TABLE positions ( - ticker TEXT PRIMARY KEY, - entry_time TEXT, - entry_price REAL, - quantity INTEGER, - tp1_done INTEGER DEFAULT 0, - target_price REAL, - stop_price REAL -); - --- [신규] AI 판단 이력 -CREATE TABLE ai_context_log ( - date TEXT PRIMARY KEY, - generated_at TEXT, - trade_allowed INTEGER, - market_sentiment TEXT, - sentiment_score INTEGER, - risk_level TEXT, - hot_sectors TEXT, -- JSON 배열 - avoid_sectors TEXT, -- JSON 배열 - boosted_tickers TEXT, -- JSON 배열 - blacklist_tickers TEXT, -- JSON 배열 - position_size_mult REAL, - reason TEXT, - claude_tokens_used INTEGER, - api_call_success INTEGER DEFAULT 1 -); -``` - ---- - -## 11. 알림 설계 (텔레그램, v2.0) - -| 이벤트 | 메시지 형식 | -|--------|-----------| -| AI 분석 완료 | `[AI분석] 시장: 중립(62점) / 주목: 반도체,2차전지 / 회피: 금융` | -| AI 진입 차단 | `[AI차단] 삼성전자 진입 차단 - 금융 섹터 회피` | -| 매수 (일반) | `[매수] 삼성전자 74,000원 / 목표 75,480 / 손절 72,890` | -| 매수 (AI부스트) | `[매수★] 하이닉스 185,000원 / AI 추천 종목` | -| 1차 익절 | `[익절1] 삼성전자 +2.1% / 잔여 50%` | -| 손절 | `[손절] 삼성전자 -1.5% / 즉시 청산` | -| 강제 청산 | `[14:50 강제청산] 전 포지션 청산 완료` | -| L2 발동 | `[경고] 일일 손실 -3% 도달. 오늘 매매 중단.` | -| 일일 결산 | `[결산] 매매 5회 / 승 3 패 2 / 순손익 +1.2% / AI 정확도: 3/5` | -| 장애 | `[긴급] WebSocket 끊김. kill-switch 실행.` | -| AI 실패 | `[경고] AI 판단 실패. 기본값 적용 (비중 80%).` | - ---- - -## 12. 비용 분석 (월간) - -### Claude API 토큰 사용량 추정 -| 작업 | 빈도 | 토큰/회 | 월간 토큰 | -|------|------|---------|---------| -| 일일 시장 판단 | 1회/일 × 22거래일 | ~3,000 | ~66,000 | -| fallback 재시도 | 0~2회/월 | ~3,000 | ~6,000 | -| **합계** | | | **~72,000 토큰/월** | - -**월 비용 (Claude Sonnet 4): 약 $2~3 (한화 약 3,000~4,000원)** - -### 전체 운영 비용 -| 항목 | 월 비용 | -|------|--------| -| KIS API | 무료 | -| Claude API | ~$3 | -| 네이버 크롤링 | 무료 | -| Synology NAS 전기세 | 기존 운영 중이면 추가 없음 | -| **합계** | **~$3/월** | - ---- - -## 13. 백테스트 계획 (v2.0) - -### AI 판단 레이어 검증 방법 -AI 판단은 백테스트에 직접 포함 불가 (과거 뉴스 재현 어려움). -따라서 2단계로 분리 검증: - -``` -1단계: 규칙 기반 백테스트 (기존) - - 변동성 돌파 전략 단독 성과 측정 - - K값 최적화, 수수료/슬리피지 반영 - -2단계: AI 필터 사후 분석 (모의투자 후) - - 3개월 모의투자 후 daily_context.json 이력 vs 실제 결과 대조 - - AI가 "avoid" 판단한 날 손실률 vs "trade_allowed" 날 수익률 비교 - - AI 판단 정확도 계산 → 임계값 재조정 -``` - -### 합격 기준 (out-of-sample) -| 지표 | 통과 기준 | 목표 | -|------|----------|------| -| 샤프지수 | > 1.0 | > 1.5 | -| MDD | < 15% | < 10% | -| 승률 | > 45% | > 55% | -| 손익비 | > 1.3 | > 1.8 | -| AI 차단 정확도 | > 55% | > 65% | - ---- - -## 14. 인프라 (docker-compose.yml) - -```yaml -version: "3.9" - -services: - redis: - image: redis:7-alpine - container_name: stockbot-redis - restart: unless-stopped - volumes: - - ./data/redis:/data - - stockbot: - build: ./app - container_name: stockbot-main - restart: unless-stopped - depends_on: - - redis - env_file: .env - volumes: - - ./data:/app/data - - ./logs:/app/logs - environment: - - TZ=Asia/Seoul - logging: - driver: "json-file" - options: - max-size: "10m" - max-file: "5" - - kill-switch: - build: ./kill_switch - container_name: stockbot-killswitch - restart: "no" - env_file: .env - profiles: ["emergency"] - - dashboard: - build: ./monitor - container_name: stockbot-dashboard - restart: unless-stopped - ports: - - "8501:8501" - volumes: - - ./data:/app/data - environment: - - TZ=Asia/Seoul -``` - -### .env 구조 (v2.0) - -``` -# KIS API -KIS_APP_KEY=... -KIS_APP_SECRET=... -KIS_ACCOUNT_NO=... -KIS_MOCK=true - -# Claude API (신규) -ANTHROPIC_API_KEY=... -CLAUDE_MODEL=claude-sonnet-4-20250514 - -# 텔레그램 -TELEGRAM_TOKEN=... -TELEGRAM_CHAT_ID=... - -# Redis -REDIS_HOST=stockbot-redis -REDIS_PORT=6379 - -# 운영 모드 -DRY_RUN=true -LOG_LEVEL=INFO -AI_ENABLED=true # false 시 AI 레이어 비활성화, 기본값 사용 -``` - ---- - -## 15. 개발 로드맵 (v2.0) - -### Phase 1 — 데이터 기반 구축 (2주) -- [ ] KIS Open API 신청 + 모의투자 계좌 -- [ ] pykrx 분봉 데이터 백필 (2021~2024) -- [ ] SQLite 스키마 (v2.0 포함) -- [ ] Universe 스캐너 구현 -- [ ] Docker Compose NAS 기동 확인 - -### Phase 2 — 백테스트 (3주) -- [ ] vectorbt 변동성 돌파 백테스트 -- [ ] 수수료/슬리피지 반영 -- [ ] K값 그리드 서치 + out-of-sample 검증 - -### Phase 3 — KIS 연동 + dry-run (2주) -- [ ] KIS REST/WebSocket 클라이언트 -- [ ] OrderExecutor (시장가/지정가/IOC) -- [ ] DRY_RUN=true 신호 발생 확인 - -### Phase 4 — AI 레이어 구현 (2주) ← 신규 -- [ ] 네이버 금융 뉴스 크롤러 구현 -- [ ] KIS 순위/수급 API 수집 모듈 -- [ ] Claude API 연동 + 프롬프트 튜닝 -- [ ] daily_context.json 생성 파이프라인 -- [ ] fallback 로직 구현 -- [ ] ai_context_log DB 저장 - -### Phase 5 — 리스크 + 알림 + 대시보드 (2주) -- [ ] RiskManager L1~L5 구현 -- [ ] kill-switch 컨테이너 -- [ ] 텔레그램 Notifier (AI 메시지 포함) -- [ ] Streamlit 대시보드 (AI 판단 현황 패널 추가) - -### Phase 6 — 모의투자 실운영 (최소 3개월) -- [ ] KIS_MOCK=true, DRY_RUN=false -- [ ] 매일 결산 로그 + AI 정확도 추적 -- [ ] 3개월 후 AI 필터 임계값 재조정 -- [ ] 샤프 > 1.0, MDD < 15% 달성 시 Phase 7 - -### Phase 7 — 소액 실거래 (무기한) -- [ ] KIS_MOCK=false -- [ ] 총자산 5% 한도로 시작 -- [ ] 1개월 단위 성과 검토 - ---- - -## 16. 보안 체크리스트 - -- [ ] .env → .gitignore 등록 -- [ ] KIS/Anthropic API 키 → GitHub 절대 금지 -- [ ] ANTHROPIC_API_KEY 월 1회 암호화 백업 -- [ ] Synology 방화벽: 8501 내부망만 허용 -- [ ] 텔레그램 봇: chat_id 화이트리스트 -- [ ] 주문 로그 SQLite + logs/ 이중 보관 -- [ ] AI 판단 이력 ai_context_log 영구 보관 - ---- - -## 17. 절대 금지 (하드코딩) - -```python -BLACKLIST_REASONS = [ - "신규상장 6개월 미만", "관리종목", "투자경고", - "거래정지", "우선주", "스팩", "ETF/ETN", -] - -TRADING_BLACKOUT = [ - ("11:30", "13:00"), # 점심 - ("14:50", "15:30"), # 마감 - ("08:00", "09:00"), # 동시호가 -] - -HARD_EXIT_TIME = "14:50" # 절대 변경 불가 - -# AI가 trade_allowed=false 반환해도 이미 보유 중인 포지션 청산은 진행 -# AI는 신규 진입만 차단, 청산 로직에는 관여하지 않음 -AI_SCOPE = "ENTRY_ONLY" # 절대 변경 불가 -``` - ---- - -## 18. 면책 조항 - -> 본 기획서는 시스템 설계 문서이며, 투자 수익을 보장하지 않는다. -> AI 판단 레이어는 보조 필터일 뿐, 수익을 보장하지 않는다. -> 단타는 개인투자자의 90% 이상이 손실을 보는 영역이다. -> 반드시 모의투자 3개월 이상 검증 후 실거래 전환할 것. diff --git a/uploads/profile.jpg b/uploads/profile.jpg deleted file mode 100644 index aa3c1e0..0000000 Binary files a/uploads/profile.jpg and /dev/null differ diff --git a/uploads/동물-사전/AnimalsDictionary.mp4 b/uploads/동물-사전/AnimalsDictionary.mp4 deleted file mode 100644 index 5db073e..0000000 Binary files a/uploads/동물-사전/AnimalsDictionary.mp4 and /dev/null differ diff --git a/uploads/동물-사전/img_69fc43297ee5b3.62410794.jpg b/uploads/동물-사전/img_69fc43297ee5b3.62410794.jpg deleted file mode 100644 index 77efb42..0000000 Binary files a/uploads/동물-사전/img_69fc43297ee5b3.62410794.jpg and /dev/null differ diff --git a/uploads/동물-사전/img_69fc432b0552a7.38602241.jpg b/uploads/동물-사전/img_69fc432b0552a7.38602241.jpg deleted file mode 100644 index f2ed23d..0000000 Binary files a/uploads/동물-사전/img_69fc432b0552a7.38602241.jpg and /dev/null differ