# DeepCoin 프로젝트 구조

실행은 **`scripts/`** 만 사용합니다. 설계는 **Ground Truth · Simulation · Operations** 세 축입니다.  
[ARCHITECTURE.md](ARCHITECTURE.md)

## 축별 매핑

| 축 | 패키지 | 스크립트 | 산출물 |
|----|--------|----------|--------|
| **데이터** | `deepcoin/data/` | `01_download`, `00_sync_ops` | `data/coins.db` |
| **Ground Truth** | `ground_truth/`, `analysis/` | `02`, `03_*`, `05_chart_truth` | `ground_truth_trades.json`, `docs/02_ground_truth/` |
| **Simulation** | `matching/` | `04_match_rules`, `04_simulation_report` | `docs/04_matching/` |
| **Operations** | `ops/` | `06_verify_live`, `06_execute_live` | `data/ops/live_trades.jsonl` |

보조: `05_run_monitor` (알림), `verify_env`, `test_buy_sell_rehearsal`

## 디렉터리 트리

```text
DeepCoin/
├── .env, config.py
├── deepcoin/
│   ├── api/
│   ├── data/
│   ├── ground_truth/
│   ├── analysis/
│   ├── matching/
│   └── ops/
├── scripts/
├── data/
└── docs/
    ├── reference/          # ARCHITECTURE, GROUND_TRUTH, SIMULATION …
    ├── 02_ground_truth/
    ├── 03_analysis/
    ├── 04_matching/
    └── 05_ops/
```

## `docs/` 규칙

- `docs/reference/` — 가이드 (Git)
- `docs/02_*` ~ `docs/05_ops/` — 스크립트 재생성 산출물

코드의 `REPORTS_*` 별칭은 `deepcoin/paths.py`에서 `docs/*`로 연결됩니다.