1.5 KiB
1.5 KiB
id, status
| id | status |
|---|---|
| ac-0005 | active |
API·문서 호환성과 query-only source-independent 교정
Criterion
Ledger 투자금 집계 교정은 기존 GET /v1/portfolios 및 단건 returns summary의 field 이름과 응답 구조를 유지해야 한다. OpenAPI schema와 repository-owned interface/data-model/runtime 문서는 source-independent valid INVEST·WITHDRAW·PROFIT, gross total_invested, INVEST-WITHDRAW net, 별도 PROFIT, source-independent matching reversal과 non-capital side 제외를 일관되게 설명해야 한다. 교정은 existing ledger row mutation/backfill 또는 buffer_out 재분류 없이 query semantic에 한정돼야 한다.
Verification
- 성공 조건:
app/schemas/v1.py,docs/interface-contract.md,docs/data-model.md,docs/runtime-flows.md가 같은 산식·reversal·권위 경계를 설명하고 기존 field·auth·filter 계약을 보존한다. - 실패·경계 조건: stale manual-only 문구가 남거나
PROFIT을 원금/전체 실현손익으로 설명하거나, API rename, ledger mutation/backfill,buffer_out=INVEST재분류 또는 권한 우회가 발생하면 실패한다. - 검사 방법: docs contract regression, API/list/manual ledger focused suite, 변경 diff와 migration/ledger write 부재를 검사한다.
- 현재 구현 평가: 최초 독립 QC가 발견한 stale interface contract를 보완하고 manual-only 문구 부재 회귀 테스트를 추가했으며 재QC는 PASS(Blocker 0 / Major 0 / Minor 0)했다.