feat: DisableSwaggerSecurity 어노테이션으로 Swagger 내 로그인과 토큰 갱신 API 보안 설정을 비활성화하는 기능 추가 (#87)

* [BOOK-90] fix: gateway - 화이트리스트를 제외하고, 모든 경로에 인증된 사용자만 접근 가능하도록 수정

* [BOOK-90] feat: global-utils - Swagger 보안을 비활성화하는 어노테이션 추가

* [BOOK-90] feat: apis - Swagger 보안 설정을 비활성화하는 OperationCustomizer 추가

* [BOOK-90] feat: apis - 소셜 로그인 및 토큰 갱신 API에 Swagger 보안 비활성화 어노테이션 추가

* [BOOK-90] chore: apis - Book 관련 유틸 클래스 book 패키지로 이동

* [BOOK-90] refactor: apis, global-utils - 코드레빗 리뷰 반영

* [BOOK-90] feat: apis, global-utils - ApplicationService 커스텀 어노테이션 생성 및 기존 Service 어노테이션 리팩토링

* [BOOK-90] chore: apis - DTO에 스키마 명세 추가

* [BOOK-90] chore: apis - 가독성을 위한 반환 방식 리팩토링

* [BOOK-90] refactor: apis, domain - 애플 리프레쉬 토큰 관련 DTO 내부 로직 변경

* [BOOK-90] fix: apis - item 내부에 있는 link를 전달하도록 수정

* [BOOK-90] chore: apis - 최소 개수 명세 추가

* [BOOK-90] refactor: apis - 애플 refreshToken이 null이나 빈문자열로 올 경우 기존 initialUserResponse를 반환하도록 변경

* [BOOK-90] refactor: apis - 프로퍼티 위의 @Schema만 @field:Schema로 변경

* [BOOK-90] chore: apis - categories 프로퍼티의 명세 변경

Author: move-hoon

apis/src/main/kotlin/org/yapp/apis/auth/controller/AuthControllerApi.kt

@@ -15,12 +15,14 @@ import org.springframework.web.bind.annotation.RequestBody
 import org.yapp.apis.auth.dto.request.SocialLoginRequest
 import org.yapp.apis.auth.dto.request.TokenRefreshRequest
 import org.yapp.apis.auth.dto.response.AuthResponse
+import org.yapp.globalutils.annotation.DisableSwaggerSecurity
 import org.yapp.globalutils.exception.ErrorResponse
 import java.util.*
 
 @Tag(name = "Authentication", description = "인증 관련 API")
 interface AuthControllerApi {
 
+    @DisableSwaggerSecurity
     @Operation(
         summary = "소셜 로그인",
         description = "카카오 또는 애플 계정으로 로그인합니다. 사용자가 존재하지 않으면 자동으로 회원가입됩니다."
@@ -47,6 +49,7 @@ interface AuthControllerApi {
     @PostMapping("/signin")
     fun signIn(@RequestBody @Valid request: SocialLoginRequest): ResponseEntity<AuthResponse>
 
+    @DisableSwaggerSecurity
     @Operation(
         summary = "토큰 갱신",
         description = "리프레시 토큰을 사용하여 액세스 토큰을 갱신합니다. 새로운 액세스 토큰과 리프레시 토큰을 반환합니다."

apis/src/main/kotlin/org/yapp/apis/auth/dto/request/DeleteTokenRequest.kt

@@ -10,7 +10,7 @@ import org.yapp.apis.auth.dto.response.RefreshTokenResponse
 )
 data class DeleteTokenRequest private constructor(
     @field:NotBlank(message = "Refresh token must not be blank.")
-    @Schema(description = "Refresh token to be deleted", example = "eyJhbGciOiJIUz...")
+    @field:Schema(description = "Refresh token to be deleted", example = "eyJhbGciOiJIUz...")
     val refreshToken: String? = null
 ) {
     fun validRefreshToken() = refreshToken!!

apis/src/main/kotlin/org/yapp/apis/auth/dto/request/GenerateTokenPairRequest.kt

@@ -12,14 +12,14 @@ import java.util.UUID
     description = "Request DTO to generate a new pair of access and refresh tokens"
 )
 data class GenerateTokenPairRequest private constructor(
-    @Schema(
+    @field:Schema(
         description = "User ID",
         example = "a1b2c3d4-e5f6-7890-1234-56789abcdef0"
     )
     @field:NotNull(message = "userId must not be null")
     val userId: UUID? = null,
 
-    @Schema(
+    @field:Schema(
         description = "User role",
         example = "USER"
     )

apis/src/main/kotlin/org/yapp/apis/auth/dto/request/SocialLoginRequest.kt

@@ -14,23 +14,23 @@ import org.yapp.domain.user.ProviderType
     description = "DTO for social login requests"
 )
 data class SocialLoginRequest private constructor(
-    @Schema(
+    @field:Schema(
         description = "Type of social login provider",
         example = "KAKAO",
         required = true
     )
     @field:NotBlank(message = "Provider type is required")
     val providerType: String? = null,
 
-    @Schema(
+    @field:Schema(
         description = "OAuth token issued by the social provider",
         example = "eyJ...",
         required = true
     )
     @field:NotBlank(message = "OAuth token is required")
     val oauthToken: String? = null,
 
-    @Schema(
+    @field:Schema(
         description = "Authorization code used to issue Apple access/refresh tokens (required only for Apple login)",
         example = "c322a426...",
         required = false

apis/src/main/kotlin/org/yapp/apis/auth/dto/request/TokenGenerateRequest.kt

@@ -11,15 +11,15 @@ import java.util.*
 )
 data class TokenGenerateRequest private constructor(
     @field:NotNull(message = "userId must not be null")
-    @Schema(description = "User ID", example = "f6b7d490-1b1a-4b9f-8e8e-27f8e3a5dafa")
+    @field:Schema(description = "User ID", example = "f6b7d490-1b1a-4b9f-8e8e-27f8e3a5dafa")
     val userId: UUID? = null,
 
     @field:NotBlank(message = "refreshToken must not be blank")
-    @Schema(description = "Generated refresh token", example = "eyJhbGciOiJIUzI1NiIsInR...")
+    @field:Schema(description = "Generated refresh token", example = "eyJhbGciOiJIUzI1NiIsInR...")
     val refreshToken: String? = null,
 
     @field:NotNull(message = "expiration must not be null")
-    @Schema(description = "Refresh token expiration time (in seconds)", example = "2592000")
+    @field:Schema(description = "Refresh token expiration time (in seconds)", example = "2592000")
     val expiration: Long? = null
 ) {
     fun validUserId() = userId!!

apis/src/main/kotlin/org/yapp/apis/auth/dto/request/TokenRefreshRequest.kt

@@ -8,7 +8,7 @@ import jakarta.validation.constraints.NotBlank
     description = "DTO for requesting an access token using a refresh token"
 )
 data class TokenRefreshRequest private constructor(
-    @Schema(
+    @field:Schema(
         description = "Valid refresh token issued during previous authentication",
         example = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
         required = true

apis/src/main/kotlin/org/yapp/apis/auth/dto/request/WithdrawStrategyRequest.kt

@@ -10,27 +10,27 @@ import java.util.*
 @Schema(description = "회원 탈퇴 처리 시 내부적으로 사용되는 요청 DTO")
 data class WithdrawStrategyRequest private constructor(
     @field:NotNull(message = "사용자 ID는 필수 값입니다.")
-    @Schema(
+    @field:Schema(
         description = "사용자 고유 ID",
         example = "123e4567-e89b-12d3-a456-426614174000"
     )
     val userId: UUID,
 
     @field:NotNull(message = "소셜 로그인 제공자 타입은 필수 값입니다.")
-    @Schema(
+    @field:Schema(
         description = "소셜 로그인 제공자 타입",
         example = "KAKAO"
     )
     val providerType: ProviderType,
 
     @field:NotBlank(message = "소셜 로그인 제공자로부터 발급받은 고유 ID는 필수 값입니다.")
-    @Schema(
+    @field:Schema(
         description = "소셜 로그인 제공자로부터 발급받은 고유 ID",
         example = "21412412412"
     )
     val providerId: String,
 
-    @Schema(
+    @field:Schema(
         description = "Apple 로그인 시 발급받은 리프레시 토큰 (Apple 로그인 회원 탈퇴 시에만 필요)",
         example = "r_abc123def456ghi789jkl0mnopqrstu",
         required = false

apis/src/main/kotlin/org/yapp/apis/auth/dto/response/AuthResponse.kt

@@ -8,13 +8,13 @@ import io.swagger.v3.oas.annotations.media.Schema
 )
 data class AuthResponse private constructor(
 
-    @Schema(
+    @field:Schema(
         description = "Access token for authorization",
         example = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
     )
     val accessToken: String,
 
-    @Schema(
+    @field:Schema(
         description = "Refresh token used to obtain a new access token",
         example = "dGhpc2lzYXJlZnJlc2h0b2tlbg=="
     )

apis/src/main/kotlin/org/yapp/apis/auth/dto/response/RefreshTokenResponse.kt

@@ -8,7 +8,7 @@ import org.yapp.domain.token.RefreshToken.Token
     description = "Response DTO containing the issued refresh token"
 )
 data class RefreshTokenResponse(
-    @Schema(description = "The refresh token string", example = "eyJhbGciOiJIUz...")
+    @field:Schema(description = "The refresh token string", example = "eyJhbGciOiJIUz...")
     val refreshToken: String
 ) {
     companion object {

apis/src/main/kotlin/org/yapp/apis/auth/dto/response/TokenPairResponse.kt

@@ -8,13 +8,13 @@ import io.swagger.v3.oas.annotations.media.Schema
 )
 data class TokenPairResponse private constructor(
 
-    @Schema(
+    @field:Schema(
         description = "Access token for user authorization",
         example = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
     )
     val accessToken: String,
 
-    @Schema(
+    @field:Schema(
         description = "Refresh token to get new access token",
         example = "dGhpc2lzYXJlZnJlc2h0b2tlbg=="
     )