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

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

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

docs/reference/STRUCTURE.md

@@ -0,0 +1,52 @@
+# DeepCoin 프로젝트 구조
+
+단계별 PM 기준으로 디렉터리·진입점을 정리합니다. **실행은 `scripts/`만 사용**합니다.
+
+**문서·산출물은 `docs/` 한 곳**에서 관리합니다.
+
+- `docs/reference/` — 사람이 읽는 가이드·명세 (Git 추적)
+- `docs/02_*` ~ `docs/charts/` — 스크립트가 만든 HTML·CSV (로컬 재생성)
+
+## 단계 ↔ 실행 ↔ 산출물
+
+| 단계 | 목적 | 스크립트 | 패키지 | 산출물 |
+|------|------|----------|--------|--------|
+| 01 | 1년치 봉 적재 | `scripts/01_download.py` | `deepcoin/data/` | `data/coins.db` |
+| 02 | Ground Truth 타점 | `scripts/02_ground_truth.py` | `deepcoin/ground_truth/` | `data/ground_truth/*.json`, `docs/02_ground_truth/` |
+| 03 | 8TF 지표 enrich | `scripts/03_analyze_enrich.py` | `deepcoin/analysis/` | `docs/03_analysis/latest/` |
+| 03b | GT 타점 MTF 스냅샷 | `scripts/03_analyze_trades.py` | `deepcoin/analysis/` | `docs/03_analysis/general_analysis_trades.csv` |
+| 04 | GT 근접 규칙 선택 | `scripts/04_match_rules.py` | `deepcoin/matching/` | `docs/04_matching/` (예정) |
+| 05 | 차트·1분 모니터 | `scripts/05_chart_*.py`, `05_run_monitor.py` | `deepcoin/ops/` | `docs/charts/`, `docs/05_ops/` |
+
+## 디렉터리 트리
+
+```text
+DeepCoin/
+├── .env, config.py
+├── scripts/                  # 단계별 CLI
+├── deepcoin/                 # 로직 패키지
+├── data/                     # DB, GT JSON, ops 상태
+└── docs/
+    ├── README.md
+    ├── reference/            # 가이드 (Git)
+    │   ├── ROADMAP.md
+    │   ├── STRUCTURE.md
+    │   ├── GROUND_TRUTH.md
+    │   └── trade_anaysis.html
+    ├── 02_ground_truth/      # 산출물
+    ├── 03_analysis/
+    ├── 04_matching/
+    ├── 05_ops/
+    └── charts/
+```
+
+## `deepcoin/analysis/` 모듈 역할
+
+| 파일 | 역할 |
+|------|------|
+| `general_analysis_enrich_runner.py` | 03 enrich |
+| `general_analysis_runner.py` | 03b GT 스냅샷 |
+| `general_analysis_pipeline.py` | 타점별 MTF 조립 |
+| `general_analysis_*` (기타) | 지표·패턴·리포트 |
+
+구 `reports/` 폴더는 `docs/`로 통합되었습니다. 코드의 `REPORTS_*` 이름은 `paths.py`에서 `docs/*`로 연결되는 별칭입니다.