클론 제거 뒤 낡은 토너먼트·위시 API 문서 정리 #1243

왜

클론 제거 뒤 남은 서술

• 클론 토너먼트를 없앤 CLONE 개념 제거 - 애그리거트 경계를 바로잡아 토너먼트(정의)와 플레이(진행)를 분리 #1027 뒤에도 토너먼트 API 문서가 클론을 만드는 흐름으로 설명함
  • 예시: 목록 필터의 CLONE, 플레이 링크가 원본을 복제, 기존 본인 클론 id 반환
  • 예시 응답에 클론 진행 중 모양(isRoot=false)이 남음
• 응답의 isRoot·sourceTournamentId 는 지금 고정값인데 문서는 클론을 전제로 설명함

코드와 다른 계약 서술

• 한도 초과 429 의 code 를 WISH-010·TOURNAMENT-037 로 안내함
  • 실제 code: ITEM-006
• 던지는 곳 없는 403 사유와 example 2쌍
  • 그룹 결과의 복제 토너먼트 조회 불가
  • 플레이 링크 생성의 복제 토너먼트 생성 불가
• 시작 403 의 "소유자 아님" 사유. 실제로는 참여자가 아닐 때만 403
• 후보 수정 400 이 두 번 선언됨
• 선언한 사유의 example 누락 3건과 PRODUCTIMAGE-002 설명 누락
• READY 이거나 시작한 토너먼트 후보인데 imageUrl 이 빈 example 5곳

발견 경위

• 참조: 파싱 성공 시점의 버전 생성과 아이템 확정 (2단계) #1180 작업 중 문서 점검(2026-10-20)에서 그 브랜치 전부터 낡은 것으로 분류

무엇을

토너먼트·위시 API 문서를 지금 동작에 맞춤

• 대상: *Api.kt 설명·@ApiResponse, *ApiExamples, 응답 DTO 주석
• 던지는 곳 없는 예외 팩토리와 에러 코드는 삭제하고 번호는 결번으로 둠
• 서비스 주석의 클론 서술 정리

범위

• 예외: 파싱 성공 단계(파싱 성공 시점의 버전 생성과 아이템 확정 (2단계) #1180)가 바꾼 문서는 그 PR 에서 처리