feat: 이번주 과제 조회 API 구현

src/main/java/com/gdschongik/gdsc/domain/study/api/StudentStudyDetailController.java

@@ -2,8 +2,10 @@
 
 import com.gdschongik.gdsc.domain.study.application.StudentStudyDetailService;
 import com.gdschongik.gdsc.domain.study.dto.response.AssignmentDashboardResponse;
+import com.gdschongik.gdsc.domain.study.dto.response.AssignmentStatusResponse;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
+import java.util.List;
 import lombok.RequiredArgsConstructor;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.GetMapping;
@@ -26,4 +28,12 @@ public ResponseEntity<AssignmentDashboardResponse> getSubmittableAssignments(
         AssignmentDashboardResponse response = studentStudyDetailService.getSubmittableAssignments(studyId);
         return ResponseEntity.ok(response);
     }
+
+    @Operation(summary = "이번주 제출해야 할 과제 조회", description = "마감 기한이 이번주까지인 과제를 조회합니다.")
+    @GetMapping("/assignments/upcoming")
+    public ResponseEntity<List<AssignmentStatusResponse>> getUpcomingAssignments(
+            @RequestParam(name = "studyId") Long studyId) {
+        List<AssignmentStatusResponse> response = studentStudyDetailService.getUpcomingAssignments(studyId);
+        return ResponseEntity.ok(response);
+    }
 }

src/main/java/com/gdschongik/gdsc/domain/study/application/StudentStudyDetailService.java

@@ -6,6 +6,7 @@
 import com.gdschongik.gdsc.domain.study.domain.AssignmentHistory;
 import com.gdschongik.gdsc.domain.study.domain.StudyHistory;
 import com.gdschongik.gdsc.domain.study.dto.response.AssignmentDashboardResponse;
+import com.gdschongik.gdsc.domain.study.dto.response.AssignmentStatusResponse;
 import com.gdschongik.gdsc.domain.study.dto.response.AssignmentSubmittableDto;
 import com.gdschongik.gdsc.global.exception.CustomException;
 import com.gdschongik.gdsc.global.exception.ErrorCode;
@@ -31,7 +32,7 @@ public AssignmentDashboardResponse getSubmittableAssignments(Long studyId) {
                 .orElseThrow(() -> new CustomException(ErrorCode.STUDY_HISTORY_NOT_FOUND));
 
         List<AssignmentHistory> assignmentHistories =
-                assignmentHistoryRepository.findAssignmentHistoriesByMenteeAndStudy(currentMember, studyId);
+                assignmentHistoryRepository.findAssignmentHistoriesByMenteeAndStudyId(currentMember, studyId);
         boolean isAnySubmitted = assignmentHistories.stream().anyMatch(AssignmentHistory::isSubmitted);
         List<AssignmentSubmittableDto> submittableAssignments = assignmentHistories.stream()
                 .filter(assignmentHistory -> assignmentHistory.getStudyDetail().isAssignmentDeadlineRemaining())
@@ -40,4 +41,16 @@ public AssignmentDashboardResponse getSubmittableAssignments(Long studyId) {
 
         return AssignmentDashboardResponse.of(studyHistory.getRepositoryLink(), isAnySubmitted, submittableAssignments);
     }
+
+    @Transactional(readOnly = true)
+    public List<AssignmentStatusResponse> getUpcomingAssignments(Long studyId) {
+        Member currentMember = memberUtil.getCurrentMember();
+        List<AssignmentHistory> assignmentHistories =
+                assignmentHistoryRepository.findAssignmentHistoriesByMenteeAndStudyId(currentMember, studyId).stream()
+                        .filter(assignmentHistory ->
+                                assignmentHistory.getStudyDetail().isAssignmentDeadlineThisWeek())
+                        .toList();
+
+        return assignmentHistories.stream().map(AssignmentStatusResponse::from).toList();
+    }
 }

src/main/java/com/gdschongik/gdsc/domain/study/application/StudentStudyHistoryService.java

@@ -79,7 +79,7 @@ private String getOwnerRepo(String repositoryLink) {
     public List<AssignmentHistoryResponse> getAllAssignmentHistories(Long studyId) {
         Member currentMember = memberUtil.getCurrentMember();
 
-        return assignmentHistoryRepository.findAssignmentHistoriesByMenteeAndStudy(currentMember, studyId).stream()
+        return assignmentHistoryRepository.findAssignmentHistoriesByMenteeAndStudyId(currentMember, studyId).stream()
                 .map(AssignmentHistoryResponse::from)
                 .toList();
     }

src/main/java/com/gdschongik/gdsc/domain/study/dao/AssignmentHistoryCustomRepository.java

@@ -9,5 +9,5 @@ public interface AssignmentHistoryCustomRepository {
 
     boolean existsSubmittedAssignmentByMemberAndStudy(Member member, Study study);
 
-    List<AssignmentHistory> findAssignmentHistoriesByMenteeAndStudy(Member member, Long studyId);
+    List<AssignmentHistory> findAssignmentHistoriesByMenteeAndStudyId(Member member, Long studyId);
 }

src/main/java/com/gdschongik/gdsc/domain/study/dao/AssignmentHistoryCustomRepositoryImpl.java

@@ -41,7 +41,7 @@ private BooleanExpression isSubmitted() {
     }
 
     @Override
-    public List<AssignmentHistory> findAssignmentHistoriesByMenteeAndStudy(Member currentMember, Long studyId) {
+    public List<AssignmentHistory> findAssignmentHistoriesByMenteeAndStudyId(Member currentMember, Long studyId) {
         return queryFactory
                 .selectFrom(assignmentHistory)
                 .join(assignmentHistory.studyDetail, studyDetail)

src/main/java/com/gdschongik/gdsc/domain/study/domain/StudyDetail.java

@@ -94,6 +94,10 @@ public boolean isAssignmentDeadlineRemaining() {
         return assignment.isDeadlineRemaining();
     }
 
+    public boolean isAssignmentDeadlineThisWeek() {
+        return assignment.isDeadLineThisWeek();
+    }
+
     // 스터디 시작일자 + 현재 주차 * 7 + (스터디 요일 - 스터디 기간 시작 요일)
     public LocalDate getAttendanceDay() {
         return study.getStartDate()

src/main/java/com/gdschongik/gdsc/domain/study/domain/vo/Assignment.java

@@ -11,6 +11,8 @@
 import jakarta.persistence.Embeddable;
 import jakarta.persistence.EnumType;
 import jakarta.persistence.Enumerated;
+import java.time.DayOfWeek;
+import java.time.LocalDate;
 import java.time.LocalDateTime;
 import lombok.AccessLevel;
 import lombok.Builder;
@@ -91,4 +93,17 @@ public boolean isDeadlineRemaining() {
         LocalDateTime now = LocalDateTime.now();
         return now.isBefore(deadline);
     }
+
+    public boolean isDeadLineThisWeek() {
+        // 현재 날짜와 마감일의 날짜 부분을 비교할 것이므로 LocalDate로 변환
+        LocalDate now = LocalDate.now();
+        LocalDate startOfWeek = now.with(DayOfWeek.MONDAY); // 이번 주 월요일
+        LocalDate endOfWeek = now.with(DayOfWeek.SUNDAY); // 이번 주 일요일
+
+        // 마감일의 날짜 부분을 가져옴
+        LocalDate deadlineDate = deadline.toLocalDate();
+
+        // 마감일이 이번 주 내에 있는지 확인
+        return !deadlineDate.isBefore(startOfWeek) && !deadlineDate.isAfter(endOfWeek);
+    }
 }

src/main/java/com/gdschongik/gdsc/domain/study/dto/response/AssignmentStatusResponse.java

@@ -0,0 +1,36 @@
+package com.gdschongik.gdsc.domain.study.dto.response;
+
+import com.gdschongik.gdsc.domain.study.domain.*;
+import com.gdschongik.gdsc.domain.study.domain.vo.Assignment;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.annotation.Nullable;
+import java.time.LocalDateTime;
+
+public record AssignmentStatusResponse(
+        Long studyDetailId,
+        @Schema(description = "과제 상태") StudyStatus assignmentStatus,
+        @Schema(description = "주차") Long week,
+        @Nullable @Schema(description = "과제 제목") String title,
+        // TODO 추후 처리 예정
+        @Nullable @Schema(description = "과제 제출 상태") AssignmentSubmissionStatus assignmentSubmissionStatus,
+        @Nullable @Schema(description = "과제 명세 링크") String descriptionLink,
+        @Nullable @Schema(description = "마감 기한") LocalDateTime deadline,
+        @Nullable @Schema(description = "과제 제출 링크") String submissionLink,
+        @Nullable @Schema(description = "과제 제출 실패 사유") SubmissionFailureType submissionFailureType,
+        @Nullable @Schema(description = "최종 수정 일시") LocalDateTime committedAt) {
+    public static AssignmentStatusResponse from(AssignmentHistory assignmentHistory) {
+        StudyDetail studyDetail = assignmentHistory.getStudyDetail();
+        Assignment assignment = studyDetail.getAssignment();
+        return new AssignmentStatusResponse(
+                studyDetail.getId(),
+                assignment.getStatus(),
+                studyDetail.getWeek(),
+                assignment.getTitle(),
+                assignmentHistory.getSubmissionStatus(),
+                assignment.getDescriptionLink(),
+                assignment.getDeadline(),
+                assignmentHistory.getSubmissionLink(),
+                assignmentHistory.getSubmissionFailureType(),
+                assignmentHistory.getCommittedAt());
+    }
+}