feat(vol_breakout): 15m 현물 롱 라이브·모니터·cron 운영 추가

vol_breakout 멀티종목 tick, vol_live HTML 모니터, 마감 봉만 저장하는 캔들 다운로드,
텔레그램 체결 알림, cron/watch 감시 스크립트 및 테스트를 포함한다.

Co-authored-by: Cursor <cursoragent@cursor.com>

.env.example

@@ -17,6 +17,8 @@ COIN_TELEGRAM_CHAT_ID=
 # --- 거래 대상 ---
 SYMBOL=BTC
 COIN_NAME=비트코인
+# 캔들 수집 대상 (쉼표 구분). 비우면 SYMBOL만 수집
+DOWNLOAD_SYMBOLS=TRX,NEAR,WLD
 
 # --- 공통: 캔들 DB (현물·선물 공유) ---
 DB_PATH=data/common/coins.db
@@ -118,7 +120,9 @@ OPS_WATCH_SIGNAL_GRACE_MIN=5
 OPS_WATCH_TICK_STALE_MIN=12
 OPS_WATCH_LOOKBACK_MIN=30
 OPS_WATCH_AUTO_REMEDIATE=true
-OPS_WATCH_AUTO_RESTART=true
+# vol_breakout(cron 1분) 사용 시 fractal loop 재시작 끄기
+OPS_WATCH_AUTO_RESTART=false
+# fractal loop 커스텀 기동 (OPS_WATCH_AUTO_RESTART=true 일 때)
 # OPS_WATCH_LOOP_START_CMD=
 # OPS_PERSIST_SIGNAL_CACHE=false
 OPS_STATE_JSON=data/spot/operations/fractal_ops_state.json
@@ -128,6 +132,36 @@ OPS_FILTERED_BACKTEST_JSON=docs/spot/3_operations/fractal_filtered_backtest_repo
 OPS_SIZING_RULES_JSON=data/spot/operations/sizing_rules.json
 # composite_v3 운영 시: OPS_TECHNIQUE_ID=composite_v3, OPS_MIN_SCORE=2.5, OPS_MTF_ENABLED=true
 
+# --- vol_breakout 현물 롱 (Binance 15m ATR 이식, BTC 제외) ---
+# fractal_swing(3분)과 별도 프로세스 — 동시 live 시 KRW 경합 주의
+OPS_SYMBOLS=TRX,NEAR,WLD
+VOL_STATE_JSON=data/spot/operations/vol_breakout_state.json
+VOL_LOOKBACK=14
+VOL_ATR_MULT=2.0
+VOL_LOOKBACK_DAYS=60
+# VOL_BUY_SPLIT=0: 미보유 슬롯 수로 동적 (3→1/3, 2→1/2, 1→100%)
+VOL_BUY_SPLIT=0
+VOL_WALLET_PCT=0.30
+VOL_MAX_BARS_PER_TICK=5
+# 순수 15m flip (trail/stop off). 청산은 하향 돌파(-1) flip만
+VOL_EXIT_ENABLED=false
+# trail/stop 사용 시 VOL_EXIT_ENABLED=true 및 아래 값
+# VOL_TRAIL_ACTIVATE_PCT=1.5
+# VOL_TRAIL_PCT=0.0025
+# VOL_TRAIL_ATR_MULT=0.5
+# VOL_STOP_PCT=-12.0
+VOL_TICK_LOCK_PATH=data/spot/operations/vol.tick.lock
+# touch data/spot/operations/vol.kill → 신규 매수 차단
+# VOL_KILL_SWITCH_PATH=data/spot/operations/vol.kill
+
+# 라이브 모니터 (Binance vol_live_monitor 유사, 기본 포트 8766)
+VOL_MONITOR_JSON=docs/spot/3_operations/vol_live_chart.json
+VOL_MONITOR_HTML=docs/spot/3_operations/vol_live_monitor.html
+VOL_MONITOR_DAYS=14
+
+# cron (vol_breakout): bash scripts/install_crontab.sh --apply
+# BITHUMB_PYTHON=/Users/dsyoon/opt/anaconda3/envs/coin/bin/python3
+
 # 폴더 구조: data|docs / {common, spot}
 #   common — coins.db 등 공유 리소스
 #   spot   — 현물 GT·기법·분석·운영