♻️ feat(api): add search term recommend

backend/streetdrop-admin/streetdrop-admin-server/src/main/java/com/depromeet/domains/recommend/search/controller/SearchRecommendController.java

@@ -0,0 +1,23 @@
+package com.depromeet.domains.recommend.search.controller;
+
+import com.depromeet.domains.recommend.search.service.SearchRecommendService;
+import com.depromeet.domains.user.dto.ResponseDto;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequestMapping("/search-term/recommend")
+@RequiredArgsConstructor
+public class SearchRecommendController {
+
+    private final SearchRecommendService searchRecommendService;
+    @PostMapping
+    public ResponseEntity<Void> addRecommendSearchTerm() {
+        searchRecommendService.addRecommendSearchTerm();
+        return ResponseDto.noContent();
+    }
+
+}

backend/streetdrop-admin/streetdrop-admin-server/src/main/java/com/depromeet/domains/recommend/search/repository/SearchRecommendTermRepository.java

@@ -0,0 +1,7 @@
+package com.depromeet.domains.recommend.search.repository;
+
+import com.depromeet.recommend.search.SearchRecommendTerm;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface SearchRecommendTermRepository extends JpaRepository<SearchRecommendTerm, Long> {
+}

backend/streetdrop-admin/streetdrop-admin-server/src/main/java/com/depromeet/domains/recommend/search/service/SearchRecommendService.java

@@ -0,0 +1,24 @@
+package com.depromeet.domains.recommend.search.service;
+
+import com.depromeet.domains.recommend.search.repository.SearchRecommendTermRepository;
+import com.depromeet.recommend.search.DescriptionTextVo;
+import com.depromeet.recommend.search.SearchRecommendTerm;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+
+import java.util.Arrays;
+import java.util.List;
+
+@Service
+@RequiredArgsConstructor
+public class SearchRecommendService {
+    private final SearchRecommendTermRepository searchRecommendTermRepository;
+
+    public void addRecommendSearchTerm() {
+        var title = "검색 추천어";
+        var description = List.of(new DescriptionTextVo("검색 추천어 설명", "#000000"));
+        var terms = Arrays.asList("검색 추천어1", "검색 추천어2", "검색 추천어3");
+        SearchRecommendTerm searchRecommendTerm = new SearchRecommendTerm(title, description, terms);
+        searchRecommendTermRepository.save(searchRecommendTerm);
+    }
+}

backend/streetdrop-api/src/main/java/com/depromeet/domains/recommend/controller/SearchRecommendController.java

@@ -0,0 +1,28 @@
+package com.depromeet.domains.recommend.controller;
+
+import com.depromeet.common.dto.ResponseDto;
+import com.depromeet.domains.recommend.dto.response.SearchTermRecommendResponseDto;
+import com.depromeet.domains.recommend.service.SearchRecommendService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequestMapping("/search-term/recommend")
+@RequiredArgsConstructor
+@Tag(name = "SearchRecommend", description = "Search Recommend API")
+public class SearchRecommendController {
+    private final SearchRecommendService searchRecommendService;
+
+    @Operation(summary = "Recommend Search Term")
+    @GetMapping
+    public ResponseEntity<SearchTermRecommendResponseDto> recommendSearchTerm() {
+        var response = searchRecommendService.recommendSearchTerm();
+        return ResponseDto.ok(response);
+    }
+
+}

backend/streetdrop-api/src/main/java/com/depromeet/domains/recommend/dto/response/SearchTermRecommendResponseDto.java

@@ -0,0 +1,15 @@
+package com.depromeet.domains.recommend.dto.response;
+
+
+import com.depromeet.recommend.search.DescriptionTextVo;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.List;
+
+@AllArgsConstructor
+@Getter
+public class SearchTermRecommendResponseDto {
+    private final List<DescriptionTextVo> description;
+    private final List<String> terms;
+}

backend/streetdrop-api/src/main/java/com/depromeet/domains/recommend/repository/SearchRecommendTermRepository.java

@@ -0,0 +1,12 @@
+package com.depromeet.domains.recommend.repository;
+
+import com.depromeet.recommend.search.SearchRecommendTerm;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
+
+import java.util.Optional;
+
+public interface SearchRecommendTermRepository extends JpaRepository<SearchRecommendTerm, Long> {
+    @Query(value = "SELECT s FROM SearchRecommendTerm s ORDER BY RAND() LIMIT 1")
+    Optional<SearchRecommendTerm> getRandomSearchRecommendTerm();
+}

backend/streetdrop-api/src/main/java/com/depromeet/domains/recommend/service/SearchRecommendService.java

@@ -0,0 +1,24 @@
+package com.depromeet.domains.recommend.service;
+
+import com.depromeet.domains.recommend.dto.response.SearchTermRecommendResponseDto;
+import com.depromeet.domains.recommend.repository.SearchRecommendTermRepository;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+
+@Service
+@RequiredArgsConstructor
+public class SearchRecommendService {
+
+    private final SearchRecommendTermRepository searchRecommendTermRepository;
+
+    public SearchTermRecommendResponseDto recommendSearchTerm() {
+        var recommendTerm = searchRecommendTermRepository.getRandomSearchRecommendTerm().orElseThrow(
+                () -> new RuntimeException("검색 추천어가 존재하지 않습니다.")
+        );
+
+        var description = recommendTerm.getDescription();
+        var termList = recommendTerm.getTerms();
+
+        return new SearchTermRecommendResponseDto(description, termList);
+    }
+}

backend/streetdrop-api/src/main/resources/db/migration/V20230822__add_search_term_recommend.sql

@@ -0,0 +1,7 @@
+CREATE TABLE search_recommend_term (
+    search_recommend_term_id BIGINT NOT NULL AUTO_INCREMENT,
+    title VARCHAR(255) NOT NULL,
+    description JSON NOT NULL,
+    terms JSON NOT NULL,
+    PRIMARY KEY (search_recommend_term_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

backend/streetdrop-domain/build.gradle

@@ -10,6 +10,8 @@ dependencies {
     implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
     implementation 'org.hibernate:hibernate-spatial:6.2.2.Final'
     implementation 'org.locationtech.jts:jts-core'
+    implementation 'io.hypersistence:hypersistence-utils-hibernate-60:3.5.1'
+    implementation 'com.fasterxml.jackson.module:jackson-module-jakarta-xmlbind-annotations:2.15.2'
 
     implementation "com.querydsl:querydsl-jpa:5.0.0:jakarta"
     annotationProcessor "com.querydsl:querydsl-apt:5.0.0:jakarta"

backend/streetdrop-domain/src/main/java/com/depromeet/recommend/search/DescriptionTextVo.java

@@ -0,0 +1,16 @@
+package com.depromeet.recommend.search;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+import static lombok.AccessLevel.PROTECTED;
+
+@Getter
+@NoArgsConstructor(access = PROTECTED)
+@AllArgsConstructor
+public class DescriptionTextVo {
+    private String text;
+
+    private String color;
+}

backend/streetdrop-domain/src/main/java/com/depromeet/recommend/search/SearchRecommendTerm.java

@@ -0,0 +1,47 @@
+package com.depromeet.recommend.search;
+
+import io.hypersistence.utils.hibernate.type.json.JsonType;
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.Id;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import org.hibernate.annotations.Type;
+
+import java.util.List;
+
+import static jakarta.persistence.GenerationType.IDENTITY;
+import static lombok.AccessLevel.PROTECTED;
+
+@Getter
+@NoArgsConstructor(access = PROTECTED)
+@Entity
+public class SearchRecommendTerm {
+
+    @Id
+    @GeneratedValue(strategy = IDENTITY)
+    @Column(name = "search_recommend_term_id")
+    private Long id;
+
+    @Column(nullable = false)
+    private String title;
+
+    @Column(nullable = false, columnDefinition = "json")
+    @Type(value = JsonType.class)
+    private List<DescriptionTextVo> description;
+
+    @Column(nullable = false, columnDefinition = "json")
+    @Type(value = JsonType.class)
+    private List<String> terms;
+
+    @Column(nullable = false)
+    private boolean active;
+
+    public SearchRecommendTerm(String title, List<DescriptionTextVo> description, List<String> terms) {
+        this.title = title;
+        this.description = description;
+        this.terms = terms;
+        this.active = true;
+    }
+}