[EA3-162] feature: 출석 조회 기능 구현

Author: pia01190

src/main/java/grep/neogul_coder/domain/attendance/controller/AttendanceController.java

@@ -1,15 +1,13 @@
 package grep.neogul_coder.domain.attendance.controller;
 
-import grep.neogul_coder.domain.attendance.controller.dto.response.AttendanceResponse;
+import grep.neogul_coder.domain.attendance.controller.dto.response.AttendanceInfoResponse;
 import grep.neogul_coder.domain.attendance.service.AttendanceService;
 import grep.neogul_coder.global.auth.Principal;
 import grep.neogul_coder.global.response.ApiResponse;
 import lombok.RequiredArgsConstructor;
 import org.springframework.security.core.annotation.AuthenticationPrincipal;
 import org.springframework.web.bind.annotation.*;
 
-import java.util.List;
-
 @RequestMapping("/api/studies/{studyId}/attendances")
 @RequiredArgsConstructor
 @RestController
@@ -18,8 +16,10 @@ public class AttendanceController implements AttendanceSpecification {
     private final AttendanceService attendanceService;
 
     @GetMapping
-    public ApiResponse<List<AttendanceResponse>> getAttendances() {
-        return ApiResponse.success(List.of(new AttendanceResponse()));
+    public ApiResponse<AttendanceInfoResponse> getAttendances(@PathVariable("studyId") Long studyId,
+                                                              @AuthenticationPrincipal Principal userDetails) {
+        AttendanceInfoResponse attendances = attendanceService.getAttendances(studyId, userDetails.getUserId());
+        return ApiResponse.success(attendances);
     }
 
     @PostMapping

src/main/java/grep/neogul_coder/domain/attendance/controller/AttendanceSpecification.java

@@ -1,5 +1,6 @@
 package grep.neogul_coder.domain.attendance.controller;
 
+import grep.neogul_coder.domain.attendance.controller.dto.response.AttendanceInfoResponse;
 import grep.neogul_coder.domain.attendance.controller.dto.response.AttendanceResponse;
 import grep.neogul_coder.global.auth.Principal;
 import grep.neogul_coder.global.response.ApiResponse;
@@ -12,7 +13,7 @@
 public interface AttendanceSpecification {
 
     @Operation(summary = "출석 조회", description = "일주일 단위로 출석을 조회합니다.")
-    ApiResponse<List<AttendanceResponse>> getAttendances();
+    ApiResponse<AttendanceInfoResponse> getAttendances(Long studyId, Principal userDetails);
 
     @Operation(summary = "출석 체크", description = "스터디에 출석을 합니다.")
     ApiResponse<Long> createAttendance(Long studyId, Principal userDetails);

src/main/java/grep/neogul_coder/domain/attendance/controller/dto/response/AttendanceInfoResponse.java

@@ -0,0 +1,30 @@
+package grep.neogul_coder.domain.attendance.controller.dto.response;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Builder;
+import lombok.Getter;
+
+import java.util.List;
+
+@Getter
+public class AttendanceInfoResponse {
+    
+    @Schema(description = "출석일 목록")
+    private List<AttendanceResponse> attendances;
+
+    @Schema(description = "출석률", example = "50")
+    private int attendanceRate;
+
+    @Builder
+    private AttendanceInfoResponse(List<AttendanceResponse> attendances, int attendanceRate) {
+        this.attendances = attendances;
+        this.attendanceRate = attendanceRate;
+    }
+
+    public static AttendanceInfoResponse of(List<AttendanceResponse> responses, int attendanceRate) {
+        return AttendanceInfoResponse.builder()
+            .attendances(responses)
+            .attendanceRate(attendanceRate)
+            .build();
+    }
+}

src/main/java/grep/neogul_coder/domain/attendance/controller/dto/response/AttendanceResponse.java

@@ -1,6 +1,8 @@
 package grep.neogul_coder.domain.attendance.controller.dto.response;
 
+import grep.neogul_coder.domain.attendance.Attendance;
 import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Builder;
 import lombok.Getter;
 
 import java.time.LocalDate;
@@ -16,4 +18,19 @@ public class AttendanceResponse {
 
     @Schema(description = "출석일", example = "2025-07-10")
     private LocalDate attendanceDate;
+
+    @Builder
+    private AttendanceResponse(Long studyId, Long userId, LocalDate attendanceDate) {
+        this.studyId = studyId;
+        this.userId = userId;
+        this.attendanceDate = attendanceDate;
+    }
+
+    public static AttendanceResponse from(Attendance attendance) {
+        return AttendanceResponse.builder()
+            .studyId(attendance.getStudyId())
+            .userId(attendance.getUserId())
+            .attendanceDate(attendance.getAttendanceDate().toLocalDate())
+            .build();
+    }
 }

src/main/java/grep/neogul_coder/domain/attendance/repository/AttendanceRepository.java

@@ -6,11 +6,14 @@
 import org.springframework.data.repository.query.Param;
 
 import java.time.LocalDateTime;
+import java.util.List;
 
 public interface AttendanceRepository extends JpaRepository<Attendance, Long> {
     @Query("select count(a) > 0 from Attendance a where a.studyId = :studyId and a.userId = :userId and a.attendanceDate between :startOfDay and :endOfDay")
     boolean existsTodayAttendance(@Param("studyId") Long studyId,
-                                   @Param("userId") Long userId,
-                                   @Param("startOfDay") LocalDateTime startOfDay,
-                                   @Param("endOfDay") LocalDateTime endOfDay);
+                                  @Param("userId") Long userId,
+                                  @Param("startOfDay") LocalDateTime startOfDay,
+                                  @Param("endOfDay") LocalDateTime endOfDay);
+
+    List<Attendance> findByStudyIdAndUserId(Long studyId, Long userId);
 }

src/main/java/grep/neogul_coder/domain/attendance/service/AttendanceService.java

@@ -1,8 +1,11 @@
 package grep.neogul_coder.domain.attendance.service;
 
 import grep.neogul_coder.domain.attendance.Attendance;
+import grep.neogul_coder.domain.attendance.controller.dto.response.AttendanceInfoResponse;
+import grep.neogul_coder.domain.attendance.controller.dto.response.AttendanceResponse;
 import grep.neogul_coder.domain.attendance.repository.AttendanceRepository;
 import grep.neogul_coder.domain.study.Study;
+import grep.neogul_coder.domain.study.repository.StudyMemberRepository;
 import grep.neogul_coder.domain.study.repository.StudyRepository;
 import grep.neogul_coder.global.exception.business.BusinessException;
 import grep.neogul_coder.global.exception.business.NotFoundException;
@@ -13,9 +16,11 @@
 import java.time.LocalDate;
 import java.time.LocalDateTime;
 import java.time.LocalTime;
+import java.time.temporal.ChronoUnit;
+import java.util.List;
 
-import static grep.neogul_coder.domain.attendance.exception.code.AttendanceErrorCode.*;
-import static grep.neogul_coder.domain.study.exception.code.StudyErrorCode.*;
+import static grep.neogul_coder.domain.attendance.exception.code.AttendanceErrorCode.ATTENDANCE_ALREADY_CHECKED;
+import static grep.neogul_coder.domain.study.exception.code.StudyErrorCode.STUDY_NOT_FOUND;
 
 @Transactional(readOnly = true)
 @RequiredArgsConstructor
@@ -24,6 +29,21 @@ public class AttendanceService {
 
     private final AttendanceRepository attendanceRepository;
     private final StudyRepository studyRepository;
+    private final StudyMemberRepository studyMemberRepository;
+
+    public AttendanceInfoResponse getAttendances(Long studyId, Long userId) {
+        Study study = studyRepository.findByIdAndActivatedTrue(studyId)
+            .orElseThrow(() -> new NotFoundException(STUDY_NOT_FOUND));
+
+        List<Attendance> attendances = attendanceRepository.findByStudyIdAndUserId(studyId, userId);
+        List<AttendanceResponse> responses = attendances.stream()
+            .map(AttendanceResponse::from)
+            .toList();
+
+        int attendanceRate = getAttendanceRate(studyId, userId, study, responses);
+
+        return AttendanceInfoResponse.of(responses, attendanceRate);
+    }
 
     @Transactional
     public Long createAttendance(Long studyId, Long userId) {
@@ -37,9 +57,23 @@ public Long createAttendance(Long studyId, Long userId) {
         return attendance.getId();
     }
 
+    private int getAttendanceRate(Long studyId, Long userId, Study study, List<AttendanceResponse> responses) {
+        LocalDate start = study.getStartDate().toLocalDate();
+        LocalDate participated = studyMemberRepository.findCreatedDateByStudyIdAndUserId(studyId, userId).toLocalDate();
+        LocalDate attendanceStart = start.isAfter(participated) ? start : participated;
+        LocalDate end = study.getEndDate().toLocalDate();
+
+        int totalDays = (int) ChronoUnit.DAYS.between(attendanceStart, end) + 1;
+        int attendDays = responses.size();
+        int attendanceRate = totalDays == 0 ? 0 : Math.round(((float) attendDays / totalDays) * 100);
+
+        return attendanceRate;
+    }
+
     private void validateNotAlreadyChecked(Long studyId, Long userId) {
         LocalDateTime startOfDay = LocalDate.now().atStartOfDay();
         LocalDateTime endOfDay = LocalDate.now().atTime(LocalTime.MAX);
+
         if (attendanceRepository.existsTodayAttendance(studyId, userId, startOfDay, endOfDay)) {
             throw new BusinessException(ATTENDANCE_ALREADY_CHECKED);
         }

src/main/java/grep/neogul_coder/domain/study/repository/StudyMemberRepository.java

@@ -7,6 +7,7 @@
 import org.springframework.data.jpa.repository.Query;
 import org.springframework.data.repository.query.Param;
 
+import java.time.LocalDateTime;
 import java.util.List;
 import java.util.Optional;
 
@@ -31,4 +32,7 @@ public interface StudyMemberRepository extends JpaRepository<StudyMember, Long>
 
     @Query("select m from StudyMember m where m.study.id = :studyId and m.role = 'MEMBER' and m.activated = true")
     List<StudyMember> findAvailableNewLeaders(@Param("studyId") Long studyId);
+
+    @Query("select m.createdDate from StudyMember m where m.study.id = :studyId and m.userId = :userId and m.activated = true")
+    LocalDateTime findCreatedDateByStudyIdAndUserId(@Param("studyId") Long studyId, @Param("userId") Long userId);
 }