#92 [BE] SISC1-204 [FEAT] 출석 세션 기능 개선

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

@@ -0,0 +1,254 @@
+package org.sejongisc.backend.attendance.controller;
+
+import io.jsonwebtoken.JwtException;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.servlet.http.HttpServletRequest;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.sejongisc.backend.attendance.dto.AttendanceCheckInRequest;
+import org.sejongisc.backend.attendance.dto.AttendanceCheckInResponse;
+import org.sejongisc.backend.attendance.dto.AttendanceRoundRequest;
+import org.sejongisc.backend.attendance.dto.AttendanceRoundResponse;
+import org.sejongisc.backend.attendance.service.AttendanceRoundService;
+import org.sejongisc.backend.attendance.service.AttendanceService;
+import org.sejongisc.backend.common.auth.jwt.JwtProvider;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.security.authentication.AnonymousAuthenticationToken;
+import org.springframework.security.core.Authentication;
+import org.springframework.web.bind.annotation.*;
+
+import java.time.LocalDate;
+import java.util.List;
+import java.util.UUID;
+
+@RestController
+@RequestMapping("/api/attendance")
+@RequiredArgsConstructor
+@Slf4j
+@Tag(
+        name = "출석 라운드(Attendance Round) API",
+        description = "출석 라운드(주차별 회차) 생성, 조회, 수정, 삭제 및 출석 체크인 관련 API"
+)
+public class AttendanceRoundController {
+
+    private final AttendanceRoundService attendanceRoundService;
+    private final AttendanceService attendanceService;
+    private final JwtProvider jwtProvider;
+
+    /**
+     * 라운드 생성
+     * POST /api/attendance/sessions/{sessionId}/rounds
+     */
+    @Operation(
+            summary = "라운드 생성",
+            description = "세션에 새로운 출석 라운드를 생성합니다. " +
+                    "라운드 날짜, 시작 시간, 출석 가능 시간을 설정할 수 있습니다."
+    )
+    @PostMapping("/sessions/{sessionId}/rounds")
+    @PreAuthorize("hasRole('PRESIDENT') or hasRole('VICE_PRESIDENT')")
+    public ResponseEntity<AttendanceRoundResponse> createRound(
+            @PathVariable UUID sessionId,
+            @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("  - startTime: {} (타입: {})", request.getStartTime(), request.getStartTime() != null ? request.getStartTime().getClass().getSimpleName() : "null");
+        log.info("  - allowedMinutes: {}", request.getAllowedMinutes());
+
+        if (request.getStartTime() != null) {
+            log.info("  - startTime 상세: 시간={}, 분={}, 초={}",
+                    request.getStartTime().getHour(),
+                    request.getStartTime().getMinute(),
+                    request.getStartTime().getSecond());
+        }
+
+        AttendanceRoundResponse response = attendanceRoundService.createRound(sessionId, request);
+        return ResponseEntity.status(HttpStatus.CREATED).body(response);
+    }
+
+    /**
+     * 라운드 조회 (개별)
+     * GET /api/attendance/rounds/{roundId}
+     */
+    @Operation(
+            summary = "라운드 조회",
+            description = "지정된 라운드 ID로 라운드 정보를 조회합니다. " +
+                    "라운드의 상태, 날짜, 시간, 참석 현황 등의 정보를 반환합니다."
+    )
+    @GetMapping("/rounds/{roundId}")
+    public ResponseEntity<AttendanceRoundResponse> getRound(@PathVariable UUID roundId) {
+        log.info("라운드 조회: roundId={}", roundId);
+        AttendanceRoundResponse response = attendanceRoundService.getRound(roundId);
+        return ResponseEntity.ok(response);
+    }
+
+    /**
+     * 세션 내 라운드 목록 조회
+     * GET /api/attendance/sessions/{sessionId}/rounds
+     */
+    @Operation(
+            summary = "세션의 라운드 목록 조회",
+            description = "지정된 세션에 속한 모든 라운드 목록을 조회합니다. " +
+                    "각 라운드의 상태, 시간, 참석 현황을 포함합니다."
+    )
+    @GetMapping("/sessions/{sessionId}/rounds")
+    public ResponseEntity<List<AttendanceRoundResponse>> getRoundsBySession(
+            @PathVariable UUID sessionId) {
+        log.info("세션 내 라운드 목록 조회: sessionId={}", sessionId);
+        List<AttendanceRoundResponse> response = attendanceRoundService.getRoundsBySession(sessionId);
+        return ResponseEntity.ok(response);
+    }
+
+    /**
+     * 라운드 정보 수정
+     * PUT /api/attendance/rounds/{roundId}
+     */
+    @Operation(
+            summary = "라운드 정보 수정",
+            description = "지정된 라운드의 정보를 수정합니다. " +
+                    "라운드 날짜, 시작 시간, 출석 가능 시간 등을 변경할 수 있습니다."
+    )
+    @PutMapping("/rounds/{roundId}")
+    @PreAuthorize("hasRole('PRESIDENT') or hasRole('VICE_PRESIDENT')")
+    public ResponseEntity<AttendanceRoundResponse> updateRound(
+            @PathVariable UUID roundId,
+            @Valid @RequestBody AttendanceRoundRequest request) {
+        log.info("라운드 수정: roundId={}", roundId);
+        AttendanceRoundResponse response = attendanceRoundService.updateRound(roundId, request);
+        return ResponseEntity.ok(response);
+    }
+
+    /**
+     * 라운드 삭제
+     * DELETE /api/attendance/rounds/{roundId}
+     */
+    @Operation(
+            summary = "라운드 삭제",
+            description = "지정된 라운드를 삭제합니다. " +
+                    "라운드와 관련된 모든 출석 기록도 함께 삭제됩니다."
+    )
+    @DeleteMapping("/rounds/{roundId}")
+    @PreAuthorize("hasRole('PRESIDENT') or hasRole('VICE_PRESIDENT')")
+    public ResponseEntity<Void> deleteRound(@PathVariable UUID roundId) {
+        log.info("라운드 삭제: roundId={}", roundId);
+        attendanceRoundService.deleteRound(roundId);
+        return ResponseEntity.noContent().build();
+    }
+
+    /**
+     * 라운드 기반 출석 체크인
+     * POST /api/attendance/rounds/check-in
+     */
+    @Operation(
+            summary = "라운드 출석 체크인",
+            description = "라운드에 출석 체크인을 기록합니다. " +
+                    "라운드 ID와 위치 정보(위도, 경도)를 전송하면 출석 여부를 판단합니다. " +
+                    "인증되지 않은 사용자는 이름을 입력하여 익명으로 출석할 수 있습니다."
+    )
+    @PostMapping("/rounds/check-in")
+    public ResponseEntity<AttendanceCheckInResponse> checkInByRound(
+            @Valid @RequestBody AttendanceCheckInRequest request,
+            Authentication authentication,
+            HttpServletRequest httpRequest) {
+        UUID userId;
+
+        // 인증된 경우 사용자 ID 추출, 미인증인 경우 임시 ID 생성
+        if (authentication != null && authentication.isAuthenticated()
+                && !(authentication instanceof AnonymousAuthenticationToken)) {
+            userId = extractUserId(authentication, httpRequest);
+            log.info("라운드 출석 체크인 요청 (인증됨): roundId={}, userId={}", request.getRoundId(), userId);
+        } else {
+            // 미인증 사용자: 임시 ID 사용
+            userId = UUID.randomUUID();
+            log.info("라운드 출석 체크인 요청 (미인증): roundId={}, 임시userId={}", request.getRoundId(), userId);
+        }
+
+        AttendanceCheckInResponse response = attendanceService.checkInByRound(request, userId);
+        return ResponseEntity.ok(response);
+    }
+
+    /**
+     * Authentication에서 사용자 ID를 추출합니다.
+     * JWT 토큰을 파싱하여 UUID를 반환하며, 파싱에 실패하면 예외를 던집니다.
+     *
+     * @param authentication 스프링 시큐리티 Authentication 객체
+     * @param httpRequest HTTP 요청 객체
+     * @return 추출된 사용자 UUID
+     * @throws IllegalStateException JWT 파싱 또는 UUID 변환에 실패한 경우
+     */
+    private UUID extractUserId(Authentication authentication, HttpServletRequest httpRequest) {
+        try {
+            // JWT 토큰에서 Authorization 헤더 추출
+            String authHeader = httpRequest.getHeader("Authorization");
+            if (authHeader == null || !authHeader.startsWith("Bearer ")) {
+                throw new IllegalStateException("Authorization 헤더가 없거나 형식이 올바르지 않습니다.");
+            }
+
+            String token = authHeader.substring(7);
+            // JwtProvider를 통해 uid 클레임에서 userId 추출
+            String userIdStr = jwtProvider.getUserIdFromToken(token);
+            if (userIdStr == null || userIdStr.isBlank()) {
+                throw new IllegalStateException("토큰에서 사용자 ID를 찾을 수 없습니다.");
+            }
+
+            return UUID.fromString(userIdStr);
+        } catch (JwtException e) {
+            log.error("JWT 파싱 실패: {}", e.getMessage(), e);
+            throw new IllegalStateException("인증 정보가 유효하지 않습니다. JWT 파싱에 실패했습니다.", e);
+        } catch (IllegalArgumentException e) {
+            log.error("UUID 변환 실패: {}", e.getMessage(), e);
+            throw new IllegalStateException("사용자 ID가 유효한 UUID 형식이 아닙니다.", e);
+        } catch (Exception e) {
+            log.error("사용자 ID 추출 중 오류 발생: {}", e.getMessage(), e);
+            throw new IllegalStateException("사용자 ID를 확인할 수 없습니다.", e);
+        }
+    }
+
+    /**
+     * 특정 날짜의 라운드 조회
+     * GET /api/attendance/sessions/{sessionId}/rounds/by-date
+     */
+    @Operation(
+            summary = "특정 날짜의 라운드 조회",
+            description = "지정된 세션과 날짜로 라운드를 조회합니다. " +
+                    "특정 날짜에만 진행되는 라운드를 찾을 때 사용합니다."
+    )
+    @GetMapping("/sessions/{sessionId}/rounds/by-date")
+    public ResponseEntity<AttendanceRoundResponse> getRoundByDate(
+            @PathVariable UUID sessionId,
+            @RequestParam LocalDate date) {
+        log.info("날짜별 라운드 조회: sessionId={}, date={}", sessionId, date);
+        AttendanceRoundResponse response = attendanceRoundService.getRoundByDate(sessionId, date);
+        return ResponseEntity.ok(response);
+    }
+
+    /**
+     * 라운드별 출석 명단 조회
+     * GET /api/attendance/rounds/{roundId}/attendances
+     */
+    @Operation(
+            summary = "라운드별 출석 명단 조회",
+            description = "지정된 라운드의 모든 출석 기록을 조회합니다. " +
+                    "참석자, 지각자, 결석자 등의 출석 상태별 명단을 반환합니다."
+    )
+    @GetMapping("/rounds/{roundId}/attendances")
+    @PreAuthorize("hasRole('PRESIDENT') or hasRole('VICE_PRESIDENT')")
+    public ResponseEntity<?> getAttendancesByRound(
+            @PathVariable UUID roundId) {
+        log.info("라운드별 출석 명단 조회: roundId={}", roundId);
+        // 라운드 조회 및 해당 라운드의 모든 출석 기록 반환
+        try {
+            var round = attendanceService.getAttendancesByRound(roundId);
+            return ResponseEntity.ok(round);
+        } catch (Exception e) {
+            log.error("라운드별 출석 명단 조회 실패: {}", e.getMessage());
+            return ResponseEntity.status(400).body(new java.util.HashMap<String, String>() {{
+                put("error", "라운드를 찾을 수 없습니다");
+            }});
+        }
+    }
+}

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

@@ -7,6 +7,7 @@
 import lombok.extern.slf4j.Slf4j;
 import org.sejongisc.backend.attendance.dto.AttendanceSessionRequest;
 import org.sejongisc.backend.attendance.dto.AttendanceSessionResponse;
+import org.sejongisc.backend.attendance.dto.SessionLocationUpdateRequest;
 import org.sejongisc.backend.attendance.entity.SessionStatus;
 import org.sejongisc.backend.attendance.service.AttendanceSessionService;
 import org.springframework.http.HttpStatus;
@@ -72,25 +73,6 @@ public ResponseEntity<AttendanceSessionResponse> getSession(@PathVariable UUID s
         return ResponseEntity.ok(response);
     }
 
-    /**
-     * 출석 코드로 세션 조회
-     * - 학생이 출석 코드 입력 시 사용
-     * - 체크인 가능 여부 확인
-     */
-    @Operation(
-            summary = "출석 코드로 세션 조회",
-            description = "6자리 출석 코드를 입력하여 해당 세션을 조회합니다. (학생용) " +
-                    "체크인 가능 여부, 남은 시간 등의 정보를 확인할 수 있습니다."
-    )
-    @GetMapping("/code/{code}")
-    public ResponseEntity<AttendanceSessionResponse> getSessionByCode(@PathVariable String code) {
-        log.info("출석 코드로 세션 조회: 코드={}", code);
-
-        AttendanceSessionResponse response = attendanceSessionService.getSessionByCode(code);
-
-        return ResponseEntity.ok(response);
-    }
-
     /**
      * 모든 세션 목록 조회
      * - 최신 순으로 정렬
@@ -148,43 +130,6 @@ public ResponseEntity<List<AttendanceSessionResponse>> getActiveSessions() {
         return ResponseEntity.ok(sessions);
     }
 
-    /**
-     * 태그별 세션 목록 조회
-     * - "금융IT", "동아리 전체" 등 태그로 필터링
-     */
-    @Operation(
-            summary = "태그별 세션 목록 조회",
-            description = "특정 태그를 가진 세션들을 조회합니다. " +
-                    "예: '금융IT', '동아리 전체', '스터디' 등으로 세션을 분류할 수 있습니다."
-    )
-    @GetMapping("/tag/{tag}")
-    public ResponseEntity<List<AttendanceSessionResponse>> getSessionsByTag(@PathVariable String tag) {
-        log.info("태그별 출석 세션 조회: 태그={}", tag);
-
-        List<AttendanceSessionResponse> sessions = attendanceSessionService.getSessionsByTag(tag);
-
-        return ResponseEntity.ok(sessions);
-    }
-
-    /**
-     * 상태별 세션 목록 조회 (관리자용)
-     * - UPCOMING/OPEN/CLOSED 상태별 필터링
-     */
-    @Operation(
-            summary = "상태별 세션 목록 조회",
-            description = "특정 상태의 세션들을 조회합니다. (관리자 전용) " +
-                    "UPCOMING(예정), OPEN(진행중), CLOSED(종료) 상태별로 필터링할 수 있습니다."
-    )
-    @GetMapping("/status/{status}")
-    @PreAuthorize("hasRole('PRESIDENT') or hasRole('VICE_PRESIDENT')")
-    public ResponseEntity<List<AttendanceSessionResponse>> getSessionsByStatus(@PathVariable SessionStatus status) {
-        log.info("상태별 출석 세션 조회: 상태={}", status);
-
-        List<AttendanceSessionResponse> sessions = attendanceSessionService.getSessionsByStatus(status);
-
-        return ResponseEntity.ok(sessions);
-    }
-
     /**
      * 세션 정보 수정 (관리자용)
      * - 제목, 시간, 위치, 반경 등 수정 가능
@@ -255,6 +200,31 @@ public ResponseEntity<Void> closeSession(@PathVariable UUID sessionId) {
         return ResponseEntity.ok().build();
     }
 
+    /**
+     * 세션 위치 재설정 (관리자용)
+     * - 기존 위치 정보를 새로운 위치로 업데이트
+     * - 반경은 기존 값 유지
+     */
+    @Operation(
+            summary = "세션 위치 재설정",
+            description = "세션의 위치 정보를 재설정합니다. (관리자 전용) " +
+                    "새로운 위도와 경도로 출석 기반 위치 검증 범위를 변경할 수 있습니다."
+    )
+    @PutMapping("/{sessionId}/location")
+    @PreAuthorize("hasRole('PRESIDENT') or hasRole('VICE_PRESIDENT')")
+    public ResponseEntity<AttendanceSessionResponse> updateSessionLocation(
+            @PathVariable UUID sessionId,
+            @Valid @RequestBody SessionLocationUpdateRequest request) {
+        log.info("세션 위치 재설정: 세션ID={}, 위도={}, 경도={}",
+                sessionId, request.getLatitude(), request.getLongitude());
+
+        AttendanceSessionResponse response = attendanceSessionService.updateSessionLocation(sessionId, request);
+
+        log.info("세션 위치 재설정 완료: 세션ID={}", sessionId);
+
+        return ResponseEntity.ok(response);
+    }
+
     /**
      * 세션 삭제 (관리자용)
      * - 세션 완전 삭제 (출석 기록도 함께 삭제)