feat: 어드민 국가 crud 추가

.gitignore

@@ -40,6 +40,9 @@ out/
 ### Claude Code ###
 .claude/settings.local.json
 
+### Serena ###
+.serena/
+
 ### YML ###
 application-secret.yml
 application-prod.yml

src/main/java/com/example/solidconnection/admin/location/country/controller/AdminCountryController.java

@@ -0,0 +1,59 @@
+package com.example.solidconnection.admin.location.country.controller;
+
+import com.example.solidconnection.admin.location.country.dto.AdminCountryCreateRequest;
+import com.example.solidconnection.admin.location.country.dto.AdminCountryResponse;
+import com.example.solidconnection.admin.location.country.dto.AdminCountryUpdateRequest;
+import com.example.solidconnection.admin.location.country.service.AdminCountryService;
+import jakarta.validation.Valid;
+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;
+
+import java.util.List;
+
+@RequiredArgsConstructor
+@RequestMapping("/admin/countries")
+@RestController
+public class AdminCountryController {
+
+    private final AdminCountryService adminCountryService;
+
+    @GetMapping
+    public ResponseEntity<List<AdminCountryResponse>> getAllCountries() {
+        List<AdminCountryResponse> responses = adminCountryService.getAllCountries();
+        return ResponseEntity.ok(responses);
+    }
+
+    @PostMapping
+    public ResponseEntity<AdminCountryResponse> createCountry(
+            @Valid @RequestBody AdminCountryCreateRequest request
+    ) {
+        AdminCountryResponse response = adminCountryService.createCountry(request);
+        return ResponseEntity.status(HttpStatus.CREATED).body(response);
+    }
+
+    @PutMapping("/{code}")
+    public ResponseEntity<AdminCountryResponse> updateCountry(
+            @PathVariable String code,
+            @Valid @RequestBody AdminCountryUpdateRequest request
+    ) {
+        AdminCountryResponse response = adminCountryService.updateCountry(code, request);
+        return ResponseEntity.ok(response);
+    }
+
+    @DeleteMapping("/{code}")
+    public ResponseEntity<Void> deleteCountry(
+            @PathVariable String code
+    ) {
+        adminCountryService.deleteCountry(code);
+        return ResponseEntity.noContent().build();
+    }
+}

src/main/java/com/example/solidconnection/admin/location/country/dto/AdminCountryCreateRequest.java

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

src/main/java/com/example/solidconnection/admin/location/country/dto/AdminCountryResponse.java

@@ -0,0 +1,18 @@
+package com.example.solidconnection.admin.location.country.dto;
+
+import com.example.solidconnection.location.country.domain.Country;
+
+public record AdminCountryResponse(
+        String code,
+        String koreanName,
+        String regionCode
+) {
+
+    public static AdminCountryResponse from(Country country) {
+        return new AdminCountryResponse(
+                country.getCode(),
+                country.getKoreanName(),
+                country.getRegionCode()
+        );
+    }
+}

src/main/java/com/example/solidconnection/admin/location/country/dto/AdminCountryUpdateRequest.java

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

src/main/java/com/example/solidconnection/admin/location/country/service/AdminCountryService.java

@@ -0,0 +1,99 @@
+package com.example.solidconnection.admin.location.country.service;
+
+import com.example.solidconnection.admin.location.country.dto.AdminCountryCreateRequest;
+import com.example.solidconnection.admin.location.country.dto.AdminCountryResponse;
+import com.example.solidconnection.admin.location.country.dto.AdminCountryUpdateRequest;
+import com.example.solidconnection.common.exception.CustomException;
+import com.example.solidconnection.common.exception.ErrorCode;
+import com.example.solidconnection.location.country.domain.Country;
+import com.example.solidconnection.location.country.repository.CountryRepository;
+import com.example.solidconnection.location.region.repository.RegionRepository;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+
+@Service
+@RequiredArgsConstructor
+public class AdminCountryService {
+
+    private final CountryRepository countryRepository;
+    private final RegionRepository regionRepository;
+
+    @Transactional(readOnly = true)
+    public List<AdminCountryResponse> getAllCountries() {
+        return countryRepository.findAll()
+                .stream()
+                .map(AdminCountryResponse::from)
+                .toList();
+    }
+
+    @Transactional
+    public AdminCountryResponse createCountry(AdminCountryCreateRequest request) {
+        validateCodeNotExists(request.code());
+        validateKoreanNameNotExists(request.koreanName());
+        validateRegionCodeExists(request.regionCode());
+
+        Country country = new Country(request.code(), request.koreanName(), request.regionCode());
+        Country savedCountry = countryRepository.save(country);
+
+        return AdminCountryResponse.from(savedCountry);
+    }
+
+    private void validateCodeNotExists(String code) {
+        countryRepository.findByCode(code)
+                .ifPresent(country -> {
+                    throw new CustomException(ErrorCode.COUNTRY_ALREADY_EXISTS);
+                });
+    }
+
+    private void validateKoreanNameNotExists(String koreanName) {
+        countryRepository.findAllByKoreanNameIn(List.of(koreanName))
+                .stream()
+                .findFirst()
+                .ifPresent(country -> {
+                    throw new CustomException(ErrorCode.COUNTRY_ALREADY_EXISTS);
+                });
+    }
+
+    private void validateRegionCodeExists(String regionCode) {
+        if (regionCode != null) {
+            regionRepository.findById(regionCode)
+                    .orElseThrow(() -> new CustomException(ErrorCode.REGION_NOT_FOUND));
+        }
+    }
+
+    @Transactional
+    public AdminCountryResponse updateCountry(String code, AdminCountryUpdateRequest request) {
+        Country country = countryRepository.findByCode(code)
+                .orElseThrow(() -> new CustomException(ErrorCode.COUNTRY_NOT_FOUND));
+
+        validateKoreanNameNotDuplicated(request.koreanName(), code);
+        validateRegionCodeExists(request.regionCode());
+
+        country.updateKoreanName(request.koreanName());
+        country.updateRegionCode(request.regionCode());
+
+        return AdminCountryResponse.from(country);
+    }
+
+    private void validateKoreanNameNotDuplicated(String koreanName, String excludeCode) {
+        countryRepository.findAllByKoreanNameIn(List.of(koreanName))
+                .stream()
+                .findFirst()
+                .ifPresent(existingCountry -> {
+                    if (!existingCountry.getCode().equals(excludeCode)) {
+                        throw new CustomException(ErrorCode.COUNTRY_ALREADY_EXISTS);
+                    }
+                });
+    }
+
+    @Transactional
+    public void deleteCountry(String code) {
+        Country country = countryRepository.findByCode(code)
+                .orElseThrow(() -> new CustomException(ErrorCode.COUNTRY_NOT_FOUND));
+
+        countryRepository.delete(country);
+    }
+}

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

@@ -41,6 +41,7 @@ public enum ErrorCode {
     REGION_NOT_FOUND(HttpStatus.NOT_FOUND.value(), "지역을 찾을 수 없습니다."),
     REGION_NOT_FOUND_BY_KOREAN_NAME(HttpStatus.NOT_FOUND.value(), "이름에 해당하는 지역을 찾을 수 없습니다."),
     REGION_ALREADY_EXISTS(HttpStatus.CONFLICT.value(), "이미 존재하는 지역입니다."),
+    COUNTRY_ALREADY_EXISTS(HttpStatus.CONFLICT.value(), "이미 존재하는 국가입니다."),
     HOST_UNIVERSITY_ALREADY_EXISTS(HttpStatus.CONFLICT.value(), "이미 존재하는 파견 대학입니다."),
     HOST_UNIVERSITY_HAS_REFERENCES(HttpStatus.CONFLICT.value(), "해당 파견 대학을 참조하는 대학 지원 정보가 존재합니다."),
     COUNTRY_NOT_FOUND(HttpStatus.NOT_FOUND.value(), "국가를 찾을 수 없습니다."),

src/main/java/com/example/solidconnection/location/country/domain/Country.java

@@ -29,4 +29,12 @@ public Country(String code, String koreanName, String regionCode) {
         this.koreanName = koreanName;
         this.regionCode = regionCode;
     }
+
+    public void updateKoreanName(String koreanName) {
+        this.koreanName = koreanName;
+    }
+
+    public void updateRegionCode(String regionCode) {
+        this.regionCode = regionCode;
+    }
 }