feat: add portfolio snapshot read layer

2026-06-06 09:33:00 +09:00
parent 56e977a7ad
commit ca757009f5
51 changed files with 3565 additions and 51 deletions
@@ -0,0 +1,131 @@
+# 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 동작 일치 확인).