trex-core/docs/srs/Documentation/req-033_snapshot-read-baseline-alignment.md

req-033: 스냅샷 read 레이어 baseline 문서 정합

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

Intent

• portfolio-hub read 포트·스냅샷 read 메시지 계약·일일 스냅샷 스케줄러·정합 검증을 baseline 문서에 정합시켜 문서-코드 일치를 유지한다.

Requirement

• docs/interface-contract.md 를 read 포트(PortfolioHubReadPort)·스냅샷 read 메시지 계약(envelope·view·strategy_key·degraded)에 맞게 갱신한다.
• docs/runtime-flows.md 를 일일 스냅샷 조회 흐름·옵션 D 현금/포지션 갱신·정합 검증 흐름에 맞게 갱신한다.
• docs/project-structure.md 를 신규 adapters/portfolio read 어댑터·스냅샷 스케줄러 컴포넌트에 맞게 갱신한다.
• dcy-006 의 transport baseline 갱신(REQ-026)과 정합을 유지한다.

Acceptance Criteria

1. Given REQ-027~032 구현, When baseline 3개 문서를 검토, Then read 포트·스냅샷 메시지 계약·스케줄러·정합 검증이 실제 코드와 정합한다.
2. Given 문서-코드 정합 점검, Then baseline 문서와 실제 포트/계약/흐름 사이 불일치가 0 이다.

Impacted Area

• Docs: docs/interface-contract.md, docs/runtime-flows.md, docs/project-structure.md, docs/discovery/dcy-005_20260604_portfolio-hub-asset-snapshot-api.md
• Modules: none(문서)
• Tests: 문서-코드 정합 리뷰

Notes

• dcy-005 FR-5 반영. dcy-006 transport baseline 과 정합.
• 보통 REQ-027~032 구현 batch 의 검증 단계에서 함께 마감한다.

Change Log

CHG-20260606-01

• Date: 2026-06-06
• Author: project maintainers

Change Summary

• dcy-005 FR-5 분해로 최초 생성(Proposed).

Intent

• read 레이어 baseline 문서 정합 작업 정의.

Acceptance Criteria Delta

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

Impacted Area Delta

• Docs:
  • interface-contract, runtime-flows, project-structure, dcy-005
• Modules:
  • none
• Tests:
  • 문서-코드 정합 리뷰

Delivery Trace Delta

• Batches:
  • none
• Releases:
  • none

Revalidation Impact

• Reverification Needed: no
• Existing Implementation Invalidated: no
• Status Recommendation: keep-current
• Follow-up Action: confirm-req

Validation Plan

• baseline 문서 vs 실제 포트/계약/흐름 정합 리뷰로 AC 검증.

CHG-20260606-02

• Date: 2026-06-06
• Author: project maintainers

Change Summary

• 승인 게이트 통과 → Proposed → Approved.

Acceptance Criteria Delta

• Added: none
• Updated: none
• Removed: none

Impacted Area Delta

• 변경 없음

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

• 승인 기록. REQ-027~032 구현 batch 검증 단계에서 함께 마감.

CHG-20260606-03

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

Change Summary

• Status 변경: Approved → Implemented. BAT-008 release-candidate verification evidence 기반.

Intent

• baseline 3 문서(runtime-flows / interface-contract / project-structure) 에 BAT-008 섹션 + Change Log 추가 완료 상태로 동기화.

Acceptance Criteria Delta

• Added/Updated/Removed: 없음

Impacted Area Delta

• Docs/Modules/Tests: 없음

Delivery Trace Delta

• Batches:
  • BAT-008 (release-candidate)
• Releases:
  • none

Revalidation Impact

• Reverification Needed: no
• Existing Implementation Invalidated: no
• Status Recommendation: Implemented
• Follow-up Action: release 단계는 별도 진행

Validation Plan

• AC-1: 3 baseline 문서 모두 BAT-008 섹션 + 2026-06-06 Change Log 항목 추가됨.
• AC-2: BAT-008 verification.md Manual 섹션의 baseline ↔ 코드 정합 리뷰 (필드 시그니처/디렉토리 트리/Protocol 동작 일치 확인).