Skip to content

[fix] 공유집(앨범) 목록 조회 응답에 썸네일(첫 사진 3장) 필드 누락 #99

Closed

Description

@hamtorygoals

📄 Description

공유집(앨범) 목록 조회 API(GET /api/v1/shared-groups/{sharedGroupId}/shared-albums) 응답에 썸네일 필드가 빠져 있습니다.

디자인상 공유그룹 상세 화면의 각 공유집 카드에는 사진 3장이 겹쳐진 썸네일이 노출되어야 하고, 그 중 맨 앞에 보이는 사진은 해당 공유집에 가장 먼저 저장된(오래된 순 1번째) 사진이 기준이 되어야 합니다.

현재 SharedAlbumListResponse.Item(SharedAlbumListResponse.java:15-22)에는 id, name, photoCount, createdBy, isCreator, createdAt, updatedAt만 있고 썸네일 관련 필드가 전혀 없어, 클라이언트가 카드에 사진을 그릴 수 없습니다.

참고로 SharedAlbumPhotoRepository.findRepresentativePhotoBySharedGroupId(SharedAlbumPhotoRepository.java:43-55)는 그룹 대표사진 1장을 최신순(desc) 으로 가져오는 쿼리라 이번 요구사항(공유집별 3장, 가장 먼저 저장된 순)과는 정렬 기준이 다릅니다. 새로 쿼리를 추가해야 합니다.

✅ Tasks

  • SharedAlbumListResponse.Item에 썸네일 URL 목록 필드 추가 (최대 3장)
  • SharedAlbumPhotoRepository에 공유집별 "가장 먼저 저장된 사진" N장을 오래된 순으로 조회하는 쿼리 추가
  • SharedAlbumService.toListItem에서 앨범별 썸네일 조회 및 응답 매핑 (목록 페이지당 앨범 수 × N+1 조회가 되지 않도록 배치 조회 고려)
  • Swagger 문서(SharedAlbumListResponse 설명) 반영
  • 단위/통합 테스트 추가

📎 ETC

  • 참고 화면: 공유그룹_상세 화면의 앨범 카드(잼사모음/기팟/디팟 등)에 사진 3장 스택 썸네일 노출
  • 범위: 공유집(앨범) 목록 조회 API만 (개별 공유집 상세, 사진 목록 API는 범위 밖)

Activity

  1. self-assigned this
    on Jul 16, 2026
  2. added a commit that references this issue on Jul 16, 2026
    9c34be8
  3. added a commit that references this issue on Jul 16, 2026
    fd48074
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions