# 운영 가이드

## 로드맵과 현재 위치 (2026-06-01)

| 순서 | 단계 | 상태 |
|------|------|------|
| 1 | 시뮬레이션 | **완료** (GO) — [SIMULATION.md](SIMULATION.md) |
| 2 | 문서화 | **본 문서군** — SIMULATION / LIVE / RISK / OPERATIONS |
| 3 | 오픈 (실거래) | Phase C 후 B-1 — [LIVE_TRADING.md](LIVE_TRADING.md) |
| 4 | 실계좌 검증 | 1~2주 |
| 5 | 지속 운영 | 06 상시 + 월간 재시뮬 |

배포 모델: **hybrid primary** (= 시뮬 `sim_causal_hybrid`). 상세: [LIVE_TRADING.md](LIVE_TRADING.md)

---

## 단계별 스크립트

| 단계 | 스크립트 | 산출·역할 |
|------|----------|-----------|
| 01 | `01_download.py` | `coins.db` (3~1440분, 1분 제외) |
| (자동) | 05/06·`load_frames_from_db` | API 수집 시 `MONITOR_PERSIST_CANDLES=1`이면 **즉시 DB INSERT** |
| 02 | `02_ground_truth.py` | GT JSON·차트 |
| 03 | `03_analyze_enrich.py` | `docs/03_analysis/latest/` |
| 03b | `03_analyze_trades.py` | GT MTF 스냅샷 CSV |
| 03c | `03_gt_mtf_profile.py` | GT 프로필 (04 입력) |
| 04 | `04_match_rules.py` | `matched_rules.json` |
| 04 시뮬 | `04_simulation_report.py` | Go/No-Go 리포트 |
| 05 | `05_run_monitor.py` | 알림 (주문 없음) |
| 06 | `06_execute_live.py` | 알림+주문 (LIVE=1) |
| 점검 | `06_verify_live_dryrun.py` | hybrid·한도·규칙 PASS |
| 환경 | `verify_env.py` | `.env`·경로 검증 |

구조: [STRUCTURE.md](STRUCTURE.md)

---

## Phase C — 지금~금요일 (dry-run, 주문 없음)

### `.env` 핵심

```env
LIVE_TRADING_ENABLED=0
GT_SIGNAL_CAUSAL=1
SIM_PRIMARY_SIZING=auto
MONITOR_LOOP_SLEEP_SEC=180
MONITOR_ALERT_COOLDOWN_MIN=180
```

전체: [env.recommended.md](../05_ops/env.recommended.md)

### 매일 루틴

| 순서 | 명령 | 빈도 |
|------|------|------|
| 1 | `python scripts/01_download.py` | 1일 1회 |
| 2 | `python scripts/06_verify_live_dryrun.py` | 1일 1회 |
| 3 | `python scripts/06_execute_live.py` | 상시 (`LIVE=0`, 발화→`paper_fires.jsonl`) |
| 4 | 금요일 | `python scripts/07_phase_c_paper_report.py` (모의 forward % 참고) |

실계좌 수익률은 dry-run에서 나오지 않음. B-1 전 C Go 판정 후 `LIVE_TRADING_ENABLED=1`.

### 일별 기록

- 파일: `docs/05_ops/live_verification_20260601.md`
- 금요일: [DEPLOYMENT_CHECKLIST.md](../05_ops/DEPLOYMENT_CHECKLIST.md) §4.4 C Go/No-Go

---

## Phase B-1 — 실거래 시작 (C GO 이후)

1. [env.recommended.md](../05_ops/env.recommended.md) Phase B-1 블록 적용
2. `LIVE_TRADING_ENABLED=1` 확인
3. `06_verify_live_dryrun.py` → PASS
4. `06_execute_live.py --once` → `live_trades.jsonl` 확인
5. `06_execute_live.py` 상시

체크리스트: [DEPLOYMENT_CHECKLIST.md](../05_ops/DEPLOYMENT_CHECKLIST.md) §5

---

## Phase B-2 이후 (검증 통과 시)

- `LIVE_DAILY_KRW_MAX` 등 한도 상향 (리스크 문서·본인 판단)
- 주간 `04_simulation_report.py`로 EV·hybrid Go 재확인

---

## 텔레그램

| 스크립트 | 내용 |
|----------|------|
| 05 | 규칙 발화·MTF 요약 (주문 없음) |
| 06 | 발화 + 체결/dry-run 결과 (`LIVE=1` 시 체결) |

중복 완화: `MONITOR_ALERT_COOLDOWN_MIN`, `LIVE_COOLDOWN_MIN`

---

## 장애 대응

| 증상 | 조치 |
|------|------|
| 주문 실패 | `live_trades.jsonl`, API 키·잔고 → `LIVE_TRADING_ENABLED=0` |
| 알림만, 주문 없음 | C: 정상. B: `LIVE_TRADING_ENABLED` 확인 |
| verify FAIL | `.env`, `matched_rules` 2개, `GT_SIGNAL_CAUSAL=1` |
| hybrid 금액 0 | 현금·EV/WF·tier 스킵 로그 확인 |
| 과다 알림 | 쿨다운 증가 |
| 시뮬과 수익 괴리 | 일한도·슬리피지 — [RISK.md](RISK.md) |

---

## 데이터·산출물 경로

| 경로 | 용도 |
|------|------|
| `data/coins.db` 또는 루트 `coins.db` | OHLCV |
| `data/ground_truth/ground_truth_trades.json` | GT |
| `docs/04_matching/matched_rules.json` | 운영 규칙 |
| `docs/04_matching/simulation_report.html` | 시뮬 리포트 |
| `data/ops/live_trades.jsonl` | 06 로그 |

---

## 오픈 당일 체크리스트 (3단계)

- [ ] Phase C **GO**
- [ ] 시뮬·hybrid Go/No-Go **GO**
- [ ] Phase B-1 `.env`
- [ ] `06_verify_live_dryrun.py` PASS
- [ ] `LIVE_TRADING_ENABLED=1` 의도 확인
- [ ] `--once` 후 `live_trades.jsonl`
- [ ] [RISK.md](RISK.md) Kill switch 숙지

---

## 관련 문서

- [ROADMAP.md](ROADMAP.md)
- [SIMULATION.md](SIMULATION.md)
- [LIVE_TRADING.md](LIVE_TRADING.md)
- [RISK.md](RISK.md)
- [DEPLOYMENT_CHECKLIST.md](../05_ops/DEPLOYMENT_CHECKLIST.md)