docs(req): approve ledger metadata migration requirement
Confirm REQ-057 for BAT-025 while preserving REQ-056/BAT-024 implementation status. Operational DB execution remains separately approved.
This commit is contained in:
@@ -182,6 +182,39 @@
|
||||
#### Validation Plan
|
||||
- AC-1~19를 batch verification에서 API/repository/concurrency/regression evidence로 검증한다.
|
||||
|
||||
### CHG-20260715-03
|
||||
- Date: 2026-07-15
|
||||
- Author: TREX lead (Hermes)
|
||||
|
||||
#### Change Summary
|
||||
- 운영 적용 방식 보완을 REQ-057로 분리 추적한다. REQ-056의 기존 API 계약, AC-1~19, `Implemented` status 및 BAT-024 `release-candidate` 상태는 변경하거나 되돌리지 않는다.
|
||||
|
||||
#### Intent
|
||||
- REQ-056 구현에서 사용된 additive `portfolio_ledger` 컬럼의 운영 DB 적용을 runtime `ensure_schema()` 자동 DDL에만 의존하지 않도록 명시 Alembic migration과 운영 runbook 요구사항으로 후속 관리한다.
|
||||
|
||||
#### Acceptance Criteria Delta
|
||||
- Added: 없음 (REQ-056 AC 변경 없음)
|
||||
- Updated: 없음
|
||||
- Removed: 없음
|
||||
- Follow-on: REQ-057 AC-1~11이 migration, schema/Alembic revision 정합, 운영 preflight/runbook, forward-only recovery, release 결재 게이트를 별도로 정의한다.
|
||||
|
||||
#### Impacted Area Delta
|
||||
- REQ-056 구현 영향 범위는 변경 없음.
|
||||
- 후속 REQ-057 영향: `migrations/versions/`, runtime `ensure_schema()` 호환성, migration/runbook 및 persistence baseline 문서. 실제 변경은 BAT-025 standard에서 수행한다.
|
||||
|
||||
#### Delivery Trace Delta
|
||||
- Batches: BAT-024는 REQ-056 구현/검증 release-candidate 상태로 유지. BAT-025 standard가 REQ-057 migration implementation/test/QC/runbook을 담당한다.
|
||||
- Releases: 운영 DB upgrade, 서비스 재시작 및 신규 manual ledger API 활성화는 별도 명시 release 결재 전 실행하지 않는다.
|
||||
|
||||
#### Revalidation Impact
|
||||
- Reverification Needed: no — REQ-056의 기존 implementation/QC evidence는 무효화하지 않는다.
|
||||
- Existing Implementation Invalidated: no
|
||||
- Status Recommendation: keep-Implemented
|
||||
- Follow-up Action: REQ-057 Proposed 검토·승인 후 BAT-025에서 migration compatibility/data preservation/runbook evidence를 확보한다.
|
||||
|
||||
#### Validation Plan
|
||||
- BAT-025에서 fresh DB와 runtime-precreated-schema 환경의 Alembic upgrade, 기존 row/source 보존, `alembic current` 정합, broker/manual ledger regression, runbook preflight 및 service smoke를 검증한다. 운영 DB 실행은 별도 release 결재 범위다.
|
||||
|
||||
|
||||
## Implementation Confirmation
|
||||
|
||||
|
||||
Reference in New Issue
Block a user