trex-core/docs/batches/bat-062_20260729_shared-account-capital-allocation/planning.md

BAT-062 Planning

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

Included REQ

• REQ-127 (Approved): 공통 계좌 자본배분 순수 정책

Delivery Plan

1. 기존 로컬 어댑터 공식과 Core 책임 경계를 고정한다.
2. Core에 데이터 모델·보호가격·배분 계획·호환 결과 함수를 구현한다.
3. 로컬 KIS 어댑터는 현금·호가 입력과 Core 결과 매핑만 남긴다.
4. 단위·속성·완전 일치·전체 회귀·월간 가상거래를 순서대로 검증한다.
5. 문서와 검증 증거를 동기화한 뒤 Draft PR로 제출한다.

Dependencies

• Internal:
  • Python 표준 dataclasses, decimal
  • 기존 dcy-021/REQ-061 주문수량 계약
• External:
  • 검증 시 로컬 KIS 어댑터와 탑50 가상거래 도구
  • 실전 브로커·Portfolio Hub 연결은 필요하지 않음

Design Gate

• Design Required Before Implementation: yes
• Reason: 새 공개 도메인 모듈과 프로젝트 구조 기준선이 추가되며 Core·어댑터·전략·원장 책임 경계를 구현 전에 고정해야 한다.

Milestones

1. 순수 정책과 Core 단위·속성 테스트
2. 어댑터 얇은 연결부와 기존 공식 완전 일치
3. 전체 회귀와 메가·탑50 가상 검증
4. 문서·품질 게이트와 Draft PR

Risks

• 기존 공식과 반올림 또는 동률 제외 순서가 달라질 수 있다.
  • 대응: 고정 시드 50,000건 결과 완전 일치.
• Core가 외부 현금·호가 조회 책임까지 흡수할 수 있다.
  • 대응: 새 모듈의 외부 의존을 금지하고 어댑터 연결부를 별도 검토.
• 실제 현금보다 큰 동시 슬롯 배정이 생길 수 있다.
  • 대응: 최악 활성 슬롯 합 불변식을 구현 내부와 10,000건 속성 테스트에서 이중 검증.