# DeepCoin — WLD MTF · Ground Truth · Simulation · Operations

빗썸 KRW-WLD. 프로젝트는 **세 축**으로만 설계됩니다.

| 축 | 역할 | 미래 데이터 |
|----|------|-------------|
| **Ground Truth** | 벤치마크 타점·leg·배분 | 허용 (사후 라벨) |
| **Simulation** | 규칙·인과 백테스트·Go/No-Go | 금지 |
| **Operations** | 시뮬과 동일 규칙·hybrid 배분 실주문 | 금지 |

설계 상세: [docs/reference/ARCHITECTURE.md](docs/reference/ARCHITECTURE.md)

## 파이프라인 (권장 순서)

```bash
conda activate ncue   # 또는 xavis

# 데이터
python scripts/01_download.py

# Ground Truth
python scripts/02_ground_truth.py
python scripts/03_analyze_enrich.py
python scripts/03_analyze_trades.py
python scripts/03_gt_mtf_profile.py
python scripts/05_chart_truth.py

# Simulation
python scripts/04_match_rules.py
python scripts/04_simulation_report.py

# Operations (LIVE_TRADING_ENABLED=1)
python scripts/06_verify_live.py
python scripts/check_balance.py
python scripts/06_execute_live.py --once
python scripts/06_execute_live.py
```

선택: `05_run_monitor.py` (알림만), `00_sync_ops.py` (운영 전 봉 동기화)

## 디렉터리

```text
DeepCoin/
├── scripts/              # CLI 진입점 (GT / Sim / Ops)
├── deepcoin/
│   ├── data/             # 01
│   ├── ground_truth/     # GT
│   ├── analysis/         # GT 입력 (03)
│   ├── matching/         # Sim (04)
│   └── ops/              # Ops (05·06)
├── data/                 # coins.db, ground_truth/, ops/
└── docs/
    ├── reference/        # ARCHITECTURE, SIMULATION, OPERATIONS …
    └── 02~05/              # 재생성 산출물
```

## 환경

| 파일 | 용도 |
|------|------|
| `.env` | API 키·전역 설정 (Git 제외) |
| `config.py` | `.env` 로드 |

`scripts/_bootstrap.py`가 루트 `.env`를 자동 로드합니다.

### 주요 변수

| 변수 | 기본 | 축 |
|------|------|-----|
| `CHART_LOOKBACK_DAYS` | 365 | GT·Sim |
| `GT_INITIAL_CASH_KRW` | 400000 | GT·Sim·Ops 배분 |
| `GENERAL_ANALYSIS_INTERVALS` | 3m~일봉+주·월 | Sim 스캔 |
| `GT_SIGNAL_CAUSAL` | 1 | Sim·Ops (인과) |
| `LIVE_TRADING_ENABLED` | 1 | Ops (`0`이면 06 기동 불가) |

전체: `.env.example`, [docs/05_ops/env.recommended.md](docs/05_ops/env.recommended.md)

## 산출물

| 경로 | 축 |
|------|-----|
| `data/ground_truth/ground_truth_trades.json` | GT |
| `docs/02_ground_truth/wld_ground_truth_chart.html` | GT 차트 (`05_chart_truth.py` 재생성) |
| `docs/04_matching/matched_rules.json` | Sim |
| `docs/04_matching/simulation_report.html` | Sim |
| `data/ops/live_trades.jsonl` | Ops |

## 문서

| 문서 | 내용 |
|------|------|
| [ARCHITECTURE.md](docs/reference/ARCHITECTURE.md) | 3축 설계 (필독) |
| [GROUND_TRUTH.md](docs/reference/GROUND_TRUTH.md) | GT 타점 |
| [SIMULATION.md](docs/reference/SIMULATION.md) | 시뮬·Go/No-Go |
| [OPERATIONS.md](docs/reference/OPERATIONS.md) | 운영 루틴 |
| [LIVE_TRADING.md](docs/reference/LIVE_TRADING.md) | 06 실거래 |

## 면책

실거래 손익은 사용자 책임입니다. 본 저장소는 투자 자문이 아닙니다.
