DASOMBE-18 <피드백 반영. 추가 설명 표시. 인증코드 템플릿 반영>

NADELYSS · NADELYSS · commit 6d0e134a1b9e · 2025-08-27T05:38:22.000+09:00
diff --git a/src/main/java/dmu/dasom/api/domain/common/exception/ErrorCode.java b/src/main/java/dmu/dasom/api/domain/common/exception/ErrorCode.java
@@ -34,11 +34,11 @@ public enum ErrorCode {
     SLOT_FULL(400, "C025", "해당 슬롯이 가득 찼습니다."),
     RESERVATION_NOT_FOUND(400, "C026", "예약을 찾을 수 없습니다."),
     SLOT_NOT_ACTIVE(400, "C027", "해당 슬롯이 비활성화 되었습니다."),
-    SLOT_UNAVAILABLE(400, "C028", "해당 슬롯을 예약할 수 없습니다."),
-    FILE_ENCODE_FAIL(400, "C029", "파일 인코딩에 실패하였습니다."),
-    RECRUITMENT_NOT_ACTIVE(400, "C030", "모집 기간이 아닙니다."),
-    NOT_FOUND_PARTICIPANT(400, "C031", "참가자를 찾을 수 없습니다."),
-    VERIFICATION_CODE_NOT_VALID(400, "C032", "인증 코드가 유효하지 않습니다.")
+    FILE_ENCODE_FAIL(400, "C028", "파일 인코딩에 실패하였습니다."),
+    RECRUITMENT_NOT_ACTIVE(400, "C029", "모집 기간이 아닙니다."),
+    NOT_FOUND_PARTICIPANT(400, "C030", "참가자를 찾을 수 없습니다."),
+    VERIFICATION_CODE_NOT_VALID(400, "C031", "인증 코드가 유효하지 않습니다."),
+    SLOT_UNAVAILABLE(400, "C032", "해당 슬롯을 예약할 수 없습니다.")
     ;
 
     private final int status;
diff --git a/src/main/java/dmu/dasom/api/domain/email/service/EmailService.java b/src/main/java/dmu/dasom/api/domain/email/service/EmailService.java
diff --git a/src/main/java/dmu/dasom/api/domain/google/service/EmailService.java b/src/main/java/dmu/dasom/api/domain/google/service/EmailService.java
@@ -44,9 +44,8 @@ public void sendEmail(String to, String name, MailType mailType) {
 
             // HTML 템플릿에 전달할 데이터 설정
             Context context = new Context();
-            context.setVariable("name", name); // 지원자 이름 전달
-            context.setVariable("buttonUrl", buttonUrl); // 버튼 링크 전달
-
+            context.setVariable("name", name);
+            context.setVariable("buttonUrl", buttonUrl);
 
             // HTML 템플릿 처리
             String htmlBody = templateEngine.process(mailTemplate.getTemplateName(), context);
@@ -60,11 +59,10 @@ public void sendEmail(String to, String name, MailType mailType) {
             helper.setText(htmlBody, true);
             helper.setFrom((from != null && !from.isEmpty()) ? from : "dasomdmu@gmail.com");
 
-            // Content-Type을 명시적으로 설정
             message.setContent(htmlBody, "text/html; charset=utf-8");
 
             javaMailSender.send(message);
-            log.info("Email sent successfull {}", to);
+            log.info("Email sent successfully {}", to);
         } catch (MessagingException e) {
             log.error("Failed to send email to {}: {}", to, e.getMessage());
             mailSendStatus = MailSendStatus.FAILURE;
@@ -76,4 +74,35 @@ public void sendEmail(String to, String name, MailType mailType) {
         }
         emailLogService.logEmailSending(to, mailSendStatus, errorMessage);
     }
+
+    /*
+     * 면접 예약 변경을 위한 인증코드 발송
+     * - VerificationCodeManager에서 생성된 코드를 이메일로 전송
+     * - verify-num-email.html 템플릿을 이용해 코드와 버튼 링크 포함
+     */
+    public void sendVerificationEmail(String to, String name, String code) throws MessagingException {
+        String subject = "DASOM 면접 시간 변경을 위한 이메일 인증 코드 안내";
+
+        // 인증 코드만 템플릿으로 전달
+        String emailContent = "인증 코드: <strong>" + code + "</strong>";
+
+        Context context = new Context();
+        context.setVariable("name", name);
+        context.setVariable("emailContent", emailContent);
+        context.setVariable("buttonUrl", "https://dmu-dasom.or.kr");
+        context.setVariable("buttonText", "인증 완료");
+
+        String htmlBody = templateEngine.process("verify-num-email", context);
+
+        MimeMessage message = javaMailSender.createMimeMessage();
+        MimeMessageHelper helper = new MimeMessageHelper(message, true, "UTF-8");
+
+        helper.setTo(to);
+        helper.setSubject(subject);
+        helper.setText(htmlBody, true);
+        helper.setFrom((from != null && !from.isEmpty()) ? from : "dasomdmu@gmail.com");
+
+        javaMailSender.send(message);
+    }
+
 }
diff --git a/src/main/java/dmu/dasom/api/domain/interview/controller/InterviewController.java b/src/main/java/dmu/dasom/api/domain/interview/controller/InterviewController.java
@@ -4,7 +4,8 @@
 import dmu.dasom.api.domain.applicant.repository.ApplicantRepository;
 import dmu.dasom.api.domain.common.exception.CustomException;
 import dmu.dasom.api.domain.common.exception.ErrorCode;
-import dmu.dasom.api.domain.email.service.EmailService;
+import dmu.dasom.api.domain.google.service.EmailService;
+
 import dmu.dasom.api.domain.interview.dto.InterviewReservationModifyRequestDto;
 import dmu.dasom.api.domain.interview.dto.VerificationCodeRequestDto;
 import dmu.dasom.api.domain.interview.service.InterviewService;
@@ -29,27 +30,46 @@ public class InterviewController {
     private final InterviewService interviewService;
     private final ApplicantRepository applicantRepository;
     private final VerificationCodeManager verificationCodeManager;
-    private final EmailService emailService;
+    private final EmailService emailService; // 이메일 발송 서비스 (Google 기반)
 
+    /*
+     * 면접 예약 수정을 위한 인증 코드 발송
+     * - 지원자의 학번을 입력받아 해당 지원자를 조회
+     * - VerificationCodeManager를 통해 인증 코드 생성 및 Redis 저장
+     * - EmailService를 이용해 지원자 이메일로 인증 코드 발송
+     */
     @Operation(summary = "면접 예약 수정을 위한 인증 코드 발송", description = "지원자의 학번을 받아 이메일로 인증 코드를 발송합니다.")
     @PostMapping("/send-verification")
     public ResponseEntity<Void> sendVerificationCode(@Valid @RequestBody VerificationCodeRequestDto request) throws MessagingException {
+        // 학번으로 지원자 조회 (없으면 예외 발생)
         Applicant applicant = applicantRepository.findByStudentNo(request.getStudentNo())
                 .orElseThrow(() -> new CustomException(ErrorCode.APPLICANT_NOT_FOUND));
 
+        // 인증 코드 생성 후 Redis에 저장
         String code = verificationCodeManager.generateAndStoreCode(applicant.getStudentNo());
+
+        // 이메일 발송 (받는 사람 이메일, 이름, 코드 전달)
         emailService.sendVerificationEmail(applicant.getEmail(), applicant.getName(), code);
 
         return ResponseEntity.ok().build();
     }
 
+    /*
+     * 면접 예약 수정
+     * - 사용자가 받은 인증 코드를 검증한 후
+     * - InterviewService를 통해 예약 날짜/시간 수정 처리
+     */
     @Operation(summary = "면접 예약 수정", description = "이메일로 발송된 인증 코드를 통해 인증 후, 면접 날짜 및 시간을 수정합니다.")
     @PutMapping("/reservation/modify")
     public ResponseEntity<Void> modifyInterviewReservation(@Valid @RequestBody InterviewReservationModifyRequestDto request) {
         interviewService.modifyInterviewReservation(request);
         return ResponseEntity.ok().build();
     }
 
+    /*
+     * 모든 면접 지원자 조회
+     * - InterviewService를 통해 모든 지원자 + 예약 정보 반환
+     */
     @Operation(summary = "모든 면접 지원자 목록 조회", description = "모든 면접 지원자의 상세 정보와 예약 정보를 조회합니다.")
     @GetMapping("/applicants")
     public ResponseEntity<List<InterviewReservationApplicantResponseDto>> getAllInterviewApplicants() {
diff --git a/src/main/java/dmu/dasom/api/domain/interview/repository/InterviewSlotRepository.java b/src/main/java/dmu/dasom/api/domain/interview/repository/InterviewSlotRepository.java
@@ -4,6 +4,7 @@
 import dmu.dasom.api.domain.interview.enums.InterviewStatus;
 import org.springframework.data.jpa.repository.JpaRepository;
 import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.query.Param; // ★ import 추가
 import org.springframework.stereotype.Repository;
 
 import java.util.Collection;
@@ -12,13 +13,12 @@
 @Repository
 public interface InterviewSlotRepository extends JpaRepository<InterviewSlot, Long> {
     // 현재 인원이 최대 인원보다 작은 슬롯 조회
-    // 현재 예약된 인원이 최대 지원자 수보다 적은 슬롯 조회
     @Query("SELECT s FROM InterviewSlot s WHERE s.currentCandidates < s.maxCandidates")
     Collection<InterviewSlot> findAllByCurrentCandidatesLessThanMaxCandidates();
 
     // 상태에 따른 슬롯 조회
     @Query("SELECT s FROM InterviewSlot s WHERE s.interviewStatus = :status AND s.currentCandidates < s.maxCandidates")
-        List<InterviewSlot> findAllByStatusAndCurrentCandidatesLessThanMaxCandidates(@org.springframework.data.repository.query.Param("status") InterviewStatus interviewStatus);
+    List<InterviewSlot> findAllByStatusAndCurrentCandidatesLessThanMaxCandidates(@Param("status") InterviewStatus interviewStatus);
 
     // 슬롯이 하나라도 존재하는지 확인
     @Query("SELECT COUNT(s) > 0 FROM InterviewSlot s")
diff --git a/src/main/java/dmu/dasom/api/domain/interview/service/InterviewServiceImpl.java b/src/main/java/dmu/dasom/api/domain/interview/service/InterviewServiceImpl.java
@@ -151,7 +151,7 @@ public List<InterviewSlotResponseDto> getAllInterviewSlots() {
                 .toList();
     }
 
-        @Override
+    @Override
     public List<InterviewReservationApplicantResponseDto> getAllInterviewApplicants() {
         List<InterviewReservation> reservations = interviewReservationRepository.findAll();
 
diff --git a/src/main/java/dmu/dasom/api/domain/recruit/controller/RecruitController.java b/src/main/java/dmu/dasom/api/domain/recruit/controller/RecruitController.java
@@ -67,20 +67,31 @@ public ResponseEntity<List<RecruitConfigResponseDto>> getRecruitSchedule() {
         return ResponseEntity.ok(recruitService.getRecruitSchedule());
     }
 
+    /*
+     * 모집 일정 수정
+     * - 관리자가 모집 일정을 수정할 때 사용
+     * - RecruitService.modifyRecruitSchedule()을 호출하여 DB 반영
+     */
     @Operation(summary = "모집 일정 수정")
     @PutMapping("/schedule")
     public ResponseEntity<Void> modifyRecruitSchedule(@RequestBody dmu.dasom.api.domain.recruit.dto.RecruitScheduleModifyRequestDto request) {
         recruitService.modifyRecruitSchedule(request);
         return ResponseEntity.ok().build();
     }
 
+    /*
+     * 모집 일정 초기화 (테스트용)
+     * - 테스트 시 초기화를 위해 전체 모집 일정을 초기 상태로 되돌림
+     * - RecruitService.initRecruitSchedule()을 호출
+     */
     @Operation(summary = "TEMP: 모집 일정 초기화")
     @GetMapping("/init-schedule")
     public ResponseEntity<String> initSchedule() {
         recruitService.initRecruitSchedule();
         return ResponseEntity.ok("Recruit schedule initialized successfully.");
     }
 
+
     // 합격 결과 확인
     @Operation(summary = "합격 결과 확인")
     @ApiResponses(value = {
diff --git a/src/main/java/dmu/dasom/api/domain/recruit/service/RecruitService.java b/src/main/java/dmu/dasom/api/domain/recruit/service/RecruitService.java
@@ -13,7 +13,7 @@ public interface RecruitService {
 
     List<RecruitConfigResponseDto> getRecruitSchedule();
 
-        void modifyRecruitSchedule(RecruitScheduleModifyRequestDto request);
+    void modifyRecruitSchedule(RecruitScheduleModifyRequestDto request);
 
     void initRecruitSchedule();
 
diff --git a/src/main/java/dmu/dasom/api/domain/recruit/service/RecruitServiceImpl.java b/src/main/java/dmu/dasom/api/domain/recruit/service/RecruitServiceImpl.java
@@ -29,9 +29,9 @@ public class RecruitServiceImpl implements RecruitService {
     @Override
     public List<RecruitConfigResponseDto> getRecruitSchedule() {
         return findAll().stream()
-            .map(config -> config.getKey() == ConfigKey.INTERVIEW_TIME_START || config.getKey() == ConfigKey.INTERVIEW_TIME_END
-                ? config.toTimeResponse() : config.toResponse())
-            .toList();
+                .map(config -> config.getKey() == ConfigKey.INTERVIEW_TIME_START || config.getKey() == ConfigKey.INTERVIEW_TIME_END
+                        ? config.toTimeResponse() : config.toResponse())
+                .toList();
     }
 
     // 모집 일정 설정 수정
@@ -74,16 +74,25 @@ public LocalDateTime getResultAnnouncementSchedule(ResultCheckType type) {
         return parseDateTimeFormat(recruit.getValue());
     }
 
+    /*
+     * 모집 일정 초기화
+     * - DB에 Recruit 데이터가 존재하지 않을 경우 기본 값으로 초기화
+     * - 각 ConfigKey에 대해 Recruit 엔티티를 생성하여 저장
+     * - 기본 값은 "2025-01-01T00:00:00"으로 설정됨
+     */
     @Override
     @Transactional
     public void initRecruitSchedule() {
+        // 이미 데이터가 존재하면 초기화하지 않음
         if (recruitRepository.count() > 0) {
-            return; // Already initialized
+            return;
         }
-        for (dmu.dasom.api.domain.recruit.enums.ConfigKey key : dmu.dasom.api.domain.recruit.enums.ConfigKey.values()) {
-            dmu.dasom.api.domain.recruit.entity.Recruit recruit = dmu.dasom.api.domain.recruit.entity.Recruit.builder()
+
+        // 모든 ConfigKey를 순회하며 기본 Recruit 데이터 생성
+        for (ConfigKey key : ConfigKey.values()) {
+            Recruit recruit = Recruit.builder()
                     .key(key)
-                    .value("2025-01-01T00:00:00") // Default value
+                    .value("2025-01-01T00:00:00") // 초기 기본 값
                     .build();
             recruitRepository.save(recruit);
         }
@@ -97,8 +106,7 @@ private List<Recruit> findAll() {
     // DB에서 key에 해당하는 Recruit 객체를 찾아 반환
     private Recruit findByKey(final ConfigKey key) {
         return recruitRepository.findByKey(key)
-            .orElseThrow(() -> new CustomException(ErrorCode.ARGUMENT_NOT_VALID));
-
+                .orElseThrow(() -> new CustomException(ErrorCode.ARGUMENT_NOT_VALID));
     }
 
     // 시간 형식 변환 및 검증
@@ -118,5 +126,4 @@ private LocalDateTime parseDateTimeFormat(String value) {
             throw new CustomException(ErrorCode.INVALID_DATETIME_FORMAT);
         }
     }
-
 }
diff --git a/src/main/java/dmu/dasom/api/global/util/VerificationCodeManager.java b/src/main/java/dmu/dasom/api/global/util/VerificationCodeManager.java
diff --git a/src/main/resources/templates/verify-num-email.html b/src/main/resources/templates/verify-num-email.html

Original file line number	Diff line number	Diff line change
`@@ -151,7 +151,7 @@ public List<InterviewSlotResponseDto> getAllInterviewSlots() {`
`151`	`151`	`.toList();`
`152`	`152`	`}`
`153`	`153`
`154`		`- @Override`
	`154`	`+ @Override`
`155`	`155`	`public List<InterviewReservationApplicantResponseDto> getAllInterviewApplicants() {`
`156`	`156`	`List<InterviewReservation> reservations = interviewReservationRepository.findAll();`
`157`	`157`