[YS-31] feat: 구글 OAuth 로그인 구현

build.gradle.kts

@@ -38,15 +38,20 @@ dependencies {
 	implementation("com.fasterxml.jackson.module:jackson-module-kotlin")
 	implementation("org.jetbrains.kotlin:kotlin-reflect")
 	implementation("org.springframework.boot:spring-boot-starter-security")
+	implementation("org.springframework.boot:spring-boot-starter-oauth2-client")
 	implementation("com.github.f4b6a3:ulid-creator:5.2.3")
 	implementation("org.mariadb.jdbc:mariadb-java-client:2.7.3")
+	implementation("org.springframework.boot:spring-boot-starter-oauth2-client")
+	implementation("org.springframework.boot:spring-boot-starter-webflux")
+	implementation("io.github.cdimascio:java-dotenv:5.2.2")
+	implementation("org.springdoc:springdoc-openapi-starter-webmvc-ui:2.7.0")
 	implementation ("io.awspring.cloud:spring-cloud-starter-aws:2.4.4")
-	implementation("org.springdoc:springdoc-openapi-starter-webmvc-ui:2.5.0")
 	compileOnly("org.projectlombok:lombok")
 	runtimeOnly("com.mysql:mysql-connector-j")
 	runtimeOnly("com.h2database:h2")
 	annotationProcessor("org.projectlombok:lombok")
 	testImplementation("org.springframework.boot:spring-boot-starter-test")
+	testImplementation("io.mockk:mockk:1.13.10")
 	testImplementation("org.jetbrains.kotlin:kotlin-test-junit5")
 	testImplementation("org.springframework.security:spring-security-test")
 	testRuntimeOnly("org.junit.platform:junit-platform-launcher")

src/main/kotlin/com/dobby/backend/DobbyBackendApplication.kt

@@ -2,10 +2,15 @@ package com.dobby.backend
 
 import org.springframework.boot.autoconfigure.SpringBootApplication
 import org.springframework.boot.runApplication
+import io.github.cdimascio.dotenv.Dotenv;
 
 @SpringBootApplication
 class DobbyBackendApplication
 
 fun main(args: Array<String>) {
+	val dotenv = Dotenv.configure().load()
+	dotenv.entries().forEach{ entry ->
+		System.setProperty(entry.key, entry.value)
+	}
 	runApplication<DobbyBackendApplication>(*args)
 }

src/main/kotlin/com/dobby/backend/application/mapper/OauthUserMapper.kt

@@ -0,0 +1,33 @@
+package com.dobby.backend.application.mapper
+
+import com.dobby.backend.domain.exception.OAuth2EmailNotFoundException
+import com.dobby.backend.domain.exception.OAuth2NameNotFoundException
+import com.dobby.backend.infrastructure.database.entity.Member
+import com.dobby.backend.infrastructure.database.entity.enum.MemberStatus
+import com.dobby.backend.infrastructure.database.entity.enum.ProviderType
+import com.dobby.backend.presentation.api.dto.request.OauthUserDto
+import org.springframework.security.oauth2.core.user.OAuth2User
+
+object OauthUserMapper {
+    fun toDto(oauthUser: OAuth2User, provider: ProviderType): OauthUserDto {
+        val email = oauthUser.getAttribute<String>("email")
+            ?: throw OAuth2EmailNotFoundException()
+        val name = oauthUser.getAttribute<String>("name")
+            ?: throw OAuth2NameNotFoundException()
+
+        return OauthUserDto(email=email, name=name, provider= provider)
+    }
+
+    fun toTempMember(dto: OauthUserDto): Member {
+        return Member(
+            id = 0L,
+            oauthEmail= dto.email,
+            name= dto.name,
+            provider = dto.provider,
+            status = MemberStatus.HOLD,
+            role = null,
+            contactEmail = null,
+            birthDate = null
+        )
+    }
+}

src/main/kotlin/com/dobby/backend/application/service/MemberService.kt

@@ -0,0 +1,23 @@
+package com.dobby.backend.application.service
+
+import com.dobby.backend.domain.exception.MemberNotFoundException
+import com.dobby.backend.infrastructure.database.entity.Member
+import com.dobby.backend.infrastructure.database.entity.enum.MemberStatus
+import com.dobby.backend.infrastructure.database.repository.MemberRepository
+import com.dobby.backend.infrastructure.token.JwtTokenProvider
+import com.dobby.backend.presentation.api.dto.request.OauthUserDto
+import jakarta.transaction.Transactional
+import org.springframework.stereotype.Service
+
+@Service
+class MemberService(
+    private val memberRepository: MemberRepository,
+    private val jwtTokenProvider: JwtTokenProvider
+) {
+    @Transactional
+    fun login(oauthUserDto: OauthUserDto): Member{
+        val member= memberRepository.findByOauthEmailAndStatus(oauthUserDto.email, MemberStatus.ACTIVE)
+            ?: throw MemberNotFoundException()
+        return member
+    }
+}

src/main/kotlin/com/dobby/backend/application/service/OauthService.kt

@@ -0,0 +1,27 @@
+package com.dobby.backend.application.service
+
+import com.dobby.backend.application.usecase.FetchGoogleUserInfoUseCase
+import com.dobby.backend.domain.exception.OAuth2EmailNotFoundException
+import com.dobby.backend.domain.exception.OAuth2NameNotFoundException
+import com.dobby.backend.infrastructure.database.entity.enum.ProviderType
+import com.dobby.backend.presentation.api.dto.response.OauthTokenResponse
+import org.springframework.stereotype.Service
+import org.springframework.web.reactive.function.client.WebClient
+
+@Service
+class OauthService(
+    private val fetchGoogleUserInfoUseCase: FetchGoogleUserInfoUseCase
+) {
+    fun getGoogleUserInfo(accessToken: String): OauthTokenResponse {
+        val userInfo = fetchGoogleUserInfoUseCase.execute(accessToken)
+
+        val email = userInfo["email"] as? String ?: throw OAuth2EmailNotFoundException()
+        val name = userInfo["name"] as? String ?: throw OAuth2NameNotFoundException()
+        return OauthTokenResponse(
+            jwtToken= accessToken,
+            email = email,
+            name = name,
+            provider = ProviderType.GOOGLE
+        )
+    }
+}

src/main/kotlin/com/dobby/backend/application/usecase/FetchGoogleUserInfoUseCase.kt

@@ -0,0 +1,26 @@
+package com.dobby.backend.application.usecase
+
+import com.dobby.backend.domain.exception.OAuth2ProviderMissingException
+import org.springframework.stereotype.Component
+import org.springframework.web.reactive.function.client.WebClient
+import org.springframework.web.reactive.function.client.WebClientResponseException
+import org.springframework.web.reactive.function.client.bodyToMono
+
+@Component
+class FetchGoogleUserInfoUseCase(
+    private val webClientBuilder : WebClient.Builder
+){
+    fun execute(accessToken: String) : Map<String, Any>{
+        try {
+            val webClient = webClientBuilder.build()
+            return webClient.get()
+                .uri("https://www.googleapis.com/oauth2/v3/userinfo")
+                .header("Authorization", "Bearer $accessToken")
+                .retrieve()
+                .bodyToMono<Map<String, Any>>()
+                .block() ?: throw OAuth2ProviderMissingException()
+        } catch (e : WebClientResponseException) {
+            throw OAuth2ProviderMissingException()
+        }
+    }
+}

src/main/kotlin/com/dobby/backend/domain/exception/AuthenticationException.kt

@@ -8,4 +8,3 @@ class AuthenticationTokenNotFoundException : AuthenticationException(ErrorCode.T
 class AuthenticationTokenNotValidException : AuthenticationException(ErrorCode.TOKEN_NOT_VALID)
 class AuthenticationTokenExpiredException : AuthenticationException(ErrorCode.TOKEN_EXPIRED)
 class InvalidTokenTypeException : AuthenticationException(ErrorCode.INVALID_TOKEN_TYPE)
-

src/main/kotlin/com/dobby/backend/domain/exception/ErrorCode.kt

@@ -33,4 +33,18 @@ enum class ErrorCode(
      * Member error codes
      */
     MEMBER_NOT_FOUND("ME0001", "Member not found", HttpStatus.NOT_FOUND),
+
+    /**
+     * OAuth2 error codes
+     */
+    OAUTH_USER_NOT_FOUND("OA001", "Authentication Principal is not an instance of OAuth2User", HttpStatus.BAD_REQUEST),
+    OAUTH_PROVIDER_MISSING("OA002", "Cannot Load OAuth2 User Info during the external API calling", HttpStatus.BAD_REQUEST),
+    OAUTH_PROVIDER_NOT_FOUND("OA003", "Not supported Provider is requested", HttpStatus.BAD_REQUEST),
+    OAUTH_EMAIL_NOT_FOUND("OA004", "Email cannot found in OAuth2 Authentication Info", HttpStatus.BAD_REQUEST),
+    OAUTH_NAME_NOT_FOUND("OA005", "Name cannt found in OAuth2 Authentication Info", HttpStatus.BAD_REQUEST),
+
+    /**
+     * Signup error codes
+     */
+    SIGNUP_ALREADY_MEMBER("SI001", "You've already joined", HttpStatus.CONFLICT)
 }

src/main/kotlin/com/dobby/backend/domain/exception/MemberException.kt

@@ -5,3 +5,4 @@ open class MemberException(
 ) : DomainException(errorCode)
 
 class MemberNotFoundException : MemberException(ErrorCode.MEMBER_NOT_FOUND)
+class AlreadyMemberException: MemberException(ErrorCode.SIGNUP_ALREADY_MEMBER)

src/main/kotlin/com/dobby/backend/domain/exception/OauthException.kt

@@ -0,0 +1,11 @@
+package com.dobby.backend.domain.exception
+
+open class OauthException (
+    errorCode: ErrorCode,
+) : DomainException(errorCode)
+class OAuth2AuthenticationException: OauthException(ErrorCode.OAUTH_USER_NOT_FOUND)
+class OAuth2ProviderMissingException: OauthException(ErrorCode.OAUTH_PROVIDER_MISSING)
+class OAuth2ProviderNotSupportedException: OauthException(ErrorCode.OAUTH_PROVIDER_NOT_FOUND)
+class OAuth2EmailNotFoundException : OauthException(ErrorCode.OAUTH_EMAIL_NOT_FOUND)
+class OAuth2NameNotFoundException : OauthException(ErrorCode.OAUTH_NAME_NOT_FOUND)
+

src/main/kotlin/com/dobby/backend/infrastructure/database/entity/Member.kt

@@ -29,14 +29,14 @@ open class Member (
 
     @Column(name = "role", nullable = true)
     @Enumerated(EnumType.STRING)
-    val role: RoleType,
+    val role: RoleType?,
 
-    @Column(name = "contact_email", length = 100, nullable = false)
-    val contactEmail : String,
+    @Column(name = "contact_email", length = 100, nullable = true)
+    val contactEmail : String?,
 
-    @Column(name = "name", length = 10, nullable = false)
-    val name : String,
+    @Column(name = "name", length = 10, nullable = true)
+    val name : String?,
 
-    @Column(name = "birth_date", nullable = false)
-    val birthDate : LocalDate,
+    @Column(name = "birth_date", nullable = true)
+    val birthDate : LocalDate?,
 ) : AuditingEntity()

src/main/kotlin/com/dobby/backend/infrastructure/database/entity/Participant.kt

@@ -6,16 +6,16 @@ import com.dobby.backend.infrastructure.database.entity.enum.ProviderType
 import com.dobby.backend.infrastructure.database.entity.enum.RoleType
 import com.dobby.backend.infrastructure.database.entity.enum.areaInfo.Area
 import com.dobby.backend.infrastructure.database.entity.enum.areaInfo.Region
-import jakarta.persistence.Column
-import jakarta.persistence.DiscriminatorValue
-import jakarta.persistence.Entity
-import jakarta.persistence.EnumType
-import jakarta.persistence.Enumerated
+import jakarta.persistence.*
 import java.time.LocalDate
 
 @Entity(name = "participant")
 @DiscriminatorValue("PARTICIPANT")
 class Participant (
+    @OneToOne
+    @JoinColumn(name = "member_id", nullable = false)
+    val member: Member,
+
     @Column(name = "gender", nullable = false)
     @Enumerated(EnumType.STRING)
     val gender: GenderType,
@@ -30,15 +30,15 @@ class Participant (
 
     @Column(name = "optional_region", nullable = true)
     @Enumerated(EnumType.STRING)
-    var optionalRegion: Region,
+    var optionalRegion: Region?,
 
     @Column(name = "optional_area", nullable = true)
     @Enumerated(EnumType.STRING)
-    var optionalArea: Area,
+    var optionalArea: Area?,
 
     @Column(name = "prefer_type", nullable = true)
     @Enumerated(EnumType.STRING)
-    var preferType: MatchType,
+    var preferType: MatchType?,
 
     id: Long,
     oauthEmail: String,
@@ -55,4 +55,3 @@ class Participant (
     name = name,
     birthDate = birthDate
 )
-

src/main/kotlin/com/dobby/backend/infrastructure/database/entity/Researcher.kt

@@ -2,14 +2,16 @@ package com.dobby.backend.infrastructure.database.entity
 
 import com.dobby.backend.infrastructure.database.entity.enum.ProviderType
 import com.dobby.backend.infrastructure.database.entity.enum.RoleType
-import jakarta.persistence.Column
-import jakarta.persistence.DiscriminatorValue
-import jakarta.persistence.Entity
+import jakarta.persistence.*
 import java.time.LocalDate
 
 @Entity(name = "researcher")
 @DiscriminatorValue("RESEARCHER")
 class Researcher (
+    @OneToOne
+    @JoinColumn(name = "member_id", nullable = false)
+    val member: Member,
+
     @Column(name = "univ_email", length = 100, nullable = false)
     val univEmail : String,
 

src/main/kotlin/com/dobby/backend/infrastructure/database/repository/MemberRepository.kt

@@ -0,0 +1,12 @@
+package com.dobby.backend.infrastructure.database.repository
+
+import com.dobby.backend.infrastructure.database.entity.Member
+import com.dobby.backend.infrastructure.database.entity.enum.MemberStatus
+import com.dobby.backend.infrastructure.database.entity.enum.ProviderType
+import org.springframework.data.jpa.repository.JpaRepository
+import org.springframework.stereotype.Repository
+
+@Repository
+interface MemberRepository : JpaRepository<Member, Long> {
+    fun findByOauthEmailAndStatus(oauthEmail: String, status: MemberStatus): Member?
+}

src/main/kotlin/com/dobby/backend/infrastructure/database/repository/ParticipantRepository.kt

@@ -0,0 +1,9 @@
+package com.dobby.backend.infrastructure.database.repository
+
+import com.dobby.backend.infrastructure.database.entity.Participant
+import org.springframework.data.jpa.repository.JpaRepository
+import org.springframework.stereotype.Repository
+
+@Repository
+interface ParticipantRepository: JpaRepository<Participant, Long> {
+}

src/main/kotlin/com/dobby/backend/presentation/api/config/SwaggerConfig.kt

@@ -6,8 +6,7 @@ import io.swagger.v3.oas.annotations.info.Info
 import io.swagger.v3.oas.annotations.servers.Server
 import io.swagger.v3.oas.models.Components
 import io.swagger.v3.oas.models.OpenAPI
-import io.swagger.v3.oas.models.security.SecurityRequirement
-import io.swagger.v3.oas.models.security.SecurityScheme
+import io.swagger.v3.oas.models.security.*
 import org.springframework.context.annotation.Bean
 import org.springframework.context.annotation.Configuration
 
@@ -28,7 +27,33 @@ class SwaggerConfig {
     @Bean
     fun openAPI(): OpenAPI = OpenAPI()
         .addSecurityItem(SecurityRequirement().addList("JWT 토큰"))
+        .addSecurityItem(SecurityRequirement().addList("Google OAuth2 토큰"))
         .components(
-            Components().addSecuritySchemes("JWT 토큰",
-            SecurityScheme().type(SecurityScheme.Type.HTTP).scheme("Bearer").bearerFormat("JWT")))
+            Components()
+                .addSecuritySchemes(
+                    "JWT 토큰",
+                    SecurityScheme()
+                        .type(SecurityScheme.Type.HTTP)
+                        .scheme("Bearer")
+                        .bearerFormat("JWT")
+                )
+                .addSecuritySchemes(
+                    "Google OAuth2 토큰",
+                    SecurityScheme()
+                        .type(SecurityScheme.Type.OAUTH2)
+                        .flows(
+                            OAuthFlows()
+                                .authorizationCode(
+                                    OAuthFlow()
+                                        .authorizationUrl("https://accounts.google.com/o/oauth2/auth")
+                                        .tokenUrl("https://oauth2.googleapis.com/token")
+                                        .scopes(
+                                            Scopes()
+                                                .addString("email", "Access your email address")
+                                                .addString("profile", "Access your profile information")
+                                        )
+                                )
+                        )
+                )
+        )
 }

src/main/kotlin/com/dobby/backend/presentation/api/config/WebClientConfig.kt

@@ -0,0 +1,13 @@
+package com.dobby.backend.presentation.api.config
+
+import org.springframework.context.annotation.Bean
+import org.springframework.context.annotation.Configuration
+import org.springframework.web.reactive.function.client.WebClient
+
+@Configuration
+class WebClientConfig {
+    @Bean
+    fun webClientBuilder(): WebClient.Builder {
+        return WebClient.builder()
+    }
+}