# BAT-063 Design

- Status: confirmed
- Batch: BAT-063

## Architecture Summary

- KIS 일별 체결조회 거래 ID와 공통 파라미터는 `KISBroker`의 private helper가
  한 번만 생성한다.
- 실전은 `TTTC0081R`, 모의는 `VTTC0081R`을 사용한다.
- 일반 주문번호 조회와 결과불명 주문 탐색 모두
  `EXCG_ID_DVSN_CD=ALL`을 전달한다.
- 체결·부분체결·취소·거부·결과불명 해석과 폴링 간격은 그대로 유지한다.

## Changed Areas

- Module: `trex_core/adapters/broker/kis.py`
- Tests: `tests/adapters/broker/test_kis.py`,
  `tests/adapters/broker/test_venue.py`
- Docs: `docs/interface-contract.md`, `docs/runtime-flows.md`

## Key Decisions

1. sidecar가 거래 ID를 바꾸지 않아도 Core 단독으로 KRX·NXT 체결을 조회한다.
2. 거래소별 분기 대신 `ALL` 하나로 주문번호와 결과불명 후보를 찾는다.
3. 공개 `BrokerPort.poll_fill` 시그니처는 변경하지 않는다.
4. 구형 거래 ID fallback을 두지 않는다. 공식 명세가 구형 거래 ID 중단 가능성을
   명시하기 때문이다.

## Architecture Impact

- KIS broker transport
- 주문 상태 해석과 도메인·애플리케이션 경계에는 영향 없음