[FEAT] 통계 단어 검색 시 최근 사용자가 기록한 단어 목록 조회 기능 구현

src/main/java/com/movelog/domain/record/application/KeywordService.java

@@ -4,6 +4,7 @@
 import com.movelog.domain.record.domain.Record;
 import com.movelog.domain.record.domain.repository.RecordRepository;
 import com.movelog.domain.record.dto.response.MyKeywordStatsRes;
+import com.movelog.domain.record.dto.response.RecommendKeywordInStatsRes;
 import com.movelog.domain.record.dto.response.SearchKeywordInStatsRes;
 import com.movelog.domain.record.exception.KeywordNotFoundException;
 import com.movelog.domain.record.domain.repository.KeywordRepository;
@@ -56,6 +57,10 @@ public List<SearchKeywordInStatsRes> searchKeywordInStats(UserPrincipal userPrin
     public MyKeywordStatsRes getMyKeywordStatsRes(UserPrincipal userPrincipal, Long keywordId) {
         validUserById(userPrincipal);
         Keyword keyword = validKeywordById(keywordId);
+        // 사용자가 기록한 키워드가 아닐 시, 빈 배열 반환
+        if (!keyword.getUser().getId().equals(userPrincipal.getId())) {
+            return MyKeywordStatsRes.builder().build();
+        }
 
         return MyKeywordStatsRes.builder()
                 .noun(keyword.getKeyword())
@@ -124,9 +129,21 @@ private double roundToTwoDecimal(double value) {
         return Math.round(value * 100) / 100.0;
     }
 
+    public List<RecommendKeywordInStatsRes> getRecommendKeywords(UserPrincipal userPrincipal) {
+        User user = validUserById(userPrincipal);
+        List<Keyword> keywords = keywordRepository.findTop5ByUserOrderByCreatedAtDesc(user);
+
+        return keywords.stream()
+                .map(keyword -> RecommendKeywordInStatsRes.builder()
+                        .keywordId(keyword.getKeywordId())
+                        .noun(keyword.getKeyword())
+                        .build())
+                .toList();
+    }
+
     private User validUserById(UserPrincipal userPrincipal) {
-        // Optional<User> userOptional = userService.findById(userPrincipal.getId());
-        Optional<User> userOptional = userRepository.findById(5L);
+        Optional<User> userOptional = userService.findById(userPrincipal.getId());
+        // Optional<User> userOptional = userRepository.findById(5L);
         if (userOptional.isEmpty()) { throw new UserNotFoundException(); }
         return userOptional.get();
     }
@@ -137,4 +154,5 @@ private Keyword validKeywordById(Long keywordId) {
         return keywordOptional.get();
     }
 
+
 }

src/main/java/com/movelog/domain/record/dto/response/RecommendKeywordInStatsRes.java

@@ -0,0 +1,19 @@
+package com.movelog.domain.record.dto.response;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Builder
+@AllArgsConstructor
+@NoArgsConstructor
+@Getter
+public class RecommendKeywordInStatsRes {
+    @Schema( type = "int", example = "1", description="추천 키워드 ID")
+    private Long keywordId;
+
+    @Schema( type = "String", example ="헬스", description="추천 키워드(명사)")
+    private String noun;
+}

src/main/java/com/movelog/domain/record/presentation/StatsController.java

@@ -2,6 +2,7 @@
 
 import com.movelog.domain.record.application.KeywordService;
 import com.movelog.domain.record.dto.response.MyKeywordStatsRes;
+import com.movelog.domain.record.dto.response.RecommendKeywordInStatsRes;
 import com.movelog.domain.record.dto.response.SearchKeywordInStatsRes;
 import com.movelog.global.config.security.token.UserPrincipal;
 import com.movelog.global.payload.ErrorResponse;
@@ -64,6 +65,21 @@ public ResponseEntity<?> getMyKeywordStats(
         return ResponseEntity.ok(response);
     }
 
+    @Operation(summary = "통계 추천 단어 조회 API", description = "사용자가 최근 기록한 단어 목록(최대 5개)을 조회하는 API입니다.")
+    @ApiResponses(value = {
+            @ApiResponse(responseCode = "200", description = "통계 추천 단어 조회 성공",
+                    content = @Content(mediaType = "application/json",
+                            schema = @Schema(type = "array", implementation = RecommendKeywordInStatsRes.class))),
+            @ApiResponse(responseCode = "400", description = "통계 추천 단어 조회 실패",
+                    content = @Content(mediaType = "application/json", schema = @Schema(implementation = ErrorResponse.class)))
+    })
+    @GetMapping("/word/recommend")
+    public ResponseEntity<?> getRecommendKeywords(
+        @Parameter(description = "Access Token을 입력해주세요.", required = true) @AuthenticationPrincipal UserPrincipal userPrincipal
+        ) {
+        List<RecommendKeywordInStatsRes> response = keywordService.getRecommendKeywords(userPrincipal);
+        return ResponseEntity.ok(response);
+    }
 
 
 }