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

설계 상세: docs/reference/ARCHITECTURE.md

파이프라인 (권장 순서)

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 (알림만), 07_daily_pnl_telegram.py (매일 24h 수익률), 00_sync_ops.py (운영 전 봉 동기화)

디렉터리

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

산출물

경로	축
`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	3축 설계 (필독)
GROUND_TRUTH.md	GT 타점
SIMULATION.md	시뮬·Go/No-Go
OPERATIONS.md	운영 루틴
LIVE_TRADING.md	06 실거래

면책

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