From f7d309be71395dbe6bd87ae059fd6394f0fbf7cf Mon Sep 17 00:00:00 2001 From: Justin Ko Date: Wed, 10 Jun 2026 10:32:52 +0900 Subject: [PATCH] =?UTF-8?q?docs(req):=20dcy-020=20confirm-req(REQ-056~065?= =?UTF-8?q?=20Approved)=20+=20=EA=B8=B0=EC=A1=B4=20REQ=20supersession=20ch?= =?UTF-8?q?ange-req?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 --- .../req-060_max-active-slots-config.md | 27 ++++++++++++- .../req-006_postgresql-slot-persistence.md | 39 +++++++++++++++++++ .../req-056_asset-permanent-slot-schema.md | 27 ++++++++++++- ...eq-065_asset-centric-baseline-alignment.md | 27 ++++++++++++- .../req-005_slot-core-daemon-runtime.md | 39 +++++++++++++++++++ ...q-058_universe-slot-reconcile-lifecycle.md | 27 ++++++++++++- ...2_quantity-hub-authority-and-divergence.md | 27 ++++++++++++- .../req-002_slot-pure-domain-port.md | 39 +++++++++++++++++++ .../req-007_intent-submission-api.md | 39 +++++++++++++++++++ .../req-057_asset-slot-state-machine.md | 27 ++++++++++++- .../req-059_active-capacity-admission.md | 27 ++++++++++++- .../req-061_asset-keyed-intent-contract.md | 27 ++++++++++++- .../req-063_unified-operator-slot-view.md | 27 ++++++++++++- .../req-064_pool-to-permanent-slot-cutover.md | 27 ++++++++++++- ...03_slot-domain-tests-and-contract-guard.md | 39 +++++++++++++++++++ docs/srs/index.md | 20 +++++----- 16 files changed, 465 insertions(+), 20 deletions(-) diff --git a/docs/srs/Configuration/req-060_max-active-slots-config.md b/docs/srs/Configuration/req-060_max-active-slots-config.md index 80bcbd2..5d6d49e 100644 --- a/docs/srs/Configuration/req-060_max-active-slots-config.md +++ b/docs/srs/Configuration/req-060_max-active-slots-config.md @@ -1,6 +1,6 @@ # req-060: 동시 활성 최대치(max_active_slots) per-instance TOML 설정 -- Status: Proposed +- Status: Approved - Type: Configuration - Priority: High - Owner: project maintainers @@ -59,3 +59,28 @@ #### Validation Plan - TOML 키 로딩 + 미설정 거부 단위테스트 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 를 검증 기준으로 사용. diff --git a/docs/srs/Data/req-006_postgresql-slot-persistence.md b/docs/srs/Data/req-006_postgresql-slot-persistence.md index a3d464e..30da041 100644 --- a/docs/srs/Data/req-006_postgresql-slot-persistence.md +++ b/docs/srs/Data/req-006_postgresql-slot-persistence.md @@ -232,3 +232,42 @@ #### Validation Plan - BAT-025: unit (in-memory selector 정렬·reallocation) green; 마이그레이션 008 round-trip + 드리프트 가드는 test DSN 환경에서 자동 검증(라이브 runtime DSN 미사용 — 파괴적 truncate 회피). + +### CHG-20260610-01 + +- Date: 2026-06-10 +- Author: Justin Ko + +#### Change Summary + +- (change-req, dcy-020) `daily_slot` persistence 가 영구 슬롯 스키마로 **재정의 예정** — REQ-056(portfolio_id 영구키·instance_key·`UNIQUE(instance_key, portfolio_id)`·trading_date/entry_count 제거·retired_at)·REQ-062(qty 미러)가 대체. find_allocatable_slot 등 풀 모델 쿼리 폐기. 현재 코드 불변이라 Implemented 유지(keep-current), dcy-020 스키마 배치 + cutover(REQ-064)에서 확정. + +#### Intent + +- 영구 슬롯 persistence 전환 추적성 forward-link. + +#### Acceptance Criteria Delta + +- Updated: 없음(dcy-020 delivery 배치에서 스키마 AC 재정의) + +#### Impacted Area Delta + +- Docs: dcy-020, REQ-056/062/064 +- Modules: (예정) adapters/persistence/postgresql.py·sql/ 재설계 +- Tests: (예정) test_migration_and_drift 재작성 + +#### Delivery Trace Delta + +- Batches: (예정) dcy-020 스키마/cutover 배치 +- Releases: none + +#### Revalidation Impact + +- Reverification Needed: no (현 시점) +- Existing Implementation Invalidated: no (코드 불변) +- Status Recommendation: keep-current +- Follow-up Action: dcy-020 스키마/cutover 배치에서 재정의 + status 전환. + +#### Validation Plan + +- dcy-020 스키마/cutover 배치 verification 으로 대체. diff --git a/docs/srs/Data/req-056_asset-permanent-slot-schema.md b/docs/srs/Data/req-056_asset-permanent-slot-schema.md index ca402bc..a91e1c8 100644 --- a/docs/srs/Data/req-056_asset-permanent-slot-schema.md +++ b/docs/srs/Data/req-056_asset-permanent-slot-schema.md @@ -1,6 +1,6 @@ # req-056: 자산 영구 슬롯 스키마 재설계 + 마이그레이션 -- Status: Proposed +- Status: Approved - Type: Data - Priority: High - Owner: project maintainers @@ -62,3 +62,28 @@ #### Validation Plan - 마이그레이션 적용 후 스키마/UNIQUE/계약 가드 + drift 테스트 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 (batch 편성 전) / 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 를 검증 기준으로 사용. diff --git a/docs/srs/Documentation/req-065_asset-centric-baseline-alignment.md b/docs/srs/Documentation/req-065_asset-centric-baseline-alignment.md index edbab8c..de40099 100644 --- a/docs/srs/Documentation/req-065_asset-centric-baseline-alignment.md +++ b/docs/srs/Documentation/req-065_asset-centric-baseline-alignment.md @@ -1,6 +1,6 @@ # req-065: 자산 중심 모델 baseline 문서 정합 + 풀 모델 폐기 명시 -- Status: Proposed +- Status: Approved - Type: Documentation - Priority: Medium - Owner: project maintainers @@ -59,3 +59,28 @@ #### Validation Plan - 코드-문서 diff 대조로 정합 확인. + +### 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: 각 배치에서 분산 수행. + +#### Validation Plan +- 승인 후 코드-문서 diff 대조로 검증. diff --git a/docs/srs/Installation/req-005_slot-core-daemon-runtime.md b/docs/srs/Installation/req-005_slot-core-daemon-runtime.md index 553c8d4..73ad4b8 100644 --- a/docs/srs/Installation/req-005_slot-core-daemon-runtime.md +++ b/docs/srs/Installation/req-005_slot-core-daemon-runtime.md @@ -190,3 +190,42 @@ #### Validation Plan - BAT-018: KST/UTC 경계 trading_date, 일자 경계 자동 생성+멱등, 설정 TZ, 트리거 시각 게이팅 단위. + +### CHG-20260610-01 + +- Date: 2026-06-10 +- Author: Justin Ko + +#### Change Summary + +- (change-req, dcy-020) 일일 슬롯 preallocation(`preallocate_daily_slots`/00:00 트리거)이 **폐기 예정** — REQ-058(universe reconcile 기반 슬롯 생성/소멸)로 대체. `TREX_TOTAL_SLOTS`(풀 크기)는 REQ-060(`max_active_slots` per-instance TOML)로 대체. trading_date KST 계산(REQ-005 NFR-1)은 일일 회계 경계용으로 **부분 존속**. 현재 코드 불변이라 Implemented 유지(keep-current), dcy-020 delivery 배치(reconcile)에서 preallocation 제거·확정. + +#### Intent + +- preallocation→universe reconcile 전환의 추적성 forward-link. + +#### Acceptance Criteria Delta + +- Updated: 없음(dcy-020 delivery 배치에서 preallocation AC 폐기) + +#### Impacted Area Delta + +- Docs: dcy-020, REQ-058/060 +- Modules: (예정) application/preallocation_scheduler.py 폐기, runtime/config.py(TREX_TOTAL_SLOTS 제거) +- Tests: (예정) test_preallocation_scheduler 폐기/대체 + +#### Delivery Trace Delta + +- Batches: (예정) dcy-020 reconcile 배치 +- Releases: none + +#### Revalidation Impact + +- Reverification Needed: no (현 시점) +- Existing Implementation Invalidated: no (코드 불변) +- Status Recommendation: keep-current +- Follow-up Action: dcy-020 reconcile 배치에서 preallocation 폐기 + status 전환. trading_date KST 계산은 존속. + +#### Validation Plan + +- dcy-020 reconcile 배치 verification 으로 대체. diff --git a/docs/srs/Integration/req-058_universe-slot-reconcile-lifecycle.md b/docs/srs/Integration/req-058_universe-slot-reconcile-lifecycle.md index 221f6c9..b0a0082 100644 --- a/docs/srs/Integration/req-058_universe-slot-reconcile-lifecycle.md +++ b/docs/srs/Integration/req-058_universe-slot-reconcile-lifecycle.md @@ -1,6 +1,6 @@ # req-058: universe 기반 슬롯 lifecycle reconcile (생성/soft-retire/tombstone) -- Status: Proposed +- Status: Approved - Type: Integration - Priority: High - Owner: project maintainers @@ -61,3 +61,28 @@ #### Validation Plan - reconcile 생성/은퇴/tombstone/degrade 단위·통합 테스트 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 를 검증 기준으로 사용. diff --git a/docs/srs/Integration/req-062_quantity-hub-authority-and-divergence.md b/docs/srs/Integration/req-062_quantity-hub-authority-and-divergence.md index a3e8a9c..a8ac1ce 100644 --- a/docs/srs/Integration/req-062_quantity-hub-authority-and-divergence.md +++ b/docs/srs/Integration/req-062_quantity-hub-authority-and-divergence.md @@ -1,6 +1,6 @@ # req-062: 수량 hub 정본+로컬 미러 + holding↔broker/hub 불일치 해소 -- Status: Proposed +- Status: Approved - Type: Integration - Priority: High - Owner: project maintainers @@ -60,3 +60,28 @@ #### Validation Plan - 청산 브로커 기준 + A/B/C 불일치 해소 단위·통합 테스트 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 를 검증 기준으로 사용. diff --git a/docs/srs/Interface/req-002_slot-pure-domain-port.md b/docs/srs/Interface/req-002_slot-pure-domain-port.md index 029f9a1..b1a0bc7 100644 --- a/docs/srs/Interface/req-002_slot-pure-domain-port.md +++ b/docs/srs/Interface/req-002_slot-pure-domain-port.md @@ -232,3 +232,42 @@ #### Validation Plan - BAT-025: 전이 카운트/계약 가드 + entry_count 증분·보존 + closed→pending_buy clean-slate 단위 테스트 green; `daily_symbol_entries`(AC-3) 회귀 green. + +### CHG-20260610-01 + +- Date: 2026-06-10 +- Author: Justin Ko + +#### Change Summary + +- (change-req, dcy-020 자산 중심 슬롯 모델) 본 REQ 의 슬롯 도메인(6상태·`closed→idle` 복구·entry_count·익명 슬롯)이 dcy-020 으로 **재정의/폐기 예정**. 신규 REQ-057(상태머신 inactive↔pending_buy↔holding↔pending_sell·holding 로컬·인스턴스 스코프 lock)·REQ-056(영구 슬롯 필드·entry_count 제거)·REQ-062(qty hub 정본+미러)가 대체. **현재 코드는 불변이므로 Implemented 유지(keep-current)**, 실제 폐기/재정의는 dcy-020 delivery 배치(상태머신/스키마 BAT)에서 확정한다. + +#### Intent + +- 자산 1:1 영구 슬롯 모델 전환의 추적성을 본 REQ 에 forward-link. + +#### Acceptance Criteria Delta + +- Updated: 없음(본 주기 변경 없음 — dcy-020 delivery 배치에서 AC 재정의 예정) + +#### Impacted Area Delta + +- Docs: dcy-020, REQ-056/057/062 +- Modules: (예정) domain/slot/state.py·models.py·service.py +- Tests: (예정) REQ-057 테스트로 대체 + +#### Delivery Trace Delta + +- Batches: (예정) dcy-020 상태머신/스키마 배치 +- Releases: none + +#### Revalidation Impact + +- Reverification Needed: no (현 시점) +- Existing Implementation Invalidated: no (코드 불변 — dcy-020 delivery 시 무효화·재정의) +- Status Recommendation: keep-current +- Follow-up Action: dcy-020 delivery 배치에서 Deprecated/재정의 + 그때 status 전환. + +#### Validation Plan + +- dcy-020 상태머신 배치의 verification 으로 대체. diff --git a/docs/srs/Interface/req-007_intent-submission-api.md b/docs/srs/Interface/req-007_intent-submission-api.md index 131c3aa..56f1693 100644 --- a/docs/srs/Interface/req-007_intent-submission-api.md +++ b/docs/srs/Interface/req-007_intent-submission-api.md @@ -312,3 +312,42 @@ #### Validation Plan - BAT-025: closed 재할당 admit / idle 우선 / 양쪽 소진 reject 단위 + 동시성 경합 회귀 green. + +### CHG-20260610-01 + +- Date: 2026-06-10 +- Author: Justin Ko + +#### Change Summary + +- (change-req, dcy-020) buy/sell admission 이 자산 중심으로 **재정의 예정** — REQ-059(FCFS·M캡·무치환·over-cap)·REQ-061(intent 자산 키 통일, `sell-by-slot_id` 폐기, already_active/not_holding)가 대체. `find_allocatable_slot`/idle·closed 배정 폐기. 외부 전략 계약 변경(NFR-4) 동반. 현재 코드 불변이라 Implemented 유지(keep-current), dcy-020 admission/intent 배치에서 확정(외부 계약 cutover 게이트). + +#### Intent + +- 신호 기반 자산 admission 전환 추적성 forward-link. + +#### Acceptance Criteria Delta + +- Updated: 없음(dcy-020 delivery 배치에서 admission/intent AC 재정의) + +#### Impacted Area Delta + +- Docs: dcy-020, REQ-059/061 +- Modules: (예정) application/intents.py·메시지 핸들러/스키마 +- Tests: (예정) intent/admission 테스트 재작성 + +#### Delivery Trace Delta + +- Batches: (예정) dcy-020 admission/intent 배치(외부 계약 cutover) +- Releases: none + +#### Revalidation Impact + +- Reverification Needed: no (현 시점) +- Existing Implementation Invalidated: no (코드 불변) +- Status Recommendation: keep-current +- Follow-up Action: dcy-020 admission/intent 배치에서 재정의 + status 전환. 외부 전략 모듈 동시 전환(NFR-4). + +#### Validation Plan + +- dcy-020 admission/intent 배치 verification 으로 대체. diff --git a/docs/srs/Interface/req-057_asset-slot-state-machine.md b/docs/srs/Interface/req-057_asset-slot-state-machine.md index 66852ca..6b16fa8 100644 --- a/docs/srs/Interface/req-057_asset-slot-state-machine.md +++ b/docs/srs/Interface/req-057_asset-slot-state-machine.md @@ -1,6 +1,6 @@ # req-057: 자산 영구 슬롯 상태머신 재정의 + 인스턴스 스코프 advisory lock -- Status: Proposed +- Status: Approved - Type: Interface - Priority: High - Owner: project maintainers @@ -62,3 +62,28 @@ #### Validation Plan - 전이 허용/거부 집합 + 인스턴스 락 단위테스트 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 를 검증 기준으로 사용. diff --git a/docs/srs/Interface/req-059_active-capacity-admission.md b/docs/srs/Interface/req-059_active-capacity-admission.md index 0cce3ff..63e1a57 100644 --- a/docs/srs/Interface/req-059_active-capacity-admission.md +++ b/docs/srs/Interface/req-059_active-capacity-admission.md @@ -1,6 +1,6 @@ # req-059: 활성 capacity 제어 + 신호 기반 admission (FCFS·M캡·무치환·over-cap) -- Status: Proposed +- Status: Approved - Type: Interface - Priority: High - Owner: project maintainers @@ -61,3 +61,28 @@ #### Validation Plan - FCFS/거부/over-cap/경합 단위·통합 테스트 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 를 검증 기준으로 사용. diff --git a/docs/srs/Interface/req-061_asset-keyed-intent-contract.md b/docs/srs/Interface/req-061_asset-keyed-intent-contract.md index 0dc574a..0c98f51 100644 --- a/docs/srs/Interface/req-061_asset-keyed-intent-contract.md +++ b/docs/srs/Interface/req-061_asset-keyed-intent-contract.md @@ -1,6 +1,6 @@ # req-061: intent 계약 자산(portfolio_id) 키 통일 + 중복/무효 규칙 -- Status: Proposed +- Status: Approved - Type: Interface - Priority: High - Owner: project maintainers @@ -60,3 +60,28 @@ #### Validation Plan - 자산 키 매도/거부 규칙/멱등 단위·통합 테스트 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 를 검증 기준으로 사용. diff --git a/docs/srs/Interface/req-063_unified-operator-slot-view.md b/docs/srs/Interface/req-063_unified-operator-slot-view.md index 2bf2e33..eba51c9 100644 --- a/docs/srs/Interface/req-063_unified-operator-slot-view.md +++ b/docs/srs/Interface/req-063_unified-operator-slot-view.md @@ -1,6 +1,6 @@ # req-063: 운영자 표면 단일화 — slots = 자산 포지션 단일 뷰 -- Status: Proposed +- Status: Approved - Type: Interface - Priority: Medium - Owner: project maintainers @@ -59,3 +59,28 @@ #### 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 를 검증 기준으로 사용. diff --git a/docs/srs/Migration/req-064_pool-to-permanent-slot-cutover.md b/docs/srs/Migration/req-064_pool-to-permanent-slot-cutover.md index 75fa9f7..8875e89 100644 --- a/docs/srs/Migration/req-064_pool-to-permanent-slot-cutover.md +++ b/docs/srs/Migration/req-064_pool-to-permanent-slot-cutover.md @@ -1,6 +1,6 @@ # req-064: 풀 모델 → 영구 자산 슬롯 cutover 마이그레이션 -- Status: Proposed +- Status: Approved - Type: Migration - Priority: High - Owner: project maintainers @@ -60,3 +60,28 @@ #### Validation Plan - cutover 리허설(보유 보존·기동 회귀·롤백) + run-the-app evidence. + +### 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 으로 승격(라이브 cutover 는 별도 배치·운영자 입회). + +#### 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: 별도 cutover 배치(BAT-δ), confirm-release 전 리허설 evidence. + +#### Validation Plan +- 승인 후 cutover 배치 planning 에서 본 REQ AC 를 검증 기준으로 사용. diff --git a/docs/srs/Testing/req-003_slot-domain-tests-and-contract-guard.md b/docs/srs/Testing/req-003_slot-domain-tests-and-contract-guard.md index fe9c21f..3b30742 100644 --- a/docs/srs/Testing/req-003_slot-domain-tests-and-contract-guard.md +++ b/docs/srs/Testing/req-003_slot-domain-tests-and-contract-guard.md @@ -232,3 +232,42 @@ #### Validation Plan - BAT-025: 전이/계약 가드 + 신규 entry_count·reallocation 단위 테스트 green (unit), PG 게이트 드리프트 가드는 test DSN 환경에서 자동 검증. + +### CHG-20260610-01 + +- Date: 2026-06-10 +- Author: Justin Ko + +#### Change Summary + +- (change-req, dcy-020) 슬롯 도메인 계약 가드/단위테스트가 영구 슬롯 모델(REQ-056/057)로 **재정의 예정** — 전이 집합(inactive 중심)·`EXPECTED_SLOT_FIELDS`(entry_count 제거·instance_key 추가)가 바뀐다. 현재 코드/테스트 불변이라 Implemented 유지(keep-current), dcy-020 delivery 배치에서 테스트 재작성·확정. + +#### Intent + +- 영구 슬롯 모델 전환의 테스트 계약 추적성 forward-link. + +#### Acceptance Criteria Delta + +- Updated: 없음(dcy-020 delivery 배치에서 재정의) + +#### Impacted Area Delta + +- Docs: dcy-020, REQ-056/057 +- Modules: (예정) 없음 +- Tests: (예정) test_state/test_contract/test_migration_and_drift 재작성 + +#### Delivery Trace Delta + +- Batches: (예정) dcy-020 상태머신/스키마 배치 +- Releases: none + +#### Revalidation Impact + +- Reverification Needed: no (현 시점) +- Existing Implementation Invalidated: no (코드 불변) +- Status Recommendation: keep-current +- Follow-up Action: dcy-020 delivery 배치에서 재정의 + status 전환. + +#### Validation Plan + +- dcy-020 배치 verification 으로 대체. diff --git a/docs/srs/index.md b/docs/srs/index.md index 8440e71..c37aea2 100644 --- a/docs/srs/index.md +++ b/docs/srs/index.md @@ -136,16 +136,16 @@ | REQ-053 | safety-sell 재시도 쿨다운 env 설정 2종 | Configuration | Implemented | Medium | project maintainers | [req-053](./Configuration/req-053_safety-sell-retry-cooldown-env.md) | | REQ-054 | safety-sell 쿨다운 runtime-flows 정합 | Documentation | Implemented | Low | project maintainers | [req-054](./Documentation/req-054_safety-sell-cooldown-baseline-alignment.md) | | REQ-055 | closed 슬롯 ↔ ledger_outbox 누락 운영 점검 쿼리 | Exception | Implemented | Medium | project maintainers | [req-055](./Exception/req-055_ledger-gap-ops-check.md) | -| REQ-056 | 자산 영구 슬롯 스키마 재설계 + 마이그레이션 | Data | Proposed | High | project maintainers | [req-056](./Data/req-056_asset-permanent-slot-schema.md) | -| REQ-057 | 자산 영구 슬롯 상태머신 재정의 + 인스턴스 스코프 advisory lock | Interface | Proposed | High | project maintainers | [req-057](./Interface/req-057_asset-slot-state-machine.md) | -| REQ-058 | universe 기반 슬롯 lifecycle reconcile (생성/soft-retire/tombstone) | Integration | Proposed | High | project maintainers | [req-058](./Integration/req-058_universe-slot-reconcile-lifecycle.md) | -| REQ-059 | 활성 capacity 제어 + 신호 기반 admission (FCFS·M캡·무치환·over-cap) | Interface | Proposed | High | project maintainers | [req-059](./Interface/req-059_active-capacity-admission.md) | -| REQ-060 | 동시 활성 최대치(max_active_slots) per-instance TOML 설정 | Configuration | Proposed | High | project maintainers | [req-060](./Configuration/req-060_max-active-slots-config.md) | -| REQ-061 | intent 계약 자산(portfolio_id) 키 통일 + 중복/무효 규칙 | Interface | Proposed | High | project maintainers | [req-061](./Interface/req-061_asset-keyed-intent-contract.md) | -| REQ-062 | 수량 hub 정본+로컬 미러 + holding↔broker/hub 불일치 해소 | Integration | Proposed | High | project maintainers | [req-062](./Integration/req-062_quantity-hub-authority-and-divergence.md) | -| REQ-063 | 운영자 표면 단일화 — slots = 자산 포지션 단일 뷰 | Interface | Proposed | Medium | project maintainers | [req-063](./Interface/req-063_unified-operator-slot-view.md) | -| REQ-064 | 풀 모델 → 영구 자산 슬롯 cutover 마이그레이션 | Migration | Proposed | High | project maintainers | [req-064](./Migration/req-064_pool-to-permanent-slot-cutover.md) | -| REQ-065 | 자산 중심 모델 baseline 문서 정합 + 풀 모델 폐기 명시 | Documentation | Proposed | Medium | project maintainers | [req-065](./Documentation/req-065_asset-centric-baseline-alignment.md) | +| REQ-056 | 자산 영구 슬롯 스키마 재설계 + 마이그레이션 | Data | Approved | High | project maintainers | [req-056](./Data/req-056_asset-permanent-slot-schema.md) | +| REQ-057 | 자산 영구 슬롯 상태머신 재정의 + 인스턴스 스코프 advisory lock | Interface | Approved | High | project maintainers | [req-057](./Interface/req-057_asset-slot-state-machine.md) | +| REQ-058 | universe 기반 슬롯 lifecycle reconcile (생성/soft-retire/tombstone) | Integration | Approved | High | project maintainers | [req-058](./Integration/req-058_universe-slot-reconcile-lifecycle.md) | +| REQ-059 | 활성 capacity 제어 + 신호 기반 admission (FCFS·M캡·무치환·over-cap) | Interface | Approved | High | project maintainers | [req-059](./Interface/req-059_active-capacity-admission.md) | +| REQ-060 | 동시 활성 최대치(max_active_slots) per-instance TOML 설정 | Configuration | Approved | High | project maintainers | [req-060](./Configuration/req-060_max-active-slots-config.md) | +| REQ-061 | intent 계약 자산(portfolio_id) 키 통일 + 중복/무효 규칙 | Interface | Approved | High | project maintainers | [req-061](./Interface/req-061_asset-keyed-intent-contract.md) | +| REQ-062 | 수량 hub 정본+로컬 미러 + holding↔broker/hub 불일치 해소 | Integration | Approved | High | project maintainers | [req-062](./Integration/req-062_quantity-hub-authority-and-divergence.md) | +| REQ-063 | 운영자 표면 단일화 — slots = 자산 포지션 단일 뷰 | Interface | Approved | Medium | project maintainers | [req-063](./Interface/req-063_unified-operator-slot-view.md) | +| REQ-064 | 풀 모델 → 영구 자산 슬롯 cutover 마이그레이션 | Migration | Approved | High | project maintainers | [req-064](./Migration/req-064_pool-to-permanent-slot-cutover.md) | +| REQ-065 | 자산 중심 모델 baseline 문서 정합 + 풀 모델 폐기 명시 | Documentation | Approved | Medium | project maintainers | [req-065](./Documentation/req-065_asset-centric-baseline-alignment.md) | ## Recent Change Log Summary