-- 토큰·세션·전략 ON/OFF 관련 컬럼 COMMENT (선별·정밀 문구)
-- 전 컬럼(config_*/env_config ~1200+)은 아래로 일괄:
--   python3 scripts/sql/fill_all_config_env_column_comments.py --apply
--   → scripts/sql/all_config_env_column_comments.generated.sql
-- 참고: docs/증권사_토큰_시세.md · kis_ws_session_windows · ls_ws_session_windows
-- 실행: python 또는 mysql 클라이언트. pymysql 사용 시 COMMENT 안 % → %% .

-- ── config_* : STRATEGY_*_ENABLED ─────────────────────────────────────
ALTER TABLE `config_us_momentum`
  MODIFY COLUMN `STRATEGY_US_MOMENTUM_ENABLED`
    TEXT NULL
    COMMENT '해외모멘텀 ON/OFF. 다음루프 신규매수중단(보유청산유지). WS구독해제 안함. 기동시OFF→켜려면재시작';

ALTER TABLE `config_momentum`
  MODIFY COLUMN `STRATEGY_MOMENTUM_ENABLED`
    TEXT NULL
    COMMENT '국내모멘텀 ON/OFF. 다음루프 신규매수중단(보유청산유지). WS구독해제 안함. 기동시OFF→켜려면재시작';

ALTER TABLE `config_short`
  MODIFY COLUMN `STRATEGY_SHORT_ENABLED`
    TEXT NULL
    COMMENT '꼬리잡기 ON/OFF. 다음루프 신규매수중단(보유청산유지). WS구독해제 안함. 기동시OFF→켜려면재시작';

ALTER TABLE `config_breakout`
  MODIFY COLUMN `STRATEGY_BREAKOUT_ENABLED`
    TEXT NULL
    COMMENT '돌파 ON/OFF. 다음루프 신규매수중단(보유청산유지). WS구독해제 안함. 기동시OFF→켜려면재시작';

ALTER TABLE `config_updow`
  MODIFY COLUMN `STRATEGY_UPDOW_ENABLED`
    TEXT NULL
    COMMENT 'UPDOWN박스 ON/OFF. 다음루프 신규매수중단(보유청산유지). WS구독해제 안함. 기동시OFF→켜려면재시작';

ALTER TABLE `config_scalp`
  MODIFY COLUMN `STRATEGY_SCALP_ENABLED`
    TEXT NULL
    COMMENT '스캘핑 ON/OFF. 다음루프 신규매수중단(보유청산유지). WS구독해제 안함. 기동시OFF→켜려면재시작';

ALTER TABLE `config_range_break`
  MODIFY COLUMN `STRATEGY_RANGE_BREAK_ENABLED`
    TEXT NULL
    COMMENT '박스권돌파 ON/OFF. 다음루프 신규매수중단(보유청산유지). WS구독해제 안함';

ALTER TABLE `config_dbband`
  MODIFY COLUMN `STRATEGY_DBBAND_ENABLED`
    TEXT NULL
    COMMENT '더블BB ON/OFF. 다음루프 신규매수중단(보유청산유지). WS구독해제 안함';

ALTER TABLE `config_dart`
  MODIFY COLUMN `STRATEGY_DART_ENABLED`
    TEXT NULL
    COMMENT 'DART수주 ON/OFF. 다음루프 신규매수중단(보유청산유지). WS구독해제 안함';

-- ── env_config : KIS approval·hold · 키움 구독한도 ─────────────────────
ALTER TABLE `env_config`
  MODIFY COLUMN `KIS_WS_KR_HOLD_START_HM`
    TEXT NULL
    COMMENT '국내WS approval점유 시작 HHMM. 기본700. 갭·해외창에선 소켓양보(재발급없음)'

, MODIFY COLUMN `KIS_WS_KR_HOLD_END_HM`
    TEXT NULL
    COMMENT '국내WS approval점유 종료 HHMM. 기본2000. kis_ws_session_windows'

, MODIFY COLUMN `KIS_WS_US_HOLD_START_HM`
    TEXT NULL
    COMMENT '해외WS(HDFSCNT0) 점유 시작 HHMM. 기본2100. 국내와 동시점유금지(1키=1세션)'

, MODIFY COLUMN `KIS_WS_US_HOLD_END_HM`
    TEXT NULL
    COMMENT '해외WS 점유 종료 HHMM. 기본600(자정넘김). 세션전환시 approval재발급금지'

, MODIFY COLUMN `KIS_WS_APPROVAL_MIN_REISSUE_SEC`
    TEXT NULL
    COMMENT 'approval_key 최소재발급간격(초). 기본21600=6h. REST재발급은기존키무효화'

, MODIFY COLUMN `KIS_WS_APPROVAL_MAX_VALID_SEC`
    TEXT NULL
    COMMENT 'approval_key 최대유효(초). 기본82800≈23h. 파일캐시 kis_approval_manager'

, MODIFY COLUMN `KIS_WS_INVALID_APPROVAL_REISSUE_AFTER`
    TEXT NULL
    COMMENT 'invalid approval 연속N회 후 응급재발급 허용. 6h가드우회조건'

, MODIFY COLUMN `KIS_WS_INVALID_APPROVAL_BYPASS_6H`
    TEXT NULL
    COMMENT 'true면 invalid루프시 6h가드우회응급재발급. 남용금지'

, MODIFY COLUMN `KIS_WS_EMERGENCY_REISSUE_MIN_SEC`
    TEXT NULL
    COMMENT '응급approval재발급 최소간격(초). 기본=정상6h와동일. 하드캡'

, MODIFY COLUMN `KIWOOM_WS_MAX_SUBSCRIPTIONS`
    TEXT NULL
    COMMENT '키움WS 그룹당최대구독. 기본100. 0B체결·0D호가·0w프로그램. 한투41과별개'
;

-- ── env_config_ext : KV 테이블 자체 설명 (키별 행은 컬럼 아님) ───────────
ALTER TABLE `env_config_ext`
  COMMENT='env_config 확장 KV. LS_WS_*·LS_TOKEN_*·OVERSEAS_WS_ENABLED·워치독/hold 등 다수키. 컬럼추가없이 env_key행'

, MODIFY COLUMN `env_key`
    VARCHAR(80) NOT NULL
    COMMENT '설정키. 예: LS_WS_WATCHDOG_SESSION_GATE, LS_WS_KR_HOLD_*, OVERSEAS_WS_ENABLED, LS_TOKEN_*'

, MODIFY COLUMN `env_value`
    TEXT NOT NULL
    COMMENT '설정값 문자열. bool/int도 텍스트저장'

, MODIFY COLUMN `updated_at`
    VARCHAR(30) NOT NULL
    COMMENT '마지막갱신시각'
;

ALTER TABLE `config_us_momentum`
  COMMENT='해외모멘텀 US_MOMENTUM_* · STRATEGY_US_MOMENTUM_ENABLED. 시세=한투HDFSCNT0 · 유니버스=permanent US'
;
