[BE] SISC1-223 [FIX] 출석 세션 시간 변수 수정 (#140)

* refactor: 출석 세션 관련 수정

* fix: roundDto 변수명 수정

* test: test코드 수정

Author: ochanhyeok

backend/src/main/java/org/sejongisc/backend/attendance/controller/AttendanceRoundController.java

@@ -55,9 +55,9 @@ public ResponseEntity<AttendanceRoundResponse> createRound(
             @Valid @RequestBody AttendanceRoundRequest request) {
         log.info("📋 라운드 생성 요청 도착:");
         log.info("  - sessionId: {}", sessionId);
-        log.info("  - roundDate: {} (타입: {})", request.getRoundDate(), request.getRoundDate() != null ? request.getRoundDate().getClass().getSimpleName() : "null");
+        log.info("  - date: {} (타입: {})", request.getDate(), request.getDate() != null ? request.getDate().getClass().getSimpleName() : "null");
         log.info("  - startTime: {} (타입: {})", request.getStartTime(), request.getStartTime() != null ? request.getStartTime().getClass().getSimpleName() : "null");
-        log.info("  - allowedMinutes: {}", request.getAllowedMinutes());
+        log.info("  - availableMinutes: {}", request.getAvailableMinutes());
 
         if (request.getStartTime() != null) {
             log.info("  - startTime 상세: 시간={}, 분={}, 초={}",

backend/src/main/java/org/sejongisc/backend/attendance/controller/AttendanceSessionController.java

@@ -34,13 +34,13 @@ public class AttendanceSessionController {
      * 출석 세션 생성 (관리자용)
      * - 6자리 랜덤 코드 자동 생성
      * - GPS 위치 및 반경 설정
-     * - 시간 윈도우 설정
+     * - 기본 시작 시간 및 출석 인정 시간 설정
      */
     @Operation(
             summary = "출석 세션 생성",
             description = "새로운 출석 세션을 생성합니다. (관리자 전용) " +
-                    "6자리 랜덤 코드가 자동 생성되며, GPS 위치 정보, 시간 윈도우, " +
-                    "보상 포인트 등을 설정할 수 있습니다."
+                    "6자리 랜덤 코드가 자동 생성되며, GPS 위치 정보, 기본 시작 시간, " +
+                    "출석 인정 시간, 보상 포인트 등을 설정할 수 있습니다."
     )
     @PostMapping
     @PreAuthorize("hasRole('PRESIDENT') or hasRole('VICE_PRESIDENT')")
@@ -132,13 +132,13 @@ public ResponseEntity<List<AttendanceSessionResponse>> getActiveSessions() {
 
     /**
      * 세션 정보 수정 (관리자용)
-     * - 제목, 시간, 위치, 반경 등 수정 가능
+     * - 제목, 기본 시간, 위치, 반경 등 수정 가능
      * - 코드는 변경 불가
      */
     @Operation(
             summary = "세션 정보 수정",
             description = "세션의 기본 정보를 수정합니다. (관리자 전용) " +
-                    "제목, 태그, 시간, GPS 위치, 반경, 포인트 등을 수정할 수 있으며, " +
+                    "제목, 기본 시작 시간, 출석 인정 시간, GPS 위치, 반경, 포인트 등을 수정할 수 있으며, " +
                     "6자리 코드는 변경할 수 없습니다."
     )
     @PutMapping("/{sessionId}")

backend/src/main/java/org/sejongisc/backend/attendance/dto/AttendanceRoundRequest.java

@@ -39,7 +39,7 @@ public class AttendanceRoundRequest {
             type = "string",
             format = "date"
     )
-    private LocalDate roundDate;
+    private LocalDate date;
 
     @NotNull(message = "시작 시간은 필수입니다")
     @Schema(
@@ -60,5 +60,5 @@ public class AttendanceRoundRequest {
             minimum = "1",
             maximum = "120"
     )
-    private Integer allowedMinutes;
+    private Integer availableMinutes;
 }

backend/src/main/java/org/sejongisc/backend/attendance/dto/AttendanceRoundResponse.java

@@ -35,7 +35,7 @@ public class AttendanceRoundResponse {
             format = "date"
     )
     @JsonFormat(pattern = "yyyy-MM-dd")
-    private LocalDate roundDate;
+    private LocalDate date;
 
     @Schema(
             description = "라운드 출석 시작 시간",
@@ -69,7 +69,7 @@ public static AttendanceRoundResponse fromEntity(AttendanceRound round) {
 
         return AttendanceRoundResponse.builder()
                 .roundId(round.getRoundId())
-                .roundDate(round.getRoundDate())
+                .date(round.getRoundDate())
                 .startTime(round.getStartTime())
                 .availableMinutes(round.getAllowedMinutes())
                 .status(statusString)

backend/src/main/java/org/sejongisc/backend/attendance/dto/AttendanceSessionRequest.java

@@ -1,10 +1,11 @@
 package org.sejongisc.backend.attendance.dto;
 
+import com.fasterxml.jackson.annotation.JsonFormat;
 import io.swagger.v3.oas.annotations.media.Schema;
 import jakarta.validation.constraints.*;
 import lombok.*;
 
-import java.time.LocalDateTime;
+import java.time.LocalTime;
 
 @Getter
 @Builder
@@ -19,33 +20,34 @@ public class AttendanceSessionRequest {
 
     @Schema(
             description = "세션의 제목/이름",
-            example = "2024년 10월 동아리 정기 모임",
+            example = "금융 IT팀 세션",
             maxLength = 100
     )
     @NotBlank(message = "제목은 필수입니다")
     @Size(max = 100, message = "제목은 100자 이하여야 합니다")
     private String title;
 
     @Schema(
-            description = "세션 시작 시간 (ISO 8601 형식). 현재 시간 이후여야 합니다.",
-            example = "2024-11-15T14:00:00",
+            description = "세션의 기본 시작 시간 (HH:MM:SS 형식). " +
+                    "모든 라운드는 이 시간을 기본값으로 사용합니다.",
+            example = "18:30:00",
             type = "string",
-            format = "date-time"
+            format = "time"
     )
     @NotNull(message = "시작 시간은 필수입니다")
-    @Future(message = "시작 시간은 현재 시간 이후여야 합니다")
-    private LocalDateTime startsAt;
+    @JsonFormat(pattern = "HH:mm:ss")
+    private LocalTime defaultStartTime;
 
     @Schema(
-            description = "출석 체크인이 가능한 시간 윈도우 (초 단위). " +
-                    "범위: 300초(5분) ~ 14400초(4시간)",
-            example = "1800",
-            minimum = "300",
-            maximum = "14400"
+            description = "출석 인정 시간 (분 단위). " +
+                    "범위: 1분 ~ 240분(4시간)",
+            example = "30",
+            minimum = "1",
+            maximum = "240"
     )
-    @Min(value = 300, message = "최소 5분 이상이어야 합니다")
-    @Max(value = 14400, message = "최대 4시간 설정 가능합니다")
-    private Integer windowSeconds;
+    @Min(value = 1, message = "최소 1분 이상이어야 합니다")
+    @Max(value = 240, message = "최대 240분(4시간) 설정 가능합니다")
+    private Integer defaultAvailableMinutes;
 
     @Schema(
             description = "출석 완료 시 지급할 포인트",

backend/src/main/java/org/sejongisc/backend/attendance/entity/Attendance.java

@@ -65,12 +65,25 @@ public class Attendance extends BasePostgresEntity {
 
     /**
      * 지각 여부 판단
+     * - 라운드 기반: 라운드 시작 시간 이후이면 지각
+     * - 세션 기반: 라운드 없이 진행되는 경우는 확인 불가
      */
     public boolean isLate() {
-        if (checkedAt == null || attendanceSession.getStartsAt() == null) {
+        if (checkedAt == null) {
             return false;
         }
-        return checkedAt.isAfter(attendanceSession.getStartsAt());
+
+        // 라운드 기반 체크인인 경우
+        if (attendanceRound != null) {
+            LocalDateTime roundStartTime = LocalDateTime.of(
+                    attendanceRound.getRoundDate(),
+                    attendanceRound.getStartTime()
+            );
+            return checkedAt.isAfter(roundStartTime);
+        }
+
+        // 라운드 없는 경우 지각 판단 불가
+        return false;
     }
 
     /**

backend/src/main/java/org/sejongisc/backend/attendance/entity/AttendanceSession.java

@@ -1,11 +1,12 @@
 package org.sejongisc.backend.attendance.entity;
 
+import com.fasterxml.jackson.annotation.JsonFormat;
 import com.fasterxml.jackson.annotation.JsonManagedReference;
 import jakarta.persistence.*;
 import lombok.*;
 import org.sejongisc.backend.common.entity.postgres.BasePostgresEntity;
 
-import java.time.LocalDateTime;
+import java.time.LocalTime;
 import java.util.ArrayList;
 import java.util.List;
 import java.util.UUID;
@@ -24,13 +25,14 @@ public class AttendanceSession extends BasePostgresEntity {
     private UUID attendanceSessionId;
 
     @Column(nullable = false)
-    private String title;       // "세투연 9/17"
+    private String title;       // "금융 IT팀 세션"
 
-    @Column(name = "starts_at", nullable = false)
-    private LocalDateTime startsAt;     // 세션 시작 시간
+    @Column(name = "default_start_time", nullable = false)
+    @JsonFormat(pattern = "HH:mm:ss")
+    private LocalTime defaultStartTime;     // 기본 시작 시간 (시간만) - 18:30:00
 
-    @Column(name = "window_seconds")
-    private Integer windowSeconds;      // 체크인 가능 시간(초) - 1800 = 30분
+    @Column(name = "default_available_minutes")
+    private Integer defaultAvailableMinutes;      // 출석 인정 시간(분) - 30분
 
     @Column(unique = true, length = 6)
     private String code;            // 6자리 출석 코드 "942715"
@@ -55,46 +57,19 @@ public class AttendanceSession extends BasePostgresEntity {
     private List<Attendance> attendances = new ArrayList<>();
 
     /**
-     * 현재 세션 상태 계산
+     * 세션 상태를 반환합니다.
+     * - UPCOMING: 활성화되지 않은 상태
+     * - OPEN: 관리자가 활성화한 상태 (체크인 가능)
+     * - CLOSED: 관리자가 종료한 상태 (체크인 불가)
      */
-    public SessionStatus calculateCurrentStatus() {
-        LocalDateTime now = LocalDateTime.now();
-
-        if (now.isBefore(startsAt)) {
-            return SessionStatus.UPCOMING;
-        } else if (now.isAfter(getEndsAt())) {
-            return SessionStatus.CLOSED;
-        } else {
-            return SessionStatus.OPEN;
-        }
+    public SessionStatus getCurrentStatus() {
+        return this.status;
     }
 
     /**
-     * 세션 종료 시간 계산
+     * 체크인이 가능한 상태인지 확인합니다.
      */
     public boolean isCheckInAvailable() {
-        LocalDateTime now = LocalDateTime.now();
-        return now.isAfter(startsAt) && now.isBefore(getEndsAt());
-    }
-
-    /**
-     * 세션 종료 시간 계산
-     */
-    public LocalDateTime getEndsAt() {
-        return startsAt.plusSeconds(windowSeconds != null ? windowSeconds : 1800);
-    }
-
-    /**
-     * 남은 시간 계산 (초단위)
-     */
-    public long getRemainingSeconds() {
-        LocalDateTime now = LocalDateTime.now();
-        LocalDateTime endsAt = getEndsAt();
-
-        if (now.isAfter(endsAt)) {
-            return 0;
-        }
-
-        return java.time.Duration.between(now, endsAt).getSeconds();
+        return SessionStatus.OPEN.equals(this.status);
     }
 }

backend/src/main/java/org/sejongisc/backend/attendance/service/AttendanceRoundService.java

@@ -35,28 +35,25 @@ public class AttendanceRoundService {
      * 라운드 생성
      */
     public AttendanceRoundResponse createRound(UUID sessionId, AttendanceRoundRequest request) {
-        log.info("📋 라운드 생성 요청: sessionId={}, roundDate={}, startTime={}, allowedMinutes={}",
-                sessionId, request.getRoundDate(), request.getStartTime(), request.getAllowedMinutes());
+        log.info("📋 라운드 생성 요청: sessionId={}, date={}, startTime={}, availableMinutes={}",
+                sessionId, request.getDate(), request.getStartTime(), request.getAvailableMinutes());
 
         AttendanceSession session = attendanceSessionRepository.findById(sessionId)
                 .orElseThrow(() -> new IllegalArgumentException("세션을 찾을 수 없습니다: " + sessionId));
 
         try {
-            // 클라이언트가 보낸 날짜 대신 서버의 현재 날짜를 사용하여 시간대 차이 방지
-            LocalDate roundDate = request.getRoundDate();
-            if (roundDate == null) {
-                roundDate = LocalDate.now();
-            }
+            // 클라이언트가 제공한 날짜를 사용하고, 없으면 서버의 현재 날짜를 기본값으로 사용
+            LocalDate roundDate = request.getDate() != null ? request.getDate() : LocalDate.now();
             LocalTime requestStartTime = request.getStartTime();
 
-            log.info("📅 시간대 정보: 클라이언트 roundDate={}, 서버 today={}, 요청 startTime={}",
-                    request.getRoundDate(), roundDate, requestStartTime);
+            log.info("📅 시간대 정보: 클라이언트 date={}, 사용할 roundDate={}, 요청 startTime={}",
+                    request.getDate(), roundDate, requestStartTime);
 
             AttendanceRound round = AttendanceRound.builder()
                     .attendanceSession(session)
-                    .roundDate(roundDate)
+                    .roundDate(roundDate)  // 클라이언트 날짜를 우선 사용
                     .startTime(requestStartTime)
-                    .allowedMinutes(request.getAllowedMinutes() != null ? request.getAllowedMinutes() : 30)
+                    .allowedMinutes(request.getAvailableMinutes() != null ? request.getAvailableMinutes() : 30)
                     .roundStatus(RoundStatus.UPCOMING)
                     .build();
 
@@ -115,9 +112,9 @@ public AttendanceRoundResponse updateRound(UUID roundId, AttendanceRoundRequest
                 .orElseThrow(() -> new IllegalArgumentException("라운드를 찾을 수 없습니다: " + roundId));
 
         round.updateRoundInfo(
-                request.getRoundDate(),
+                request.getDate(),
                 request.getStartTime(),
-                request.getAllowedMinutes()
+                request.getAvailableMinutes()
         );
 
         AttendanceRound updated = attendanceRoundRepository.save(round);

backend/src/main/java/org/sejongisc/backend/attendance/service/AttendanceService.java

@@ -75,24 +75,27 @@ public AttendanceResponse checkIn(UUID sessionId, AttendanceRequest request, UUI
         }
 
 
+        // 세션의 활성 라운드를 찾음
         LocalDateTime now = LocalDateTime.now();
-        if (now.isBefore(session.getStartsAt())) {
-            throw new IllegalStateException("아직 출석 시간이 아닙니다");
-        }
-
-        LocalDateTime endTime = session.getEndsAt();
-        if (now.isAfter(endTime)) {
-            throw new IllegalStateException("출석 시간이 종료되었습니다");
-        }
+        AttendanceRound activeRound = session.getRounds().stream()
+                .filter(round -> {
+                    LocalDateTime roundStart = LocalDateTime.of(round.getRoundDate(), round.getStartTime());
+                    LocalDateTime roundEnd = roundStart.plusMinutes(round.getAllowedMinutes());
+                    return !now.isBefore(roundStart) && now.isBefore(roundEnd);
+                })
+                .findFirst()
+                .orElseThrow(() -> new IllegalStateException("현재 진행 중인 라운드가 없습니다"));
 
         // 시작 후 5분 이내는 정상 출석, 이후는 지각
-        LocalDateTime lateThreshold = session.getStartsAt().plusMinutes(5);
+        LocalDateTime roundStart = LocalDateTime.of(activeRound.getRoundDate(), activeRound.getStartTime());
+        LocalDateTime lateThreshold = roundStart.plusMinutes(5);
         AttendanceStatus status = now.isAfter(lateThreshold) ?
                 AttendanceStatus.LATE : AttendanceStatus.PRESENT;
 
         Attendance attendance = Attendance.builder()
                 .user(user)
                 .attendanceSession(session)
+                .attendanceRound(activeRound)
                 .attendanceStatus(status)
                 .checkedAt(now)
                 .awardedPoints(session.getRewardPoints())
@@ -101,6 +104,7 @@ public AttendanceResponse checkIn(UUID sessionId, AttendanceRequest request, UUI
                 .deviceInfo(request.getDeviceInfo())
                 .build();
 
+
         attendance = attendanceRepository.save(attendance);
 
         log.info("출석 체크인 완료: 사용자={}, 상태={}", user.getName(), status);