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

BAT-063 Planning

• Status: confirmed
• Batch: BAT-063
• Profile: standard

Included REQ

• REQ-118 CHG-20260729-01 (Approved): KIS 전체 거래소 일별 체결조회

Delivery Plan

1. KIS 공식 거래 ID·거래소 파라미터 계약을 테스트로 고정한다.
2. 일반 주문과 결과불명 주문 조회에 하나의 요청 생성 함수를 적용한다.
3. 기존 체결·취소·거부·결과불명 상태 해석을 변경하지 않는다.
4. 집중검사, 전체 회귀, 가상 주문 수명주기 1~7단계를 순서대로 검증한다.
5. 문서와 검증 증거를 동기화하고 Draft PR로 제출한다.

Dependencies

• Internal: KISBroker.poll_fill, _poll_unknown_submission
• External: KIS inquire-daily-ccld 신형 요청 계약

Design Gate

• Design Required Before Implementation: yes
• Reason: 실전 주문 체결조회 경로이므로 요청 생성 책임과 불변 동작을 먼저 고정한다.

Risks

• 결과불명 주문 조회만 구형 계약에 남을 수 있다.
  • 대응: 일반·결과불명 두 경로의 거래 ID와 ALL을 별도 회귀검사로 고정한다.
• 체결 상태 해석이 바뀔 수 있다.
  • 대응: 요청 생성만 변경하고 응답 파싱 함수와 공개 포트 시그니처를 보존한다.