Skip to content

Latest commit

 

History

History
193 lines (148 loc) · 6.38 KB

File metadata and controls

193 lines (148 loc) · 6.38 KB

ECOS 통계 구현 현황

마지막 업데이트: 2025-12-31 라이브러리 버전: 0.1.5

전체 현황

항목 개수 비율
ECOS 전체 통계표 664개 100%
구현 완료 43개 6.5%
미구현 621개 93.5%

카테고리별 구현 현황

카테고리 전체 통계 구현 완료 미구현 구현률
1. 통화/금융 139개 23개 116개 16.5%
2. 국민계정 155개 10개 145개 6.5%
3. 국제수지/외채/환율 24개 0개 24개 0%
4. 물가 27개 4개 23개 14.8%
5. 경기/기업경영 90개 0개 90개 0%
6. 금융시장 - 5개 - -
7. 재정 - 1개 - -
8. 주택 - 0개 - 0%
9. 생산/건설/소비/무역/고용 22개 0개 22개 0%

구현 완료 통계 목록

1. 통화/금융 (7개)

통계코드 통계명 주기 구현 함수
161Y004 M1 상품별 구성내역(말잔, 원계열) get_money_supply(indicator="M1")
161Y008 M2 상품별 구성내역(말잔, 원계열) get_money_supply(indicator="M2")
171Y002 Lf 상품별 구성내역(말잔, 원계열) get_money_supply(indicator="Lf")
104Y016 예금은행 대출금(말잔) get_bank_lending(sector="all")
151Y002 예금취급기관 가계대출(업권별, 월) get_bank_lending(sector="household")
722Y001 한국은행 기준금리 및 여수신금리 get_base_rate()
817Y002 시장금리(일별) get_treasury_yield()

2. 국민계정 (3개)

통계코드 통계명 주기 구현 함수
200Y109 국내총생산에 대한 지출(원계열, 명목, 분기 및 연간) 분기 get_gdp(basis="nominal")
200Y110 국내총생산에 대한 지출(원계열, 실질, 분기 및 연간) 분기 get_gdp(basis="real")
200Y112 국내총생산에 대한 지출 디플레이터(분기 및 연간) 분기 get_gdp_deflator()

4. 물가 (3개)

통계코드 통계명 주기 구현 함수
404Y014 생산자물가지수(기본분류) get_ppi()
901Y009 소비자물가지수 get_cpi()
901Y010 소비자물가지수(특수분류) get_core_cpi()

우선순위별 미구현 통계

🔴 우선순위 1 (Phase 3) - 환율 및 국제수지

constants.py에 정의되어 있으나 미구현된 통계:

통계코드 통계명 예상 함수명
731Y003 원화의 대미달러, 원화의 대위안/대엔 환율 get_exchange_rate()
731Y004 주요국 통화의 대원화환율 get_effective_exchange_rate()
301Y017 국제수지 get_current_account(), get_capital_account()

🟡 우선순위 2 (Phase 4) - 실물경제 및 심리지표

constants.py에 정의되어 있으나 미구현된 통계:

통계코드 통계명 예상 함수명
901Y033 산업생산지수 get_industrial_production()
901Y049 설비투자지수 get_facility_investment()
901Y037 소매판매지수 get_retail_sales()
512Y014 기업경기실사지수(BSI) get_bsi()
511Y002 소비자심리지수(CSI) get_csi()

🟢 우선순위 3 - 기타 중요 통계

사용 빈도가 높은 미구현 통계:

금리 관련

통계코드 통계명
721Y001 시장금리(월, 분기, 년)
121Y002 예금은행 수신금리(신규취급액 기준)
121Y006 예금은행 대출금리(신규취급액 기준)

국민계정 관련

통계코드 통계명
200Y138 경제활동별 설비투자(명목, 연간)
200Y140 가계의 목적별 최종소비지출(계절조정, 명목, 분기)
200Y142 가계의 목적별 최종소비지출(원계열, 명목, 분기 및 연간)

물가 관련

통계코드 통계명
404Y015 생산자물가지수(특수분류)
402Y014 수출물가지수(기본분류)
401Y015 수입물가지수(기본분류)

무역 관련

통계코드 통계명
901Y118 수출입 총괄
901Y119 대륙별 수출입
901Y121 국가별 수출입

개발 로드맵

v0.2.x - 환율 및 국제수지 (Phase 3)

  • get_exchange_rate() - 주요 통화 환율
  • get_effective_exchange_rate() - 실효환율
  • get_current_account() - 경상수지
  • get_capital_account() - 자본수지

v0.3.x - 실물경제 및 심리지표 (Phase 4)

  • get_industrial_production() - 산업생산지수
  • get_facility_investment() - 설비투자지수
  • get_retail_sales() - 소매판매지수
  • get_bsi() - 기업경기실사지수
  • get_csi() - 소비자심리지수

v0.4.x - 무역 및 고용 (Phase 5)

  • get_export_import() - 수출입 통계
  • get_trade_by_country() - 국가별 무역
  • get_employment() - 고용 통계

v0.5.x - 기업경영 및 재정 (Phase 6)

  • 기업경영분석 지표
  • 재정 통계

기여 가이드

새로운 지표 추가 방법

  1. 통계코드 확인

    # ECOS에서 원하는 통계 찾기
    client = EcosClient(api_key="your_key")
    tables = client.get_statistic_table_list(start=1, end=100)
  2. constants.py에 추가

    # 통계코드 및 항목코드 정의
    STAT_NEW_INDICATOR = "XXX"
    ITEM_NEW_INDICATOR = "YYY"
  3. indicator 함수 구현

    # src/ecos/indicators/category.py
    def get_new_indicator(start_date=None, end_date=None):
        # 구현
        pass
  4. E2E 테스트 작성

    # tests/test_e2e_indicators.py
    def test_get_new_indicator(self):
        df = ecos.get_new_indicator()
        assert not df.empty
  5. Pull Request 제출

    • 테스트 통과 확인
    • 문서 업데이트
    • PR 제출

참고 자료