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

Author: pia01190

src/main/java/grep/neogul_coder/domain/attendance/Attendance.java

@@ -2,15 +2,18 @@
 
 import grep.neogul_coder.global.entity.BaseEntity;
 import jakarta.persistence.*;
+import lombok.Builder;
+import lombok.Getter;
 
-import java.time.LocalDate;
+import java.time.LocalDateTime;
 
+@Getter
 @Entity
 public class Attendance extends BaseEntity {
 
     @Id
     @GeneratedValue(strategy = GenerationType.IDENTITY)
-    private Long attendanceId;
+    private Long id;
 
     @Column(nullable = false)
     private Long studyId;
@@ -19,5 +22,22 @@ public class Attendance extends BaseEntity {
     private Long userId;
 
     @Column(nullable = false)
-    private LocalDate attendanceDate;
+    private LocalDateTime attendanceDate;
+
+    protected Attendance() {}
+
+    @Builder
+    private Attendance(Long studyId, Long userId, LocalDateTime attendanceDate) {
+        this.studyId = studyId;
+        this.userId = userId;
+        this.attendanceDate = attendanceDate;
+    }
+
+    public static Attendance create(Long studyId, Long userId) {
+        return Attendance.builder()
+            .studyId(studyId)
+            .userId(userId)
+            .attendanceDate(LocalDateTime.now())
+            .build();
+    }
 }

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

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

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

@@ -1,6 +1,7 @@
 package grep.neogul_coder.domain.attendance.controller;
 
 import grep.neogul_coder.domain.attendance.controller.dto.response.AttendanceResponse;
+import grep.neogul_coder.global.auth.Principal;
 import grep.neogul_coder.global.response.ApiResponse;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
@@ -14,5 +15,5 @@ public interface AttendanceSpecification {
     ApiResponse<List<AttendanceResponse>> getAttendances();
 
     @Operation(summary = "출석 체크", description = "스터디에 출석을 합니다.")
-    ApiResponse<Void> createAttendance();
+    ApiResponse<Long> createAttendance(Long studyId, Principal userDetails);
 }

src/main/java/grep/neogul_coder/domain/attendance/exception/code/AttendanceErrorCode.java

@@ -0,0 +1,21 @@
+package grep.neogul_coder.domain.attendance.exception.code;
+
+import grep.neogul_coder.global.response.code.ErrorCode;
+import lombok.Getter;
+import org.springframework.http.HttpStatus;
+
+@Getter
+public enum AttendanceErrorCode implements ErrorCode {
+
+    ATTENDANCE_ALREADY_CHECKED("A001", HttpStatus.BAD_REQUEST, "출석은 하루에 한 번만 가능합니다.");
+
+    private final String code;
+    private final HttpStatus status;
+    private final String message;
+
+    AttendanceErrorCode(String code, HttpStatus status, String message) {
+        this.code = code;
+        this.status = status;
+        this.message = message;
+    }
+}

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

@@ -0,0 +1,16 @@
+package grep.neogul_coder.domain.attendance.repository;
+
+import grep.neogul_coder.domain.attendance.Attendance;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.query.Param;
+
+import java.time.LocalDateTime;
+
+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);
+}

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

@@ -0,0 +1,47 @@
+package grep.neogul_coder.domain.attendance.service;
+
+import grep.neogul_coder.domain.attendance.Attendance;
+import grep.neogul_coder.domain.attendance.repository.AttendanceRepository;
+import grep.neogul_coder.domain.study.Study;
+import grep.neogul_coder.domain.study.repository.StudyRepository;
+import grep.neogul_coder.global.exception.business.BusinessException;
+import grep.neogul_coder.global.exception.business.NotFoundException;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+
+import static grep.neogul_coder.domain.attendance.exception.code.AttendanceErrorCode.*;
+import static grep.neogul_coder.domain.study.exception.code.StudyErrorCode.*;
+
+@Transactional(readOnly = true)
+@RequiredArgsConstructor
+@Service
+public class AttendanceService {
+
+    private final AttendanceRepository attendanceRepository;
+    private final StudyRepository studyRepository;
+
+    @Transactional
+    public Long createAttendance(Long studyId, Long userId) {
+        Study study = studyRepository.findByIdAndActivatedTrue(studyId)
+            .orElseThrow(() -> new NotFoundException(STUDY_NOT_FOUND));
+
+        validateNotAlreadyChecked(studyId, userId);
+
+        Attendance attendance = Attendance.create(studyId, userId);
+        attendanceRepository.save(attendance);
+        return attendance.getId();
+    }
+
+    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);
+        }
+    }
+}