[EC-88] BE/feat: 수강생 유고 결석 취소 api (#77)

* [EC-88] feat: S3 Client delete service 추가

* [EC-88] feat: 리소스 생성자와 수정 및 삭제 요청자 불일치 커스텀 예외 추가

* [EC-88] feat: 삭제 요청 날짜 관리할 필드 추가

* [EC-88] feat: 유고결석 신청 , 유고결석 신청 첨부파일 테이블 삭제 요청 처리

- 소프트 딜리트 적용

* [EC-88] feat: 첨부파일 삭제 로직 적용

- 삭제 요청일로부터 3달 지난 첨부파일은 S3에서 하드 딜리트
- DB 테이블 상에서도 삭제 처리
- 신청 내역은 DB 상에 유지

Author: devyejin

api/src/main/java/org/example/educheck/domain/absenceattendance/controller/AbsenceAttendanceController.java

@@ -47,4 +47,15 @@ public ResponseEntity<ApiResponse<CreateAbsenceAttendacneReponseDto>> applyAtten
                 ;
     }
 
+    @DeleteMapping("/my/course/{courseId}/absence-attendances/{absenceAttendancesId}")
+    public ResponseEntity<ApiResponse<Object>> cancelAttendanceAbsence(@AuthenticationPrincipal Member member,
+                                                                       @PathVariable Long absenceAttendancesId) {
+        absenceAttendanceService.cancelAttendanceAbsence(member, absenceAttendancesId);
+        return ResponseEntity.ok(
+                ApiResponse.ok("유고 결석 신청 취소 성공",
+                        "OK",
+                        null));
+
+    }
+
 }

api/src/main/java/org/example/educheck/domain/absenceattendance/entity/AbsenceAttendance.java

@@ -2,12 +2,16 @@
 
 import jakarta.persistence.*;
 import lombok.*;
+import org.example.educheck.domain.absenceattendanceattachmentfile.entity.AbsenceAttendanceAttachmentFile;
 import org.example.educheck.domain.course.entity.Course;
 import org.example.educheck.domain.member.staff.entity.Staff;
 import org.example.educheck.domain.member.student.entity.Student;
+import org.example.educheck.global.common.entity.BaseTimeEntity;
 
 import java.time.LocalDate;
 import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.List;
 
 /**
  * isApprove : T 승인 F 반려 null 대기
@@ -16,7 +20,7 @@
 @Setter
 @Entity
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
-public class AbsenceAttendance {
+public class AbsenceAttendance extends BaseTimeEntity {
 
     @Id
     @GeneratedValue(strategy = GenerationType.IDENTITY)
@@ -41,6 +45,11 @@ public class AbsenceAttendance {
     private String reason;
     private String category;
 
+    @OneToMany(mappedBy = "absenceAttendance", cascade = CascadeType.ALL, orphanRemoval = true)
+    private List<AbsenceAttendanceAttachmentFile> absenceAttendanceAttachmentFiles = new ArrayList<>();
+
+    private LocalDateTime deletionRequestedAt;
+
     @Builder
     public AbsenceAttendance(Staff staff, Course course, Student student, LocalDate startTime, LocalDate endTime, Character isApprove, LocalDateTime approveDate, String reason, String category) {
         this.staff = staff;
@@ -53,4 +62,9 @@ public AbsenceAttendance(Staff staff, Course course, Student student, LocalDate
         this.reason = reason;
         this.category = category;
     }
+
+    public void markDeletionRequested() {
+        this.deletionRequestedAt = LocalDateTime.now();
+    }
+
 }

api/src/main/java/org/example/educheck/domain/absenceattendance/service/AbsenceAttendanceService.java

@@ -16,6 +16,7 @@
 import org.example.educheck.domain.member.student.entity.Student;
 import org.example.educheck.domain.registration.entity.Registration;
 import org.example.educheck.domain.registration.repository.RegistrationRepository;
+import org.example.educheck.global.common.exception.custom.common.NotOwnerException;
 import org.example.educheck.global.common.exception.custom.common.ResourceMismatchException;
 import org.example.educheck.global.common.exception.custom.common.ResourceNotFoundException;
 import org.example.educheck.global.common.s3.S3Service;
@@ -27,6 +28,7 @@
 import java.time.LocalDateTime;
 import java.util.List;
 import java.util.Map;
+import java.util.Objects;
 
 @Service
 @RequiredArgsConstructor
@@ -40,6 +42,13 @@ public class AbsenceAttendanceService {
     private final AbsenceAttendanceAttachmentFileRepository absenceAttendanceAttachmentFileRepository;
     private final RegistrationRepository registrationRepository;
 
+    private static void validateIsApplicant(Member member, AbsenceAttendance absenceAttendance) {
+
+        if (!Objects.equals(member.getStudentId(), absenceAttendance.getStudent().getId())) {
+            throw new NotOwnerException();
+        }
+    }
+
     @Transactional
     @PreAuthorize("hasAnyAuthority('MIDDLE_ADMIN')")
     public void processAbsenceAttendanceService(Long courseId, Long absesnceAttendancesId, ProcessAbsenceAttendanceRequestDto requestDto, Member member) {
@@ -115,14 +124,31 @@ private void saveAttachementFiles(MultipartFile[] files, AbsenceAttendance saved
     }
 
     private void validateRegistrationCourse(Member member, Long courseId) {
-        log.info("memberId: " + member.getId() + " courseId: " + courseId);
         Student student = member.getStudent();
-        log.info("studentId : {}", student.getId());
+
         Registration registration = registrationRepository.findByStudentIdAndCourseId(member.getStudent().getId(), courseId)
                 .orElseThrow(ResourceNotFoundException::new);
 
         if (registration == null) {
             throw new ResourceMismatchException();
         }
     }
+
+    @Transactional
+    public void cancelAttendanceAbsence(Member member, Long absenceAttendancesId) {
+
+        AbsenceAttendance absenceAttendance = absenceAttendanceRepository.findById(absenceAttendancesId)
+                .orElseThrow(() -> new ResourceNotFoundException("해당 유고 결석 신청 내역이 존재하지 않습니다."));
+
+        validateIsApplicant(member, absenceAttendance);
+
+        List<AbsenceAttendanceAttachmentFile> attachmentFiles = absenceAttendance.getAbsenceAttendanceAttachmentFiles();
+        for (AbsenceAttendanceAttachmentFile attachmentFile : attachmentFiles) {
+            attachmentFile.markDeletionRequested();
+            absenceAttendanceAttachmentFileRepository.save(attachmentFile);
+        }
+
+        absenceAttendance.markDeletionRequested();
+        absenceAttendanceRepository.save(absenceAttendance);
+    }
 }

api/src/main/java/org/example/educheck/domain/absenceattendanceattachmentfile/entity/AbsenceAttendanceAttachmentFile.java

@@ -8,6 +8,8 @@
 import org.example.educheck.domain.absenceattendance.entity.AbsenceAttendance;
 import org.example.educheck.global.common.entity.BaseTimeEntity;
 
+import java.time.LocalDateTime;
+
 @Getter
 @Entity(name = "absence_attendacne_attachment_file")
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
@@ -28,6 +30,8 @@ public class AbsenceAttendanceAttachmentFile extends BaseTimeEntity {
     //버킷 내 고유 식별자, 전체 경로 포함
     private String s3Key;
 
+    private LocalDateTime deletionRequestedAt;
+
     @Builder
     public AbsenceAttendanceAttachmentFile(AbsenceAttendance absenceAttendance, String url, String originalName, String s3Key, String mime) {
         this.absenceAttendance = absenceAttendance;
@@ -37,4 +41,20 @@ public AbsenceAttendanceAttachmentFile(AbsenceAttendance absenceAttendance, Stri
         this.mime = mime;
     }
 
+    public void markDeletionRequested() {
+        this.deletionRequestedAt = LocalDateTime.now();
+    }
+
+    @Override
+    public String toString() {
+        return "AbsenceAttendanceAttachmentFile{" +
+                "id=" + id +
+                ", absenceAttendance=" + absenceAttendance +
+                ", url='" + url + '\'' +
+                ", mime='" + mime + '\'' +
+                ", originalName='" + originalName + '\'' +
+                ", s3Key='" + s3Key + '\'' +
+                ", deletionRequestedAt=" + deletionRequestedAt +
+                '}';
+    }
 }

api/src/main/java/org/example/educheck/domain/absenceattendanceattachmentfile/repository/AbsenceAttendanceAttachmentFileRepository.java

@@ -2,6 +2,14 @@
 
 import org.example.educheck.domain.absenceattendanceattachmentfile.entity.AbsenceAttendanceAttachmentFile;
 import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
+
+import java.time.LocalDateTime;
+import java.util.List;
 
 public interface AbsenceAttendanceAttachmentFileRepository extends JpaRepository<AbsenceAttendanceAttachmentFile, Long> {
+
+    @Query("SELECT a FROM absence_attendacne_attachment_file  a WHERE a.deletionRequestedAt <= :date")
+    List<AbsenceAttendanceAttachmentFile> findByDeletionRequestedAtBeforeAndDeleted(LocalDateTime date);
+
 }

api/src/main/java/org/example/educheck/domain/member/controller/MyController.java

@@ -64,4 +64,8 @@ public Collection<? extends GrantedAuthority> getAuthorities() {
     public String getUsername() {
         return email;
     }
+
+    public Long getStudentId() {
+        return student != null ? student.getId() : null;
+    }
 }

api/src/main/java/org/example/educheck/domain/member/entity/Member.java

@@ -10,6 +10,7 @@
 
 import java.util.ArrayList;
 import java.util.List;
+import java.util.Objects;
 
 
 @Entity
@@ -40,4 +41,17 @@ public Student(Member member, Status status, char courseParticipationStatus, Lis
         this.courseParticipationStatus = courseParticipationStatus;
         this.registrations = registrations;
     }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        Student student = (Student) o;
+        return Objects.equals(id, student.id);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(id);
+    }
 }

api/src/main/java/org/example/educheck/domain/member/student/entity/Student.java

@@ -2,9 +2,11 @@
 
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.context.annotation.Configuration;
+import org.springframework.scheduling.annotation.EnableScheduling;
 import org.springframework.web.servlet.config.annotation.CorsRegistry;
 import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
 
+@EnableScheduling
 @Configuration
 public class WebConfig implements WebMvcConfigurer {
 

api/src/main/java/org/example/educheck/global/common/config/WebConfig.java

@@ -0,0 +1,18 @@
+package org.example.educheck.global.common.exception.custom.common;
+
+
+import org.example.educheck.global.common.exception.ErrorCode;
+
+public class NotOwnerException extends GlobalException {
+    public NotOwnerException(ErrorCode errorCode) {
+        super(errorCode);
+    }
+
+    public NotOwnerException() {
+        super(ErrorCode.NOT_OWNER, ErrorCode.NOT_OWNER.getMessage());
+    }
+
+    public NotOwnerException(String message) {
+        super(ErrorCode.NOT_OWNER, message);
+    }
+}