fix: 공유하기 링크 404·카드 아이콘 누락 수정

[rrheon]

요약

공유하기에서 링크가 열리지 않고 공유 카드에 아이콘·제목이 빠지던 문제 수정.

🐛 버그 수정

1. 공유 링크 연결 실패 버그

• 서버 측: 배틀 상세 shareUrl이 접속 불가능한 무관한 도메인(pique.app)으로 응답됨.
• 클라이언트 폴백 측: 서버 값이 없을 때 사용하는 클라이언트 기본 링크가 존재하지 않는 복수형 경로(picke.store/battles/{id})로 설정되어 403 에러 발생 (실제 랜딩 경로는 단수형 /battle/{id}).

해결: 공유 링크 생성 PickeShareURL 추가

서버 응답 shareUrl이 picke.store(서브도메인 포함)인지 검증하여 신뢰할 수 있을 때만 사용.

도메인이 다르거나 값이 없으면, 실제 존재하는 단수형 경로(/battle/{id})로 클라이언트가 직접 생성하도록 로직을 추가
(적용: 사전투표·최종투표는 서버값 검증 후 사용, 빠른배틀은 모델에 서버값이 없어 항상 직접 생성)

2. 공유 카드에 철학자 아이콘 누락 (빈 원으로 캡처되는 현상)

원인: KFImage 비동기 로딩 특성상, ImageRenderer가 화면을 동기적으로 캡처하는 시점에는 이미지가 로드되지 않아 플레이스홀더만 찍힘.

해결:

사전/최종투표: RecapView에 적용했던 avatarOverride 패턴(QA 픽스 eebbe2d)을 PreVoteView에 적용. Kingfisher로 이미지를 선로드한 뒤 뷰에 주입하여 정상적으로 렌더링되게 수정.

빠른배틀: URLSession으로 배틀 이미지를 먼저 다운로드한 뒤 UIImage 형태로 첨부하도록 처리.

3. 최종투표 공유 카드에서 제목 문제

원인: 최종투표(post) 카드의 배경색이 밝은 beige50인데, 텍스트 색상(titleColor)도 동일한 beige50으로 설정되어 글씨가 배경에 묻힘.

해결: 스냅샷 렌더링 시점에만 titleColorOverride: .neutral500 속성을 적용.

테스트 플랜

• 사전투표 공유 → 링크 picke.store/battle/{id} 접속, 카드에 아이콘·제목 렌더
• 최종투표 공유 → 링크 동일, 밝은 배경에서 제목 가독
• 빠른배틀 공유 → 링크 정상, 배틀 이미지 첨부
• Recap 공유 → 기존과 동일(텍스트 + 카드 이미지)

[github-actions]

공유 기능 관련 버그 수정에 대한 PR을 검토했습니다.

새로운 PickeShareURL 엔티티를 도입하여 공유 링크 생성 로직을 Domain/Entity 레이어에서 일원화하고, 서버에서 잘못된 URL이 내려올 경우를 방어하는 견고한 로직을 추가했습니다. 이는 클린 아키텍처 원칙에 부합합니다.

공유 카드 스냅샷 시 아이콘(철학자 이미지) 및 제목이 올바르게 렌더링되지 않던 문제 또한 효과적으로 해결되었습니다. PreVoteView에서는 Kingfisher를 이용한 비동기 이미지 선로드 후 ImageRenderer에 주입하여 동기 렌더링 문제를 해결했고, BattleFeature에서도 URLSession을 통한 이미지 로드 및 ShareItem 구성을 적용했습니다. 또한, 최종투표(post) 화면의 제목 색상 문제를 titleColorOverride 패턴을 사용하여 수정했습니다.

TCA 컨벤션에 따라 비동기 작업(prepareShare)은 Effect.run을 통해 처리하고, state 업데이트는 InnerAction으로 분리하여 부작용을 관리하는 등 모범적인 패턴을 따르고 있습니다. SwiftUI 뷰 코드 역시 프로젝트의 @ViewBuilder 함수 패턴을 잘 준수하며 가독성 좋게 작성되었습니다.

전반적으로 설계가 견고하고, 모든 변경 사항이 명확하며 코드 품질도 높습니다. 특별히 지적할 만한 문제점은 발견되지 않았습니다.