feat: 학교 이메일 인증으로 HomeUniversity 자동 매핑

* feat: 학교별 이메일 인증으로 HomeUniversity 자동 매핑 (#751)

- HomeUniversity에 emailDomain 컬럼 추가 (V50 마이그레이션)
- HomeUniversityRepository에 findByEmailDomain 메서드 추가
- EmailService 구현 (JavaMailSender 기반 인증 코드 발송)
- SchoolEmailService 구현 (인증 코드 발급/확인, Redis TTL 5분)
- SiteUser.verifySchool() 도메인 메서드 추가
- MyPageController에 POST /my/school-email, POST /my/school-email/confirm 엔드포인트 추가
- 어드민 HomeUniversity DTO에 emailDomain 필드 반영

* refactor: EmailService를 common/mail/MailService로 이동

email 발송은 공통 인프라 관심사이므로 별도 email 패키지 대신
common/mail 패키지로 이동

* refactor: 학교 이메일 인증 API 응답 body 제거

클라이언트가 이미 알고 있는 이메일을 응답으로 돌려줄 필요가 없으므로
SchoolEmailResponse 제거 및 반환 타입을 void로 변경

* refactor: Redis 저장 실패 시 CustomException으로 처리

RuntimeException 대신 SCHOOL_EMAIL_VERIFICATION_INFO_SAVE_FAILED
ErrorCode를 사용하여 예외 처리를 명확하게 표현

* refactor: Redis 인증 정보 역직렬화 실패 시 CORRUPTED 예외로 처리

데이터가 존재하지만 파싱 실패인 경우 REQUEST_NOT_FOUND 대신
SCHOOL_EMAIL_VERIFICATION_INFO_CORRUPTED로 명확하게 구분

* test: 학교 이메일 인증 테스트를 인하대학교(inha.edu) 기반으로 변경

* style: 테스트 Given-When-Then 주석 소문자로 통일

* feat: data.sql에 HomeUniversity email_domain 데이터 추가

* fix: CodeRabbit 리뷰 반영 - emailDomain 검증 강화 및 트랜잭션 범위 축소

- V50 마이그레이션에 기존 대학 email_domain 백필 UPDATE 추가
- AdminHomeUniversityService에 emailDomain 중복 검증 추가
- SchoolEmailService에서 이메일 발송 실패 시 Redis 보상 삭제 추가
- requestSchoolEmailVerification에서 불필요한 @transactional 제거
- extractEmailDomain에서 도메인 소문자 정규화 적용
- AdminHomeUniversity DTO의 emailDomain 검증을 @pattern으로 강화

* revert: V50 마이그레이션에서 DML 제거

* refactor: @Email 검증으로 보장된 중복 atIndex 검사 제거

* refactor: develop rebase 충돌 해결 및 테스트 코드 적용

* fix: emailDomain @SiZe 검증 추가

Author: sukangpunch

build.gradle

@@ -65,6 +65,9 @@ dependencies {
     testAnnotationProcessor 'org.projectlombok:lombok'
     testImplementation 'org.awaitility:awaitility:4.2.0'
 
+    // Mail
+    implementation 'org.springframework.boot:spring-boot-starter-mail'
+
     // Etc
     implementation platform('software.amazon.awssdk:bom:2.41.4')
     implementation 'software.amazon.awssdk:s3'

src/main/java/com/example/solidconnection/admin/university/dto/AdminHomeUniversityCreateRequest.java

@@ -2,6 +2,7 @@
 
 import jakarta.validation.constraints.Min;
 import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Pattern;
 import jakarta.validation.constraints.Size;
 
 public record AdminHomeUniversityCreateRequest(
@@ -10,7 +11,14 @@ public record AdminHomeUniversityCreateRequest(
         String name,
 
         @Min(value = 1, message = "최대 지망 수는 1 이상이어야 합니다")
-        int maxChoiceCount
+        int maxChoiceCount,
+
+        @Size(max = 100, message = "이메일 도메인은 100자 이하여야 합니다")
+        @Pattern(
+                regexp = "^[a-zA-Z0-9]([a-zA-Z0-9\\-]*[a-zA-Z0-9])?(\\.[a-zA-Z0-9]([a-zA-Z0-9\\-]*[a-zA-Z0-9])?)+$",
+                message = "올바른 이메일 도메인 형식이 아닙니다 (예: inha.edu, inu.ac.kr)"
+        )
+        String emailDomain
 ) {
 
 }

src/main/java/com/example/solidconnection/admin/university/dto/AdminHomeUniversityResponse.java

@@ -5,14 +5,16 @@
 public record AdminHomeUniversityResponse(
         long id,
         String name,
-        int maxChoiceCount
+        int maxChoiceCount,
+        String emailDomain
 ) {
 
     public static AdminHomeUniversityResponse from(HomeUniversity homeUniversity) {
         return new AdminHomeUniversityResponse(
                 homeUniversity.getId(),
                 homeUniversity.getName(),
-                homeUniversity.getMaxChoiceCount()
+                homeUniversity.getMaxChoiceCount(),
+                homeUniversity.getEmailDomain()
         );
     }
 }

src/main/java/com/example/solidconnection/admin/university/dto/AdminHomeUniversityUpdateRequest.java

@@ -2,6 +2,7 @@
 
 import jakarta.validation.constraints.Min;
 import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Pattern;
 import jakarta.validation.constraints.Size;
 
 public record AdminHomeUniversityUpdateRequest(
@@ -10,7 +11,15 @@ public record AdminHomeUniversityUpdateRequest(
         String name,
 
         @Min(value = 1, message = "최대 지망 수는 1 이상이어야 합니다")
-        int maxChoiceCount
+        int maxChoiceCount,
+
+        @Size(max = 100, message = "이메일 도메인은 100자 이하여야 합니다")
+        @Pattern(
+                regexp = "^[a-zA-Z0-9]([a-zA-Z0-9\\-]*[a-zA-Z0-9])?(\\.[a-zA-Z0-9]([a-zA-Z0-9\\-]*[a-zA-Z0-9])?)+$",
+                message = "올바른 이메일 도메인 형식이 아닙니다 (예: inha.edu, inu.ac.kr)"
+        )
+        String emailDomain
+
 ) {
 
 }

src/main/java/com/example/solidconnection/admin/university/service/AdminHomeUniversityService.java

@@ -1,6 +1,7 @@
 package com.example.solidconnection.admin.university.service;
 
 import static com.example.solidconnection.common.exception.ErrorCode.HOME_UNIVERSITY_ALREADY_EXISTS;
+import static com.example.solidconnection.common.exception.ErrorCode.HOME_UNIVERSITY_EMAIL_DOMAIN_ALREADY_EXISTS;
 import static com.example.solidconnection.common.exception.ErrorCode.HOME_UNIVERSITY_HAS_REFERENCES;
 import static com.example.solidconnection.common.exception.ErrorCode.HOME_UNIVERSITY_NOT_FOUND;
 
@@ -48,7 +49,8 @@ public AdminHomeUniversityResponse getHomeUniversity(Long id) {
     )
     public AdminHomeUniversityResponse createHomeUniversity(AdminHomeUniversityCreateRequest request) {
         validateNameNotExists(request.name());
-        HomeUniversity homeUniversity = new HomeUniversity(null, request.name(), request.maxChoiceCount());
+        validateEmailDomainNotExists(request.emailDomain());
+        HomeUniversity homeUniversity = new HomeUniversity(null, request.name(), request.maxChoiceCount(), request.emailDomain());
         return AdminHomeUniversityResponse.from(homeUniversityRepository.save(homeUniversity));
     }
 
@@ -59,6 +61,16 @@ private void validateNameNotExists(String name) {
                 });
     }
 
+    private void validateEmailDomainNotExists(String emailDomain) {
+        if (emailDomain == null || emailDomain.isBlank()) {
+            return;
+        }
+        homeUniversityRepository.findByEmailDomain(emailDomain)
+                .ifPresent(existing -> {
+                    throw new CustomException(HOME_UNIVERSITY_EMAIL_DOMAIN_ALREADY_EXISTS);
+                });
+    }
+
     @Transactional
     @DefaultCacheOut(
             key = {"univApplyInfoTextSearch", "university:recommend:general"},
@@ -69,7 +81,8 @@ public AdminHomeUniversityResponse updateHomeUniversity(Long id, AdminHomeUniver
         HomeUniversity homeUniversity = homeUniversityRepository.findById(id)
                 .orElseThrow(() -> new CustomException(HOME_UNIVERSITY_NOT_FOUND));
         validateNameNotDuplicated(request.name(), id);
-        homeUniversity.update(request.name(), request.maxChoiceCount());
+        validateEmailDomainNotDuplicated(request.emailDomain(), id);
+        homeUniversity.update(request.name(), request.maxChoiceCount(), request.emailDomain());
         return AdminHomeUniversityResponse.from(homeUniversity);
     }
 
@@ -82,6 +95,18 @@ private void validateNameNotDuplicated(String name, Long excludeId) {
                 });
     }
 
+    private void validateEmailDomainNotDuplicated(String emailDomain, Long excludeId) {
+        if (emailDomain == null || emailDomain.isBlank()) {
+            return;
+        }
+        homeUniversityRepository.findByEmailDomain(emailDomain)
+                .ifPresent(existing -> {
+                    if (!existing.getId().equals(excludeId)) {
+                        throw new CustomException(HOME_UNIVERSITY_EMAIL_DOMAIN_ALREADY_EXISTS);
+                    }
+                });
+    }
+
     @Transactional
     @DefaultCacheOut(
             key = {"univApplyInfoTextSearch", "university:recommend:general"},

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

@@ -47,6 +47,7 @@ public enum ErrorCode {
     HOST_UNIVERSITY_HAS_REFERENCES(HttpStatus.CONFLICT.value(), "해당 파견 대학을 참조하는 대학 지원 정보가 존재합니다."),
     HOME_UNIVERSITY_NOT_FOUND(HttpStatus.NOT_FOUND.value(), "협정 대학교를 찾을 수 없습니다."),
     HOME_UNIVERSITY_ALREADY_EXISTS(HttpStatus.CONFLICT.value(), "이미 존재하는 협정 대학입니다."),
+    HOME_UNIVERSITY_EMAIL_DOMAIN_ALREADY_EXISTS(HttpStatus.CONFLICT.value(), "이미 사용 중인 이메일 도메인입니다."),
     HOME_UNIVERSITY_HAS_REFERENCES(HttpStatus.CONFLICT.value(), "해당 협정 대학을 참조하는 데이터가 존재합니다."),
     COUNTRY_NOT_FOUND(HttpStatus.NOT_FOUND.value(), "국가를 찾을 수 없습니다."),
     COUNTRY_NOT_FOUND_BY_KOREAN_NAME(HttpStatus.NOT_FOUND.value(), "이름에 해당하는 국가를 찾을 수 없습니다."),
@@ -78,6 +79,14 @@ public enum ErrorCode {
     SIGN_IN_FAILED(HttpStatus.UNAUTHORIZED.value(), "로그인에 실패했습니다. 이메일과 비밀번호를 확인해주세요."),
     OAUTH_USER_CANNOT_CHANGE_PASSWORD(HttpStatus.BAD_REQUEST.value(), "소셜 로그인 사용자는 비밀번호를 변경할 수 없습니다."),
 
+    // school email verification
+    SCHOOL_EMAIL_ALREADY_VERIFIED(HttpStatus.BAD_REQUEST.value(), "이미 학교 이메일 인증이 완료되었습니다."),
+    SCHOOL_EMAIL_DOMAIN_NOT_SUPPORTED(HttpStatus.BAD_REQUEST.value(), "지원하지 않는 학교 이메일 도메인입니다."),
+    SCHOOL_EMAIL_CONFIRM_REQUEST_NOT_FOUND(HttpStatus.BAD_REQUEST.value(), "학교 이메일 인증 요청을 찾을 수 없습니다. 인증 코드 발송을 다시 요청해주세요."),
+    SCHOOL_EMAIL_CONFIRM_CODE_DIFFERENT(HttpStatus.BAD_REQUEST.value(), "인증 코드가 일치하지 않습니다."),
+    SCHOOL_EMAIL_VERIFICATION_INFO_SAVE_FAILED(HttpStatus.INTERNAL_SERVER_ERROR.value(), "학교 이메일 인증 정보 저장에 실패했습니다."),
+    SCHOOL_EMAIL_VERIFICATION_INFO_CORRUPTED(HttpStatus.INTERNAL_SERVER_ERROR.value(), "학교 이메일 인증 정보가 손상되었습니다. 인증 코드 발송을 다시 요청해주세요."),
+
     // s3
     S3_SERVICE_EXCEPTION(HttpStatus.BAD_REQUEST.value(), "S3 서비스 에러 발생"),
     S3_CLIENT_EXCEPTION(HttpStatus.BAD_REQUEST.value(), "S3 클라이언트 에러 발생"),

src/main/java/com/example/solidconnection/common/mail/MailService.java

@@ -0,0 +1,21 @@
+package com.example.solidconnection.common.mail;
+
+import lombok.RequiredArgsConstructor;
+import org.springframework.mail.SimpleMailMessage;
+import org.springframework.mail.javamail.JavaMailSender;
+import org.springframework.stereotype.Service;
+
+@Service
+@RequiredArgsConstructor
+public class MailService {
+
+    private final JavaMailSender javaMailSender;
+
+    public void sendVerificationEmail(String to, String verificationCode) {
+        SimpleMailMessage message = new SimpleMailMessage();
+        message.setTo(to);
+        message.setSubject("[Solid Connect] 학교 이메일 인증");
+        message.setText("인증 코드: " + verificationCode + "\n\n인증 코드는 5분간 유효합니다.");
+        javaMailSender.send(message);
+    }
+}

src/main/java/com/example/solidconnection/siteuser/controller/MyPageController.java

@@ -5,12 +5,16 @@
 import com.example.solidconnection.siteuser.dto.LocationUpdateRequest;
 import com.example.solidconnection.siteuser.dto.MyPageResponse;
 import com.example.solidconnection.siteuser.dto.PasswordUpdateRequest;
+import com.example.solidconnection.siteuser.dto.SchoolEmailConfirmRequest;
+import com.example.solidconnection.siteuser.dto.SchoolEmailRequest;
 import com.example.solidconnection.siteuser.service.MyPageService;
+import com.example.solidconnection.siteuser.service.SchoolEmailService;
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PatchMapping;
+import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RequestParam;
@@ -23,6 +27,7 @@
 class MyPageController {
 
     private final MyPageService myPageService;
+    private final SchoolEmailService schoolEmailService;
 
     @GetMapping
     public ResponseEntity<MyPageResponse> getMyPageInfo(
@@ -59,4 +64,22 @@ public ResponseEntity<Void> updateLocation(
         myPageService.updateLocation(siteUserId, request);
         return ResponseEntity.ok().build();
     }
+
+    @PostMapping("/school-email")
+    public ResponseEntity<Void> requestSchoolEmailVerification(
+            @AuthorizedUser long siteUserId,
+            @RequestBody @Valid SchoolEmailRequest request
+    ) {
+        schoolEmailService.requestSchoolEmailVerification(siteUserId, request.schoolEmail());
+        return ResponseEntity.ok().build();
+    }
+
+    @PostMapping("/school-email/confirm")
+    public ResponseEntity<Void> confirmSchoolEmail(
+            @AuthorizedUser long siteUserId,
+            @RequestBody @Valid SchoolEmailConfirmRequest request
+    ) {
+        schoolEmailService.confirmSchoolEmail(siteUserId, request.code());
+        return ResponseEntity.ok().build();
+    }
 }

src/main/java/com/example/solidconnection/siteuser/domain/SiteUser.java

@@ -159,6 +159,10 @@ public void updateUserStatus(UserStatus status) {
         this.userStatus = status;
     }
 
+    public void verifySchool(Long homeUniversityId) {
+        this.homeUniversityId = homeUniversityId;
+    }
+
     public void becomeMentor() {
         this.role = Role.MENTOR;
     }

src/main/java/com/example/solidconnection/siteuser/dto/SchoolEmailConfirmRequest.java

@@ -0,0 +1,10 @@
+package com.example.solidconnection.siteuser.dto;
+
+import jakarta.validation.constraints.NotBlank;
+
+public record SchoolEmailConfirmRequest(
+        @NotBlank(message = "인증 코드는 필수입니다")
+        String code
+) {
+
+}