Files
trex-core/docs/batches/bat-029_20260610_asset-keyed-intent-and-divergence/index.md
T
genichinandClaude Opus 4.8 e10ac519c7 docs(batch): draft-batch BAT-029 (dcy-020 BAT-γ) + FR-7 재정의(계약 키=slot_id)
사용자 결정으로 intent 계약 키를 portfolio_id → slot_id 재정의(코어 native·스냅샷
slots[] round-trip·portfolio-hub 식별 누수 방지). 매도는 이미 slot_id; 매수만 이동
(레거시 portfolio_id dual-accept, 폐기 BAT-δ).

- REQ-061 change-req(CHG-20260610-03): 계약 키 slot_id 로 body/AC 재작성
- dcy-020 FR-7 재정의 주석(2026-06-10)
- draft-batch BAT-029(REQ-061/062/063) + design 확정
  (D1=slot_id 계약, D2=reconcile 3자 확장+A=error/B·C=warning)
- batches/index BAT-029 등록

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-10 12:07:10 +09:00

2.2 KiB
Raw Blame History

BAT-029: intent 자산 키 + 수량/불일치 해소 + 운영자 단일 뷰 (dcy-020 BAT-γ)

  • Status: planning
  • Profile: standard
  • Source Discovery: dcy-020
  • Included REQ: REQ-061 (intent 자산 키 통일), REQ-062 (수량 hub 정본+미러·불일치 해소), REQ-063 (운영자 slots 단일 뷰)

Summary

  • dcy-020 의 3번째 구현 배치(BAT-γ). 매수/매도 intent 를 자산(portfolio_id) 키로 통일하고, 수량 정본을 hub+미러로·청산 수량을 브로커 정본으로 두며 코어 holding↔broker/hub 비정상 불일치를 표면화한다. 운영자 slots 를 자산 포지션 단일 뷰로.
  • 외부 계약 영향(NFR-4): sell 이 현재 slot_id 필수 → 자산 키(portfolio_id)로 전환. 라이브 전략 모듈을 깨지 않기 위해 dual-accept(slot_id 레거시 + portfolio_id 신규)로 도입하고, slot_id 완전 폐기는 BAT-δ.

Scope

  • In Scope:
    • REQ-061: sell intent 에 portfolio_id 수용(자산 중심 모드) + already_active/not_holding 규칙. slot_id 는 레거시 dual-accept(폐기 BAT-δ).
    • REQ-062: reconcile_positions 확장 — 코어 슬롯 holding ↔ broker/hub 3자 비교, 불일치 A/B/C/D 표면화(warning/error). 청산 수량 = 브로커 잔고 정본.
    • REQ-063: snapshot envelope slots[] 에 universe_detached/retired·symbol, trex-core slots 자산 포지션 단일 뷰.
    • runtime-flows.md 부분 갱신.
  • Out of Scope:
    • sell slot_id 완전 폐기·literal inactive 전면화·컬럼 drop·자산 중심 default → BAT-δ
    • 라이브 cutover (REQ-064 → BAT-δ)
    • 자동 청산/자동 편입(불일치 해소는 표면화·운영자 게이트만, issue #15)

Documents

Notes

  • Source discovery 단일(dcy-020). BAT-027/028 후속, BAT-δ 선행.
  • 핵심 리스크: REQ-061 은 외부 전략 모듈 계약 변경(NFR-4) → dual-accept 로 무중단 도입. REQ-062 불일치 해소는 자동 청산 금지(issue #15). design 체크포인트에서 계약 호환·divergence 범위 확정 후 구현.