version: 1
generated_for: value-chain-dashboard
default_output_root: outputs/data_lake

sources:
  yahoo_chart_prices:
    status: public_no_key
    provider: Yahoo Finance chart endpoint
    base_url: https://query1.finance.yahoo.com/v8/finance/chart/{symbol}
    taxonomy:
      - 3.7 시장 미시구조와 거래 제도
      - 5.1 상대가치
    fields:
      - symbol
      - currency
      - exchangeName
      - regularMarketTime
      - timestamp
      - open
      - high
      - low
      - close
      - volume
    collection_notes: Availability check and lightweight OHLCV sample only; not an official exchange feed.

  fred_graph_csv_macro:
    status: public_no_key
    provider: FRED graph CSV
    base_url: https://fred.stlouisfed.org/graph/fredgraph.csv?id={series_id}
    taxonomy:
      - 2.1 거시경제 요인
      - 2.2 금리와 통화정책
      - 2.3 물가와 인플레이션
    fields:
      - observation_date
      - series_value
    default_series:
      - DGS10
      - DGS2
      - FEDFUNDS
      - CPIAUCSL
      - PCEPI
      - UNRATE
      - INDPRO
    collection_notes: No-key CSV where available; use FRED API key only for richer metadata.

  treasury_daily_yield_curve:
    status: public_no_key
    provider: U.S. Treasury XML daily yield curve
    base_url: https://home.treasury.gov/resource-center/data-chart-center/interest-rates/pages/xml?data=daily_treasury_yield_curve&field_tdr_date_value={year}
    taxonomy:
      - 2.2 금리와 통화정책
    fields:
      - date
      - month_1
      - month_2
      - month_3
      - month_4
      - month_6
      - year_1
      - year_2
      - year_3
      - year_5
      - year_7
      - year_10
      - year_20
      - year_30
    collection_notes: Official fallback when FRED graph CSV treasury-rate endpoints time out or need cross-checking.

  yahoo_fx_commodity_proxies:
    status: public_no_key
    provider: Yahoo Finance chart endpoint
    base_url: https://query1.finance.yahoo.com/v8/finance/chart/{symbol}
    taxonomy:
      - 2.4 환율 요인
      - 2.5 원자재와 에너지
      - 5.4 대체자산
    fields:
      - symbol
      - timestamp
      - close
      - volume
    default_symbols:
      - KRW=X
      - EURUSD=X
      - JPY=X
      - CL=F
      - GC=F
      - HG=F
      - ^GSPC
      - ^KS11
    collection_notes: Proxies for dashboard context; validate against official data before investment use.

  sec_company_tickers:
    status: public_no_key
    provider: SEC EDGAR
    base_url: https://www.sec.gov/files/company_tickers.json
    taxonomy:
      - 1.13 회계, 감사, 공시 신뢰
    fields:
      - cik_str
      - ticker
      - title
    collection_notes: Mapping step for US tickers before submissions and companyfacts collection.

  sec_submissions_companyfacts:
    status: public_no_key
    provider: SEC EDGAR
    base_urls:
      submissions: https://data.sec.gov/submissions/CIK{cik10}.json
      companyfacts: https://data.sec.gov/api/xbrl/companyfacts/CIK{cik10}.json
    taxonomy:
      - 1.1 매출 요인
      - 1.2 원가와 마진 요인
      - 1.4 이익 요인
      - 1.5 현금흐름 요인
      - 1.6 재무상태 요인
      - 1.12 주주환원과 희석
      - 1.14 기업 이벤트
    fields:
      - cik
      - form
      - accessionNumber
      - filingDate
      - reportDate
      - facts
    collection_notes: Requires a truthful User-Agent. Set SEC_USER_AGENT for production contact info.

  opendart_filings_financials:
    status: requires_key
    provider: OpenDART
    required_env: OPENDART_API_KEY
    base_url: https://opendart.fss.or.kr/api/
    taxonomy:
      - 1.1 매출 요인
      - 1.4 이익 요인
      - 1.6 재무상태 요인
      - 1.13 회계, 감사, 공시 신뢰
      - 1.14 기업 이벤트
    fields:
      - corp_code
      - rcept_no
      - report_nm
      - fs_div
      - account_nm
      - thstrm_amount
    collection_notes: Mark needs_key when OPENDART_API_KEY is absent. Never print the key.

  gdelt_google_news_plans:
    status: public_no_key
    provider: GDELT Doc API and Google News RSS
    base_urls:
      gdelt_doc: https://api.gdeltproject.org/api/v2/doc/doc
      google_news_rss: https://news.google.com/rss/search
    taxonomy:
      - 4.2 정보 흐름
      - 4.4 테마와 스토리
    fields:
      - query
      - planned_url
      - companyName
      - ticker
      - countryCode
    collection_notes: Plan URLs and sample metadata only. Do not aggressively scrape publisher article bodies.

  krx_pykrx_investor_flows:
    status: public_candidate
    provider: KRX / pykrx
    taxonomy:
      - 3.1 투자자별 수급
      - 3.3 공매도와 대차
      - 3.4 신용과 레버리지
    fields:
      - date
      - ticker
      - investor_class
      - net_buy_amount
      - short_volume
    collection_notes: Candidate for later implementation; complete point-in-time quality may require paid feeds.

  analyst_revisions:
    status: paid_limited
    provider: FactSet / LSEG / Bloomberg / S&P Capital IQ / Visible Alpha
    taxonomy:
      - 4.1 시장 기대
      - 5.1 상대가치
    fields:
      - estimate_date
      - analyst
      - fiscal_period
      - eps_estimate
      - revenue_estimate
      - target_price
      - recommendation
    collection_notes: Paid or redistribution-limited. Public collection scaffold only records the gap.