pyqqq.backtest.environment
==========================

트레이딩 시스템의 다양한 실행 환경을 정의하는 모듈입니다. 백테스팅과 실제 거래 환경에서 일관된 인터페이스를 제공하며,
브로커와 시간 관리 컴포넌트를 통합적으로 관리합니다.

주요 기능
---------

* 백테스팅 환경 설정 및 관리
* 실시간 거래 환경 구성
* 국내/해외 주식 거래 지원
* 실제 계좌 및 모의투자 계좌 지원

클래스 구성
-----------

.. toctree::
   :maxdepth: 1
   :hidden:

   trading_environment
   backtest_environment
   kis_domestic_environment
   kis_overseas_environment

TradingEnvironment
^^^^^^^^^^^^^^^^^^^

트레이딩 환경의 기본이 되는 추상 클래스입니다.

**주요 메서드**

* get_broker(): 브로커 인스턴스 반환
* get_clock(): 시계 인스턴스 반환

BacktestEnvironment
^^^^^^^^^^^^^^^^^^^

과거 데이터를 사용한 백테스팅 환경을 제공합니다.

**주요 기능**

* 사용자 정의 기간 설정
* 분단위/일단위 시뮬레이션 지원
* 초기 포지션 설정 기능
* 가상 시계와 브로커 통합 관리

KISDomesticEnvironment
^^^^^^^^^^^^^^^^^^^^^^

한국투자증권 API를 사용한 국내주식 거래 환경입니다.

**주요 기능**

* 실제 계좌 거래 지원
* 모의투자 계좌 지원
* 실시간 시장 데이터 연동
* 환경변수 기반 인증 관리

KISOverseasEnvironment
^^^^^^^^^^^^^^^^^^^^^^^

한국투자증권 API를 사용한 해외주식 거래 환경입니다.

**주요 기능**

* 실제 계좌 해외주식 거래 지원
* 실시간 해외 시장 데이터 연동
* 환경변수 기반 인증 관리

사용 예시
---------

백테스팅 환경
^^^^^^^^^^^^^

.. code-block:: python

    # 백테스팅 환경 설정
    env = BacktestEnvironment(
        start_time=datetime(2023, 1, 1, 9, 0),
        end_time=datetime(2023, 1, 31, 15, 30),
        time_unit="minutes"
    )

    # 전략 실행
    await MyStrategy(env).run()

실시간 거래 환경
^^^^^^^^^^^^^^^^^

.. code-block:: python

    # 국내주식 실거래
    env = KISDomesticEnvironment(paper_trading=False)

    # 국내주식 모의투자
    env = KISDomesticEnvironment(paper_trading=True)

    # 해외주식 거래
    env = KISOverseasEnvironment()

환경변수 설정
-------------

국내주식 거래시 필요한 환경변수:

* KIS_APP_KEY: API 키
* KIS_APP_SECRET: API 시크릿
* KIS_CANO: 계좌번호
* KIS_ACNT_PRDT_CD: 계좌상품코드

모의투자 추가 환경변수:

* PAPER_KIS_APP_KEY: 모의투자 API 키
* PAPER_KIS_APP_SECRET: 모의투자 API 시크릿
* PAPER_KIS_CANO: 모의투자 계좌번호
* PAPER_KIS_ACNT_PRDT_CD: 모의투자 계좌상품코드