[DEV-265/BE] feat: 회사를 검색하는 API 개발

backend/src/main/java/com/shyashyashya/refit/domain/company/api/CompanyController.java

@@ -0,0 +1,32 @@
+package com.shyashyashya.refit.domain.company.api;
+
+import static com.shyashyashya.refit.global.model.ResponseCode.COMMON200;
+
+import com.shyashyashya.refit.domain.company.api.response.CompanyResponse;
+import com.shyashyashya.refit.domain.company.service.CompanyService;
+import com.shyashyashya.refit.global.dto.ApiResponse;
+import lombok.RequiredArgsConstructor;
+import org.springdoc.core.annotations.ParameterObject;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+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
+@RequiredArgsConstructor
+@RequestMapping("/company")
+public class CompanyController {
+
+    private final CompanyService companyService;
+
+    @GetMapping
+    public ResponseEntity<ApiResponse<Page<CompanyResponse>>> findCompanies(
+            @RequestParam(required = false) String q, @ParameterObject Pageable pageable) {
+        var response = companyService.findCompanies(q, pageable);
+        var body = ApiResponse.success(COMMON200, response);
+        return ResponseEntity.ok(body);
+    }
+}

backend/src/main/java/com/shyashyashya/refit/domain/company/api/response/CompanyResponse.java

@@ -0,0 +1,3 @@
+package com.shyashyashya.refit.domain.company.api.response;
+
+public record CompanyResponse(Long companyId, String companyName) {}

backend/src/main/java/com/shyashyashya/refit/domain/company/model/Company.java

@@ -25,26 +25,35 @@ public class Company {
     @Column(name = "company_name", columnDefinition = "varchar(20)", unique = true)
     private String name;
 
+    @Column(name = "search_name", columnDefinition = "varchar(80)")
+    private String searchName;
+
     @Column(name = "company_logo_url", columnDefinition = "varchar(2048)")
     private String logoUrl;
 
     @Column(nullable = false)
     private boolean isSearchAllowed;
 
+    public void allowSearch() {
+        this.isSearchAllowed = true;
+    }
+
     /*
      Factory Method
     */
-    public static Company create(String name, String logoUrl, boolean isSearchAllowed) {
+    public static Company create(String name, String searchName, String logoUrl) {
         return Company.builder()
                 .name(name)
+                .searchName(searchName)
                 .logoUrl(logoUrl)
-                .isSearchAllowed(isSearchAllowed)
+                .isSearchAllowed(false)
                 .build();
     }
 
     @Builder(access = AccessLevel.PRIVATE)
-    private Company(String name, String logoUrl, boolean isSearchAllowed) {
+    private Company(String name, String searchName, String logoUrl, boolean isSearchAllowed) {
         this.name = name;
+        this.searchName = searchName;
         this.logoUrl = logoUrl;
         this.isSearchAllowed = isSearchAllowed;
     }

backend/src/main/java/com/shyashyashya/refit/domain/company/repository/CompanyRepository.java

@@ -1,9 +1,26 @@
 package com.shyashyashya.refit.domain.company.repository;
 
+import com.shyashyashya.refit.domain.company.api.response.CompanyResponse;
 import com.shyashyashya.refit.domain.company.model.Company;
 import java.util.Optional;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
 import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
 
 public interface CompanyRepository extends JpaRepository<Company, Long> {
     Optional<Company> findByName(String name);
+
+    @Query(value = """
+        SELECT new com.shyashyashya.refit.domain.company.api.response.CompanyResponse(c.id, c.name)
+          FROM Company c
+         WHERE LOWER(c.searchName) LIKE LOWER(CONCAT(:query, '%'))
+           AND c.isSearchAllowed = TRUE
+    """, countQuery = """
+        SELECT COUNT(c)
+          FROM Company c
+         WHERE LOWER(c.searchName) LIKE LOWER(CONCAT(:query, '%'))
+           AND c.isSearchAllowed = TRUE
+    """)
+    Page<CompanyResponse> findAllBySearchQuery(String query, Pageable pageable);
 }

backend/src/main/java/com/shyashyashya/refit/domain/company/service/CompanyService.java

@@ -0,0 +1,22 @@
+package com.shyashyashya.refit.domain.company.service;
+
+import com.shyashyashya.refit.domain.company.api.response.CompanyResponse;
+import com.shyashyashya.refit.domain.company.repository.CompanyRepository;
+import com.shyashyashya.refit.global.util.HangulUtil;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.stereotype.Service;
+
+@Service
+@RequiredArgsConstructor
+public class CompanyService {
+
+    private final CompanyRepository companyRepository;
+    private final HangulUtil hangulUtil;
+
+    public Page<CompanyResponse> findCompanies(String query, Pageable pageable) {
+        query = (query == null || query.isBlank()) ? "" : hangulUtil.decompose(query);
+        return companyRepository.findAllBySearchQuery(query, pageable);
+    }
+}

backend/src/main/java/com/shyashyashya/refit/domain/interview/service/InterviewService.java

@@ -35,6 +35,7 @@
 import com.shyashyashya.refit.domain.qnaset.repository.StarAnalysisRepository;
 import com.shyashyashya.refit.domain.user.model.User;
 import com.shyashyashya.refit.global.exception.CustomException;
+import com.shyashyashya.refit.global.util.HangulUtil;
 import com.shyashyashya.refit.global.util.RequestUserContext;
 import java.util.List;
 import java.util.Map;
@@ -62,6 +63,7 @@ public class InterviewService {
 
     private final InterviewValidator interviewValidator;
     private final RequestUserContext requestUserContext;
+    private final HangulUtil hangulUtil;
 
     @Transactional(readOnly = true)
     public InterviewDto getInterview(Long interviewId) {
@@ -238,7 +240,8 @@ private Company findOrSaveCompany(InterviewCreateRequest request) {
         return companyRepository.findByName(request.companyName()).orElseGet(() -> {
             try {
                 // TODO 회사 디폴트 이미지 url로 변경
-                Company newCompany = Company.create(request.companyName(), null, false);
+                Company newCompany =
+                        Company.create(request.companyName(), hangulUtil.decompose(request.companyName()), null);
                 return companyRepository.save(newCompany);
             } catch (DataIntegrityViolationException e) {
                 // Race condition

backend/src/main/java/com/shyashyashya/refit/global/util/HangulUtil.java

@@ -0,0 +1,57 @@
+package com.shyashyashya.refit.global.util;
+
+import org.springframework.stereotype.Component;
+
+@Component
+public class HangulUtil {
+
+    // 초성 (19자)
+    private static final char[] CHOSUNG = {
+        'ㄱ', 'ㄲ', 'ㄴ', 'ㄷ', 'ㄸ', 'ㄹ', 'ㅁ', 'ㅂ', 'ㅃ', 'ㅅ', 'ㅆ', 'ㅇ', 'ㅈ', 'ㅉ', 'ㅊ', 'ㅋ', 'ㅌ', 'ㅍ', 'ㅎ'
+    };
+
+    // 중성 (21자)
+    private static final char[] JUNGSUNG = {
+        'ㅏ', 'ㅐ', 'ㅑ', 'ㅒ', 'ㅓ', 'ㅔ', 'ㅕ', 'ㅖ', 'ㅗ', 'ㅘ', 'ㅙ', 'ㅚ', 'ㅛ', 'ㅜ', 'ㅝ', 'ㅞ', 'ㅟ', 'ㅠ', 'ㅡ', 'ㅢ', 'ㅣ'
+    };
+
+    // 종성 (28자, 0번째는 종성 없음)
+    private static final char[] JONGSUNG = {
+        '\0', 'ㄱ', 'ㄲ', 'ㄳ', 'ㄴ', 'ㄵ', 'ㄶ', 'ㄷ', 'ㄹ', 'ㄺ', 'ㄻ', 'ㄼ', 'ㄽ', 'ㄾ', 'ㄿ', 'ㅀ', 'ㅁ', 'ㅂ', 'ㅄ', 'ㅅ', 'ㅆ', 'ㅇ',
+        'ㅈ', 'ㅊ', 'ㅋ', 'ㅌ', 'ㅍ', 'ㅎ'
+    };
+
+    public String decompose(String input) {
+        StringBuilder result = new StringBuilder();
+
+        for (char c : input.toCharArray()) {
+
+            // 한글 완성형 음절이 아닌 경우는 그대로 추가
+            if (!isHangleSyllable(c)) {
+                result.append(c);
+                continue;
+            }
+
+            int code = c - 0xAC00;
+
+            int chosungIndex = code / (21 * 28);
+            int jungsungIndex = (code % (21 * 28)) / 28;
+            int jongsungIndex = code % 28;
+
+            result.append(CHOSUNG[chosungIndex]);
+            result.append(JUNGSUNG[jungsungIndex]);
+
+            // 종성이 있는 경우에만 추가
+            if (jongsungIndex > 0) {
+                result.append(JONGSUNG[jongsungIndex]);
+            }
+        }
+
+        return result.toString();
+    }
+
+    // '가' ~ '힣' 사이의 한글 완성형 음절인지 확인하는 메서드
+    public boolean isHangleSyllable(char c) {
+        return 0xAC00 <= c && c <= 0xD7A3;
+    }
+}

backend/src/test/java/com/shyashyashya/refit/core/IntegrationTest.java

@@ -16,6 +16,7 @@
 import com.shyashyashya.refit.domain.user.repository.UserRepository;
 import com.shyashyashya.refit.global.auth.service.JwtEncoder;
 import com.shyashyashya.refit.global.constant.AuthConstant;
+import com.shyashyashya.refit.global.util.HangulUtil;
 import io.restassured.RestAssured;
 import io.restassured.builder.RequestSpecBuilder;
 import io.restassured.http.ContentType;
@@ -65,6 +66,9 @@ public abstract class IntegrationTest {
     @Autowired
     private JwtEncoder jwtEncoder;
 
+    @Autowired
+    private HangulUtil hangulUtil;
+
     @Autowired
     private UserRepository userRepository;
 
@@ -91,9 +95,9 @@ void restAssuredSetUp() {
         jobCategory1 = jobCategoryRepository.save(JobCategory.create("BE Developer"));
         jobCategory2 = jobCategoryRepository.save(JobCategory.create("FE Developer"));
         jobCategory3 = jobCategoryRepository.save(JobCategory.create("Designer"));
-        company1 = companyRepository.save(Company.create("현대자동차", "logo1", true));
-        company2 = companyRepository.save(Company.create("카카오", "logo2", true));
-        company3 = companyRepository.save(Company.create("네이버", "logo3", true));
+        company1 = createAndSaveCompany("현대자동차", "logo1.jpg");
+        company2 = createAndSaveCompany("카카오", "logo2.png");
+        company3 = createAndSaveCompany("네이버", "logo3.svg");
 
         requestUser = createAndSaveUser("test@example.com", "default", industry1, jobCategory1);
         Instant issuedAt = Instant.now();
@@ -185,7 +189,14 @@ protected Interview createAndSaveInterview(InterviewCreateRequest request, Inter
     }
 
     protected Company createAndSaveCompany(String companyName) {
-        Company company = Company.create(companyName, "logo.url", true);
+        Company company = Company.create(companyName, hangulUtil.decompose(companyName), "logo.url");
+        company.allowSearch();
+        return companyRepository.save(company);
+    }
+
+    protected Company createAndSaveCompany(String companyName, String logoUrl) {
+        Company company = Company.create(companyName, hangulUtil.decompose(companyName), logoUrl);
+        company.allowSearch();
         return companyRepository.save(company);
     }
 }

backend/src/test/java/com/shyashyashya/refit/fixture/CompanyFixture.java

@@ -1,8 +1,9 @@
 package com.shyashyashya.refit.fixture;
 
 import com.shyashyashya.refit.domain.company.model.Company;
+import com.shyashyashya.refit.global.util.HangulUtil;
 
 public class CompanyFixture {
 
-    public static final Company TEST_COMPANY = Company.create("test company", "test.com/logo.png", true);
+    public static final Company TEST_COMPANY = Company.create("test company", new HangulUtil().decompose("test company"), "test.com/logo.png");
 }