[BE] Sisc1 200 [FEAT] 회원 탈퇴 및 refreshtoken 구현, Swagger 수정

backend/.gitignore

@@ -37,6 +37,6 @@ out/
 .vscode/
 
 ### yml ###
-/src/main/resources/application.yml
+# /src/main/resources/application.yml
 /src/main/resources/application-dev.yml
 /src/main/resources/application-prod.yml

backend/build.gradle

@@ -59,6 +59,7 @@ dependencies {
 
 	// backtesting library
 	implementation 'org.ta4j:ta4j-core:0.15'
+
 }
 
 jacoco {

backend/src/main/java/org/sejongisc/backend/auth/dto/GithubTokenResponse.java

@@ -2,6 +2,7 @@
 
 import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
 import com.fasterxml.jackson.annotation.JsonProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
 import lombok.Setter;
@@ -10,15 +11,30 @@
 @Setter
 @NoArgsConstructor
 @JsonIgnoreProperties(ignoreUnknown = true)
+@Schema(
+        name = "GithubTokenResponse",
+        description = "GitHub OAuth 로그인 후 Access Token 응답 객체"
+)
 public class GithubTokenResponse {
 
+    @Schema(
+            description = "GitHub에서 발급된 Access Token",
+            example = "gho_16a93b27fbc8e87a69c8aa0f3e7d7e7e8a2b"
+    )
     @JsonProperty("access_token")
     private String accessToken;
 
+    @Schema(
+            description = "토큰 타입 (일반적으로 'bearer')",
+            example = "bearer"
+    )
     @JsonProperty("token_type")
     private String tokenType;
 
+    @Schema(
+            description = "OAuth 인증 시 부여된 권한 범위 (scope)",
+            example = "read:user,user:email"
+    )
     @JsonProperty("scope")
     private String scope;
 }
-

backend/src/main/java/org/sejongisc/backend/auth/dto/GithubUserInfoResponse.java

@@ -2,6 +2,7 @@
 
 import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
 import com.fasterxml.jackson.annotation.JsonProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
 import lombok.Setter;
@@ -10,20 +11,44 @@
 @Setter
 @NoArgsConstructor
 @JsonIgnoreProperties(ignoreUnknown = true)
+@Schema(
+        name = "GithubUserInfoResponse",
+        description = "GitHub OAuth 로그인 후 사용자 정보 응답 객체"
+)
 public class GithubUserInfoResponse {
 
+    @Schema(
+            description = "GitHub 사용자 고유 ID",
+            example = "12345678"
+    )
     @JsonProperty("id")
     private Long id;
 
+    @Schema(
+            description = "GitHub 사용자 로그인 아이디 (username)",
+            example = "octocat"
+    )
     @JsonProperty("login")
     private String login;
 
+    @Schema(
+            description = "GitHub 계정에 등록된 전체 이름",
+            example = "The Octocat"
+    )
     @JsonProperty("name")
     private String name;
 
+    @Schema(
+            description = "GitHub 계정에 등록된 이메일 주소",
+            example = "octocat@github.com"
+    )
     @JsonProperty("email")
     private String email;
 
+    @Schema(
+            description = "GitHub 프로필 이미지 URL",
+            example = "https://avatars.githubusercontent.com/u/583231?v=4"
+    )
     @JsonProperty("avatar_url")
     private String avatarUrl;
-}
+}

backend/src/main/java/org/sejongisc/backend/auth/dto/GoogleTokenResponse.java

@@ -2,31 +2,60 @@
 
 import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
 import com.fasterxml.jackson.annotation.JsonProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
 import lombok.Setter;
-import org.springframework.stereotype.Service;
 
 @Getter
 @Setter
 @NoArgsConstructor
 @JsonIgnoreProperties(ignoreUnknown = true)
+@Schema(
+        name = "GoogleTokenResponse",
+        description = "Google OAuth 로그인 후 토큰 발급 응답 객체"
+)
 public class GoogleTokenResponse {
+
+    @Schema(
+            description = "Google에서 발급된 Access Token",
+            example = "ya29.a0AfH6SMAF1Z8vF6c9lL7uN9LbQZxExampleToken"
+    )
     @JsonProperty("access_token")
     private String accessToken;
 
+    @Schema(
+            description = "Access Token의 만료 시간 (초 단위)",
+            example = "3599"
+    )
     @JsonProperty("expires_in")
     private Long expiresIn;
 
+    @Schema(
+            description = "새로운 Access Token을 발급받을 때 사용하는 Refresh Token",
+            example = "1//0gkExampleRefreshToken"
+    )
     @JsonProperty("refresh_token")
     private String refreshToken;
 
+    @Schema(
+            description = "OAuth 인증 범위 (space로 구분됨)",
+            example = "https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/userinfo.profile openid"
+    )
     @JsonProperty("scope")
     private String scope;
 
+    @Schema(
+            description = "OpenID Connect용 ID Token (JWT 형식)",
+            example = "eyJhbGciOiJSUzI1NiIsImtpZCI6IjAifQ.eyJhenAiOiIx..."
+    )
     @JsonProperty("id_token")
     private String idToken;
 
+    @Schema(
+            description = "토큰 타입 (일반적으로 'Bearer')",
+            example = "Bearer"
+    )
     @JsonProperty("token_type")
     private String tokenType;
 }