Files
trex-core/docs/batches/bat-027_20260610_asset-permanent-slot-foundation/index.md
T
genichinandClaude Sonnet 4.6 1f59322f52 docs(rel-006/bat-026~036): confirm-release 상태 반영 — released 전환
REL-006 confirm-release 스킬 실행 결과 BAT-026~036 상태를 released로 갱신하고
rel-006 배포 근거를 보완한 변경 사항을 커밋.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-12 22:45:45 +09:00

2.5 KiB
Raw Blame History

BAT-027: 자산 영구 슬롯 토대 — 스키마 + 상태머신 재정의 (dcy-020 BAT-α)

  • Status: released
  • Profile: standard
  • Source Discovery: dcy-020
  • Included REQ: REQ-056 (영구 슬롯 스키마+마이그레이션), REQ-057 (상태머신 재정의 + 인스턴스 스코프 advisory lock)

Summary

  • dcy-020(자산 중심 영구 슬롯 모델)의 첫 구현 배치(BAT-α). 익명 풀 슬롯 도메인을 자산 1:1 영구 슬롯의 데이터 모델 + 상태머신 토대로 재작성한다. 외부 전략 계약 변경(BAT-γ)·라이브 cutover(BAT-δ)는 포함하지 않는다.
  • 핵심: Slot 모델/EXPECTED_SLOT_FIELDS 재정의(portfolio_id 영구키·instance_key·retired_at, entry_count/슬롯 trading_date 제거), 멱등 마이그레이션 009(UNIQUE(instance_key, portfolio_id)), 상태머신 inactive↔pending_buy↔holding↔pending_sell(+error) 으로 재정의(closed→idle 복구 제거), advisory lock 인스턴스 스코프화.

Scope

  • In Scope:
    • Slot 모델·EXPECTED_SLOT_FIELDS 영구 슬롯 재정의 (REQ-056)
    • 마이그레이션 009 (instance_key·retired_at·UNIQUE 복합, entry_count/trading_date 제거) + persistence flat 매핑 (REQ-056)
    • 상태머신 재정의(inactive 합침·closed→idle 제거) + holding 로컬 정본 + 인스턴스 스코프 advisory lock (REQ-057)
    • data-model.md 슬롯 스키마/상태 부분 갱신 (REQ-065 부분)
    • 상태/계약 단위테스트 재작성
  • Out of Scope:
    • universe reconcile lifecycle (REQ-058 → BAT-β)
    • admission/capacity·intent 계약 (REQ-059/061 → BAT-β/γ)
    • 수량/불일치 해소 (REQ-062 → BAT-γ)
    • 라이브 cutover (REQ-064 → BAT-δ)
    • 운영자 slots 단일 뷰 (REQ-063 → 후속)

Documents

Notes

  • Source discovery 단일(dcy-020). 본 배치는 dcy-020 의 토대 배치로, 후속 BAT-β(reconcile·admission)/BAT-γ(intent·수량)/BAT-δ(cutover)의 선행.
  • 핵심 리스크(R-cascade): Slot 모델·상태머신 변경은 intents.py·safety_sell·snapshot_handlers·execution 등 다수 소비처로 연쇄된다. design.md 에서 cascade 격리 전략(소비처 동시 수정 범위)을 확정한 뒤 구현한다 — design 체크포인트 필수.
  • 라이브 데이터는 본 배치에서 건드리지 않는다(스키마는 신규 마이그레이션으로 정의만; 기존 행 전환은 REQ-064/BAT-δ).