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,16 @@
+package com.example.solidconnection.admin.location.region.dto;
+
+import com.example.solidconnection.location.region.domain.Region;
+
+public record AdminRegionResponse(
+ String code,
+ String koreanName
+) {
+
+ public static AdminRegionResponse from(Region region) {
+ return new AdminRegionResponse(
+ region.getCode(),
+ region.getKoreanName()
+ );
+ }
+}

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,81 @@
+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) {
+ validateCodeNotExists(request.code());
+ validateKoreanNameNotExists(request.koreanName());
+
+ Region region = new Region(request.code(), request.koreanName());
+ Region savedRegion = regionRepository.save(region);
+
+ return AdminRegionResponse.from(savedRegion);
+ }
+
+ private void validateCodeNotExists(String code) {
+ regionRepository.findById(code)
+ .ifPresent(region -> {
+ throw new CustomException(ErrorCode.REGION_ALREADY_EXISTS);
+ });
+ }
+
+ private void validateKoreanNameNotExists(String koreanName) {
+ regionRepository.findByKoreanName(koreanName)
+ .ifPresent(region -> {
+ throw new CustomException(ErrorCode.REGION_ALREADY_EXISTS);
+ });
+ }
+
+ @Transactional
+ public AdminRegionResponse updateRegion(String code, AdminRegionUpdateRequest request) {
+ Region region = regionRepository.findById(code)
+ .orElseThrow(() -> new CustomException(ErrorCode.REGION_NOT_FOUND));
+
+ validateKoreanNameNotDuplicated(request.koreanName(), code);
+
+ region.updateKoreanName(request.koreanName());
+ return AdminRegionResponse.from(region);
+ }
+
+ private void validateKoreanNameNotDuplicated(String koreanName, String excludeCode) {
+ regionRepository.findByKoreanName(koreanName)
+ .ifPresent(existingRegion -> {
+ if (!existingRegion.getCode().equals(excludeCode)) {
+ throw new CustomException(ErrorCode.REGION_ALREADY_EXISTS);
+ }
+ });
+ }
+
+ @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/domain/Region.java

@@ -25,4 +25,8 @@ public Region(String code, String koreanName) {
  this.code = code;
  this.koreanName = koreanName;
  }
+
+ public void updateKoreanName(String koreanName) {
+ this.koreanName = koreanName;
+ }
 }

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);