Files
trex-core/docs/srs/Documentation/req-075_slots-read-surface-baseline-alignment.md
T
genichinandClaude Opus 4.8 f0ad37747b feat(rel-007): dcy-025/024 + BAT-035/036 — slots.req 즉시 교체 + safety_sell_enabled
BAT-035 (dcy-025): trex.snapshot.req → trex.slots.req 즉시 교체
- topology: SNAPSHOT_REQ_QUEUE 제거, SLOTS_REQ_QUEUE = "trex.slots.req" 추가
- portfolio.py: View/build_snapshot_envelope/SnapshotEnvelope/_asset_to_dict 제거;
  slot_to_dict 시그니처 확장(snapshot_store/watchdog_store/pause_store/watchdog_timeout_sec)
  — asset_quantity(hub)/cash_balance/cash_estimated/warned/watchdog{}/paused 병합 (REQ-074)
- messaging_handlers.py: make_snapshot_rpc_handler 제거, make_slots_rpc_handler 추가
  — filter(all/inactive/pending/holding/error) + spy(bool) 처리; strategy 필드 제외 (REQ-073/074)
- daemon.py: _snapshot_rpc_loop → _slots_rpc_loop, make_slots_rpc_handler 연결
- cli.py: universe/slots → slots_queue + spy=True + server-side filter; buyable→inactive 매핑 (REQ-063)
- rabbitmq.py: snapshot_queue → slots_queue
- docs: interface-contract.md + runtime-flows.md slots.req 계약으로 업데이트 (REQ-075)
- REQ-028: Implemented → Deprecated (코드 삭제 완료)
- 테스트: test_snapshot_handler/selection/rpc_watchdog/messaging_snapshot_consumer 삭제;
  test_slots_handler.py(신규, 13 cases), test_killswitch_masking_resume 재작성,
  test_ledger_option_d._apply_cash_estimate → slots handler 경유, test_topology/cli_operator 갱신

BAT-036 (dcy-024): per-instance safety_sell_enabled 플래그
- config.py: DaemonInstanceConfig + DaemonConfig 에 safety_sell_enabled: bool = True 추가;
  from_toml 파싱, from_config 전파
- daemon.py: start() workers 조건부 — safety_sell_enabled=false 시 trex-safety-sell 미기동 + WARNING
- tests: test_instance_config.py 에 safety_sell_enabled 파싱 3개 케이스 추가

REQ: 073/074/075/021/034/063/048/005 Approved → Implemented

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-11 14:45:45 +09:00

2.7 KiB

req-075: slots read 표면 baseline 문서 정합

  • Status: Implemented
  • Type: Documentation
  • Priority: Medium
  • Owner: project maintainers

Intent

  • trex.snapshot.req→trex.slots.req 표면 교체(REQ-073)·슬롯 단일 행 스키마(REQ-074)를 baseline 문서에 반영해, REQ/batch/운영이 참조하는 계약 문서가 실제 표면과 어긋나지 않게 한다. (dcy-025 FR-7)

Requirement

  • docs/interface-contract.md: trex.snapshot.req 섹션(요청 view/strategy_key, 응답 assets[]/available_slots/watchdog[])을 제거하고 trex.slots.req 계약(요청 {filter, spy}, 응답 {slots[], degraded/reason/message}, 행 스키마 + 필드별 정본 출처 표(hub/슬롯·코어/브로커(행 미포함)/watchdog/overlay))으로 대체한다. 토폴로지 표의 큐명도 갱신한다.
  • docs/runtime-flows.md: 전략/운영자 read 흐름을 새 표면(slots.req, filter/spy, 워치독 터치 시맨틱)으로 갱신하고 snapshot envelope 흐름 서술을 제거·대체한다.
  • 제거되는 표면(view 모드, assets[], available_slots, watchdog[] 배열)이 문서 어디에도 현행 계약으로 남지 않는다(이력/Change Log 는 보존).

Acceptance Criteria

  1. Given docs/interface-contract.md, When 검토, Then trex.slots.req 계약(요청/응답/행 스키마/정본 표)이 기술되어 있고 trex.snapshot.req 가 현행 계약으로 남아 있지 않다.
  2. Given docs/runtime-flows.md, When 검토, Then read 흐름이 slots.req(filter/spy/워치독 시맨틱) 기준으로 기술되어 있다.
  3. Given 저장소 전체 문서, When grep(trex.snapshot.req/available_slots/assets[] 현행 서술), Then 현행 계약으로서의 잔존 서술이 없다(이력 제외).

Impacted Area

  • Docs: docs/interface-contract.md, docs/runtime-flows.md
  • Modules: 없음(문서 전용)
  • Tests: 없음(문서 검토)

Notes

  • REQ-073/074 와 같은 batch 에서 구현과 동시 정합(코드-문서 drift 방지).
  • 출처: dcy-025 FR-7.

Change Log

CHG-20260611-01

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

Change Summary

  • dcy-025 FR-7 로부터 최초 생성(Proposed). interface-contract/runtime-flows 의 snapshot→slots 표면 정합.

Intent

  • 표면 교체의 계약 문서 동기화.

Acceptance Criteria Delta

  • Added:
    • AC-1~3 신규
  • Updated/Removed: none

Impacted Area Delta

  • Docs: interface-contract/runtime-flows

Delivery Trace Delta

  • Batches: none(승인 후 draft-batch)
  • Releases: none

Revalidation Impact

  • Reverification Needed: no(신규)
  • Existing Implementation Invalidated: no
  • Status Recommendation: keep-current(Proposed)
  • Follow-up Action: confirm-req

Validation Plan

  • 신규 batch verification 에서 문서 검토 + grep 잔존 확인.