Merge pull request #188 from asowjdan/feat/oauth

Feat[oauth] : 소셜 로그인 기능 구현

Author: DooHyoJeong

backend/.env.default

@@ -1,15 +1,26 @@
 SPRING_PROFILES_ACTIVE=NEED_TO_SET
-
 SPRING_JPA_HIBERNATE_DDL_AUTO=NEED_TO_SET
 
-SPRING__SECURITY__OAUTH2__CLIENT__REGISTRATION__KAKAO__CLIENT_ID=NEED_TO_SET
-SPRING__SECURITY__OAUTH2__CLIENT__REGISTRATION__KAKAO__CLIENT_SECRET=NEED_TO_SET
-SPRING__SECURITY__OAUTH2__CLIENT__REGISTRATION__NAVER__CLIENT_ID=NEED_TO_SET
-SPRING__SECURITY__OAUTH2__CLIENT__REGISTRATION__NAVER__CLIENT_SECRET=NEED_TO_SET
+SPRING_SECURITY_OAUTH2_CLIENT_REGISTRATION_KAKAO_CLIENT_ID=NEED_TO_SET
+SPRING_SECURITY_OAUTH2_CLIENT_REGISTRATION_KAKAO_CLIENT_SECRET=NEED_TO_SET
+SPRING_SECURITY_OAUTH2_CLIENT_REGISTRATION_NAVER_CLIENT_ID=NEED_TO_SET
+SPRING_SECURITY_OAUTH2_CLIENT_REGISTRATION_NAVER_CLIENT_SECRET=NEED_TO_SET
 
 CUSTOM_JWT_SECRET_KEY=NEED_TO_SET
 CUSTOM_JWT_ACCESS_TOKEN_EXPIRATION_SECONDS=NEED_TO_SET
 
+# Email
+SEND_EMAIL_ADDRESS=NEED_TO_SET
+SEND_EMAIL_PASSWORD=NEED_TO_SET
+
+# PROD
+PROD_URL=NEED_TO_SET
+PROD_FRONTEND_URL=NEED_TO_SET
+PROD_CORS_ALLOWED_ORIGINS=NEED_TO_SET
+PROD_OAUTH2_KAKAO_REDIRECT_URI=NEED_TO_SET
+PROD_OAUTH2_NAVER_REDIRECT_URI=NEED_TO_SET
+PROD_OAUTH2_SUCCESS_REDIRECT_URL=NEED_TO_SET
+PROD_OAUTH2_FAILURE_REDIRECT_URL=NEED_TO_SET
 PROD_DATASOURCE_URL=NEED_TO_SET
 PROD_DATASOURCE_DRIVER=NEED_TO_SET
 PROD_DATASOURCE_USERNAME=NEED_TO_SET
@@ -19,16 +30,33 @@ PROD_REDIS_HOST=NEED_TO_SET
 PROD_REDIS_PORT=NEED_TO_SET
 PROD_REDIS_PASSWORD=NEED_TO_SET
 
+PROD_QDRANT_HOST=NEED_TO_SET
+PROD_QDRANT_PORT=NEED_TO_SET
+
+# DEV
+DEV_URL=NEED_TO_SET
+DEV_FRONTEND_URL=NEED_TO_SET
+DEV_CORS_ALLOWED_ORIGINS=NEED_TO_SET
+DEV_OAUTH2_KAKAO_REDIRECT_URI=NEED_TO_SET
+DEV_OAUTH2_NAVER_REDIRECT_URI=NEED_TO_SET
+DEV_OAUTH2_SUCCESS_REDIRECT_URL=NEED_TO_SET
+DEV_OAUTH2_FAILURE_REDIRECT_URL=NEED_TO_SET
 DEV_DATASOURCE_URL=NEED_TO_SET
 DEV_DATASOURCE_USERNAME=NEED_TO_SET
 DEV_DATASOURCE_PASSWORD=NEED_TO_SET
 DEV_DATASOURCE_DRIVER=NEED_TO_SET
 DEV_JPA_HIBERNATE_DDL_AUTO=NEED_TO_SET
+DEV_DATASOURCE_PORT=NEED_TO_SET
+DEV_DB_ROOT_PASSWORD=NEED_TO_SET
 
 DEV_REDIS_HOST=NEED_TO_SET
 DEV_REDIS_PORT=NEED_TO_SET
 DEV_REDIS_PASSWORD=NEED_TO_SET
 
+DEV_QDRANT_HOST=NEED_TO_SET
+DEV_QDRANT_PORT=NEED_TO_SET
+
+# TEST
 TEST_DATASOURCE_URL=NEED_TO_SET
 TEST_DATASOURCE_USERNAME=NEED_TO_SET
 TEST_DATASOURCE_PASSWORD=NEED_TO_SET
@@ -37,4 +65,17 @@ TEST_JPA_HIBERNATE_DDL_AUTO=NEED_TO_SET
 
 TEST_REDIS_HOST=NEED_TO_SET
 TEST_REDIS_PORT=NEED_TO_SET
-TEST_REDIS_PASSWORD=NEED_TO_SET
+TEST_REDIS_PASSWORD=NEED_TO_SET
+
+# AI
+OPENAI_API_KEY=NEED_TO_SET
+
+# Base application.yml variables (no profile-specific prefix)
+SPRING_AI_VECTORSTORE_QDRANT_HOST=NEED_TO_SET
+SPRING_AI_VECTORSTORE_QDRANT_PORT=NEED_TO_SET
+SPRING_SECURITY_OAUTH2_CLIENT_REGISTRATION_KAKAO_REDIRECT_URI=NEED_TO_SET
+SPRING_SECURITY_OAUTH2_CLIENT_REGISTRATION_NAVER_REDIRECT_URI=NEED_TO_SET
+CUSTOM_CORS_ALLOWED_ORIGINS=NEED_TO_SET
+CUSTOM_OAUTH2_REDIRECT_URL=NEED_TO_SET
+CUSTOM_OAUTH2_FAILURE_URL=NEED_TO_SET
+CUSTOM_FRONTEND_URL=NEED_TO_SET

backend/build.gradle

@@ -38,6 +38,7 @@ dependencies {
     implementation 'org.springframework.boot:spring-boot-starter-validation'
     implementation 'org.springframework.boot:spring-boot-starter-web'
     implementation 'org.springframework.boot:spring-boot-starter-actuator'
+    implementation 'org.springframework.boot:spring-boot-starter-oauth2-client'
     implementation group: 'org.springframework.boot', name: 'spring-boot-starter-mail', version: '3.0.5'
 
     // API Documentation (문서화)

backend/src/main/java/com/ai/lawyer/domain/auth/dto/OAuth2LoginResponse.java

@@ -0,0 +1,11 @@
+package com.ai.lawyer.domain.auth.dto;
+
+import lombok.Builder;
+import lombok.Getter;
+
+@Getter
+@Builder
+public class OAuth2LoginResponse {
+    private boolean success;
+    private String message;
+}

backend/src/main/java/com/ai/lawyer/domain/member/controller/MemberController.java

@@ -1,19 +1,14 @@
 package com.ai.lawyer.domain.member.dto;
 
-import lombok.AllArgsConstructor;
-import lombok.Getter;
-
 import java.time.LocalDateTime;
 
-@Getter
-@AllArgsConstructor
-public class MemberErrorResponse {
-    private final String message;
-    private final int status;
-    private final String error;
-    private final LocalDateTime timestamp;
-
+public record MemberErrorResponse(
+        String message,
+        int status,
+        String error,
+        LocalDateTime timestamp
+) {
     public static MemberErrorResponse of(String message, int status, String error) {
         return new MemberErrorResponse(message, status, error, LocalDateTime.now());
     }
-}
+}

backend/src/main/java/com/ai/lawyer/domain/member/dto/MemberErrorResponse.java

@@ -1,6 +1,8 @@
 package com.ai.lawyer.domain.member.dto;
 
 import com.ai.lawyer.domain.member.entity.Member;
+import com.ai.lawyer.domain.member.entity.MemberAdapter;
+import com.ai.lawyer.domain.member.entity.OAuth2Member;
 import lombok.*;
 
 import java.time.LocalDateTime;
@@ -14,6 +16,7 @@ public class MemberResponse {
 
     private Long memberId;
     private String loginId;
+    private String email;  // 이메일 추가
     private Integer age;
     private Member.Gender gender;
     private Member.Role role;
@@ -25,6 +28,7 @@ public static MemberResponse from(Member member) {
         return MemberResponse.builder()
                 .memberId(member.getMemberId())
                 .loginId(member.getLoginId())
+                .email(member.getLoginId())  // 로컬 회원은 loginId가 이메일
                 .age(member.getAge())
                 .gender(member.getGender())
                 .role(member.getRole())
@@ -33,4 +37,24 @@ public static MemberResponse from(Member member) {
                 .updatedAt(member.getUpdatedAt())
                 .build();
     }
-}
+
+    public static MemberResponse from(MemberAdapter memberAdapter) {
+        return switch (memberAdapter) {
+            case null -> throw new IllegalArgumentException("MemberAdapter cannot be null");
+            case Member member -> from(member);
+            case OAuth2Member oauth2Member -> MemberResponse.builder()
+                    .memberId(oauth2Member.getMemberId())
+                    .loginId(oauth2Member.getLoginId())
+                    .email(oauth2Member.getEmail())  // OAuth2Member의 email 컬럼
+                    .age(oauth2Member.getAge())
+                    .gender(oauth2Member.getGender())
+                    .role(oauth2Member.getRole())
+                    .name(oauth2Member.getName())
+                    .createdAt(oauth2Member.getCreatedAt())
+                    .updatedAt(oauth2Member.getUpdatedAt())
+                    .build();
+            default ->
+                    throw new IllegalArgumentException("Unsupported member type: " + memberAdapter.getClass().getName());
+        };
+    }
+}

backend/src/main/java/com/ai/lawyer/domain/member/dto/MemberResponse.java

@@ -0,0 +1,43 @@
+package com.ai.lawyer.domain.member.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@Schema(description = "OAuth2 로그인 테스트 요청 (개발/테스트용)")
+public class OAuth2LoginTestRequest {
+
+    @NotBlank(message = "이메일은 필수입니다")
+    @Email(message = "올바른 이메일 형식이어야 합니다")
+    @Schema(description = "사용자 이메일", example = "[email protected]")
+    private String email;
+
+    @NotBlank(message = "이름은 필수입니다")
+    @Schema(description = "사용자 이름", example = "홍길동")
+    private String name;
+
+    @NotNull(message = "나이는 필수입니다")
+    @Schema(description = "사용자 나이", example = "25")
+    private Integer age;
+
+    @NotBlank(message = "성별은 필수입니다")
+    @Schema(description = "사용자 성별 (MALE/FEMALE/OTHER)", example = "MALE")
+    private String gender;
+
+    @NotBlank(message = "Provider는 필수입니다")
+    @Schema(description = "OAuth Provider (KAKAO/NAVER)", example = "KAKAO")
+    private String provider;
+
+    @NotBlank(message = "Provider ID는 필수입니다")
+    @Schema(description = "OAuth Provider의 사용자 ID", example = "123456789")
+    private String providerId;
+}

backend/src/main/java/com/ai/lawyer/domain/member/dto/OAuth2LoginTestRequest.java

@@ -11,7 +11,7 @@
 @Entity
 @Table(name = "member",
         indexes = {
-                @Index(name = "idx_member_loginid", columnList = "loginid")
+                @Index(name = "idx_member_login_id", columnList = "login_id")
         })
 @Getter
 @Setter
@@ -20,14 +20,14 @@
 @Builder
 @ToString(exclude = "password")
 @EqualsAndHashCode(of = "memberId")
-public class Member {
+public class Member implements MemberAdapter {
 
     @Id
     @GeneratedValue(strategy = GenerationType.IDENTITY)
     @Column(name = "member_id", nullable = false)
     private Long memberId;
 
-    @Column(name = "loginid", nullable = false, unique = true, length = 100)
+    @Column(name = "login_id", nullable = false, unique = true, length = 100)
     @Email(message = "올바른 이메일 형식이 아닙니다")
     @NotBlank(message = "이메일(로그인 ID)은 필수입니다")
     private String loginId;

backend/src/main/java/com/ai/lawyer/domain/member/entity/Member.java

@@ -0,0 +1,42 @@
+package com.ai.lawyer.domain.member.entity;
+
+/**
+ * Member와 OAuth2Member를 통합해서 처리하기 위한 어댑터 인터페이스
+ * TokenProvider, JwtAuthenticationFilter 등에서 동일한 방식으로 처리 가능
+ */
+public interface MemberAdapter {
+    Long getMemberId();
+    String getLoginId();
+    String getName();
+    Integer getAge();
+    Member.Gender getGender();
+    Member.Role getRole();
+
+    /**
+     * 이메일 반환
+     * - Member: loginId 반환 (loginId가 이메일)
+     * - OAuth2Member: email 컬럼 반환
+     */
+    default String getEmail() {
+        if (isLocalMember()) {
+            return getLoginId(); // 로컬 회원은 loginId가 이메일
+        } else if (isOAuth2Member()) {
+            return this.getEmail();
+        }
+        return null;
+    }
+
+    /**
+     * 로컬 회원인지 확인
+     */
+    default boolean isLocalMember() {
+        return this instanceof Member;
+    }
+
+    /**
+     * OAuth2 회원인지 확인
+     */
+    default boolean isOAuth2Member() {
+        return this instanceof OAuth2Member;
+    }
+}

backend/src/main/java/com/ai/lawyer/domain/member/entity/MemberAdapter.java

@@ -0,0 +1,83 @@
+package com.ai.lawyer.domain.member.entity;
+
+import jakarta.persistence.*;
+import jakarta.validation.constraints.*;
+import lombok.*;
+import org.hibernate.annotations.CreationTimestamp;
+import org.hibernate.annotations.UpdateTimestamp;
+
+import java.time.LocalDateTime;
+
+@Entity
+@Table(name = "oauth2_member",
+        indexes = {
+                @Index(name = "idx_oauth2_member_login_id", columnList = "login_id"),
+                @Index(name = "idx_oauth2_member_provider", columnList = "provider, provider_id")
+        })
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@ToString
+@EqualsAndHashCode()
+public class OAuth2Member implements MemberAdapter {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(name = "member_id", nullable = false)
+    private Long memberId;
+
+    @Column(name = "login_id", nullable = false, unique = true, length = 100)
+    @Email(message = "올바른 이메일 형식이 아닙니다")
+    @NotBlank(message = "이메일(로그인 ID)은 필수입니다")
+    private String loginId;
+
+    @Column(name = "email", nullable = false, length = 100)
+    @Email(message = "올바른 이메일 형식이 아닙니다")
+    @NotBlank(message = "이메일은 필수입니다")
+    private String email;
+
+    @Column(name = "age", nullable = false)
+    @NotNull(message = "나이는 필수입니다")
+    @Min(value = 14, message = "최소 14세 이상이어야 합니다")
+    private Integer age;
+
+    @Enumerated(EnumType.STRING)
+    @Column(name = "gender", nullable = false, length = 10)
+    @NotNull(message = "성별은 필수입니다")
+    private Member.Gender gender;
+
+    @Enumerated(EnumType.STRING)
+    @Column(name = "role", nullable = false, length = 20)
+    @Builder.Default
+    private Member.Role role = Member.Role.USER;
+
+    @Column(name = "name", nullable = false, length = 20)
+    @NotBlank(message = "이름은 필수입니다")
+    private String name;
+
+    @Enumerated(EnumType.STRING)
+    @Column(name = "provider", nullable = false, length = 20)
+    @NotNull(message = "OAuth Provider는 필수입니다")
+    private Provider provider;
+
+    @Column(name = "provider_id", nullable = false, length = 100)
+    @NotBlank(message = "Provider ID는 필수입니다")
+    private String providerId;
+
+    @CreationTimestamp
+    @Column(name = "created_at", nullable = false, updatable = false)
+    private LocalDateTime createdAt;
+
+    @UpdateTimestamp
+    @Column(name = "updated_at")
+    private LocalDateTime updatedAt;
+
+    @Getter
+    public enum Provider {
+        KAKAO("카카오"), NAVER("네이버");
+        private final String description;
+        Provider(String description) { this.description = description; }
+    }
+}