feat: 스터디 통계 조회 API 추가

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

@@ -5,6 +5,7 @@
 import com.gdschongik.gdsc.domain.study.dto.response.AssignmentResponse;
 import com.gdschongik.gdsc.domain.study.dto.response.StudyCurriculumResponse;
 import com.gdschongik.gdsc.domain.study.dto.response.StudyMentorAttendanceResponse;
+import com.gdschongik.gdsc.domain.study.dto.response.StudyStatisticsResponse;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.validation.Valid;
@@ -80,4 +81,11 @@ public ResponseEntity<List<StudyMentorAttendanceResponse>> getAttendanceNumbers(
         List<StudyMentorAttendanceResponse> response = mentorStudyDetailService.getAttendanceNumbers(studyId);
         return ResponseEntity.ok(response);
     }
+
+    @Operation(summary = "스터디 통계 조회", description = "멘토가 자신의 스터디 출석률, 과제 제출률, 수료율에 대한 통계를 조회합니다. 휴강 주차는 계산에서 제외합니다.")
+    @GetMapping("/statistics")
+    public ResponseEntity<StudyStatisticsResponse> getStudyStatistics(@RequestParam(name = "studyId") Long studyId) {
+        StudyStatisticsResponse response = mentorStudyDetailService.getStudyStatistics(studyId);
+        return ResponseEntity.ok(response);
+    }
 }

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

@@ -1,15 +1,25 @@
 package com.gdschongik.gdsc.domain.study.application;
 
+import static com.gdschongik.gdsc.domain.study.domain.AssignmentSubmissionStatus.SUCCESS;
 import static com.gdschongik.gdsc.global.exception.ErrorCode.*;
 
 import com.gdschongik.gdsc.domain.member.domain.Member;
+import com.gdschongik.gdsc.domain.study.dao.AssignmentHistoryRepository;
+import com.gdschongik.gdsc.domain.study.dao.AttendanceRepository;
 import com.gdschongik.gdsc.domain.study.dao.StudyDetailRepository;
+import com.gdschongik.gdsc.domain.study.dao.StudyHistoryRepository;
+import com.gdschongik.gdsc.domain.study.dao.StudyRepository;
+import com.gdschongik.gdsc.domain.study.domain.Study;
 import com.gdschongik.gdsc.domain.study.domain.StudyDetail;
 import com.gdschongik.gdsc.domain.study.domain.StudyDetailValidator;
+import com.gdschongik.gdsc.domain.study.domain.StudyHistory;
+import com.gdschongik.gdsc.domain.study.domain.StudyValidator;
 import com.gdschongik.gdsc.domain.study.dto.request.AssignmentCreateUpdateRequest;
 import com.gdschongik.gdsc.domain.study.dto.response.AssignmentResponse;
 import com.gdschongik.gdsc.domain.study.dto.response.StudyCurriculumResponse;
 import com.gdschongik.gdsc.domain.study.dto.response.StudyMentorAttendanceResponse;
+import com.gdschongik.gdsc.domain.study.dto.response.StudyStatisticsResponse;
+import com.gdschongik.gdsc.domain.study.dto.response.StudyWeekStatisticsResponse;
 import com.gdschongik.gdsc.global.exception.CustomException;
 import com.gdschongik.gdsc.global.util.MemberUtil;
 import java.time.LocalDate;
@@ -27,6 +37,11 @@ public class MentorStudyDetailService {
     private final MemberUtil memberUtil;
     private final StudyDetailRepository studyDetailRepository;
     private final StudyDetailValidator studyDetailValidator;
+    private final StudyHistoryRepository studyHistoryRepository;
+    private final AttendanceRepository attendanceRepository;
+    private final AssignmentHistoryRepository assignmentHistoryRepository;
+    private final StudyValidator studyValidator;
+    private final StudyRepository studyRepository;
 
     @Transactional(readOnly = true)
     public List<AssignmentResponse> getWeeklyAssignments(Long studyId) {
@@ -108,4 +123,80 @@ public List<StudyMentorAttendanceResponse> getAttendanceNumbers(Long studyId) {
                 .limit(2)
                 .toList();
     }
+
+    @Transactional(readOnly = true)
+    public StudyStatisticsResponse getStudyStatistics(Long studyId) {
+        Member currentMember = memberUtil.getCurrentMember();
+        Study study = studyRepository.findById(studyId).orElseThrow(() -> new CustomException(STUDY_NOT_FOUND));
+        List<StudyHistory> studyHistories = studyHistoryRepository.findAllByStudyId(studyId);
+        List<StudyDetail> studyDetails = studyDetailRepository.findAllByStudyIdOrderByWeekAsc(studyId);
+        studyValidator.validateStudyMentor(currentMember, study);
+
+        long totalStudentCount = studyHistories.size();
+        long studyCompleteStudentCount =
+                studyHistories.stream().filter(StudyHistory::isComplete).count();
+
+        List<StudyWeekStatisticsResponse> studyWeekStatisticsResponses = studyDetails.stream()
+                .map((studyDetail -> calculateWeekStatistics(studyDetail, totalStudentCount)))
+                .toList();
+
+        long averageAttendanceRate = calculateAverageWeekAttendanceRate(studyWeekStatisticsResponses);
+        long averageAssignmentSubmitRate = calculateAverageWeekAssignmentSubmitRate(studyWeekStatisticsResponses);
+
+        return StudyStatisticsResponse.of(
+                totalStudentCount,
+                studyCompleteStudentCount,
+                averageAttendanceRate,
+                averageAssignmentSubmitRate,
+                studyWeekStatisticsResponses);
+    }
+
+    private StudyWeekStatisticsResponse calculateWeekStatistics(StudyDetail studyDetail, Long totalStudentCount) {
+        boolean isCanceledWeek = !studyDetail.getCurriculum().isOpen();
+        boolean isCanceledAssignment = !studyDetail.getAssignment().isOpen() || isCanceledWeek;
+
+        if (totalStudentCount == 0) {
+            return StudyWeekStatisticsResponse.emptyOf(studyDetail.getWeek(), isCanceledAssignment, isCanceledWeek);
+        }
+
+        if (isCanceledWeek) {
+            return StudyWeekStatisticsResponse.canceledWeekFrom(studyDetail.getWeek());
+        }
+
+        long attendanceCount = attendanceRepository.countByStudyDetailId(studyDetail.getId());
+        long attendanceRate = Math.round(attendanceCount / (double) totalStudentCount * 100);
+
+        if (isCanceledAssignment) {
+            return StudyWeekStatisticsResponse.canceledAssignmentOf(studyDetail.getWeek(), attendanceRate);
+        }
+
+        long assignmentCount =
+                assignmentHistoryRepository.countByStudyDetailIdAndSubmissionStatusEquals(studyDetail.getId(), SUCCESS);
+        long assignmentRate = Math.round(assignmentCount / (double) totalStudentCount * 100);
+
+        return StudyWeekStatisticsResponse.openedOf(studyDetail.getWeek(), attendanceRate, assignmentRate);
+    }
+
+    private long calculateAverageWeekAttendanceRate(List<StudyWeekStatisticsResponse> studyWeekStatisticsResponses) {
+
+        double averageAttendanceRate = studyWeekStatisticsResponses.stream()
+                .filter(weekStatisticsResponse -> !weekStatisticsResponse.isCanceledWeek())
+                .mapToLong(StudyWeekStatisticsResponse::attendanceRate)
+                .average()
+                .orElse(0);
+
+        return Math.round(averageAttendanceRate);
+    }
+
+    private long calculateAverageWeekAssignmentSubmitRate(
+            List<StudyWeekStatisticsResponse> studyWeekStatisticsResponses) {
+
+        double averageAssignmentSubmitRate = studyWeekStatisticsResponses.stream()
+                .filter(studyWeekStatistics -> !studyWeekStatistics.isCanceledAssignment())
+                .mapToLong(StudyWeekStatisticsResponse::assignmentSubmitRate)
+                .average()
+                .orElse(0);
+
+        return Math.round(averageAssignmentSubmitRate);
+    }
 }

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

@@ -2,11 +2,14 @@
 
 import com.gdschongik.gdsc.domain.member.domain.Member;
 import com.gdschongik.gdsc.domain.study.domain.AssignmentHistory;
+import com.gdschongik.gdsc.domain.study.domain.AssignmentSubmissionStatus;
 import com.gdschongik.gdsc.domain.study.domain.StudyDetail;
 import java.util.Optional;
 import org.springframework.data.jpa.repository.JpaRepository;
 
 public interface AssignmentHistoryRepository
         extends JpaRepository<AssignmentHistory, Long>, AssignmentHistoryCustomRepository {
     Optional<AssignmentHistory> findByMemberAndStudyDetail(Member member, StudyDetail studyDetail);
+
+    long countByStudyDetailIdAndSubmissionStatusEquals(Long studyDetailId, AssignmentSubmissionStatus status);
 }

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

@@ -5,4 +5,6 @@
 
 public interface AttendanceRepository extends JpaRepository<Attendance, Long>, AttendanceCustomRepository {
     boolean existsByStudentIdAndStudyDetailId(Long studentId, Long studyDetailId);
+
+    long countByStudyDetailId(Long studyDetailId);
 }

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

@@ -82,4 +82,8 @@ public void complete() {
     public boolean isWithinApplicationAndCourse() {
         return study.isWithinApplicationAndCourse();
     }
+
+    public boolean isComplete() {
+        return studyHistoryStatus == COMPLETED;
+    }
 }

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

@@ -0,0 +1,28 @@
+package com.gdschongik.gdsc.domain.study.dto.response;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import java.util.List;
+
+public record StudyStatisticsResponse(
+        @Schema(description = "스터디 전체 수강생 수") Long totalStudentCount,
+        @Schema(description = "스터디 수료 수강생 수") Long completeStudentCount,
+        @Schema(description = "평균 출석률") Long averageAttendanceRate,
+        @Schema(description = "평균 과제 제출률") Long averageAssignmentSubmitRate,
+        @Schema(description = "스터디 수료율") Long studyCompleteRate,
+        @Schema(description = "주차별 출석률 및 과제 제출률") List<StudyWeekStatisticsResponse> studyWeekStatisticsResponses) {
+
+    public static StudyStatisticsResponse of(
+            Long totalStudentCount,
+            Long completeStudentCount,
+            Long averageAttendanceRate,
+            Long averageAssignmentSubmitRate,
+            List<StudyWeekStatisticsResponse> studyWeekStatisticsResponses) {
+        return new StudyStatisticsResponse(
+                totalStudentCount,
+                completeStudentCount,
+                averageAttendanceRate,
+                averageAssignmentSubmitRate,
+                totalStudentCount == 0 ? 0 : Math.round(completeStudentCount / (double) totalStudentCount * 100),
+                studyWeekStatisticsResponses);
+    }
+}

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

@@ -0,0 +1,27 @@
+package com.gdschongik.gdsc.domain.study.dto.response;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+
+public record StudyWeekStatisticsResponse(
+        @Schema(description = "스터디 주차") Long week,
+        @Schema(description = "출석률") Long attendanceRate,
+        @Schema(description = "과제 제출률") Long assignmentSubmitRate,
+        @Schema(description = "과제 휴강 여부") boolean isCanceledAssignment,
+        @Schema(description = "스터디 휴강 여부") boolean isCanceledWeek) {
+
+    public static StudyWeekStatisticsResponse openedOf(Long week, Long attendanceRate, Long assignmentSubmitRate) {
+        return new StudyWeekStatisticsResponse(week, attendanceRate, assignmentSubmitRate, false, false);
+    }
+
+    public static StudyWeekStatisticsResponse emptyOf(Long week, boolean isCanceledAssignment, boolean isCanceledWeek) {
+        return new StudyWeekStatisticsResponse(week, 0L, 0L, isCanceledAssignment, isCanceledWeek);
+    }
+
+    public static StudyWeekStatisticsResponse canceledWeekFrom(Long week) {
+        return StudyWeekStatisticsResponse.emptyOf(week, true, true);
+    }
+
+    public static StudyWeekStatisticsResponse canceledAssignmentOf(Long week, Long attendanceRate) {
+        return new StudyWeekStatisticsResponse(week, attendanceRate, 0L, true, false);
+    }
+}