Files
portfolio-hub/.proofline/criteria/ac-0005.md
T

1.2 KiB

id, status
id status
ac-0005 active

additive API·문서 호환성과 reversal 회귀 보존

Criterion

ledger 투자금 집계 확장은 기존 GET /v1/portfolios 및 단건 returns summary 계약에 대한 additive 변경이어야 한다. OpenAPI와 repository-owned interface/runtime 문서는 net_contributed_capital을 순투자현금, cumulative_profit_withdrawn을 누적 수익 인출액으로 정의하고 portfolio-hub가 ledger 권위 값을 제공함을 명시해야 하며, 기존 이중 reversal 거부 동작을 유지해야 한다.

Verification

  • 성공 조건: 기존 목록 필드와 token/filter 동작이 보존되고 docs/interface-contract.md, docs/runtime-flows.md, OpenAPI schema가 두 필드의 산식·REVERSAL·권위 경계를 일관되게 설명한다.
  • 실패·경계 조건: PROFIT을 WITHDRAW 또는 전체 실현손익으로 설명하지 않고, 동일 원거래를 두 번 reversal하려는 기존 요청은 계속 거부된다.
  • 검사 방법: 목록·manual ledger 회귀 테스트와 문서·OpenAPI 검사를 실행하고 focused suite 및 전체 프로젝트 suite를 사용해 기존 동작 회귀 여부를 판정한다.