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

1.1 KiB

id, status
id status
ac-0001 active

포트폴리오 목록의 ledger 투자금 집계 필드

Criterion

GET /v1/portfolios의 각 PortfolioItem은 기존 응답 필드를 유지하면서 net_contributed_capital과 cumulative_profit_withdrawn을 float 값으로 포함해야 한다. 전자는 순투자현금, 후자는 누적 수익 인출액을 뜻하며, 해당 portfolio에 유효한 manual ledger가 없거나 집계 결과가 없으면 두 값은 각각 0.0이어야 한다.

Verification

  • 성공 조건: ledger 집계가 있는 portfolio는 두 필드에 해당 집계값을 반환하고, ledger 집계가 없는 portfolio는 두 필드를 0.0으로 반환한다.
  • 실패·경계 조건: 빈 목록은 portfolios: [], total: 0을 반환하며 신규 필드 추가 때문에 기존 응답 필드가 제거되거나 값의 의미가 바뀌지 않는다.
  • 검사 방법: tests/test_v1_portfolios_list.py의 목록 집계값 결합·기본값·빈 목록·기존 필드 회귀 테스트와 OpenAPI schema의 PortfolioItem을 검사한다.