Feat/#7

.dockerignore

@@ -0,0 +1,50 @@
+# Git
+.git
+.gitignore
+.gitattributes
+.github
+
+# Gradle
+.gradle
+build/
+!gradle/wrapper/gradle-wrapper.jar
+!gradle/wrapper/gradle-wrapper.properties
+
+# IDE
+.idea
+*.iml
+*.iws
+*.ipr
+.vscode
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+
+# Local data
+postgres_data/
+localstack_data/
+
+# Docker
+Dockerfile
+.dockerignore
+docker-compose.yaml
+
+# Documentation
+README.md
+*.md
+
+# Kotlin
+.kotlin
+
+# Test
+src/test/
+
+# Misc
+Makefile

Dockerfile

@@ -0,0 +1,42 @@
+# Build stage
+FROM eclipse-temurin:21-jdk-alpine AS builder
+
+WORKDIR /app
+
+# Gradle wrapper와 설정 파일 복사 (캐싱 최적화를 위해 먼저 복사)
+COPY gradle gradle
+COPY gradlew .
+COPY settings.gradle.kts .
+COPY build.gradle.kts .
+
+# 실행 권한 부여
+RUN chmod +x ./gradlew
+
+# 의존성 다운로드 (소스 코드 변경 시에도 이 레이어는 캐시됨)
+RUN ./gradlew dependencies --no-daemon
+
+# 소스 코드 복사
+COPY src src
+
+# 애플리케이션 빌드
+RUN ./gradlew bootJar --no-daemon -x test
+
+# Runtime stage
+FROM eclipse-temurin:21-jre-alpine
+
+WORKDIR /app
+
+# 보안을 위해 non-root 사용자 생성
+RUN addgroup -S spring && adduser -S spring -G spring
+USER spring:spring
+
+# 빌드된 JAR 파일 복사
+COPY --from=builder /app/build/libs/*.jar app.jar
+
+# 환경변수 설정 (기본값, 런타임에 오버라이드 가능)
+ENV SPRING_PROFILES_ACTIVE=staging
+ENV JASYPT_PASSWORD=""
+
+# 애플리케이션 실행
+# Spring Boot가 SPRING_PROFILES_ACTIVE, JASYPT_PASSWORD 환경변수를 자동으로 읽음
+ENTRYPOINT ["java", "-jar", "app.jar"]

src/main/kotlin/com/yapp2app/auth/api/controller/AuthController.kt

@@ -1,14 +1,22 @@
 package com.yapp2app.auth.api.controller
 
-import com.yapp2app.auth.api.dto.KakaoOIDCLoginRequest
-import com.yapp2app.auth.api.dto.TokenResponse
+import com.yapp2app.auth.api.request.KakaoOIDCLoginRequest
+import com.yapp2app.auth.api.response.GetKakaoRegisterResponse
+import com.yapp2app.auth.api.response.GetKakaoTokenResponse
+import com.yapp2app.auth.application.command.RegisterKakaoUserCommand
+import com.yapp2app.auth.application.usecase.KakaoAuthUseCase
 import com.yapp2app.common.api.dto.BaseResponse
+import io.swagger.v3.oas.annotations.Hidden
+import io.swagger.v3.oas.annotations.Operation
 import io.swagger.v3.oas.annotations.responses.ApiResponse
 import io.swagger.v3.oas.annotations.responses.ApiResponses
 import io.swagger.v3.oas.annotations.tags.Tag
+import jakarta.validation.Valid
+import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.PostMapping
 import org.springframework.web.bind.annotation.RequestBody
 import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RequestParam
 import org.springframework.web.bind.annotation.RestController
 
 /**
@@ -20,15 +28,61 @@ import org.springframework.web.bind.annotation.RestController
 @Tag(name = "AuthController", description = "인증/인가 API")
 @RequestMapping("/api/auth")
 @RestController
-class AuthController {
+class AuthController(private val kakaoAuthUseCase: KakaoAuthUseCase) {
 
     /**
-     * OIDC 방식 로그인
+     * OIDC 방식 회원가입
      */
+    @Operation(
+        summary = "카카오 OIDC 회원가입",
+        description = """
+        ## 카카오 OIDC 회원가입 API
+
+        앱에서 카카오 SDK로 획득한 idToken을 검증하고 회원가입을 처리합니다.
+
+        ### 테스트용 idToken 발급 방법
+
+        #### 1단계: Authorization Code 획득
+        아래 URL을 브라우저에서 실행하여 카카오 로그인 후 idToken 얻습니다.
+
+        [local] https://kauth.kakao.com/oauth/authorize?client_id=a8777a62d28eee709e96cd6f803ec377&redirect_uri=http://localhost:8080/api/auth/test/kakao/redirect&response_type=code&scope=openid,profile_nickname
+
+        [staging] https://kauth.kakao.com/oauth/authorize?client_id=a8777a62d28eee709e96cd6f803ec377&redirect_uri=https://dev-yapp.suitestudy.com:4641/api/auth/test/kakao/redirect&response_type=code&scope=openid,profile_nickname
+
+        응답의 `id_token` 필드 값을 이 API의 `idToken`으로 사용하세요.
+        """,
+    )
     @ApiResponses(
         ApiResponse(responseCode = "200", description = "카카오 OIDC 엔드포인트가 정상적으로 작동합니다."),
     )
     @PostMapping("/kakao/oidc")
-    fun kakaoLoginWithOIDC(@RequestBody request: KakaoOIDCLoginRequest): BaseResponse<TokenResponse> =
-        BaseResponse(data = TokenResponse("OK", "OK"))
+    fun kakaoRegisterWithOIDC(
+        @RequestBody @Valid request: KakaoOIDCLoginRequest,
+    ): BaseResponse<GetKakaoRegisterResponse> {
+        val result = kakaoAuthUseCase.execute(RegisterKakaoUserCommand(idToken = request.idToken))
+
+        return BaseResponse(data = GetKakaoRegisterResponse(oid = result.oid, providerType = result.providerType))
+    }
+
+    /**
+     * ****** Test용이므로 Swagger Hidden 처리 ******
+     * 테스트용 카카오 OAuth Redirect 엔드포인트
+     * Authorization Code를 받아서 idToken으로 교환
+     */
+    @Hidden
+    @GetMapping("/test/kakao/redirect")
+    fun kakaoTestRedirect(@RequestParam code: String): BaseResponse<GetKakaoTokenResponse> {
+        val tokenResponse = kakaoAuthUseCase.getAccessTokenByCode(code)
+        return BaseResponse(
+            data = GetKakaoTokenResponse(
+                accessToken = tokenResponse.accessToken,
+                tokenType = tokenResponse.tokenType,
+                refreshToken = tokenResponse.refreshToken,
+                expiresIn = tokenResponse.expiresIn,
+                scope = tokenResponse.scope,
+                refreshTokenExpiresIn = tokenResponse.refreshTokenExpiresIn,
+                idToken = tokenResponse.idToken,
+            ),
+        )
+    }
 }

src/main/kotlin/com/yapp2app/auth/api/controller/TestAuthController.kt

@@ -6,8 +6,8 @@ import com.yapp2app.auth.infra.security.token.AuthTokenProvider
 import com.yapp2app.common.api.dto.BaseResponse
 import com.yapp2app.common.api.dto.ResultCode
 import com.yapp2app.common.exception.BusinessException
-import com.yapp2app.user.application.repository.UserRepository
 import com.yapp2app.user.domain.enums.ProviderType
+import com.yapp2app.user.infra.persist.jpa.UserRepository
 import org.springframework.security.crypto.password.PasswordEncoder
 import org.springframework.web.bind.annotation.PostMapping
 import org.springframework.web.bind.annotation.RequestBody
@@ -31,15 +31,11 @@ class TestAuthController(
 
     @PostMapping("/login")
     fun login(@RequestBody request: LoginRequest): BaseResponse<TokenResponse> {
-        val user = userRepository.findByEmailAndProviderType(
-            request.email,
-            ProviderType.LOCAL,
+        val user = userRepository.findByOidAndProviderType(
+            request.oid,
+            ProviderType.KAKAO,
         ) ?: throw BusinessException(ResultCode.NOT_FOUND_USER)
 
-        if (!passwordEncoder.matches(request.password, user.password)) {
-            throw BusinessException(ResultCode.SECURITY_ERROR)
-        }
-
         // Access Token 생성
         val accessToken = tokenProvider.createToken(
             id = user.id.toString(),

src/main/kotlin/com/yapp2app/auth/api/dto/AuthDto.kt

@@ -12,12 +12,7 @@ package com.yapp2app.auth.api.dto
 // Request DTOs
 // ====================================================================================================
 
-/**
- * 카카오 OIDC 로그인
- */
-data class KakaoOIDCLoginRequest(val idToken: String)
-
-data class LoginRequest(val email: String, val password: String)
+data class LoginRequest(val oid: Long, val password: String)
 
 // ====================================================================================================
 // Response DTOs

src/main/kotlin/com/yapp2app/auth/api/request/KakaoOIDCLoginRequest.kt

@@ -0,0 +1,11 @@
+package com.yapp2app.auth.api.request
+
+import jakarta.validation.constraints.NotBlank
+
+/**
+ * fileName       : AuthRequest
+ * author         : darren
+ * date           : 2025. 12. 26. 18:05
+ * description    : 인증/인가 관련 요청 body
+ */
+data class KakaoOIDCLoginRequest(@NotBlank(message = "ID 토큰은 필수입니다") val idToken: String)

src/main/kotlin/com/yapp2app/auth/api/response/AuthResponse.kt

@@ -0,0 +1,21 @@
+package com.yapp2app.auth.api.response
+
+import com.yapp2app.user.domain.enums.ProviderType
+
+/**
+ * fileName       : AuthResponse
+ * author         : darren
+ * date           : 2025. 12. 26. 18:05
+ * description    : Auth aggregate에 대한 응답
+ */
+data class GetKakaoRegisterResponse(val oid: Long, val providerType: ProviderType)
+
+data class GetKakaoTokenResponse(
+    val accessToken: String,
+    val tokenType: String,
+    val refreshToken: String,
+    val expiresIn: Int,
+    val scope: String? = null,
+    val refreshTokenExpiresIn: Int? = null,
+    val idToken: String? = null,
+)

src/main/kotlin/com/yapp2app/auth/application/command/RegisterKakaoUserCommand.kt

@@ -0,0 +1,9 @@
+package com.yapp2app.auth.application.command
+
+/**
+ * fileName       : AuthCommand
+ * author         : darren
+ * date           : 2025. 12. 12. 13:18
+ * description    : 인증/인가 관련 API
+ */
+data class RegisterKakaoUserCommand(val idToken: String)