feat: '카카오 ID를 통한 스토리 조회' API 구현

Author: leegwichan

src/main/java/eatda/controller/story/StoryController.java

@@ -42,4 +42,13 @@ public ResponseEntity<StoryResponse> getStory(@PathVariable long storyId) {
         return ResponseEntity.status(HttpStatus.OK)
                 .body(storyService.getStory(storyId));
     }
+
+    @GetMapping("/api/stories/kakao/{kakaoId}")
+    public ResponseEntity<StoriesDetailResponse> getStoriesByKakaoId(
+            @PathVariable String kakaoId,
+            @RequestParam(defaultValue = "5") @Min(1) @Max(50) int size
+    ) {
+        return ResponseEntity.status(HttpStatus.OK)
+                .body(storyService.getPagedStoryDetails(kakaoId, size));
+    }
 }

src/test/java/eatda/controller/story/StoryControllerTest.java

@@ -8,6 +8,7 @@
 import static org.mockito.Mockito.doThrow;
 
 import eatda.controller.BaseControllerTest;
+import eatda.controller.story.StoriesDetailResponse.StoryDetailResponse;
 import eatda.exception.BusinessErrorCode;
 import eatda.exception.BusinessException;
 import eatda.util.ImageUtils;
@@ -137,4 +138,38 @@ class GetStory {
                     .body("message", equalTo(BusinessErrorCode.STORY_NOT_FOUND.getMessage()));
         }
     }
+
+    @Nested
+    class GetPagedStoryDetailsByKakaoId {
+
+        @Test
+        void 카카오ID로_스토리_목록을_조회할_수_있다() {
+            String kakaoId = "123456";
+            List<StoryDetailResponse> mockDetails = List.of(
+                    new StoryDetailResponse(1L, "https://s3.bucket.com/story/dummy/1.jpg", 5L, "커찬"),
+                    new StoryDetailResponse(2L, "https://s3.bucket.com/story/dummy/2.jpg", 2L, "지민")
+            );
+
+            doReturn(new StoriesDetailResponse(mockDetails))
+                    .when(storyService)
+                    .getPagedStoryDetails(kakaoId, 5);
+
+            StoriesDetailResponse response = given()
+                    .pathParam("kakaoId", kakaoId)
+                    .queryParam("size", 5)
+                    .when()
+                    .get("/api/stories/kakao/{kakaoId}")
+                    .then().statusCode(200)
+                    .extract().as(StoriesDetailResponse.class);
+
+            assertAll(
+                    () -> assertThat(response.stories()).hasSize(2),
+                    () -> assertThat(response.stories().getFirst().storyId()).isEqualTo(1L),
+                    () -> assertThat(response.stories().getFirst().imageUrl()).isEqualTo(
+                            "https://s3.bucket.com/story/dummy/1.jpg"),
+                    () -> assertThat(response.stories().getFirst().memberId()).isEqualTo(5L),
+                    () -> assertThat(response.stories().getFirst().memberNickname()).isEqualTo("커찬")
+            );
+        }
+    }
 }

src/test/java/eatda/document/story/StoryDocumentTest.java

@@ -5,10 +5,15 @@
 import static org.mockito.Mockito.doReturn;
 import static org.mockito.Mockito.doThrow;
 import static org.springframework.restdocs.headers.HeaderDocumentation.headerWithName;
+import static org.springframework.restdocs.payload.JsonFieldType.ARRAY;
+import static org.springframework.restdocs.payload.JsonFieldType.NUMBER;
+import static org.springframework.restdocs.payload.JsonFieldType.STRING;
 import static org.springframework.restdocs.payload.PayloadDocumentation.fieldWithPath;
 import static org.springframework.restdocs.request.RequestDocumentation.parameterWithName;
 import static org.springframework.restdocs.request.RequestDocumentation.partWithName;
 
+import eatda.controller.story.StoriesDetailResponse;
+import eatda.controller.story.StoriesDetailResponse.StoryDetailResponse;
 import eatda.controller.story.StoriesResponse;
 import eatda.controller.story.StoryRegisterRequest;
 import eatda.controller.story.StoryRegisterResponse;
@@ -26,6 +31,8 @@
 import java.util.List;
 import org.junit.jupiter.api.Nested;
 import org.junit.jupiter.api.Test;
+import org.junit.jupiter.params.ParameterizedTest;
+import org.junit.jupiter.params.provider.EnumSource;
 import org.springframework.http.HttpHeaders;
 import org.springframework.restdocs.restassured.RestDocumentationFilter;
 
@@ -223,4 +230,68 @@ class GetStory {
                     .body("message", equalTo(BusinessErrorCode.STORY_NOT_FOUND.getMessage()));
         }
     }
+
+    @Nested
+    class GetStoriesByKakaoId {
+
+        RestDocsRequest requestDocument = request()
+                .tag(Tag.STORY_API)
+                .summary("카카오 ID로 스토리 목록 조회")
+                .description("특정 카카오 ID에 해당하는 스토리 목록을 페이지네이션하여 조회합니다.")
+                .pathParameter(
+                        parameterWithName("kakaoId").description("가게의 카카오 ID")
+                )
+                .queryParameter(
+                        parameterWithName("size").description("스토리 개수 (기본값: 5) (최소값: 1, 최대값: 50)").optional()
+                );
+
+        RestDocsResponse responseDocument = response()
+                .responseBodyField(
+                        fieldWithPath("stories").type(ARRAY).description("스토리 상세 리스트"),
+                        fieldWithPath("stories[].storyId").type(NUMBER).description("스토리 ID"),
+                        fieldWithPath("stories[].imageUrl").type(STRING).description("스토리 이미지 URL"),
+                        fieldWithPath("stories[].memberId").type(NUMBER).description("회원 ID"),
+                        fieldWithPath("stories[].memberNickname").type(STRING).description("회원 닉네임")
+                );
+
+        @Test
+        void 카카오_ID로_스토리_목록_조회_성공() {
+            String kakaoId = "123456";
+            int size = 5;
+            StoriesDetailResponse response = new StoriesDetailResponse(List.of(
+                    new StoryDetailResponse(1L, "https://dummy-s3.com/story1.png", 1L, "커찬"),
+                    new StoryDetailResponse(2L, "https://dummy-s3.com/story2.png", 2L, "준환")
+            ));
+            doReturn(response).when(storyService).getPagedStoryDetails(kakaoId, size);
+
+            var document = document("story/get-stories-by-kakao-id", 200)
+                    .request(requestDocument)
+                    .response(responseDocument)
+                    .build();
+
+            given(document)
+                    .queryParam("size", size)
+                    .header(HttpHeaders.AUTHORIZATION, accessToken())
+                    .when().get("/api/stories/kakao/{kakaoId}", kakaoId)
+                    .then().statusCode(200);
+        }
+
+        @EnumSource(value = BusinessErrorCode.class, names = {"PRESIGNED_URL_GENERATION_FAILED"})
+        @ParameterizedTest
+        void 카카오_ID로_스토리_목록_조회_실패(BusinessErrorCode errorCode) {
+            String kakaoId = "nonexistent";
+            int size = 5;
+            doThrow(new BusinessException(errorCode)).when(storyService).getPagedStoryDetails(kakaoId, size);
+
+            var document = document("story/get-stories-by-kakao-id", errorCode)
+                    .request(requestDocument)
+                    .response(ERROR_RESPONSE)
+                    .build();
+
+            given(document)
+                    .queryParam("size", size)
+                    .when().get("/api/stories/kakao/{kakaoId}", kakaoId)
+                    .then().statusCode(errorCode.getStatus().value());
+        }
+    }
 }