[BACKEND] 용어사전 자동검색 및 상세 검색 API 구현, ELasticsearch 연동 (#75)

## 📝작업 내용

- Elasticsearch, Kibana 컨테이너 환경 구성

- 용어사전 자동검색 및 상세검색 구현
- GET /glossary/autocomplete?query={query}&size={size}: 사용자가 입력 중인 검색어
기반으로 연관된 용어 후보 반환
    - query와 의미상으로 부분 일치하는 용어 반환 및 prefix match
    - 대소문자 구분X
    - 동의어 검색 가능
  - GET /glossary/detail?query={query}: 입력한 용어와 완전히 일치하는 용어의 이름과 설명 반환

- spring-data-elasticsearch 의존성 추가

Author: ddoed

backend/Dockerfile.elastic

@@ -0,0 +1,4 @@
+FROM docker.elastic.co/elasticsearch/elasticsearch:8.17.4
+
+# Nori Analyzer 플러그인 설치
+RUN bin/elasticsearch-plugin install analysis-nori

backend/build.gradle

@@ -44,6 +44,8 @@ dependencies {
 
 	implementation 'org.springframework.boot:spring-boot-starter-cache'
 	implementation 'com.github.ben-manes.caffeine:caffeine'
+
+	implementation 'org.springframework.boot:spring-boot-starter-data-elasticsearch'
 }
 
 tasks.named('test') {

backend/docker-compose.yml

@@ -6,3 +6,23 @@ services:
     ports:
       - "8080:8080"
     env_file: ".env" #EC2에 올려둔 .env 사용
+
+  elastic:
+    build:
+      context: .
+      dockerfile: Dockerfile.elastic
+    container_name: elasticsearch
+    ports:
+      - "9200:9200"
+    environment:
+      - discovery.type=single-node
+      - xpack.security.enabled=false
+      - xpack.security.http.ssl.enabled=false
+
+  kibana:
+    image: docker.elastic.co/kibana/kibana:8.17.4
+    container_name: kibana
+    ports:
+      - "5601:5601"
+    environment:
+      - ELASTICSEARCH_HOSTS=http://elastic:9200

backend/src/main/java/com/cmg/comtogether/common/exception/ErrorCode.java

@@ -29,7 +29,10 @@ public enum ErrorCode {
     NAVER_API_ERROR(502, "NAVER-999", "네이버 서버와 통신 중 오류가 발생했습니다."),
 
     // 가이드
-    GUIDE_NOT_FOUND(404, "GUIDE-001", "가이드를 찾을 수 없습니다");
+    GUIDE_NOT_FOUND(404, "GUIDE-001", "가이드를 찾을 수 없습니다"),
+
+    // 용어사전
+    WORD_NOT_FOUND(404, "GLOSSARY-001", "해당 용어를 찾을 수 없습니다.");
 
     private final int status;
     private final String code;

backend/src/main/java/com/cmg/comtogether/common/security/config/SecurityConfig.java

@@ -41,7 +41,8 @@ public SecurityFilterChain securityFilterChain(HttpSecurity http, CorsConfigurat
                                 "/v3/api-docs/**",
                                 "/products/**",
                                 "/guide/**",
-                                "/users/all"
+                                "/users/all",
+                                "/glossary/**"
                         ).permitAll()
                         .anyRequest().authenticated()
                 )

backend/src/main/java/com/cmg/comtogether/glossary/controller/GlossaryController.java

@@ -0,0 +1,37 @@
+package com.cmg.comtogether.glossary.controller;
+
+import com.cmg.comtogether.common.response.ApiResponse;
+import com.cmg.comtogether.glossary.dto.GlossaryAutoCompleteResponseDto;
+import com.cmg.comtogether.glossary.dto.GlossaryDetailResponseDto;
+import com.cmg.comtogether.glossary.service.GlossaryService;
+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.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequestMapping("/glossary")
+@RequiredArgsConstructor
+public class GlossaryController {
+
+    private final GlossaryService glossaryService;
+
+    @GetMapping("/autocomplete")
+    public ResponseEntity<ApiResponse<GlossaryAutoCompleteResponseDto>> autoComplete(
+            @RequestParam String query,
+            @RequestParam(defaultValue = "5") int size
+    ) {
+        GlossaryAutoCompleteResponseDto autoComplete = glossaryService.getAutoComplete(query, size);
+        return ResponseEntity.ok(ApiResponse.success(autoComplete));
+    }
+
+    @GetMapping("/detail")
+    public ResponseEntity<ApiResponse<GlossaryDetailResponseDto>> getDetail(
+            @RequestParam String query
+    ) {
+        GlossaryDetailResponseDto detail = glossaryService.getDetail(query);
+        return ResponseEntity.ok(ApiResponse.success(detail));
+    }
+}

backend/src/main/java/com/cmg/comtogether/glossary/dto/GlossaryAutoCompleteResponseDto.java

@@ -0,0 +1,14 @@
+package com.cmg.comtogether.glossary.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+
+import java.util.List;
+
+@Getter
+@Builder
+@AllArgsConstructor
+public class GlossaryAutoCompleteResponseDto {
+    List<String> suggestions;
+}

backend/src/main/java/com/cmg/comtogether/glossary/dto/GlossaryDetailResponseDto.java

@@ -0,0 +1,13 @@
+package com.cmg.comtogether.glossary.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+
+@Getter
+@Builder
+@AllArgsConstructor
+public class GlossaryDetailResponseDto {
+    private String name;
+    private String description;
+}

backend/src/main/java/com/cmg/comtogether/glossary/entity/GlossaryDocument.java

@@ -0,0 +1,32 @@
+package com.cmg.comtogether.glossary.entity;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import org.springframework.data.annotation.Id;
+import org.springframework.data.elasticsearch.annotations.*;
+
+@Getter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@Document(indexName = "glossary")
+@Setting(settingPath = "/elasticsearch/glossary-settings.json")
+public class GlossaryDocument {
+
+    @Id
+    private String id;
+
+    @MultiField(
+            mainField = @Field(type = FieldType.Text, analyzer = "glossary_name_analyzer"),
+            otherFields = {
+                    @InnerField(suffix = "auto_complete", type = FieldType.Search_As_You_Type),
+                    @InnerField(suffix = "raw", type = FieldType.Keyword)
+            }
+    )
+    private String name;
+
+    @Field(type = FieldType.Keyword)
+    private String description;
+}

backend/src/main/java/com/cmg/comtogether/glossary/repository/GlossaryRepository.java

@@ -0,0 +1,9 @@
+package com.cmg.comtogether.glossary.repository;
+
+import com.cmg.comtogether.glossary.entity.GlossaryDocument;
+import org.springframework.data.elasticsearch.repository.ElasticsearchRepository;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public interface GlossaryRepository extends ElasticsearchRepository<GlossaryDocument, String> {
+}