fix: 리스크 결함 일괄 수정 — 누적 4% 상한·스윙 소유권·일일한도 분리·DT 순손익/체결가·시간손절 밴 제외·체결조회 경로

trade_executor - 종목당 4% 상한을 기존 보유분 포함 누적으로 (sizing_core.remaining_position_room) - 추천 경로는 스윙 소유 행만 매수·매도 (external/manual/daytrading/us_swing skip, 대칭), 고아 DT 행 warning - 일일 매수한도는 스윙 소유 매수만 집계, 집계 실패 시 fail-closed - 부분매도 반복 차단에서만 DT 매도 제외 (재매수 쿨다운은 유지) - 체결 확인: 부분체결 잔량 자동 재주문 제거(가드 전부 우회·취소/거부 시 발동), PARTIAL→COMPLETED+체결수량, 초과체결 캡 korea_investment_api - get_order_execution 이 존재하지 않는 /trading/inquire-ccnl 을 호출하던 결함 → inquire-daily-ccld (TTTC0081R 우선, 구 TR 폴백, 페이지네이션, ODNO 매칭, EXCG_ID_DVSN_CD=KRX), 실패 로그 warning daytrading - 시간손절은 loss_tracker 중립 (42일 밴이 스윙까지 막던 문제) - 실현손익을 수수료·거래세 차감 순손익으로 (trade_cost_core), 체결가 백그라운드 보정 (fill_reconciler) - legacy _record_trade strategy_type=daytrading 명시 db_worker - update_trade_history_by_order_id 를 당일(KST)+최신 1행으로 한정 (일별 재사용 ODNO 로 과거 행 덮어쓰기 방지) alembic 0013: trade_journals strategy_name='unknown' 을 trade_history.strategy_type 으로 보정 (백업 테이블 포함) CLAUDE.md: 변경 동작 반영, MT 예약 리비전 0013→0014 998 passed Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 17:37:29 +09:00
parent 599de3b52e
commit 45677c8fbb
19 changed files with 2873 additions and 166 deletions
--- a/backend/app/services/daytrading/fill_reconciler.py
+++ b/backend/app/services/daytrading/fill_reconciler.py
@@ -0,0 +1,143 @@
+"""데이트레이딩 실제 체결가 확인 (백그라운드).
+
+[2026-10-01] DT 는 시장가 주문 후 신호 시점 가격(1분봉 종가)을 체결가로 기록했다.
+실제 체결가와의 차이(슬리피지)가 원장·일일 손익·성과 통계에서 사라진다.
+
+설계:
+  - 주문 응답(KIS order-cash)에는 체결가가 없다 → 당일 주문체결 조회
+    (`korea_investment_api.get_todays_orders`, inquire-daily-ccld)에서 주문번호(ODNO)로 찾는다.
+    `get_order_execution()` 은 쓰지 않는다 — 국내 경로가 같은 TR(TTTC8001R)을
+    `/trading/inquire-ccnl` 로 호출해(같은 TR 의 다른 메서드 `get_todays_orders` 는
+    `/trading/inquire-daily-ccld`) 경로가 어긋나 있을 가능성이 높고, 실패를 debug 로 삼켜
+    체결 0 과 구분되지 않는다(운영 확인 필요 — 보고 사항).
+  - **실시간 루프를 막지 않는다**: `schedule()` 이 asyncio 태스크로 띄우고 즉시 반환.
+    전체를 `DAY_TRADE_FILL_CHECK_TIMEOUT_SEC` 로 감싼다 — KIS 토큰 rate-limit 의
+    `asyncio.sleep(≈70초)` 에 걸려도 상한에서 끊긴다.
+  - DB I/O 없음. 반영은 호출부 콜백이 인메모리 + db_worker 큐로 한다(§3).
+  - 확인 실패 시 None → 호출부는 신호가 기록을 유지하고 warning 을 남긴다.
+"""
+from __future__ import annotations
+
+import asyncio
+import logging
+from typing import Awaitable, Callable, Optional
+
+from app.core.config import settings
+from app.services.korea_investment_api import korea_investment_api
+
+logger = logging.getLogger(__name__)
+
+# create_task 결과의 강한 참조 — 참조가 없으면 GC 로 태스크가 중간에 사라질 수 있다.
+_pending_tasks: "set[asyncio.Task]" = set()
+
+
+def _norm_odno(value) -> str:
+    """KIS 주문번호 정규화 — 응답(ODNO)은 0 패딩, 조회(odno)는 경우에 따라 다르다."""
+    s = str(value or "").strip()
+    return s.lstrip("0") or ("0" if s else "")
+
+
+def parse_fill_row(rows: list, order_id: str) -> Optional[tuple[int, float]]:
+    """inquire-daily-ccld output1 에서 주문번호가 일치하는 행의 (체결수량, 평균체결가).
+
+    체결수량 0 이거나 평균가를 구할 수 없으면 None.
+    """
+    target = _norm_odno(order_id)
+    if not target:
+        return None
+    for row in rows or []:
+        if not isinstance(row, dict):
+            continue
+        if _norm_odno(row.get("odno")) != target:
+            continue
+        try:
+            qty = int(float(row.get("tot_ccld_qty", 0) or 0))
+            avg = float(row.get("avg_prvs", 0) or 0)
+            if avg <= 0 and qty > 0:
+                amt = float(row.get("tot_ccld_amt", 0) or 0)
+                avg = amt / qty if amt > 0 else 0.0
+        except (TypeError, ValueError):
+            return None
+        if qty > 0 and avg > 0:
+            return qty, avg
+        return None
+    return None
+
+
+async def _poll_fill(stock_code: str, order_id: str) -> Optional[tuple[int, float]]:
+    """체결 조회 폴링 (타임아웃은 호출부 wait_for 가 건다)."""
+    attempts = max(1, int(settings.DAY_TRADE_FILL_CHECK_ATTEMPTS))
+    interval = max(0.0, float(settings.DAY_TRADE_FILL_CHECK_INTERVAL_SEC))
+    await asyncio.sleep(max(0.0, float(settings.DAY_TRADE_FILL_CHECK_DELAY_SEC)))
+    for i in range(attempts):
+        rows = await korea_investment_api.get_todays_orders(stock_code)
+        fill = parse_fill_row(rows, order_id)
+        if fill is not None:
+            return fill
+        if i < attempts - 1:
+            await asyncio.sleep(interval)
+    return None
+
+
+async def fetch_fill(stock_code: str, order_id: str, side: str) -> Optional[tuple[int, float]]:
+    """주문번호의 실제 (체결수량, 평균체결가). 실패·시간초과·미체결이면 None + warning."""
+    if not order_id:
+        logger.warning(f"[DTFill] {stock_code} {side}: 주문번호 없음 — 신호가 기록 유지")
+        return None
+    timeout = float(settings.DAY_TRADE_FILL_CHECK_TIMEOUT_SEC)
+    try:
+        fill = await asyncio.wait_for(_poll_fill(stock_code, order_id), timeout=timeout)
+    except asyncio.TimeoutError:
+        logger.warning(
+            f"[DTFill] {stock_code} {side} 체결 조회 시간초과({timeout:.0f}초) "
+            f"order_id={order_id} — 신호가 기록 유지"
+        )
+        return None
+    except Exception as e:
+        logger.warning(
+            f"[DTFill] {stock_code} {side} 체결 조회 실패 order_id={order_id}: "
+            f"{type(e).__name__}: {e} — 신호가 기록 유지"
+        )
+        return None
+    if fill is None:
+        logger.warning(
+            f"[DTFill] {stock_code} {side} 체결 미확인 "
+            f"({int(settings.DAY_TRADE_FILL_CHECK_ATTEMPTS)}회 조회) order_id={order_id} — 신호가 기록 유지"
+        )
+    return fill
+
+
+def schedule(
+    stock_code: str,
+    order_id: str,
+    side: str,
+    on_fill: Callable[[int, float], Awaitable[None]],
+) -> Optional[asyncio.Task]:
+    """체결 확인을 백그라운드로 띄우고 즉시 반환. 확인되면 `on_fill(qty, avg_price)` 호출.
+
+    `DAY_TRADE_FILL_CHECK_ENABLED=False` 면 아무것도 하지 않는다(None).
+    """
+    if not settings.DAY_TRADE_FILL_CHECK_ENABLED:
+        return None
+
+    async def _run() -> None:
+        fill = await fetch_fill(stock_code, order_id, side)
+        if fill is None:
+            return
+        try:
+            await on_fill(*fill)
+        except Exception as e:
+            logger.warning(
+                f"[DTFill] {stock_code} {side} 체결가 반영 실패 order_id={order_id}: "
+                f"{type(e).__name__}: {e}",
+                exc_info=True,
+            )
+
+    try:
+        task = asyncio.get_running_loop().create_task(_run())
+    except RuntimeError as e:
+        logger.warning(f"[DTFill] {stock_code} {side} 체결 확인 예약 실패: {e}")
+        return None
+    _pending_tasks.add(task)
+    task.add_done_callback(_pending_tasks.discard)
+    return task