Files
trex-core/docs/srs/Interface/req-063_unified-operator-slot-view.md
T
genichinandClaude Opus 4.8 f7d309be71 docs(req): dcy-020 confirm-req(REQ-056~065 Approved) + 기존 REQ supersession change-req
- confirm-req: REQ-056~065 Proposed→Approved (CHG-20260610-02 각). srs/index Register Approved.
- change-req(forward-looking): REQ-002/003/005/006/007 에 dcy-020 재정의/폐기 예정 기록
  (CHG-20260610-01). 현재 코드 불변이라 status Implemented 유지(keep-current);
  실제 폐기/재정의·status 전환은 dcy-020 delivery 배치에서 확정.
  - REQ-002 상태머신/도메인 → REQ-056/057/062
  - REQ-003 테스트 계약 → REQ-056/057
  - REQ-005 일일 preallocation 폐기 → REQ-058(reconcile)/REQ-060(M)
  - REQ-006 persistence 스키마 → REQ-056/062/064
  - REQ-007 admission/intent → REQ-059/061

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

3.5 KiB

req-063: 운영자 표면 단일화 — slots = 자산 포지션 단일 뷰

  • Status: Approved
  • Type: Interface
  • Priority: Medium
  • Owner: project maintainers

Intent

  • universe(자산 리스트)와 slots(슬롯 상태)의 이중 표면(BAT-022 혼동 원인)을 해소하기 위해, 슬롯=자산 1:1 모델에서 trex-core slots 가 자산 포지션을 단일 뷰로 제공한다. (dcy-020 FR-8)

Requirement

  • trex-core slots 가 자산 슬롯(슬롯=자산)을 단일 뷰로 표시한다: portfolio_id/symbol/status(inactive/pending_buy/holding/pending_sell/error)/holding 수량 미러/universe_detached(tombstone)/retired. universe(자산 리스트)와 slots(자산 포지션)는 같은 자산 집합 위의 view 가 되며, 데몬 RPC(스냅샷)로 통일한다(직접 DB 쓰기 없음). 운영자는 자산별 포지션·활성 여부·tombstone 여부를 한 표면에서 본다.

Acceptance Criteria

  1. Given universe N개 자산, When trex-core slots, Then N개 자산 슬롯이 status·holding·tombstone 표시와 함께 단일 뷰로 출력된다.
  2. Given tombstone(universe-detached holding) 슬롯, When slots, Then universe_detached 로 구분 표시된다.
  3. Given --status 필터, When 조회, Then 자산 슬롯 status 로 필터된다.

Impacted Area

  • Docs: docs/runtime-flows.md, docs/interface-contract.md(snapshot envelope slots[])
  • Modules: trex_core/runtime/cli.py, snapshot envelope 빌더
  • Tests: tests/application/test_messaging_snapshot_consumer.py, CLI 테스트

Notes

  • 기존 REQ-032(운영자 CLI)·REQ-028/029(snapshot envelope) 와 연계 change-req. BAT-022 슬롯 가시화의 자산 중심 재정의.
  • 출처: dcy-020 FR-8.

Change Log

CHG-20260610-01

  • Date: 2026-06-10
  • Author: Justin Ko

Change Summary

  • dcy-020 FR-8 로부터 최초 생성(Proposed). trex-core slots = 자산 포지션 단일 뷰(universe↔slots 이중 표면 해소).

Intent

  • 운영 관측 단일화(자산별 포지션·활성·tombstone)를 backlog 정규화.

Acceptance Criteria Delta

  • Added: 단일 뷰 출력/tombstone 표시/status 필터 3개 기준
  • Updated: 없음
  • Removed: 없음

Impacted Area Delta

  • Docs: docs/runtime-flows.md, docs/interface-contract.md
  • Modules: runtime/cli.py, snapshot envelope 빌더
  • Tests: test_messaging_snapshot_consumer.py, CLI 테스트

Delivery Trace Delta

  • Batches: none
  • Releases: none

Revalidation Impact

  • Reverification Needed: no
  • Existing Implementation Invalidated: no (REQ-032/028/029 연계 change-req)
  • Status Recommendation: keep-current
  • Follow-up Action: confirm-req.

Validation Plan

  • slots 단일 뷰 출력·tombstone·필터 단위테스트 green.

CHG-20260610-02

  • Date: 2026-06-10
  • Author: Justin Ko

Change Summary

  • Status Proposed → Approved (confirm-req). 필수 필드·구체 AC 충족, source dcy-020(confirmed, handoff 승인)과 모순 없음.

Intent

  • delivery input 으로 승격.

Acceptance Criteria Delta

  • Added: 없음 / Updated: 없음 / Removed: 없음

Impacted Area Delta

  • Docs: docs/srs/index.md (Register Approved) / Modules: 없음 / Tests: 없음

Delivery Trace Delta

  • Batches: none / Releases: none

Revalidation Impact

  • Reverification Needed: no / Existing Implementation Invalidated: no / Status Recommendation: keep-current / Follow-up Action: suggest-batch-reqs / draft-batch.

Validation Plan

  • 승인 후 batch planning 에서 본 REQ AC 를 검증 기준으로 사용.