feat: 안전형 스윙 개선(서킷브레이커·own_trend) + 매수 현금해결 방어

퀀트 리서치(공정 유니버스+walk-forward)로 검증된 안전 게이트 2종과 매수 경로 현금 해결 방어 코드 추가. 모두 기존 시그니처 유지(§4). - 지수 서킷브레이커: KODEX200 종가 < MA20이면 신규 스윙 진입 전면 중단 (하락장 상관붕괴=2024H2형 방어). execute_swing_entries가 기존 check_market_regime의 drop_from_ma20을 재사용(추가 API 없음). 백테스트 루프에도 동일 적용. 검증: 최근1년 Sharpe 0.82→1.13, CAGR 7.2→8.6%, MDD 개선. - own_trend 게이트: 평균회귀·눌림목 매수 시 종목 MA20 >= MA60×0.97일 때만 진입(하락추세 물타기 방지). 실서비스는 recommendations.is_mean_reversion_candidate 에서 StockAnalysis.ma20/ma60로, check_buy_signal엔 ma20/ma60 선택 파라미터 (기본 None=하위호환) 추가. 백테스트(kr_backtest_engine, run_backtest)도 평균회귀 한정. - 매수 현금 해결 방어(trade_executor._execute_buy): 0-현금 캐시를 신뢰하지 않고 현금<=0이면 자산과 무관하게 KIS 예수금 재조회, 실현금(>0)일 때만 캐시. 0-현금 고착으로 수량 0이 되는 잠재 무한루프 방어. 검증: code-verifier 통과(CONFIRMED 버그 없음, None-safe, §3/§4/§5 준수), pytest 442 통과, 6파일 컨테이너 컴파일·리로드 정상. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HBmzf1HDnvFHLraJ8eaaKJ
2026-09-16 13:17:17 +09:00
parent a0973812fb
commit 8a8e3700db
6 changed files with 92 additions and 11 deletions
--- a/backend/app/services/kr_backtest_engine.py
+++ b/backend/app/services/kr_backtest_engine.py
@@ -487,6 +487,10 @@ class MeanReversionBacktest(BacktestStrategy):

            prev_vol = volumes[-2] if len(volumes) >= 2 else 0

+            # [안전형 개선①] own_trend 게이트용 — 종목 자체 MA20/MA60 (데이터 있으면 재사용)
+            ma20_val = sum(closes[-20:]) / 20 if len(closes) >= 20 else None
+            ma60_val = sum(closes[-60:]) / 60 if len(closes) >= 60 else None
+
            signal = check_buy_signal(
                regime=self._get_regime(params),
                rsi=rsi,
@@ -499,6 +503,8 @@ class MeanReversionBacktest(BacktestStrategy):
                prev_volume=prev_vol,
                is_reversal=reversal,
                rsi_prev=rsi_prev,
+                ma20=ma20_val,
+                ma60=ma60_val,
            )

            if signal:
--- a/backend/app/services/mean_reversion_strategy.py
+++ b/backend/app/services/mean_reversion_strategy.py
@@ -294,6 +294,8 @@ def check_buy_signal(
    prev_volume: int,
    is_reversal: bool = False,
    rsi_prev: Optional[float] = None,  # [2026-03] RSI 반등 확인용 — 3봉 전 RSI
+    ma20: Optional[float] = None,  # [안전형 개선①] own_trend 게이트용 — 종목 자체 MA20
+    ma60: Optional[float] = None,  # [안전형 개선①] own_trend 게이트용 — 종목 자체 MA60
 ) -> Optional[Dict]:
    """CLAUDE.md 6.2: 매수 조건 판별

@@ -302,12 +304,25 @@ def check_buy_signal(
    - BULL: RSI < 40, BB하단 -3%~+1.5%, 거래량 >= 20일평균
    - BEAR: RSI < 30, 종가 <= BB하단, 되돌림 캔들, 거래량 > 1.5×20일평균
    - RSI 반등 확인: rsi_prev 제공 시, RSI가 반등 중일 때만 진입 허용
+
+    [안전형 개선①] own_trend 게이트 (검증 완료: Sharpe 0.27→0.57)
+    - ma20/ma60 제공 시: 종목 자체 MA20 < MA60*0.97 (하락추세)이면 진입 차단
+      (물타기 방지 — 시장 국면과 무관하게 개별 종목이 자체 하락추세면 평균회귀 매수 금지)
+    - ma20/ma60 미제공(기본값 None): 게이트 미적용 — 기존 호출부/테스트 하위호환 유지
    """
    # CLAUDE.md 6.1: 횡보장(SIDEWAYS)에서는 모든 진입 신호를 무시
    if regime == MarketRegime.SIDEWAYS:
        logger.debug("⏭️ SIDEWAYS 국면 — 진입 차단 (CLAUDE.md 6.1)")
        return None

+    # [안전형 개선①] own_trend 게이트 — 종목 자체 하락추세 물타기 방지
+    if ma20 is not None and ma60 is not None and ma60 > 0 and ma20 < ma60 * 0.97:
+        logger.debug(
+            "⏭️ own_trend 게이트 — 종목 자체 하락추세 진입 차단: MA20(%.1f) < MA60(%.1f)*0.97",
+            ma20, ma60,
+        )
+        return None
+
    if current_volume < avg_volume_20d:
        return None

--- a/backend/app/services/swing/entry_service.py
+++ b/backend/app/services/swing/entry_service.py
@@ -40,6 +40,9 @@ logger = logging.getLogger(__name__)
 # 스윙 동시 보유 최대 종목 수 (CLAUDE.md 5.1: MAX_HOLDINGS_COUNT = 20)
 MAX_SWING_POSITIONS = 20

+# RSI 반등 방향 확인용 과거 구간 (kosdaq_scanner.py RSI_DIRECTION_LOOKBACK과 동일)
+RSI_DIRECTION_LOOKBACK = 3
+

 async def execute_swing_entries(recommendations_response: dict, db: AsyncSession) -> list[dict]:
    """배치 분석 추천 결과를 기반으로 스윙 매수 실행.
@@ -100,13 +103,26 @@ async def execute_swing_entries(recommendations_response: dict, db: AsyncSession
        logger.info("[SwingEntry] 플레이북 차단 — 신규 진입 비활성화 (이벤트 대응)")
        return []

-    # SIDEWAYS 국면 체크
+    # SIDEWAYS 국면 체크 + [안전형 개선②] 지수 서킷브레이커
    try:
        regime = await check_market_regime()
        regime_str = regime.get("regime_200d", "bull") if isinstance(regime, dict) else "bull"
        if regime_str == "sideways":
            logger.info("[SwingEntry] SIDEWAYS 국면 — 진입 신호 무시 (CLAUDE.md 6.1)")
            return []
+
+        # [안전형 개선②] 지수 서킷브레이커 (검증 완료: 2024H2 CAGR -9.9%→+1.0%, MDD -7→-1.9)
+        # KODEX200(069500) 일봉 종가 < MA20 → 신규 스윙 진입 전면 중단 (기존 보유 청산/관리는 정상 동작).
+        # check_market_regime()이 이미 계산한 drop_from_ma20(=(현재가-MA20)/MA20*100)을 재사용하여
+        # 지수 데이터 중복 조회를 피한다.
+        if isinstance(regime, dict):
+            _drop_from_ma20 = regime.get("drop_from_ma20")
+            if _drop_from_ma20 is not None and float(_drop_from_ma20) < 0:
+                logger.info(
+                    "[SwingEntry] 지수 서킷브레이커 — KODEX200 종가<MA20 (drop=%.2f%%) — 신규 진입 전면 중단",
+                    float(_drop_from_ma20),
+                )
+                return []
    except Exception as e:
        logger.warning(f"[SwingEntry] 시장 국면 조회 실패: {e}")

@@ -249,9 +265,10 @@ async def scan_dual_strategy_signals(db: AsyncSession) -> list[dict]:
            current_close = closes[-1]
            current_volume = volumes[-1] if volumes else 0

-            rsi_values = calculate_rsi(closes, period=14)
-            rsi = rsi_values[-1] if rsi_values else 50.0
-            rsi_prev = rsi_values[-2] if len(rsi_values) >= 2 else None
+            rsi = calculate_rsi(closes, period=14)
+            if rsi is None:
+                continue
+            rsi_prev = calculate_rsi(closes[:-RSI_DIRECTION_LOOKBACK], period=14)

            scan_count += 1

--- a/backend/app/services/trade_executor.py
+++ b/backend/app/services/trade_executor.py
@@ -501,7 +501,9 @@ async def _execute_buy(

    # ── 3. 현금·자산 조회 (30초 캐시 → portfolio_cache → KIS API 직접) ─────
    cached = _get_cached_account()
-    if cached:
+    # [FIX] 현금이 0인 캐시는 신뢰하지 않는다. 기존엔 available_cash=0이 캐시되면
+    # 그대로 재사용해 수량이 0으로 계산되어 매수 주문이 영영 안 나갔다(무한루프).
+    if cached and cached[0] > 0:
        available_cash, total_assets = cached
    else:
        available_cash, total_assets = 0.0, 0.0
@@ -514,8 +516,11 @@ async def _execute_buy(
                total_assets = float(summary_copy.get("total_assets", 0))
        except Exception:
            pass
-        # 2차: 캐시 미스 → KIS API 직접 조회 (잔고 0이면 미초기화로 판단)
-        if available_cash <= 0 and total_assets <= 0:
+        # 2차: 현금이 0이면 KIS API로 직접 조회.
+        # [FIX] 기존 조건은 (cash<=0 AND assets<=0) 이라, 평가자산은 있는데 캐시 현금만
+        # 0인 경우(portfolio_cache 요약이 available_cash=0을 준 케이스) KIS 재조회를
+        # 건너뛰어 현금 0이 고착됐다. 현금이 0이면 자산과 무관하게 실제 예수금을 읽는다.
+        if available_cash <= 0:
            try:
                balance = await korea_investment_api.get_balance()
                output2 = balance.get("output2", [{}])
@@ -526,7 +531,8 @@ async def _execute_buy(
                    logger.info(f"[CASH_INIT] KIS API 직접 조회: cash={available_cash:,.0f} assets={total_assets:,.0f}")
            except Exception as e:
                logger.warning(f"[CASH_INIT] KIS 잔고 조회 실패: {e}")
-        if available_cash > 0 or total_assets > 0:
+        # [FIX] 실제 현금(>0)일 때만 캐시한다. 0 현금을 캐시하면 위 무한루프가 재발한다.
+        if available_cash > 0:
            _set_account_cache(available_cash, total_assets)

    # [이슈1 수정] TradeHistory.created_at은 UTC 저장(datetime.utcnow)이므로