portfolio-hub/.proofline/criteria/ac-0017.md

id, status

id	status
ac-0017	active

포트폴리오 ID-only 요청과 응답 호환성 계약

Criterion

/v1/portfolios와 legacy /portfolios의 생성은 strategy_id를 생략하거나 null로 전달해도 가능해야 하며, 이 경우 전략 참조를 만들거나 기본 전략을 암묵적으로 선택해서는 안 된다. strategy_id가 제공된 생성·수정은 ID-only여야 하고 기존 active 전략 ID만 선택할 수 있으며, 요청의 strategy_name·strategy_params는 422로 거부해야 한다. v1 PortfolioItem 응답은 현재 참조 전략의 active_strategy_id·strategy_nick·strategy_name·strategy_params·strategy_revision을 같은 committed row에서 반환해야 하고 참조가 없거나 해석할 수 없으면 이 전략 메타데이터는 null이어야 하며, legacy 응답의 기존 호환 필드는 유지되어야 한다.

Verification

• 성공 조건: strategy ID 없이 또는 null로 포트폴리오가 생성되고 전략 참조와 전략 메타데이터가 모두 null이며, 기본 전략이 자동 연결되지 않는다. 명시한 active ID로 생성·수정하면 v1 create/PATCH/list 응답에 현재 전략 ID·nick·이름·config·revision이 나타난다.
• 실패·경계 조건: 제공된 unknown ID는 404, inactive ID는 409이며, 제거 필드·빈 문자열·malformed 요청은 새 전략 row를 만들지 않고 422다.
• 검사 방법: v1·legacy create/update schema와 저장소 row count, strategy 미지정·explicit null·active/unknown/inactive ID의 create read-back, v1 create/PATCH/list 전략 메타데이터 및 기존 응답 호환 필드를 API/CLI 회귀로 검사한다.
• 현재 구현 평가: v1 schema와 API는 strategy 미지정·null 생성을 구현하고 회귀 테스트가 이를 검사한다. legacy /portfolios schema와 생성 경로는 아직 strategy_id를 필수로 유지하므로 전체 계약의 executable coverage는 PARTIAL이며, legacy 동등 구현과 read-back 회귀가 필요하다.