WLD DeepCoin 단계별 구조 재편 및 설정·문서 통합

로고스/루트 레거시를 제거하고 deepcoin 패키지·scripts 01~05 CLI·docs/reference로
데이터·GT·분석·매칭·운영 단계를 정리했다. config와 .env 기반 설정, trade_anaysis.html 동기화 포함.

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

deepcoin/matching/README.md

@@ -0,0 +1,15 @@
+# Phase 04 — Matching
+
+Ground Truth 매수·매도 타점의 MTF 스냅샷(`docs/03_analysis/general_analysis_trades.csv`)과
+실시간·최근 봉 상태를 비교해 **가장 근접한 기술적 프로파일** 및 **진입·청산 규칙**을 선택합니다.
+
+예정 산출물:
+
+- `docs/04_matching/rule_candidates.json`
+- `docs/04_matching/similarity_report.html`
+
+실행 (스텁):
+
+```bash
+python scripts/04_match_rules.py
+```

deepcoin/matching/__init__.py

@@ -0,0 +1,3 @@
+"""
+04단계: Ground Truth에 근접한 기술적 상태·규칙 선택 (예정).
+"""

deepcoin/matching/match_rules.py

@@ -0,0 +1,31 @@
+"""
+04단계 스텁: GT 스냅샷과 현재 상태 유사도·규칙 후보 (구현 예정).
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from deepcoin.paths import REPORTS_ANALYSIS, REPORTS_MATCHING, resolve_ground_truth_file
+
+
+def run_match_stub() -> Path:
+    """
+    입력 파일 존재 여부만 확인하고 04단계 안내를 출력합니다.
+
+    Returns:
+        matching 리포트 디렉터리.
+    """
+    REPORTS_MATCHING.mkdir(parents=True, exist_ok=True)
+    gt = resolve_ground_truth_file()
+    csv = REPORTS_ANALYSIS / "general_analysis_trades.csv"
+    print("=== Phase 04 Matching (stub) ===")
+    print(f"  ground truth: {gt} ({'OK' if gt.is_file() else 'MISSING'})")
+    print(f"  analysis csv: {csv} ({'OK' if csv.is_file() else 'MISSING — run scripts/03_analyze_trades.py'})")
+    print(f"  output dir:   {REPORTS_MATCHING}")
+    print("  구현 예정: 유사도·규칙 선택")
+    return REPORTS_MATCHING
+
+
+if __name__ == "__main__":
+    run_match_stub()