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:
Hermes Agent
2026-07-15 10:50:25 +09:00
parent f5636c1ade
commit 7b9c23a377
3 changed files with 160 additions and 1 deletions
@@ -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