[EC-65] BE/feat: 퇴실 api 구현 (#54)

* [EC-65] feat: 출석 기록 조회 메서드 추가

- findByStudentIdAndCheckInTimestampBetween 메서드 추가

* [EC-65] feat: 퇴실 처리 로직 구현

- checkOut 메서드 추가
- 당일 출석 기록 조회 및 퇴실 시간 기록
- 지각, 조퇴, 정상 출석 상태 처리 로직 구현
- 중복 퇴실 처리 방지 로직 추가

* [EC-65] feat: 퇴실 API 엔드포인트 구현

Author: DaeJungYoon

api/src/main/java/org/example/educheck/domain/attendance/controller/AttendanceController.java

@@ -80,4 +80,17 @@ public ResponseEntity<ApiResponse<Object>> updateStudentAttendance(
                 null
         ));
     }
+
+    @PatchMapping("/checkout")
+    public ResponseEntity<ApiResponse<AttendanceStatusResponseDto>> checkOut(@AuthenticationPrincipal UserDetails user) {
+        Status attendanceStatus = attendanceService.checkOut(user);
+
+        AttendanceStatusResponseDto responseDto = new AttendanceStatusResponseDto(attendanceStatus);
+        return ResponseEntity.status(HttpStatus.OK)
+                .body(ApiResponse.ok(
+                "퇴실 성공",
+                "OK",
+                responseDto
+        ));
+    }
 }

api/src/main/java/org/example/educheck/domain/attendance/repository/AttendanceRepository.java

@@ -4,7 +4,9 @@
 import org.springframework.data.jpa.repository.JpaRepository;
 import org.springframework.data.jpa.repository.Query;
 
+import java.time.LocalDateTime;
 import java.util.List;
+import java.util.Optional;
 
 
 public interface AttendanceRepository extends JpaRepository<Attendance, Long> {
@@ -13,4 +15,10 @@ public interface AttendanceRepository extends JpaRepository<Attendance, Long> {
 
     @Query("SELECT a FROM Attendance a WHERE a.student = :studentId AND a.lecture = :lectureId")
     Attendance findByLectureIdStudentId(Long studentId, Long lectureId);
+
+    Optional<Attendance> findByStudentIdAndCheckInTimestampBetween(
+            Long studentId,
+            LocalDateTime startOfDay,
+            LocalDateTime endOfDay
+    );
 }

api/src/main/java/org/example/educheck/domain/attendance/service/AttendanceService.java

@@ -203,4 +203,42 @@ public void checkStaffHasCourse(UserDetails user, Long courseId) {
         staffCourseRepository.findByStaffIdAndCourseId(staff.getId(), courseId)
                 .orElseThrow(() -> new ResourceNotFoundException("관리자가 해당하는 강의를 가지고 있지 않습니다."));
     }
+
+    @Transactional
+    public Status checkOut(UserDetails user) {
+        String email = user.getUsername();
+        Member member = memberRepository.findByEmail(email)
+                .orElseThrow(() -> new ResourceNotFoundException("사용자 정보를 찾을 수 없습니다."));
+
+        Student student = studentRepository.findByMemberId(member.getId())
+                .orElseThrow(() -> new ResourceNotFoundException("학생 정보를 찾을 수 없습니다."));
+
+        LocalDate today = LocalDate.now();
+        LocalDateTime startOfDay = today.atStartOfDay();
+        LocalDateTime endOfDay = today.plusDays(1).atStartOfDay().minusNanos(1);
+
+        Attendance attendance = attendanceRepository.findByStudentIdAndCheckInTimestampBetween(
+                        student.getId(), startOfDay, endOfDay)
+                .orElseThrow(() -> new IllegalArgumentException("금일 출석 기록이 없습니다."));
+
+        if (attendance.getCheckOutTimestamp() != null) {
+            throw new IllegalStateException("이미 퇴실 처리되었습니다.");
+        }
+
+        LocalDateTime now = LocalDateTime.now();
+        attendance.setCheckOutTimestamp(now);
+
+        LocalTime earlyLeaveTime = LocalTime.of(17, 0);
+        if (attendance.getStatus() == Status.LATE) {
+            attendance.setStatus(Status.LATE);
+        } else if (now.toLocalTime().isBefore(earlyLeaveTime)) {
+            attendance.setStatus(Status.EARLY_LEAVE);
+        } else {
+            attendance.setStatus(Status.ATTENDANCE);
+        }
+
+        attendanceRepository.save(attendance);
+        return attendance.getStatus();
+    }
+
 }