chore: 코드 정리 (#57)

Author: joonhyong

hs_err_pid59708.log

@@ -36,7 +36,7 @@ public void logout(
                 CookieUtils.deleteRefreshTokenCookie(cookieSecure)
         );
 
-        // 2. 레거시 쿠키(Path=/api/auth)도 삭제 (과거 잔재 청소)
+        // 2. 레거시 쿠키(Path=/api/auth)도 삭제
         response.addCookie(CookieUtils.deleteRefreshTokenCookie(cookieSecure, "/api/auth", "Lax"));
         response.addCookie(CookieUtils.deleteRefreshTokenCookie(cookieSecure, "/api/auth", "Strict"));
     }

replay_pid59708.log

@@ -39,7 +39,7 @@ public OAuthLoginResponse login(
     ) {
         OAuthLoginResult result = oAuthService.login(OAuthProvider.from(provider), code);
 
-        // 1. 레거시(/api/auth) 쿠키 제거 (예전 SameSite가 Strict였다면 Strict로 한 번 더)
+        // 1. 레거시(/api/auth) 쿠키 제거
         response.addCookie(CookieUtils.deleteRefreshTokenCookie(cookieSecure, "/api/auth", "Strict"));
         response.addCookie(CookieUtils.deleteRefreshTokenCookie(cookieSecure, "/api/auth", "Lax"));
 

src/main/java/com/ureca/unity/domain/auth/controller/LogoutController.java

@@ -18,7 +18,6 @@ public class LogoutServiceImpl implements LogoutService {
     @Override
     public void logout(String refreshToken) {
 
-// refreshToken 없어도 로그아웃은 성공
         if (refreshToken == null || refreshToken.isBlank()) {
             log.info("Logout: no refreshToken provided");
             return;

src/main/java/com/ureca/unity/domain/auth/controller/OAuthController.java

@@ -54,18 +54,15 @@ public void saveRefreshToken(Long userId, String refreshToken) {
     public TokenResponse refreshAccessToken(HttpServletRequest request,
                                             HttpServletResponse response) {
 
-        // 1. Cookie에서 refreshToken 추출
         String refreshToken = extractRefreshToken(request);
 
-        // 1-1. JWT 서명 검증 (DB 조회 전)
         Long jwtUserId;
         try {
             jwtUserId = jwtProvider.getUserId(refreshToken, "refresh");
         } catch (JwtException | IllegalArgumentException | CustomException e) {
             throw new CustomException(ErrorCode.REFRESH_TOKEN_INVALID);
         }
 
-        // 2. DB 조회
         RefreshToken savedToken = refreshTokenMapper.findByToken(refreshToken)
                 .orElseThrow(() ->
                         new CustomException(ErrorCode.REFRESH_TOKEN_INVALID)
@@ -75,10 +72,8 @@ public TokenResponse refreshAccessToken(HttpServletRequest request,
             throw new CustomException(ErrorCode.REFRESH_TOKEN_INVALID);
         }
 
-        // 3. 만료 체크
         if (savedToken.getExpiresAt().isBefore(Instant.now())) {
-            // 만료된 토큰은 즉시 삭제 후 예외 반환 (rotation 로직 미진입)
-            refreshTokenMapper.deleteByToken(refreshToken); // 만료 토큰 정리
+            refreshTokenMapper.deleteByToken(refreshToken);
             throw new CustomException(ErrorCode.REFRESH_TOKEN_EXPIRED);
         }
 
@@ -88,30 +83,24 @@ public TokenResponse refreshAccessToken(HttpServletRequest request,
             throw new CustomException(ErrorCode.REFRESH_TOKEN_INVALID);
         }
 
-        // 4. 기존 refreshToken 폐기 (Rotation 로직 진입)
         int deletedCount = refreshTokenMapper.deleteByToken(refreshToken);
         if (deletedCount == 0) {
             throw new CustomException(ErrorCode.REFRESH_TOKEN_INVALID);
         }
 
-        // 5. 새 Access + Refresh 발급
         TokenResponse accessToken = jwtIssuer.issueAccessToken(userId);
 
-        // 6. 새 refreshToken 발급
         String newRefreshToken = jwtIssuer.issueRefreshToken(userId);
 
-        // 7. DB 저장
         saveRefreshToken(userId, newRefreshToken);
 
-        // 8. 새 refreshToken 쿠키 설정
         response.addCookie(CookieUtils.createRefreshTokenCookie(
                 newRefreshToken,
                 jwtProperties.refreshExpirationSeconds(),
                 cookieSecure
                 )
         );
 
-        // 9. accessToken만 반환
         return accessToken;
     }
 

src/main/java/com/ureca/unity/domain/auth/service/LogoutServiceImpl.java

@@ -4,6 +4,7 @@
 import com.ureca.unity.domain.call.service.CallService;
 import com.ureca.unity.global.exception.CustomException;
 import com.ureca.unity.global.exception.ErrorCode;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.http.ResponseEntity;
@@ -12,6 +13,10 @@
 import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
+@Tag(
+        name = "3. Call",
+        description = "전화 연결"
+)
 @RestController
 @RequestMapping("/api/agora")
 @RequiredArgsConstructor

src/main/java/com/ureca/unity/domain/auth/service/RefreshTokenServiceImpl.java

@@ -6,11 +6,16 @@
 import com.ureca.unity.domain.call.service.RecordingServiceImpl;
 import com.ureca.unity.global.exception.CustomException;
 import com.ureca.unity.global.exception.ErrorCode;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.RequiredArgsConstructor;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.ErrorResponse;
 import org.springframework.web.bind.annotation.*;
 
+@Tag(
+        name = "3. Call",
+        description = "전화 연결"
+)
 @RestController
 @RequestMapping("/api/recording")
 @RequiredArgsConstructor