# ============================================
# Lifetime PD Model Configuration
# ============================================

# BOK ECOS API
ecos:
  api_key: "C5220CGY8FYFDN43B7ON"
  base_url: "https://ecos.bok.or.kr/api"
  # 주요 통계코드 (검증 완료 2026-03-10)
  stat_codes:
    gdp_growth: "902Y015"       # 국제 주요국 경제성장률 / ITEM: KOR
    unemployment: "901Y027"     # 경제활동인구 / ITEM: I61BC (실업률)
    base_rate: "722Y001"        # 한국은행 기준금리 / ITEM: 0101000
    cd_rate: "721Y001"          # 시장금리 / ITEM: 2010000 (CD 91일)
    cpi: "901Y009"              # 소비자물가지수 / ITEM: 0 (총지수, level→YoY% 변환)
    composite_leading: "901Y067" # 경기종합지수 / ITEM: I16A (선행, 월별→연평균)

# 전이행렬 데이터 소스
data:
  transition_source: "real"   # "real" (3사 실제) | "builtin" (내장 샘플)
  transition_dir: null        # null이면 기본 data/real_v2/

# 모형 파라미터
model:
  # 자산상관계수 (Basel IRB 기준 0.12~0.24, 기업 평균 ~0.20)
  rho: 0.20
  # 신용등급 체계 (한국 3사 공통)
  rating_grades: ["AAA", "AA", "A", "BBB", "BB", "B", "D"]  # 7x7 (CCC제외, Zt추정용)
  # 거시 회귀모형 설정
  macro_method: "ar1_macro"    # "ar1_macro" | "stepwise_aic"
  macro_vars: ["HOUSING_PRICE", "CREDIT_SPREAD_LAG1", "CURRENT_ACCOUNT_R"]

# 시나리오 설정
scenarios:
  upside:
    name: "호황 (Upside)"
    z_multiplier: 1.0      # Z-직접 fallback용
    weight: 0.20
    macro_shocks:           # AR(1) 충격 (σ 배수)
      HOUSING_PRICE: 1.0        # 주택가격 1σ 상승 (호재)
      CREDIT_SPREAD_LAG1: -1.0  # 신용스프레드 1σ 하락 (호재)
      CURRENT_ACCOUNT_R: 1.0    # 경상수지변화율 1σ 상승
  base:
    name: "중립 (Base)"
    z_multiplier: 0.0
    weight: 0.50
    macro_shocks:
      HOUSING_PRICE: 0.0
      CREDIT_SPREAD_LAG1: 0.0
      CURRENT_ACCOUNT_R: 0.0
  downside:
    name: "불황 (Downside)"
    z_multiplier: -1.5
    weight: 0.30
    macro_shocks:
      HOUSING_PRICE: -1.5        # 주택가격 1.5σ 하락 (악재)
      CREDIT_SPREAD_LAG1: 1.5    # 신용스프레드 1.5σ 상승 (악재)
      CURRENT_ACCOUNT_R: -1.5    # 경상수지변화율 1.5σ 하락

# 50년 수렴 메커니즘
convergence:
  pit_horizon: 5            # PIT 적용 기간 (년)
  transition_horizon: 10    # TTC로의 전환 완료 기간 (년)
  mean_reversion_lambda: 0.3  # Mean-reversion 속도
  total_horizon: 50         # 총 예측 기간 (년)

# 출력 설정
output:
  save_dir: "results"
  figure_dpi: 150
  figure_format: "png"
