From 515af7a068d4fa0f4694234ab818f887f24abaa0 Mon Sep 17 00:00:00 2001 From: Justin Ko Date: Sat, 6 Jun 2026 10:34:40 +0900 Subject: [PATCH] =?UTF-8?q?docs(srs):=20REQ-029=20CHG-04=20=E2=80=94=20orb?= =?UTF-8?q?-v1=20snapshot=20consumption=20note?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Record that the first strategy (orb-v1) queries view=buyable without a strategy_key, so missing PortfolioItem strategy fields are harmless for the single-strategy stage. Documentation-only; REQ-029 stays Implemented. Co-Authored-By: Claude Opus 4.7 --- ...tion-slot-overlay-view-and-strategy-key.md | 37 +++++++++++++++++++ docs/srs/index.md | 2 +- 2 files changed, 38 insertions(+), 1 deletion(-) diff --git a/docs/srs/Interface/req-029_asset-selection-slot-overlay-view-and-strategy-key.md b/docs/srs/Interface/req-029_asset-selection-slot-overlay-view-and-strategy-key.md index f2a29d3..15fb9c5 100644 --- a/docs/srs/Interface/req-029_asset-selection-slot-overlay-view-and-strategy-key.md +++ b/docs/srs/Interface/req-029_asset-selection-slot-overlay-view-and-strategy-key.md @@ -30,6 +30,7 @@ - core 권위 슬롯 상태(불변식 A)가 portfolio-hub 보유 여부보다 우선한다. - OQ-4(in-flight 합성)·OQ-9(strategy_key)·OQ-11/OQ-12(view 모드) 반영. - holding 자산의 보유 수량 표기를 core 슬롯 vs 스냅샷 중 무엇 기준으로 할지(holding→ledger flush 갭)는 설계 시 확정(dcy-005 OQ-4 잔여). +- (orb-v1 소비 참고, CHG-04) 첫 전략 orb-v1 은 `strategy_key` 없이 `view=buyable` 로 조회한다. 즉 전략 설정과 무관하게 universe 전체를 대상으로 하고, slot 점유(holding·pending)·warning(정합 불일치)·pause(사용자) 만 제외하면 된다 — 이는 `view=buyable` + `strategy_key` 생략의 기존 동작과 정확히 일치한다. pending(in-flight) 제외는 중복 주문 방지, warning 제외는 틀린 baseline 매매 차단(REQ-031) 목적으로 orb-v1 의도에 부합한다(사용자 확인). 따라서 단일 전략 단계에서는 `/v1/portfolios` PortfolioItem 의 전략 필드(active_strategy_id/strategy_params) 부재가 orb-v1 동작에 무해하다. (2번째 전략부터는 strategy_key 라우팅이 필요해져 전략 필드 부재 해소가 재대두된다.) ## Change Log @@ -136,3 +137,39 @@ - AC-3: ::test_view_held_returns_only_holding_slot_assets. - AC-4: ::test_strategy_key_orthogonal_filter + ::test_strategy_key_missing_includes_everything_unmasked. - AC-5: ::test_warning_overlay_masks_asset_uniformly_across_views + ::test_pause_overlay_masks_asset. + +### CHG-20260606-04 +- Date: 2026-06-06 +- Author: Justin Ko + +#### Change Summary +- 첫 전략 orb-v1 의 스냅샷 소비 패턴을 Notes 참고 사항으로 추가(본문 비변경). AC/요구사항/계약 변경 없음. + +#### Intent +- orb-v1 은 전략 설정(active_strategy_id/strategy_params)과 무관하게 모든 자산을 대상으로 하며 `strategy_key` 없이 `view=buyable` 로 조회한다는 소비 계약을 명시해, `/v1/portfolios` PortfolioItem 의 전략 필드 부재가 orb-v1 에 무해함을 기록한다. + +#### Acceptance Criteria Delta +- Added: none +- Updated: none +- Removed: none + +#### Impacted Area Delta +- Docs: + - 본 REQ Notes 에 orb-v1 소비 참고 사항 1건 추가 +- Modules: 없음 +- Tests: 없음 + +#### Delivery Trace Delta +- Batches: + - BAT-008 (release-candidate) — 영향 없음(기존 구현/검증 그대로 유효) +- Releases: + - none + +#### Revalidation Impact +- Reverification Needed: no +- Existing Implementation Invalidated: no +- Status Recommendation: keep-current (Implemented 유지) +- Follow-up Action: orb-v1 Discovery 착수 시 본 참고 사항을 입력으로 사용. 2번째 전략 도입 시 strategy_key/strategy_params 필요 → PortfolioItem 전략 필드 부재 해소(detail strategy_set 보강 또는 별도 change-req) 재검토. + +#### Validation Plan +- 문서 전용 변경. 기존 AC-1~5 테스트 그대로 유효하며 재실행 불필요. diff --git a/docs/srs/index.md b/docs/srs/index.md index b21fbef..930fe66 100644 --- a/docs/srs/index.md +++ b/docs/srs/index.md @@ -117,8 +117,8 @@ ## Recent Change Log Summary +- 2026-06-06 :: REQ-029 CHG-04 — orb-v1 소비 참고 사항 추가(strategy_key 없이 view=buyable, 전략 필드 부재 무해). 문서 전용·Implemented 유지. (change-req) - 2026-06-06 :: REQ-027~029, REQ-031~033 Approved → Implemented — BAT-008 release-candidate verification evidence 기반. REQ-030 은 AC-1 evidence 확보·AC-2/AC-3 portfolio-hub#8 배포 대기로 Approved 유지. (confirm-req-implemented) - 2026-06-06 :: REQ-027~033 Proposed → Approved — dcy-005 confirmed, 전체 승인 게이트 통과. REQ-030 옵션 D 구현은 portfolio-hub#8 배포 후 착수. (confirm-req) - 2026-06-06 :: REQ-027~033 최초 생성(Proposed) — dcy-005 FR-1~FR-9 분해(NFR-1 → REQ-027 흡수, NFR-2 → REQ-030 흡수, NFR-3 → REQ-028 흡수). (draft-req) - 2026-06-05 :: REQ-021~026 Approved → Implemented — BAT-007 release-candidate verification evidence 기반. (confirm-req-implemented) -- 2026-06-05 :: REQ-021~026 Proposed -> Approved — 승인 게이트 통과. (confirm-req)