[Feature] 판매글 중 키워드 검색을 위한 API 구현 close #11

src/main/java/kr/warmlink/application/article/dto/ArticleDto.java

@@ -89,4 +89,34 @@ public static DetailResponse from(Article article, User user) {
                     .build();
         }
     }
+
+    @Getter
+    @Builder
+    @AllArgsConstructor
+    @Schema(name = "ArticleDto.SearchResponse", description = "검색 결과 반환을 위한 응답 DTO")
+    public static class SearchResponse {
+        @Schema(description = "게시글 id", example = "1")
+        private Long id;
+
+        @Schema(description = "게시글 제목", example = "초상화 그려드립니다.")
+        private String title;
+
+        @Schema(description = "작성자", example = "홍길동")
+        private String name;
+
+        @Schema(description = "작성일", example = "2025-06-26")
+        private LocalDateTime createdAt;
+
+        public static List<SearchResponse> from(List<Article> articles) {
+            return articles.stream()
+                    .filter(article -> article.isDeleted() == false)
+                    .map(article -> SearchResponse.builder()
+                            .id(article.getId())
+                            .name(article.getUser().getName())
+                            .title(article.getTitle())
+                            .createdAt(article.getCreatedAt())
+                            .build())
+                    .collect(Collectors.toUnmodifiableList());
+        }
+    }
 }

src/main/java/kr/warmlink/domain/article/repository/ArticleRepository.java

@@ -2,6 +2,13 @@
 
 import kr.warmlink.domain.article.entity.Article;
 import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.query.Param;
+
+import java.util.List;
 
 public interface ArticleRepository extends JpaRepository<Article, Long> {
+    @Query("SELECT a FROM article a WHERE a.title LIKE %:keyword%")
+    List<Article> findByKeyword(@Param("keyword") String keyword);
+
 }

src/main/java/kr/warmlink/domain/article/service/ArticleService.java

@@ -92,4 +92,14 @@ public ArticleDto.DetailResponse detail(HttpServletRequest request, Long id) {
 
         return ArticleDto.DetailResponse.from(article, article.getUser());
     }
+
+    @Transactional
+    public List<ArticleDto.SearchResponse> search(HttpServletRequest request, String keyword) {
+        String accessToken = jwtProvider.resolveToken(request);
+        String email = jwtProvider.getEmail(accessToken);
+
+        List<Article> result = articleRepository.findByKeyword(keyword);
+
+        return ArticleDto.SearchResponse.from(result);
+    }
 }

src/main/java/kr/warmlink/presentation/api/ArticleApi.java

@@ -9,6 +9,7 @@
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.PathVariable;
 import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestParam;
 
 @Tag(name = "[판매글 관련 API]", description = "사용자 판매글 관련 API")
 public interface ArticleApi {
@@ -47,4 +48,11 @@ public interface ArticleApi {
     })
     ResponseEntity<?> detail(HttpServletRequest request, @PathVariable Long id);
 
+    @Operation(summary = "판매글 키워드 검색", description = "특정 키워드를 검색했을 때, 게시글 목록 조회를 위한 API")
+    @ApiResponses({
+            @ApiResponse(responseCode = "200", description = "판매글 검색 성공"),
+            @ApiResponse(responseCode = "400", description = "판매글 검색 실패")
+    })
+    ResponseEntity<?> searchKeyword(HttpServletRequest request, @RequestParam String keyword);
+
 }

src/main/java/kr/warmlink/presentation/controller/ArticleController.java

@@ -49,4 +49,9 @@ public ResponseEntity<?> detail(HttpServletRequest request, Long id) {
         return ResponseEntity.ok(articleService.detail(request, id));
     }
 
+    @Override
+    @GetMapping("/search")
+    public ResponseEntity<?> searchKeyword(HttpServletRequest request, String keyword) {
+        return ResponseEntity.ok(articleService.search(request, keyword));
+    }
 }