feat: Enhance trading system with new permanent subscription features and order book management

Changes: - Added a new API endpoint for managing permanent subscriptions, allowing users to enable or disable subscriptions dynamically. - Implemented a function to fill candle data from Kiwoom, ensuring that only relevant data is inserted into the database. - Introduced a mechanism to handle master subscription states, improving the management of subscription statuses. - Updated the database schema to include new fields for managing subscription states and order book filtering. Impact: - These enhancements improve the flexibility and reliability of the trading system, allowing for better management of subscriptions and order book data, while reducing the risk of data inconsistencies. 히스토리 align 제거 븅신같은 초기설계 아예 제거 진입모드에 구멍메움 호가진입을 켜도 호가가 안들어올때 호가 안보고 그냥 사버림
2026-08-15 23:01:14 +09:00
parent 4a18ce2697
commit 36a3e2b4a1
94 changed files with 6368 additions and 1639 deletions
--- a/kis_trader/backtest/results/optuna_breakout_tpe_20260814_020952.briefing.md
+++ b/kis_trader/backtest/results/optuna_breakout_tpe_20260814_020952.briefing.md
@@ -0,0 +1,46 @@
+# Optuna 브리핑 — 돌파 (tpe)
+기간: 2026-08-12 ~ 2026-08-13 (거래일≈2일) · trials 400/400
+탐색 게이트: WR≥0% PF≥0 · min_trades≥1 | 후보 게이트: WR≥40% PF≥1 · min_trades≥1
+- min_trades=1: **합격 인정 최소 거래 건수**(표본 부족·우연 승률 방지). 이보다 적은 조합은 학습/후보 집계에서 제외됩니다.
+학습용 통과 334건 · 사후합격(results_gated) 243건
+
+## 과적합·적용 가능도 (휴리스틱)
+- **과적합 위험 44.0%** · **적용 가능도 56.0%** · 판정: **주의** — 적용 가능도 중간 — 다일(≥5일) 재검증·웹백테 후 소액만
+  - 표본 장일: +28.0p — 거래일≈2일 — 이틀만으로는 추세 전환에 취약
+  - 거래 표본: +10.0p — 상위 후보 거래 4건 — 해석 시 주의
+  - 승률·PF 이상치: +6.0p — PF 12.21
+  - 게이트 커버: +0.0p — 사후합격 243건 · stable 0건
+  - PnL 고원: +0.0p — 고원 비율 0% (1건)
+- 임계값 분포 표본: results_gated 상위 30건
+| 파라미터 | median | p25~p75 | mode(비율) |
+|---|---:|---|---|
+| `max_daily_chg` | 36.5 | 33.25 ~ 42.75 | 36.0 (17%) |
+| `vol_mult` | 1.95 | 1.5 ~ 2.475 | 1.0 (13%) |
+| `vol_window` | 7.0 | 4.25 ~ 9.75 | 4 (27%) |
+| `min_turnover_1m_pct` | 0.1 | 0.05 ~ 0.2 | 0.05 (40%) |
+| `prev_chg_min` | 0.7 | 0.6 ~ 0.8 | 0.6 (23%) |
+| `prev_chg_max` | 22.5 | 17.0 ~ 25.0 | 25.0 (7%) |
+| `min_price` | 2750.0 | 2000.0 ~ 4000.0 | 4000 (23%) |
+| `tp_pct` | 17.0 | 12.625 ~ 19.875 | 17.0 (10%) |
+| `sl_pct` | 5.8 | 4.9 ~ 6.675 | 4.9 (13%) |
+| `sl_mode` | — | — | fixed (93%) |
+| `atr_sl_mult` | 3.1 | 2.675 ~ 3.275 | 3.2 (13%) |
+| `trail_pct` | 3.7 | 3.3 ~ 4.85 | 4.9 (13%) |
+- _참고: 과적합%는 교차검증 점수가 아니라 표본·이상치·고원 휴리스틱입니다. 적용 가능도%=100−과적합위험%. DB 적용 버튼 활성 조건(gated PnL>0)과는 별개입니다._
+
+## 이전 장에서는
+- 실매 동기간 청산 3건 · 승률 33% · 합산 PnL -5,471원 (백테 Optuna와 숫자 달라도 정상 — 고스트·유니버스·틱 경로 차이).
+- 사후합격 1위: trial #383 · 거래 4건 · 승률 75.0% · PF 12.21 · PnL 15,638원
+- 표본 장이 2일뿐이라, ‘이전 장에 잘 먹힌 숫자’일 뿐 **추세가 바뀌면 바로 깨질 수 있습니다.**
+
+## 앞으로 장에서는
+- **1~2일 Optuna best를 바로 실매에 넣지 마세요.** 다일(≥5거래일) 재검증·웹백테 1회 후 검토.
+- 적용 시에는 `results_gated` 후보만. 탐색용 best(objective)와 다를 수 있습니다.
+- 장이 좁아지거나 변동성이 커지면: 손절·트레일·시간창이 먼저 깨집니다. 승률 자랑보다 **손절이 살아 있는지**를 보세요.
+- 사후합격이 있어도 ‘내일도 같은 장’이 아닙니다. 페이퍼/소액·모의로 1~2일 관찰 후 확대하세요.
+
+_생성: 2026-08-14 02:10:08 (rule)_
+
+## AI 코멘트
+
+_(미생성: api_call_failed. 구글 키는 GEMINI_API_KEY 를 DB/환경에 넣으세요 — kis_trader/backtest/optuna_briefing.py 모듈 docstring 참고)_
--- a/kis_trader/backtest/results/optuna_momentum_tpe_20260814_020143.briefing.md
+++ b/kis_trader/backtest/results/optuna_momentum_tpe_20260814_020143.briefing.md
@@ -0,0 +1,46 @@
+# Optuna 브리핑 — 모멘텀 (tpe)
+기간: 2026-08-12 ~ 2026-08-13 (거래일≈2일) · trials 400/174
+탐색 게이트: WR≥0% PF≥0 · min_trades≥1 | 후보 게이트: WR≥40% PF≥1 · min_trades≥1
+- min_trades=1: **합격 인정 최소 거래 건수**(표본 부족·우연 승률 방지). 이보다 적은 조합은 학습/후보 집계에서 제외됩니다.
+학습용 통과 359건 · 사후합격(results_gated) 51건
+
+## 과적합·적용 가능도 (휴리스틱)
+- **과적합 위험 28.0%** · **적용 가능도 72.0%** · 판정: **상대적으로낮음** — 휴리스틱상 위험 상대적 낮음 — 그래도 다일 확인 권장
+  - 표본 장일: +28.0p — 거래일≈2일 — 이틀만으로는 추세 전환에 취약
+  - 거래 표본: +0.0p — 상위 후보 거래 19건 — 상대적 양호
+  - 승률·PF 이상치: +0.0p — 이상치 없음
+  - 게이트 커버: +0.0p — 사후합격 51건 · stable 51건
+  - PnL 고원: +0.0p — 고원 비율 2% (1건)
+- 임계값 분포 표본: results_gated 상위 30건
+| 파라미터 | median | p25~p75 | mode(비율) |
+|---|---:|---|---|
+| `mom_rsi_min` | 58.0 | 55.0 ~ 60.75 | 58 (17%) |
+| `mom_rsi_max` | 89.0 | 85.0 ~ 96.5 | 82 (13%) |
+| `mom_vol_mult` | 2.95 | 2.5 ~ 4.2 | 5.0 (10%) |
+| `mom_vol_win` | 10.0 | 10.0 ~ 10.0 | 10 (77%) |
+| `e_min_chg_pct` | 2.1 | 1.825 ~ 2.575 | 1.9 (13%) |
+| `tp_pct` | 7.45 | 4.05 ~ 9.45 | 8.8 (7%) |
+| `tp_max_pct` | 16.5 | 15.125 ~ 19.0 | 15.5 (13%) |
+| `sl_pct` | 6.2 | 5.65 ~ 6.5 | 6.5 (13%) |
+| `shoulder_min_high` | 4.5 | 4.4 ~ 5.0 | 5.0 (37%) |
+| `shoulder_cut_pct` | 0.5 | 0.45 ~ 0.5375 | 0.5 (33%) |
+| `trail_pct` | 2.7 | 2.325 ~ 3.4 | 3.4 (13%) |
+| `trail_arm_pct` | 4.5 | 4.225 ~ 4.9 | 5.0 (27%) |
+- _참고: 과적합%는 교차검증 점수가 아니라 표본·이상치·고원 휴리스틱입니다. 적용 가능도%=100−과적합위험%. DB 적용 버튼 활성 조건(gated PnL>0)과는 별개입니다._
+
+## 이전 장에서는
+- 실매 동기간 청산 31건 · 승률 16% · 합산 PnL -59,726원 (백테 Optuna와 숫자 달라도 정상 — 고스트·유니버스·틱 경로 차이).
+- 사후합격 1위: trial #169 · 거래 19건 · 승률 52.6% · PF 1.89 · PnL 60,303원
+- 표본 장이 2일뿐이라, ‘이전 장에 잘 먹힌 숫자’일 뿐 **추세가 바뀌면 바로 깨질 수 있습니다.**
+
+## 앞으로 장에서는
+- **1~2일 Optuna best를 바로 실매에 넣지 마세요.** 다일(≥5거래일) 재검증·웹백테 1회 후 검토.
+- 적용 시에는 `results_gated` 후보만. 탐색용 best(objective)와 다를 수 있습니다.
+- 장이 좁아지거나 변동성이 커지면: 손절·트레일·시간창이 먼저 깨집니다. 승률 자랑보다 **손절이 살아 있는지**를 보세요.
+- 사후합격이 있어도 ‘내일도 같은 장’이 아닙니다. 페이퍼/소액·모의로 1~2일 관찰 후 확대하세요.
+
+_생성: 2026-08-14 02:02:07 (rule)_
+
+## AI 코멘트
+
+_(미생성: api_call_failed. 구글 키는 GEMINI_API_KEY 를 DB/환경에 넣으세요 — kis_trader/backtest/optuna_briefing.py 모듈 docstring 참고)_
--- a/kis_trader/backtest/results/optuna_momentum_tpe_20260814_115644.briefing.md
+++ b/kis_trader/backtest/results/optuna_momentum_tpe_20260814_115644.briefing.md
@@ -0,0 +1,46 @@
+# Optuna 브리핑 — 모멘텀 (tpe)
+기간: 2026-08-12 ~ 2026-08-14 (거래일≈3일) · trials 30/30
+탐색 게이트: WR≥0% PF≥0 · min_trades≥1 | 후보 게이트: WR≥40% PF≥1 · min_trades≥1
+- min_trades=1: **합격 인정 최소 거래 건수**(표본 부족·우연 승률 방지). 이보다 적은 조합은 학습/후보 집계에서 제외됩니다.
+학습용 통과 23건 · 사후합격(results_gated) 0건
+
+## 과적합·적용 가능도 (휴리스틱)
+- **과적합 위험 28.0%** · **적용 가능도 72.0%** · 판정: **상대적으로낮음** — 휴리스틱상 위험 상대적 낮음 — 그래도 다일 확인 권장
+  - 표본 장일: +16.0p — 거래일≈3일 — 다일 재검증 권장(≥5일)
+  - 거래 표본: +0.0p — 상위 후보 거래 42건 — 상대적 양호
+  - 승률·PF 이상치: +0.0p — 이상치 없음
+  - 게이트 커버: +12.0p — 사후합격 0건 (학습 23) — DB 적용 비권장
+  - PnL 고원: +0.0p — 고원 비율 4% (1건)
+- 임계값 분포 표본: results(learning) 상위 23건
+| 파라미터 | median | p25~p75 | mode(비율) |
+|---|---:|---|---|
+| `mom_rsi_min` | 54.0 | 50.5 ~ 57.0 | 52 (13%) |
+| `mom_rsi_max` | 74.0 | 72.0 ~ 78.0 | 74 (22%) |
+| `mom_vol_mult` | 3.5 | 2.75 ~ 5.0 | 3.2 (9%) |
+| `mom_vol_win` | 4.0 | 4.0 ~ 6.0 | 4 (35%) |
+| `e_min_chg_pct` | 1.9 | 0.85 ~ 2.4 | 2.4 (9%) |
+| `tp_pct` | 3.9 | 2.55 ~ 5.3 | 1.6 (13%) |
+| `tp_max_pct` | 16.5 | 15.5 ~ 19.0 | 16.0 (22%) |
+| `sl_pct` | 5.5 | 4.85 ~ 6.3 | 5.0 (13%) |
+| `shoulder_min_high` | 1.8 | 1.2 ~ 2.3 | 2.2 (9%) |
+| `shoulder_cut_pct` | 0.45 | 0.35 ~ 0.625 | 0.65 (17%) |
+| `trail_pct` | 1.5 | 0.9 ~ 2.05 | 1.4 (9%) |
+| `trail_arm_pct` | 2.7 | 1.4 ~ 3.2 | 2.8 (9%) |
+- _참고: 과적합%는 교차검증 점수가 아니라 표본·이상치·고원 휴리스틱입니다. 적용 가능도%=100−과적합위험%. DB 적용 버튼 활성 조건(gated PnL>0)과는 별개입니다._
+
+## 이전 장에서는
+- 실매 동기간 청산 55건 · 승률 18% · 합산 PnL -99,287원 (백테 Optuna와 숫자 달라도 정상 — 고스트·유니버스·틱 경로 차이).
+- 학습 1위(사후게이트 미달 가능): trial #26 · 거래 42건 · 승률 45.2% · PF 0.93 · PnL -8,718원
+- 플러스/학습 후보는 있으나 승률·PF 사후 기준은 못 넘김 → **당장 DB 적용은 비권장.**
+
+## 앞으로 장에서는
+- **1~2일 Optuna best를 바로 실매에 넣지 마세요.** 다일(≥5거래일) 재검증·웹백테 1회 후 검토.
+- 적용 시에는 `results_gated` 후보만. 탐색용 best(objective)와 다를 수 있습니다.
+- 장이 좁아지거나 변동성이 커지면: 손절·트레일·시간창이 먼저 깨집니다. 승률 자랑보다 **손절이 살아 있는지**를 보세요.
+- 현재 사후합격 0건 → 파라미터 유지(현행 DB) + 유니버스/데이터 점검이 우선입니다.
+
+_생성: 2026-08-14 11:59:04 (rule)_
+
+## AI 코멘트
+
+_(미생성: api_call_failed. 구글 키는 GEMINI_API_KEY 를 DB/환경에 넣으세요 — kis_trader/backtest/optuna_briefing.py 모듈 docstring 참고)_
--- a/kis_trader/backtest/results/optuna_scalp_tpe_20260814_021723.briefing.md
+++ b/kis_trader/backtest/results/optuna_scalp_tpe_20260814_021723.briefing.md
@@ -0,0 +1,46 @@
+# Optuna 브리핑 — 스캘핑 (tpe)
+기간: 2026-08-12 ~ 2026-08-13 (거래일≈2일) · trials 400/400
+탐색 게이트: WR≥0% PF≥0 · min_trades≥1 | 후보 게이트: WR≥40% PF≥1 · min_trades≥1
+- min_trades=1: **합격 인정 최소 거래 건수**(표본 부족·우연 승률 방지). 이보다 적은 조합은 학습/후보 집계에서 제외됩니다.
+학습용 통과 358건 · 사후합격(results_gated) 308건
+
+## 과적합·적용 가능도 (휴리스틱)
+- **과적합 위험 38.0%** · **적용 가능도 62.0%** · 판정: **상대적으로낮음** — 휴리스틱상 위험 상대적 낮음 — 그래도 다일 확인 권장
+  - 표본 장일: +28.0p — 거래일≈2일 — 이틀만으로는 추세 전환에 취약
+  - 거래 표본: +0.0p — 상위 후보 거래 16건 — 상대적 양호
+  - 승률·PF 이상치: +0.0p — 이상치 없음
+  - 게이트 커버: +10.0p — gated/all=308/358 — 단일에 대부분 통과(필터 느슨·노이즈)
+  - PnL 고원: +0.0p — 고원 비율 0% (1건)
+- 임계값 분포 표본: results_gated 상위 30건
+| 파라미터 | median | p25~p75 | mode(비율) |
+|---|---:|---|---|
+| `rsi_period` | 4.0 | 3.0 ~ 4.0 | 3 (40%) |
+| `rsi_oversold` | 22.5 | 16.625 ~ 25.25 | 16.0 (10%) |
+| `rsi_overbought` | 75.75 | 69.0 ~ 78.5 | 78.5 (10%) |
+| `sl_pct` | 4.2 | 2.775 ~ 4.8 | 3.0 (10%) |
+| `tp_pct` | 0.8 | 0.6 ~ 1.3 | 0.5 (20%) |
+| `tp_max_pct` | 6.75 | 5.0 ~ 10.0 | 10.0 (17%) |
+| `drop_rate` | 1.4 | 0.5 ~ 1.675 | 0.5 (30%) |
+| `shoulder_min_high` | 0.7 | 0.5 ~ 1.3 | 0.3 (17%) |
+| `shoulder_cut_pct` | 0.45 | 0.3625 ~ 0.5875 | 0.6 (27%) |
+| `cooldown_min` | 0.5 | 0.0 ~ 4.75 | 0 (50%) |
+| `high_chase_thr` | 0.975 | 0.975 ~ 0.975 | 0.975 (83%) |
+| `max_daily_chg` | 26.0 | 16.0 ~ 37.0 | 5.0 (17%) |
+- _참고: 과적합%는 교차검증 점수가 아니라 표본·이상치·고원 휴리스틱입니다. 적용 가능도%=100−과적합위험%. DB 적용 버튼 활성 조건(gated PnL>0)과는 별개입니다._
+
+## 이전 장에서는
+- 실매 동기간 청산 7건 · 승률 43% · 합산 PnL 18,134원 (백테 Optuna와 숫자 달라도 정상 — 고스트·유니버스·틱 경로 차이).
+- 사후합격 1위: trial #323 · 거래 16건 · 승률 75.0% · PF 14.68 · PnL 104,649원
+- 표본 장이 2일뿐이라, ‘이전 장에 잘 먹힌 숫자’일 뿐 **추세가 바뀌면 바로 깨질 수 있습니다.**
+
+## 앞으로 장에서는
+- **1~2일 Optuna best를 바로 실매에 넣지 마세요.** 다일(≥5거래일) 재검증·웹백테 1회 후 검토.
+- 적용 시에는 `results_gated` 후보만. 탐색용 best(objective)와 다를 수 있습니다.
+- 장이 좁아지거나 변동성이 커지면: 손절·트레일·시간창이 먼저 깨집니다. 승률 자랑보다 **손절이 살아 있는지**를 보세요.
+- 사후합격이 있어도 ‘내일도 같은 장’이 아닙니다. 페이퍼/소액·모의로 1~2일 관찰 후 확대하세요.
+
+_생성: 2026-08-14 02:17:33 (rule)_
+
+## AI 코멘트
+
+_(미생성: api_call_failed. 구글 키는 GEMINI_API_KEY 를 DB/환경에 넣으세요 — kis_trader/backtest/optuna_briefing.py 모듈 docstring 참고)_
--- a/kis_trader/backtest/results/optuna_tail_tpe_20260814_013943.briefing.md
+++ b/kis_trader/backtest/results/optuna_tail_tpe_20260814_013943.briefing.md
@@ -0,0 +1,22 @@
+# Optuna 브리핑 — 꼬리 (tpe)
+기간: 2026-08-12 ~ 2026-08-14 (거래일≈3일) · trials 200/200
+탐색 게이트: WR≥0% PF≥0 · min_trades≥1 | 후보 게이트: WR≥40% PF≥1 · min_trades≥1
+- min_trades=1: **합격 인정 최소 거래 건수**(표본 부족·우연 승률 방지). 이보다 적은 조합은 학습/후보 집계에서 제외됩니다.
+학습용 통과 100건 · 사후합격(results_gated) 44건
+
+## 이전 장에서는
+- 실매 동기간 청산 1건 · 승률 0% · 합산 PnL 0원 (백테 Optuna와 숫자 달라도 정상 — 고스트·유니버스·틱 경로 차이).
+- 사후합격 1위: trial #37 · 거래 1건 · 승률 100.0% · PF 9999.00 · PnL 3,776원
+- 승률이 비정상적으로 높고 표본이 작습니다 → **해당 장에만 맞는 과적합** 신호.
+
+## 앞으로 장에서는
+- **1~2일 Optuna best를 바로 실매에 넣지 마세요.** 다일(≥5거래일) 재검증·웹백테 1회 후 검토.
+- 적용 시에는 `results_gated` 후보만. 탐색용 best(objective)와 다를 수 있습니다.
+- 장이 좁아지거나 변동성이 커지면: 손절·트레일·시간창이 먼저 깨집니다. 승률 자랑보다 **손절이 살아 있는지**를 보세요.
+- 사후합격이 있어도 ‘내일도 같은 장’이 아닙니다. 페이퍼/소액·모의로 1~2일 관찰 후 확대하세요.
+
+_생성: 2026-08-14 01:39:45 (rule)_
+
+## AI 코멘트
+
+_(미생성: api_call_failed. 구글 키는 GEMINI_API_KEY 를 DB/환경에 넣으세요 — kis_trader/backtest/optuna_briefing.py 모듈 docstring 참고)_
--- a/kis_trader/backtest/results/optuna_tail_tpe_20260815_225139.briefing.md
+++ b/kis_trader/backtest/results/optuna_tail_tpe_20260815_225139.briefing.md
@@ -0,0 +1,46 @@
+# Optuna 브리핑 — 꼬리 (tpe)
+기간: 2026-08-12 ~ 2026-08-14 (거래일≈3일) · trials 30/30
+탐색 게이트: WR≥0% PF≥0 · min_trades≥1 | 후보 게이트: WR≥40% PF≥1 · min_trades≥1
+- min_trades=1: **합격 인정 최소 거래 건수**(표본 부족·우연 승률 방지). 이보다 적은 조합은 학습/후보 집계에서 제외됩니다.
+학습용 통과 23건 · 사후합격(results_gated) 20건
+
+## 과적합·적용 가능도 (휴리스틱)
+- **과적합 위험 59.0%** · **적용 가능도 41.0%** · 판정: **주의** — 적용 가능도 중간 — 다일(≥5일) 재검증·웹백테 후 소액만
+  - 표본 장일: +16.0p — 거래일≈3일 — 다일 재검증 권장(≥5일)
+  - 거래 표본: +18.0p — 상위 후보 거래 3건 — 표본 부족
+  - 승률·PF 이상치: +25.0p — 승률 100.0% + 거래 3건 · PF 9999.00 (소수 거래 폭증)
+  - 게이트 커버: +0.0p — 사후합격 20건 · stable 4건
+  - PnL 고원: +0.0p — 고원 비율 5% (1건)
+- 임계값 분포 표본: results_gated 상위 20건
+| 파라미터 | median | p25~p75 | mode(비율) |
+|---|---:|---|---|
+| `entry_mode` | — | — | align (100%) |
+| `cand_limit` | 20.0 | 15.0 ~ 20.0 | 20 (75%) |
+| `max_daily_change` | 28.5 | 15.0 ~ 37.0 | 30.0 (10%) |
+| `min_drop_rate` | 0.0825 | 0.06875 ~ 0.1075 | 0.07 (10%) |
+| `min_recovery_ratio` | 0.115 | 0.1 ~ 0.15 | 0.11 (20%) |
+| `tail_ratio_min` | 1.3 | 1.175 ~ 1.4 | 1.3 (25%) |
+| `tail_pct_min` | 0.0035 | 0.001 ~ 0.0045 | 0.0005 (20%) |
+| `max_rec_3m` | 0.935 | 0.905 ~ 0.97 | 0.97 (20%) |
+| `shoulder_min_high` | 0.008 | 0.00575 ~ 0.01125 | 0.008 (20%) |
+| `shoulder_cut_pct` | 0.00325 | 0.0025 ~ 0.004125 | 0.0025 (20%) |
+| `stop_atr_mult` | 1.7 | 1.6 ~ 2.125 | 1.7 (20%) |
+| `target_atr_mult` | 1.8 | 1.375 ~ 2.325 | 1.6 (15%) |
+- _참고: 과적합%는 교차검증 점수가 아니라 표본·이상치·고원 휴리스틱입니다. 적용 가능도%=100−과적합위험%. DB 적용 버튼 활성 조건(gated PnL>0)과는 별개입니다._
+
+## 이전 장에서는
+- 실매 동기간 청산 7건 · 승률 14% · 합산 PnL -7,236원 (백테 Optuna와 숫자 달라도 정상 — 고스트·유니버스·틱 경로 차이).
+- 사후합격 1위: trial #17 · 거래 3건 · 승률 100.0% · PF 9999.00 · PnL 10,533원
+- 승률이 비정상적으로 높고 표본이 작습니다 → **해당 장에만 맞는 과적합** 신호.
+
+## 앞으로 장에서는
+- **1~2일 Optuna best를 바로 실매에 넣지 마세요.** 다일(≥5거래일) 재검증·웹백테 1회 후 검토.
+- 적용 시에는 `results_gated` 후보만. 탐색용 best(objective)와 다를 수 있습니다.
+- 장이 좁아지거나 변동성이 커지면: 손절·트레일·시간창이 먼저 깨집니다. 승률 자랑보다 **손절이 살아 있는지**를 보세요.
+- 사후합격이 있어도 ‘내일도 같은 장’이 아닙니다. 페이퍼/소액·모의로 1~2일 관찰 후 확대하세요.
+
+_생성: 2026-08-15 22:53:10 (rule)_
+
+## AI 코멘트
+
+_(미생성: api_call_failed. 구글 키는 GEMINI_API_KEY 를 DB/환경에 넣으세요 — kis_trader/backtest/optuna_briefing.py 모듈 docstring 참고)_
--- a/kis_trader/backtest/results/optuna_tail_tpe_20260815_225502.briefing.md
+++ b/kis_trader/backtest/results/optuna_tail_tpe_20260815_225502.briefing.md
@@ -0,0 +1,30 @@
+# Optuna 브리핑 — 꼬리 (tpe)
+기간: 2026-08-12 ~ 2026-08-14 (거래일≈3일) · trials 30/30
+탐색 게이트: WR≥0% PF≥0 · min_trades≥1 | 후보 게이트: WR≥40% PF≥1 · min_trades≥1
+- min_trades=1: **합격 인정 최소 거래 건수**(표본 부족·우연 승률 방지). 이보다 적은 조합은 학습/후보 집계에서 제외됩니다.
+학습용 통과 0건 · 사후합격(results_gated) 0건
+
+## 과적합·적용 가능도 (휴리스틱)
+- **과적합 위험 49.0%** · **적용 가능도 51.0%** · 판정: **주의** — 적용 가능도 중간 — 다일(≥5일) 재검증·웹백테 후 소액만
+  - 표본 장일: +16.0p — 거래일≈3일 — 다일 재검증 권장(≥5일)
+  - 거래 표본: +25.0p — 통과 후보 없음 — 적용 불가
+  - 승률·PF 이상치: +0.0p — 이상치 없음
+  - 게이트 커버: +8.0p — 학습·gated 모두 비어 있음
+  - PnL 고원: +0.0p — 고원 판정 스킵
+- _참고: 과적합%는 교차검증 점수가 아니라 표본·이상치·고원 휴리스틱입니다. 적용 가능도%=100−과적합위험%. DB 적용 버튼 활성 조건(gated PnL>0)과는 별개입니다._
+
+## 이전 장에서는
+- 실매 동기간 청산 7건 · 승률 14% · 합산 PnL -7,236원 (백테 Optuna와 숫자 달라도 정상 — 고스트·유니버스·틱 경로 차이).
+- 이 기간 백테에서는 **유의미한 통과 조합이 거의 없었습니다.** 유니버스·틱·손절·시간창을 먼저 점검하세요 (돌파 0건이면 특히).
+
+## 앞으로 장에서는
+- **1~2일 Optuna best를 바로 실매에 넣지 마세요.** 다일(≥5거래일) 재검증·웹백테 1회 후 검토.
+- 적용 시에는 `results_gated` 후보만. 탐색용 best(objective)와 다를 수 있습니다.
+- 장이 좁아지거나 변동성이 커지면: 손절·트레일·시간창이 먼저 깨집니다. 승률 자랑보다 **손절이 살아 있는지**를 보세요.
+- 현재 사후합격 0건 → 파라미터 유지(현행 DB) + 유니버스/데이터 점검이 우선입니다.
+
+_생성: 2026-08-15 22:55:03 (rule)_
+
+## AI 코멘트
+
+_(미생성: api_call_failed. 구글 키는 GEMINI_API_KEY 를 DB/환경에 넣으세요 — kis_trader/backtest/optuna_briefing.py 모듈 docstring 참고)_