[Feat] Apply Swagger to search DTO

Author: chltmdgh522

src/main/java/boombimapi/domain/search/presentation/dto/res/SearchHistoryRes.java

@@ -1,8 +1,12 @@
 package boombimapi.domain.search.presentation.dto.res;
 
+import io.swagger.v3.oas.annotations.media.Schema;
+
+@Schema(description = "검색 내역 조회")
 public record SearchHistoryRes(
+        @Schema(description = "검색 ID")
         Long searchId,
-
+        @Schema(description = "검색 장소 이름")
         String posName
 ) {
     public static SearchHistoryRes of(Long searchId, String posName){

src/main/java/boombimapi/domain/search/presentation/dto/res/SearchRelatedRes.java

@@ -1,6 +1,11 @@
 package boombimapi.domain.search.presentation.dto.res;
 
+import io.swagger.v3.oas.annotations.media.Schema;
+
+@Schema(description = "연관 검색어")
 public record SearchRelatedRes(
+
+        @Schema(description = "검색 장소 이름")
         String posName
 ) {
     public static SearchRelatedRes of(String posName){

src/main/java/boombimapi/domain/search/presentation/dto/res/SearchRes.java

@@ -2,29 +2,44 @@
 
 import java.time.LocalDateTime;
 
-import java.time.LocalDateTime;
+import io.swagger.v3.oas.annotations.media.Schema;
 
+@Schema(description = "검색 결과 응답 모델")
 public record SearchRes(
+
+        @Schema(description = "장소 ID", example = "12345")
         Long placeId,
+
+        @Schema(description = "장소명", example = "스타벅스 강남점")
         String posName,
-        LocalDateTime timeAt, // 가장 최신 날짜
+
+        @Schema(description = "가장 최신 날짜 그 몇분전 설명", example = "2024-12-01T14:30:00")
+        LocalDateTime timeAt,
+
+        @Schema(description = "최신 답변 유형", example = "여유", allowableValues = {"여유", "보통", "약간 붐빔", "붐빔"})
         String answerType,
+
+        @Schema(description = "주소", example = "서울특별시 강남구 테헤란로 123")
         String address,
-        String imageUrl
+
+        @Schema(description = "이미지 URL // 원래 공식만 주는게 맞는데 나중을 사용자도 올린거 다 주겠음", example = "https://example.com/image.jpg")
+        String imageUrl,
+
+        @Schema(description = "장소 유형", example = "공식 or 사용자가 올린거")
+        String placeType
+
 ) {
-    public static SearchRes of(Long id,
-                               String posName,
-                               LocalDateTime timeAt,
-                               String answerType,
-                               String address,
-                               String imageUrl) {
+    @Schema(description = "SearchRes 객체 생성을 위한 팩토리 메서드")
+    public static SearchRes of(Long id, String posName, LocalDateTime timeAt,
+                               String answerType, String address, String imageUrl, String placeType) {
         return new SearchRes(
                 id,
                 posName,
                 timeAt,
                 answerType,
                 address,
-                imageUrl
+                imageUrl,
+                placeType
         );
     }
-}
+}