Merge pull request #416 from easygap/fix/holidays-substitute-days

fix: 휴장일 fallback 대체공휴일·연말휴장 보강 — 60일 커버리지 분모 보호

Author: easygap

config/holidays.yaml

@@ -7,27 +7,39 @@ holidays:
 - '2026-01-28'
 - '2026-01-29'
 - '2026-03-01'
+- '2026-03-02'
 - '2026-05-05'
 - '2026-05-24'
+- '2026-05-25'
 - '2026-06-06'
 - '2026-08-15'
+- '2026-08-17'
 - '2026-09-24'
 - '2026-09-25'
 - '2026-09-26'
+- '2026-09-28'
 - '2026-10-03'
+- '2026-10-05'
 - '2026-10-09'
 - '2026-12-25'
+- '2026-12-31'
 - '2027-01-01'
 - '2027-02-10'
 - '2027-02-11'
 - '2027-02-12'
 - '2027-03-01'
 - '2027-05-05'
+- '2027-05-13'
 - '2027-06-06'
 - '2027-08-15'
+- '2027-08-16'
 - '2027-10-03'
 - '2027-10-04'
 - '2027-10-05'
 - '2027-10-06'
+- '2027-10-07'
 - '2027-10-09'
+- '2027-10-11'
 - '2027-12-25'
+- '2027-12-27'
+- '2027-12-31'

core/holidays_updater.py

@@ -15,24 +15,44 @@
 # 프로젝트 루트
 _PROJECT_ROOT = Path(__file__).resolve().parent.parent
 
-# pykrx 미사용/실패 시 사용할 연도별 휴장일 (고정 공휴일 위주; 설·추석은 연도별 상이)
+# pykrx 미사용/실패 시 사용할 연도별 휴장일.
+# 대체공휴일 규정(설·추석 연휴, 3·1절, 광복절, 개천절, 한글날, 어린이날,
+# 부처님오신날, 성탄절은 주말 겹침 시 다음 평일 대체; 신정·현충일은 미적용)과
+# KRX 연말 휴장(마지막 거래일 12/31)을 포함한다 — 누락되면 휴장일이 거래일로
+# 계산돼 트랙레코드 커버리지 분모가 부풀고 스냅샷 귀속(가격 기준일)이 어긋난다.
 FALLBACK_BY_YEAR = {
     2025: {
-        "2025-01-01", "2025-01-28", "2025-01-29", "2025-01-30",
-        "2025-03-01", "2025-05-05", "2025-05-06", "2025-06-06",
-        "2025-08-15", "2025-10-03", "2025-10-09", "2025-12-25",
+        "2025-01-01", "2025-01-27", "2025-01-28", "2025-01-29", "2025-01-30",  # 1/27 임시공휴일
+        "2025-03-01", "2025-03-03",  # 3·1절(토) 대체
+        "2025-05-05", "2025-05-06", "2025-06-06",
+        "2025-08-15", "2025-10-03",
+        "2025-10-06", "2025-10-07", "2025-10-08",  # 추석 연휴(일~화) + 대체
+        "2025-10-09", "2025-12-25", "2025-12-31",
     },
     2026: {
         "2026-01-01", "2026-01-27", "2026-01-28", "2026-01-29",
-        "2026-03-01", "2026-05-05", "2026-05-24", "2026-06-06",
-        "2026-08-15", "2026-09-24", "2026-09-25", "2026-09-26",
-        "2026-10-03", "2026-10-09", "2026-12-25",
+        "2026-03-01", "2026-03-02",  # 3·1절(일) 대체
+        "2026-05-05",
+        "2026-05-24", "2026-05-25",  # 부처님오신날(일) 대체
+        "2026-06-06",                 # 현충일(토) — 대체 미적용
+        "2026-08-15", "2026-08-17",  # 광복절(토) 대체
+        "2026-09-24", "2026-09-25", "2026-09-26",
+        "2026-09-28",                 # 추석 연휴 토요일 겹침 대체
+        "2026-10-03", "2026-10-05",  # 개천절(토) 대체
+        "2026-10-09", "2026-12-25",
+        "2026-12-31",                 # KRX 연말 휴장
     },
     2027: {
         "2027-01-01", "2027-02-10", "2027-02-11", "2027-02-12",
-        "2027-03-01", "2027-05-05", "2027-06-06", "2027-08-15",
-        "2027-10-03", "2027-10-04", "2027-10-05", "2027-10-06", "2027-10-09",
-        "2027-12-25",
+        "2027-03-01", "2027-05-05",
+        "2027-05-13",                 # 부처님오신날(목)
+        "2027-06-06",                 # 현충일(일) — 대체 미적용
+        "2027-08-15", "2027-08-16",  # 광복절(일) 대체
+        "2027-10-03", "2027-10-04", "2027-10-05", "2027-10-06",
+        "2027-10-07",                 # 개천절(일) 대체(추석 연휴 직후 평일)
+        "2027-10-09", "2027-10-11",  # 한글날(토) 대체
+        "2027-12-25", "2027-12-27",  # 성탄절(토) 대체
+        "2027-12-31",                 # KRX 연말 휴장
     },
 }
 

core/trading_hours.py

@@ -16,13 +16,13 @@
 # 프로젝트 루트 (config 상위)
 _PROJECT_ROOT = Path(__file__).resolve().parent.parent
 
-# 한국 증시 공휴일 — 최종 fallback (네트워크/파일 불가 시)
-KR_HOLIDAYS_FALLBACK = {
-    "2026-01-01", "2026-01-27", "2026-01-28", "2026-01-29",
-    "2026-03-01", "2026-05-05", "2026-05-24", "2026-06-06",
-    "2026-08-15", "2026-09-24", "2026-09-25", "2026-09-26",
-    "2026-10-03", "2026-10-09", "2026-12-25",
-}
+# 한국 증시 공휴일 — 최종 fallback (네트워크/파일 불가 시).
+# 단일 소스: core/holidays_updater.FALLBACK_BY_YEAR (대체공휴일·연말휴장 포함).
+# 별도 하드코딩을 두면 누락이 한쪽만 고쳐지는 드리프트가 생긴다 — 휴장일 누락은
+# 트랙레코드 커버리지 분모 부풀림·스냅샷 귀속 오차로 직결된다.
+from core.holidays_updater import FALLBACK_BY_YEAR as _FALLBACK_BY_YEAR
+
+KR_HOLIDAYS_FALLBACK = set().union(*_FALLBACK_BY_YEAR.values())
 
 
 def _load_holidays() -> set:

tests/test_target_weight_paper_adapter.py

@@ -8436,12 +8436,13 @@ def test_recommend_pilot_caps_matches_target_weight_plan(monkeypatch):
     assert suggested["max_gross_exposure"] == 3_360_000
     assert rec["suggested_preview"]["allowed"] is True
     assert rec["valid_from"] == "2026-04-10"
-    assert rec["valid_to"] == "2026-07-03"
+    # 2026-05-25(부처님오신날 대체휴일) 반영으로 60영업일 만기가 1영업일 밀림
+    assert rec["valid_to"] == "2026-07-06"
     assert rec["target_pilot_days"] == 60
     assert "YYYY-MM-DD" not in rec["enable_command"]
     assert "\n" not in rec["enable_command"]
     assert "\\" not in rec["enable_command"]
-    assert "--from 2026-04-10 --to 2026-07-03" in rec["enable_command"]
+    assert "--from 2026-04-10 --to 2026-07-06" in rec["enable_command"]
     assert "--max-orders 3 --max-positions 3" in rec["enable_command"]
     assert "--max-notional 1260000 --max-exposure 3360000" in rec["enable_command"]
 

tests/test_trading_hours.py

@@ -33,3 +33,31 @@ def test_market_open_time(th):
     dt = datetime(2026, 1, 5, 10, 0, 0)  # 월 10:00
     if th.is_trading_day(dt):
         assert th.is_market_open(dt) is True
+
+
+def test_2026_substitute_holidays_are_non_trading_days():
+    """대체공휴일·연말휴장 누락 회귀 — 누락되면 휴장일이 거래일로 계산돼
+    트랙레코드 커버리지 분모가 부풀고 스냅샷 귀속(가격 기준일)이 어긋난다.
+
+    2026: 3·1절(일)→3/2, 부처님오신날(일)→5/25, 광복절(토)→8/17,
+    추석 토요일 겹침→9/28, 개천절(토)→10/5, KRX 연말 휴장 12/31.
+    (현충일 6/6(토)은 대체 미적용 — 6/8은 거래일이어야 함)
+    """
+    from datetime import datetime
+    from core.trading_hours import TradingHours
+
+    th = TradingHours()
+    for d in ("2026-03-02", "2026-05-25", "2026-08-17",
+              "2026-09-28", "2026-10-05", "2026-12-31"):
+        y, m, dd = map(int, d.split("-"))
+        assert th.is_trading_day(datetime(y, m, dd)) is False, f"{d}는 휴장일이어야 함"
+    # 현충일은 대체공휴일 미적용 — 다음 월요일은 정상 거래일
+    assert th.is_trading_day(datetime(2026, 6, 8)) is True
+
+
+def test_fallback_sets_are_single_source():
+    """trading_hours의 최종 fallback이 holidays_updater와 단일 소스인지(드리프트 방지)."""
+    from core.holidays_updater import FALLBACK_BY_YEAR
+    from core.trading_hours import KR_HOLIDAYS_FALLBACK
+
+    assert KR_HOLIDAYS_FALLBACK == set().union(*FALLBACK_BY_YEAR.values())