refactor: DeepCoin 1·2단계 파이프라인으로 구조 재편

레거시 분석·매칭·운영 코드를 정리하고 src/deepcoin 기반으로 재구성한다.
1단계 GT는 2년 스윙·눌림목·돌파·다이버전스 타점을 차트에 표시하고,
2단계는 8개 매매 기법과 GT 정합 평가 스크립트를 추가한다.
.env와 GT JSON 산출물은 추적에서 제외한다.

Co-authored-by: Cursor <cursoragent@cursor.com>

scripts/02_ground_truth.py

@@ -1,11 +1,123 @@
 #!/usr/bin/env python3
-"""Ground Truth: 매수·매도 정답 타점 JSON 생성."""
-import runpy
+"""1단계: Ground Truth — 사후 최적 스윙 매수·매도 타점 (1매수·1매도 레그)."""
+
+from __future__ import annotations
+
+import argparse
+import logging
+import sys
 from pathlib import Path
 
-runpy.run_path(str(Path(__file__).resolve().parent / "_bootstrap.py"))
+ROOT = Path(__file__).resolve().parents[1]
+SRC = ROOT / "src"
+if str(SRC) not in sys.path:
+    sys.path.insert(0, str(SRC))
+
+from deepcoin.config import load_settings
+from deepcoin.data.intervals import interval_label
+from deepcoin.ground_truth.chart import render_ground_truth_chart
+from deepcoin.ground_truth.ground_truth import GtParams, build_ground_truth, save_ground_truth
+
+
+def _configure_logging(verbose: bool) -> None:
+    """로깅 레벨을 설정한다."""
+    level = logging.DEBUG if verbose else logging.INFO
+    logging.basicConfig(
+        level=level,
+        format="%(asctime)s [%(levelname)s] %(message)s",
+        datefmt="%Y-%m-%d %H:%M:%S",
+    )
+
+
+def main() -> int:
+    """CLI 진입점."""
+    parser = argparse.ArgumentParser(description="Ground Truth 스윙 레그 생성 (1단계)")
+    parser.add_argument("--interval", type=int, default=None, help="GT 인터벌(분)")
+    parser.add_argument("--days", type=int, default=None, help="GT·타점 기간(일). 기본 730(2년)")
+    parser.add_argument("--zigzag", type=float, default=None, help="ZigZag 되돌림 %%")
+    parser.add_argument("--min-leg", type=float, default=None, help="최소 레그 수익률 %%")
+    parser.add_argument("--no-chart", action="store_true", help="HTML 차트 생략")
+    parser.add_argument("-v", "--verbose", action="store_true")
+    args = parser.parse_args()
+
+    _configure_logging(args.verbose)
+    settings = load_settings()
+
+    params = GtParams(
+        interval_min=args.interval or settings.gt_interval_min,
+        lookback_days=args.days or settings.gt_lookback_days,
+        zigzag_reversal_pct=args.zigzag or settings.gt_zigzag_reversal_pct,
+        min_leg_pct=args.min_leg or settings.gt_min_leg_pct,
+        pullback_min_pct=settings.gt_pullback_min_pct,
+        pullback_local_order=settings.gt_pullback_local_order,
+        breakout_buffer_pct=settings.gt_breakout_buffer_pct,
+        breakout_consolidation_bars=settings.gt_breakout_consolidation_bars,
+        breakout_min_rally_pct=settings.gt_breakout_min_rally_pct,
+        div_local_order=settings.gt_div_local_order,
+        div_min_bars_between=settings.gt_div_min_bars_between,
+        div_min_rsi_diff=settings.gt_div_min_rsi_diff,
+        div_min_future_move_pct=settings.gt_div_min_future_move_pct,
+    )
+
+    logging.info(
+        "GT 생성: %s %s, %s일, ZigZag=%s%%, min_leg=%s%%, 초기=%s원",
+        settings.symbol,
+        interval_label(params.interval_min),
+        params.lookback_days,
+        params.zigzag_reversal_pct,
+        params.min_leg_pct,
+        f"{settings.gt_initial_cash_krw:,.0f}",
+    )
+
+    result = build_ground_truth(
+        db_path=settings.db_path,
+        symbol=settings.symbol,
+        coin_name=settings.coin_name,
+        params=params,
+        initial_cash_krw=settings.gt_initial_cash_krw,
+        fee_rate=settings.gt_trading_fee_rate,
+    )
+
+    out_json = save_ground_truth(result, settings.ground_truth_file)
+    summary = result["summary"]
+    meta = result["meta"]
+    pnl = result["pnl"]
+
+    print("\n=== Ground Truth 완료 (1단계 벤치마크) ===")
+    print(f"대상: {meta['symbol']} ({meta['interval_label']})")
+    print(f"GT·수익 기간: {meta['data_from']} ~ {meta['data_to']} ({meta['bar_count']}봉)")
+    print(f"차트·타점: 최근 {settings.download_days}일 (2년)")
+    print(f"피벗: {meta['pivot_count']}개 → 레그: {summary['leg_count']}개")
+    print(
+        f"매수 타점: {summary['buy_count']}개 "
+        f"(눌림 {summary.get('pullback_buy_count', 0)} / 돌파 {summary.get('breakout_buy_count', 0)} "
+        f"/ 다이버전스 {summary.get('divergence_buy_count', 0)}) "
+        f"/ 매도: {summary['sell_count']}개 (다이버전스 {summary.get('divergence_sell_count', 0)})"
+    )
+    print(f"레그 수익률 — 평균: {summary['avg_leg_pct']}%, 최대: {summary['max_leg_pct']}%")
+
+    period = ""
+    if pnl.get("period_from"):
+        period = f" ({pnl['period_from'][:10]} ~ {pnl['period_to'][:10]})"
+    print(f"\n=== 누적 수익{period} — 초기 {pnl['initial_cash_krw']:,.0f}원 ===")
+    print(f"최종 자산: {pnl['final_cash_krw']:,.0f}원")
+    print(f"손익: {pnl['total_pnl_krw']:+,.0f}원")
+    print(f"기간 수익률: {pnl['total_return_pct']:+.2f}%")
+    print(f"거래 레그: {pnl['legs_traded']}건")
+    print(f"JSON: {out_json}")
+
+    if not args.no_chart:
+        chart_path = render_ground_truth_chart(
+            db_path=settings.db_path,
+            symbol=settings.symbol,
+            gt_result=result,
+            output_path=settings.ground_truth_chart_file,
+            chart_lookback_days=settings.download_days,
+        )
+        print(f"차트: {chart_path}")
+
+    return 0
 
-from deepcoin.ground_truth.ground_truth import run_from_db
 
 if __name__ == "__main__":
-    run_from_db()
+    raise SystemExit(main())