docs(srs/batch): dcy-021 REQ + BAT-031 + Implemented 전환

- draft-req: REQ-066(사이징 도메인·end-to-end), REQ-067(baseline 정합) 신규
- change-req: REQ-057(CHG-03 holding→pending_buy)·REQ-061(CHG-04 사이징 intent)·
  REQ-062(CHG-03 부분 매도 min(주문,잔고)) — Implemented→Approved 후 재구현
- confirm-req: REQ-066/067 Approved
- BAT-031 batch(index/planning/design D1~D4/implementation/verification) → release-candidate
- confirm-batch-verification 승인 + confirm-req-implemented:
  REQ-057/061/062/066/067 → Implemented (BAT-031 verification 근거)
- srs/batch index + dcy-021 discovery 생성 REQ 역참조 갱신

(issue #21 dcy-022 는 별도 작업으로 미포함)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-06-10 18:53:53 +09:00
co-authored by Claude Opus 4.8
parent e4be4d60c2
commit 5ee5f7f4e2
13 changed files with 517 additions and 10 deletions
@@ -0,0 +1,88 @@
# req-067: 포지션 사이징 baseline 문서 정합
- Status: Implemented
- Type: Documentation
- Priority: Medium
- Owner: project maintainers
## Intent
- dcy-021: 보유 포지션 사이징(증액·부분 감액·명령형 사이징 intent) 구현이 끝나면 cross-cutting baseline 문서를 실제 동작과 일치시켜, 이후 Discovery/REQ/Batch 가 정확한 기준을 참조하게 한다. (issue #1, dcy-020 OQ-4 후속)
## Requirement
- `docs/data-model.md`: 보유 슬롯 수량 가변(증액 누적·부분 감액 잔량)·avg_price 가중평균 재계산·cost basis 유지 규칙을 반영한다.
- `docs/runtime-flows.md`: 사이징 intent 수신 → 집행(증액 매수/부분 매도, 집행 수량 = min(intent, 브로커 잔고)) → 부분 체결 실제 반영·미추적 → 슬롯 holding 유지/inactive 종료 흐름과 확장된 상태 전이(HOLDING→PENDING_BUY 등)를 반영한다.
- `docs/interface-contract.md`: 사이징 intent payload(명령형 qty+price; 증액 buy-on-holding·부분 매도 qty)·이벤트·집행 수량 규칙을 반영한다.
- `docs/project-structure.md`: 사이징으로 영향받은 모듈(slot service·state·intents·execution) 책임 서술을 갱신한다.
## Acceptance Criteria
1. Given 사이징 구현 완료, When `docs/data-model.md` 확인, Then 수량 가변·avg_price 가중평균·cost basis 유지가 코드와 일치한다.
2. Given 사이징 구현 완료, When `docs/runtime-flows.md`·`docs/interface-contract.md` 확인, Then 사이징 intent·집행(min(intent,잔고))·부분 체결 미추적·상태 전이 확장이 실제와 일치한다.
3. Given baseline 갱신, When `docs/project-structure.md` 확인, Then 영향 모듈 서술이 구현과 일치한다.
## Impacted Area
- Docs: docs/data-model.md, docs/runtime-flows.md, docs/interface-contract.md, docs/project-structure.md
- Modules: 없음(문서)
- Tests: 없음(문서 리뷰)
## Notes
- 본 REQ 는 REQ-066 및 change-req(REQ-057/061/062) 구현 완료 후 마지막에 정합한다(dcy-020 REQ-065 와 동일 패턴).
- 출처: dcy-021 FR-4.
## Change Log
### CHG-20260610-01
- Date: 2026-06-10
- Author: Justin Ko
#### Change Summary
- dcy-021(포지션 사이징)로부터 최초 생성(Proposed). 사이징 baseline 4문서 정합.
#### Intent
- 구현 후 cross-cutting baseline 을 실제 동작과 일치.
#### Acceptance Criteria Delta
- Added: data-model/runtime-flows·interface-contract/project-structure 정합 3개 기준
- Updated: 없음 / Removed: 없음
#### Impacted Area Delta
- Docs: data-model/runtime-flows/interface-contract/project-structure / Modules: 없음 / Tests: 없음(문서 리뷰)
#### Delivery Trace Delta
- Batches: dcy-021 신규 배치(예정) / Releases: none
#### Revalidation Impact
- Reverification Needed: no(문서) / Existing Implementation Invalidated: no / Status Recommendation: keep-current / Follow-up Action: confirm-req → dcy-021 배치 마지막 정합.
#### Validation Plan
- 사이징 구현 완료 후 baseline 4문서 diff 리뷰.
### CHG-20260610-02
- Date: 2026-06-10
- Author: Justin Ko
#### Change Summary
- Status Proposed → Approved (confirm-req). 필수 필드·구체 AC 충족, source dcy-021 와 모순 없음.
#### 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: dcy-021 배치 마지막 정합.
#### Validation Plan
- 승인 후 dcy-021 배치 verification 에서 baseline 정합 확인.
### CHG-20260610-IMPL
- Date: 2026-06-10
- Author: Justin Ko
- Type: status
- Summary: Approved → Implemented (confirm-req-implemented). 근거: BAT-031(release-candidate) verification — 단위 378 / 통합 422 passed + run-the-app 사이징 e2e(증액 가중평균·부분 매도 잔량·전량 매도) green. Blocking Issues 없음.