feat: region 관련 관리 기능 추가

src/main/java/com/example/solidconnection/admin/location/region/controller/AdminRegionController.java

@@ -0,0 +1,58 @@
+package com.example.solidconnection.admin.location.region.controller;
+
+import com.example.solidconnection.admin.location.region.dto.AdminRegionCreateRequest;
+import com.example.solidconnection.admin.location.region.dto.AdminRegionResponse;
+import com.example.solidconnection.admin.location.region.dto.AdminRegionUpdateRequest;
+import com.example.solidconnection.admin.location.region.service.AdminRegionService;
+import jakarta.validation.Valid;
+import java.util.List;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RequiredArgsConstructor
+@RequestMapping("/admin/regions")
+@RestController
+public class AdminRegionController {
+
+    private final AdminRegionService adminRegionService;
+
+    @GetMapping
+    public ResponseEntity<List<AdminRegionResponse>> getAllRegions() {
+        List<AdminRegionResponse> responses = adminRegionService.getAllRegions();
+        return ResponseEntity.ok(responses);
+    }
+
+    @PostMapping
+    public ResponseEntity<AdminRegionResponse> createRegion(
+            @Valid @RequestBody AdminRegionCreateRequest request
+    ) {
+        AdminRegionResponse response = adminRegionService.createRegion(request);
+        return ResponseEntity.status(HttpStatus.CREATED).body(response);
+    }
+
+    @PutMapping("/{code}")
+    public ResponseEntity<AdminRegionResponse> updateRegion(
+            @PathVariable String code,
+            @Valid @RequestBody AdminRegionUpdateRequest request
+    ) {
+        AdminRegionResponse response = adminRegionService.updateRegion(code, request);
+        return ResponseEntity.ok(response);
+    }
+
+    @DeleteMapping("/{code}")
+    public ResponseEntity<Void> deleteRegion(
+            @PathVariable String code
+    ) {
+        adminRegionService.deleteRegion(code);
+        return ResponseEntity.noContent().build();
+    }
+}

src/main/java/com/example/solidconnection/admin/location/region/dto/AdminRegionCreateRequest.java

@@ -0,0 +1,16 @@
+package com.example.solidconnection.admin.location.region.dto;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+
+public record AdminRegionCreateRequest(
+        @NotBlank(message = "지역 코드는 필수입니다")
+        @Size(min = 1, max = 10, message = "지역 코드는 1자 이상 10자 이하여야 합니다")
+        String code,
+
+        @NotBlank(message = "한글 지역명은 필수입니다")
+        @Size(min = 1, max = 100, message = "한글 지역명은 1자 이상 100자 이하여야 합니다")
+        String koreanName
+) {
+
+}

src/main/java/com/example/solidconnection/admin/location/region/dto/AdminRegionResponse.java

@@ -0,0 +1,14 @@
+package com.example.solidconnection.admin.location.region.dto;
+
+import com.example.solidconnection.location.region.domain.Region;
+
+public record AdminRegionResponse(
+        String code
+) {
+
+    public static AdminRegionResponse from(Region region) {
+        return new AdminRegionResponse(
+                region.getCode()
+        );
+    }
+}

src/main/java/com/example/solidconnection/admin/location/region/dto/AdminRegionUpdateRequest.java

@@ -0,0 +1,12 @@
+package com.example.solidconnection.admin.location.region.dto;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+
+public record AdminRegionUpdateRequest(
+        @NotBlank(message = "한글 지역명은 필수입니다")
+        @Size(min = 1, max = 100, message = "한글 지역명은 1자 이상 100자 이하여야 합니다")
+        String koreanName
+) {
+
+}

src/main/java/com/example/solidconnection/admin/location/region/service/AdminRegionService.java

@@ -0,0 +1,72 @@
+package com.example.solidconnection.admin.location.region.service;
+
+import com.example.solidconnection.admin.location.region.dto.AdminRegionCreateRequest;
+import com.example.solidconnection.admin.location.region.dto.AdminRegionResponse;
+import com.example.solidconnection.admin.location.region.dto.AdminRegionUpdateRequest;
+import com.example.solidconnection.common.exception.CustomException;
+import com.example.solidconnection.common.exception.ErrorCode;
+import com.example.solidconnection.location.region.domain.Region;
+import com.example.solidconnection.location.region.repository.RegionRepository;
+import java.util.List;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+@Service
+@RequiredArgsConstructor
+public class AdminRegionService {
+
+    private final RegionRepository regionRepository;
+
+    @Transactional(readOnly = true)
+    public List<AdminRegionResponse> getAllRegions() {
+        return regionRepository.findAll()
+                .stream()
+                .map(AdminRegionResponse::from)
+                .toList();
+    }
+
+    @Transactional
+    public AdminRegionResponse createRegion(AdminRegionCreateRequest request) {
+        regionRepository.findById(request.code())
+                .ifPresent(region -> {
+                    throw new CustomException(ErrorCode.REGION_ALREADY_EXISTS);
+                });
+
+        regionRepository.findByKoreanName(request.koreanName())
+                .ifPresent(region -> {
+                    throw new CustomException(ErrorCode.REGION_ALREADY_EXISTS);
+                });
+
+        Region region = new Region(request.code(), request.koreanName());
+        Region savedRegion = regionRepository.save(region);
+
+        return AdminRegionResponse.from(savedRegion);
+    }
+
+    @Transactional
+    public AdminRegionResponse updateRegion(String code, AdminRegionUpdateRequest request) {
+        Region region = regionRepository.findById(code)
+                .orElseThrow(() -> new CustomException(ErrorCode.REGION_NOT_FOUND));
+
+        regionRepository.findByKoreanName(request.koreanName())
+                .ifPresent(existingRegion -> {
+                    if (!existingRegion.getCode().equals(code)) {
+                        throw new CustomException(ErrorCode.REGION_ALREADY_EXISTS);
+                    }
+                });
+
+        Region updatedRegion = new Region(region.getCode(), request.koreanName());
+        Region savedRegion = regionRepository.save(updatedRegion);
+
+        return AdminRegionResponse.from(savedRegion);
+    }
+
+    @Transactional
+    public void deleteRegion(String code) {
+        Region region = regionRepository.findById(code)
+                .orElseThrow(() -> new CustomException(ErrorCode.REGION_NOT_FOUND));
+
+        regionRepository.delete(region);
+    }
+}

src/main/java/com/example/solidconnection/common/exception/ErrorCode.java

@@ -38,7 +38,9 @@ public enum ErrorCode {
     APPLICATION_NOT_FOUND(HttpStatus.NOT_FOUND.value(), "사용자의 대학 지원 정보를 찾을 수 없습니다."),
     USER_NOT_FOUND(HttpStatus.NOT_FOUND.value(), "회원을 찾을 수 없습니다."),
     UNIVERSITY_NOT_FOUND(HttpStatus.NOT_FOUND.value(), "대학교를 찾을 수 없습니다."),
+    REGION_NOT_FOUND(HttpStatus.NOT_FOUND.value(), "지역을 찾을 수 없습니다."),
     REGION_NOT_FOUND_BY_KOREAN_NAME(HttpStatus.NOT_FOUND.value(), "이름에 해당하는 지역을 찾을 수 없습니다."),
+    REGION_ALREADY_EXISTS(HttpStatus.CONFLICT.value(), "이미 존재하는 지역입니다."),
     COUNTRY_NOT_FOUND_BY_KOREAN_NAME(HttpStatus.NOT_FOUND.value(), "이름에 해당하는 국가를 찾을 수 없습니다."),
     GPA_SCORE_NOT_FOUND(HttpStatus.NOT_FOUND.value(), "존재하지 않는 학점입니다."),
     LANGUAGE_TEST_SCORE_NOT_FOUND(HttpStatus.NOT_FOUND.value(), "존재하지 않는 어학성적입니다."),

src/main/java/com/example/solidconnection/location/region/repository/RegionRepository.java

@@ -5,7 +5,7 @@
 import java.util.Optional;
 import org.springframework.data.jpa.repository.JpaRepository;
 
-public interface RegionRepository extends JpaRepository<Region, Long> {
+public interface RegionRepository extends JpaRepository<Region, String> {
 
     List<Region> findAllByKoreanNameIn(List<String> koreanNames);
 

src/test/java/com/example/solidconnection/admin/location/region/service/AdminRegionServiceTest.java

@@ -0,0 +1,197 @@
+package com.example.solidconnection.admin.location.region.service;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.assertj.core.api.Assertions.assertThatCode;
+
+import com.example.solidconnection.admin.location.region.dto.AdminRegionCreateRequest;
+import com.example.solidconnection.admin.location.region.dto.AdminRegionResponse;
+import com.example.solidconnection.admin.location.region.dto.AdminRegionUpdateRequest;
+import com.example.solidconnection.common.exception.CustomException;
+import com.example.solidconnection.common.exception.ErrorCode;
+import com.example.solidconnection.location.region.domain.Region;
+import com.example.solidconnection.location.region.fixture.RegionFixture;
+import com.example.solidconnection.location.region.repository.RegionRepository;
+import com.example.solidconnection.support.TestContainerSpringBootTest;
+import java.util.List;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Nested;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+
+@TestContainerSpringBootTest
+@DisplayName("지역 관련 관리자 서비스 테스트")
+class AdminRegionServiceTest {
+
+    @Autowired
+    private AdminRegionService adminRegionService;
+
+    @Autowired
+    private RegionRepository regionRepository;
+
+    @Autowired
+    private RegionFixture regionFixture;
+
+    @Nested
+    class 전체_지역_조회 {
+
+        @Test
+        void 지역이_없으면_빈_목록을_반환한다() {
+            // when
+            List<AdminRegionResponse> responses = adminRegionService.getAllRegions();
+
+            // then
+            assertThat(responses).isEqualTo(List.of());
+        }
+
+        @Test
+        @DisplayName("저장된 모든 지역을 조회한다")
+        void 저장된_모든_지역을_조회한다() {
+            // given
+            Region region1 = regionFixture.영미권();
+            Region region2 = regionFixture.유럽();
+            Region region3 = regionFixture.아시아();
+
+            // when
+            List<AdminRegionResponse> responses = adminRegionService.getAllRegions();
+
+            // then
+            assertThat(responses)
+                    .hasSize(3)
+                    .extracting(AdminRegionResponse::code)
+                    .containsExactlyInAnyOrder(
+                            region1.getCode(),
+                            region2.getCode(),
+                            region3.getCode()
+                    );
+        }
+    }
+
+    @Nested
+    class 지역_생성 {
+
+        @Test
+        void 유효한_정보로_지역을_생성하면_성공한다() {
+            // given
+            AdminRegionCreateRequest request = new AdminRegionCreateRequest("KR_SEOUL", "서울");
+
+            // when
+            AdminRegionResponse response = adminRegionService.createRegion(request);
+
+            // then
+            assertThat(response.code()).isEqualTo("KR_SEOUL");
+
+            // 데이터베이스에 저장되었는지 확인
+            Region savedRegion = regionRepository.findById(request.code()).orElseThrow();
+            assertThat(savedRegion.getKoreanName()).isEqualTo(request.koreanName());
+        }
+
+        @Test
+        void 이미_존재하는_코드로_지역을_생성하면_예외_응답을_반환한다() {
+            // given
+            regionFixture.영미권();
+
+            AdminRegionCreateRequest request = new AdminRegionCreateRequest("AMERICAS", "새로운 영미권");
+
+            // when & then
+            assertThatCode(() -> adminRegionService.createRegion(request))
+                    .isInstanceOf(CustomException.class)
+                    .hasMessage(ErrorCode.REGION_ALREADY_EXISTS.getMessage());
+        }
+
+        @Test
+        void 이미_존재하는_한글명으로_지역을_생성하면_예외_응답을_반환한다() {
+            // given
+            regionFixture.유럽();
+
+            AdminRegionCreateRequest request = new AdminRegionCreateRequest("NEW_CODE", "유럽");
+
+            // when & then
+            assertThatCode(() -> adminRegionService.createRegion(request))
+                    .isInstanceOf(CustomException.class)
+                    .hasMessage(ErrorCode.REGION_ALREADY_EXISTS.getMessage());
+        }
+    }
+
+    @Nested
+    class 지역_수정 {
+
+        @Test
+        void 유효한_정보로_지역을_수정하면_성공한다() {
+            // given
+            Region region = regionFixture.영미권();
+
+            AdminRegionUpdateRequest request = new AdminRegionUpdateRequest("미주");
+
+            // when
+            AdminRegionResponse response = adminRegionService.updateRegion(region.getCode(), request);
+
+            // then
+            assertThat(response.code()).isEqualTo(region.getCode());
+            Region updatedRegion = regionRepository.findById(region.getCode()).orElseThrow();
+            assertThat(updatedRegion.getKoreanName()).isEqualTo(request.koreanName());
+        }
+
+        @Test
+        void 존재하지_않는_지역_코드로_수정하면_예외_응답을_반환한다() {
+            // given
+            AdminRegionUpdateRequest request = new AdminRegionUpdateRequest("부산");
+
+            // when & then
+            assertThatCode(() -> adminRegionService.updateRegion("NOT_EXIST", request))
+                    .isInstanceOf(CustomException.class)
+                    .hasMessage(ErrorCode.REGION_NOT_FOUND.getMessage());
+        }
+
+        @Test
+        void 다른_지역의_한글명으로_수정하면_예외_응답을_반환한다() {
+            // given
+            Region region1 = regionFixture.영미권();
+            Region region2 = regionFixture.유럽();
+
+            AdminRegionUpdateRequest request = new AdminRegionUpdateRequest(region2.getKoreanName());
+
+            // when & then
+            assertThatCode(() -> adminRegionService.updateRegion(region1.getCode(), request))
+                    .isInstanceOf(CustomException.class)
+                    .hasMessage(ErrorCode.REGION_ALREADY_EXISTS.getMessage());
+        }
+
+        @Test
+        void 같은_지역의_한글명으로_수정하면_성공한다() {
+            // given
+            Region region = regionFixture.아시아();
+
+            AdminRegionUpdateRequest request = new AdminRegionUpdateRequest(region.getKoreanName());
+
+            // when
+            AdminRegionResponse response = adminRegionService.updateRegion(region.getCode(), request);
+
+            // then
+            assertThat(response.code()).isEqualTo(region.getCode());
+        }
+    }
+
+    @Nested
+    class 지역_삭제 {
+
+        @Test
+        void 존재하는_지역을_삭제하면_성공한다() {
+            // given
+            Region region = regionFixture.영미권();
+
+            // when
+            adminRegionService.deleteRegion(region.getCode());
+
+            // then
+            assertThat(regionRepository.findById(region.getCode())).isEmpty();
+        }
+
+        @Test
+        void 존재하지_않는_지역을_삭제하면_예외_응답을_반환한다() {
+            // when & then
+            assertThatCode(() -> adminRegionService.deleteRegion("NOT_EXIST"))
+                    .isInstanceOf(CustomException.class)
+                    .hasMessage(ErrorCode.REGION_NOT_FOUND.getMessage());
+        }
+    }
+}