Files
Bithumb/docs/reference/OPERATIONS.md
xavis d7848df6f7 refactor: GT·시뮬·운영 3축 정리 및 hybrid 실거래 정합
Phase C/dry-run·미사용 모듈·재생성 HTML을 제거하고, 운영 체결을
sim_causal_hybrid와 동일한 hybrid 로직으로 통합한다.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-03 23:50:28 +09:00

4.0 KiB

운영 가이드

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

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

배포 모델: hybrid primary (= 시뮬 sim_causal_hybrid). 상세: 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.py hybrid·한도·규칙 PASS (LIVE=1)
환경 verify_env.py .env·경로 검증

구조: STRUCTURE.md


실거래 운영 (LIVE=1)

.env 핵심

LIVE_TRADING_ENABLED=1
GT_SIGNAL_CAUSAL=1
SIM_PRIMARY_SIZING=auto
MONITOR_LOOP_SLEEP_SEC=180

전체: env.recommended.md

매일 루틴

순서 명령 빈도
1 python scripts/01_download.py 1일 1회
2 python scripts/06_verify_live.py 기동 전·1일 1회
3 python scripts/06_execute_live.py 상시 (빗썸 실주문)

선택: python scripts/05_run_monitor.py (알림만 병행)

기동 절차

  1. env.recommended.md 적용
  2. LIVE_TRADING_ENABLED=1 확인
  3. 06_verify_live.py → PASS
  4. 06_execute_live.py --oncelive_trades.jsonl 확인
  5. 06_execute_live.py 상시

체크리스트: DEPLOYMENT_CHECKLIST.md


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

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

텔레그램

스크립트 내용
05 규칙 발화·MTF 요약 (주문 없음)
06 발화 + 실주문 체결 (LIVE=1 필수)

중복 완화: MONITOR_ALERT_COOLDOWN_MIN, LIVE_COOLDOWN_MIN


장애 대응

증상 조치
주문 실패 live_trades.jsonl, API 키·잔고 → LIVE_TRADING_ENABLED=0
알림만, 주문 없음 LIVE_TRADING_ENABLED=1 및 06 프로세스 확인
verify FAIL .env, matched_rules 2개, GT_SIGNAL_CAUSAL=1
hybrid 금액 0 현금·EV/WF·tier 스킵 로그 확인
과다 알림 쿨다운 증가
시뮬과 수익 괴리 일한도·슬리피지 — 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단계)

  • 시뮬·hybrid Go/No-Go GO (참고)
  • 운영 .env
  • 06_verify_live.py PASS
  • LIVE_TRADING_ENABLED=1 의도 확인
  • --oncelive_trades.jsonl
  • RISK.md Kill switch 숙지

관련 문서