# DeepCoin — WLD MTF 분석·정답·운영

빗썸 KRW-WLD. **1, 3, 5, 10, 15, 30, 60, 240, 1440분** 봉을 적재하고,  
Ground Truth·기술적 분석·(예정) 규칙 매칭·1분 모니터까지 **단계별 폴더**로 관리합니다.

## 로드맵

| 단계 | 목적 | 실행 |
|------|------|------|
| 01 데이터 | 1년치 봉 적재 | `python scripts/01_download.py` |
| 02 Ground Truth | 매수·매도 정답 타점 | `python scripts/02_ground_truth.py` |
| 03 분석 | 8TF 기술 지표 enrich | `python scripts/03_analyze_enrich.py` |
| 03b 분석 | GT 타점 MTF 스냅샷 | `python scripts/03_analyze_trades.py` |
| 04 매칭 | GT 근접 규칙 선택 (예정) | `python scripts/04_match_rules.py` |
| 05 운영 | 차트·1분 모니터 | `scripts/05_chart_*.py`, `05_run_monitor.py` |

상세: [docs/reference/ROADMAP.md](docs/reference/ROADMAP.md)

## 디렉터리 구조

```text
DeepCoin/
├── .env, config.py
├── scripts/                  # ★ 단계별 CLI (유일한 진입점)
├── deepcoin/
│   ├── api/bithumb.py        # 빗썸 API
│   ├── data/                 # 01 다운로드
│   ├── ground_truth/         # 02 정답 타점
│   ├── analysis/             # 03·03b 지표·스냅샷
│   ├── matching/             # 04 규칙 매칭 (예정)
│   └── ops/                  # 05 모니터·차트
├── data/                     # coins.db, ground_truth/, ops/
└── docs/
    ├── reference/            # 가이드·기법 명세 (Git)
    └── 02~05, charts/        # 단계별 HTML·CSV (재생성)
```

상세: [docs/reference/STRUCTURE.md](docs/reference/STRUCTURE.md) · [docs/README.md](docs/README.md)

## 환경 변수

| 파일 | 용도 |
|------|------|
| `.env` | 전역 설정·API 키 (Git 제외, 프로젝트 루트에 필수) |

`config.py`와 `scripts/_bootstrap.py`가 프로젝트 루트 `.env`를 `python-dotenv`로 자동 로드합니다. 새 환경에서는 팀에서 `.env`를 전달받거나 기존 로컬 파일을 복사하세요.

```bash
pip install -r requirements.txt
```

## 빠른 시작

```bash
python scripts/01_download.py
python scripts/02_ground_truth.py
python scripts/03_analyze_enrich.py
python scripts/03_analyze_trades.py
python scripts/05_chart_truth.py
```

## 주요 설정 (`config.py` / `.env`)

| 항목 | 설명 |
|------|------|
| `BITHUMB_ACCESS_KEY` | 빗썸 API (다운로드·시세) |
| `DB_PATH` | `data/coins.db` (`.env`로 변경 가능) |
| `GROUND_TRUTH_FILE` | `data/ground_truth/ground_truth_trades.json` |
| `CHART_LOOKBACK_DAYS` | 기본 365일 |
| `DOWNLOAD_MONTHS` | 3분 이상 봉 12개월 |
| `MONITOR_LOOP_SLEEP_SEC` | 05 모니터 루프 주기(초) |

## 산출물

| 경로 | 내용 |
|------|------|
| `data/coins.db` | 전 간격 OHLCV |
| `data/ground_truth/ground_truth_trades.json` | 정답 타점 |
| `docs/charts/wld_bb_chart.html` | 3분 BB 차트 |
| `docs/02_ground_truth/wld_ground_truth_chart.html` | 정답 차트 |
| `docs/03_analysis/latest/*_latest.csv` | 간격별 최근 봉 전 기법 |
| `docs/03_analysis/general_analysis_trades.csv` | GT 타점 MTF 스냅샷 |

## 면책

실거래는 사용자 책임입니다. 본 저장소는 주문 실행을 포함하지 않습니다.