trex-core/docs/batches/bat-063_20260729_kis-daily-fill-all/design.md

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
• 주문 상태 해석과 도메인·애플리케이션 경계에는 영향 없음