feat: 소셜 로그인으로 회원 가입 지원 및 계정 연결 해제 구현

src/main/java/com/dreamteam/alter/adapter/inbound/general/user/controller/UserPublicController.java

@@ -11,6 +11,7 @@
 import com.dreamteam.alter.domain.user.port.inbound.LoginWithPasswordUseCase;
 import com.dreamteam.alter.domain.user.port.inbound.LoginWithSocialUseCase;
 import com.dreamteam.alter.domain.user.port.inbound.CreateUserUseCase;
+import com.dreamteam.alter.domain.user.port.inbound.CreateUserWithSocialUseCase;
 import com.dreamteam.alter.domain.user.port.inbound.CheckContactDuplicationUseCase;
 import com.dreamteam.alter.domain.user.port.inbound.CheckNicknameDuplicationUseCase;
 import com.dreamteam.alter.domain.user.port.inbound.CheckEmailDuplicationUseCase;
@@ -41,6 +42,9 @@ public class UserPublicController implements UserPublicControllerSpec {
     @Resource(name = "createUser")
     private final CreateUserUseCase createUser;
 
+    @Resource(name = "createUserWithSocial")
+    private final CreateUserWithSocialUseCase createUserWithSocial;
+
     @Resource(name = "checkContactDuplication")
     private final CheckContactDuplicationUseCase checkContactDuplication;
 
@@ -95,6 +99,14 @@ public ResponseEntity<CommonApiResponse<GenerateTokenResponseDto>> createUser(
         return ResponseEntity.ok(CommonApiResponse.of(createUser.execute(request)));
     }
 
+    @Override
+    @PostMapping("/signup-social")
+    public ResponseEntity<CommonApiResponse<GenerateTokenResponseDto>> createUserWithSocial(
+        @Valid @RequestBody CreateUserWithSocialRequestDto request
+    ) {
+        return ResponseEntity.ok(CommonApiResponse.of(createUserWithSocial.execute(request)));
+    }
+
     @Override
     @PostMapping("/exists/nickname")
     public ResponseEntity<CommonApiResponse<CheckNicknameDuplicationResponseDto>> checkNicknameDuplication(

src/main/java/com/dreamteam/alter/adapter/inbound/general/user/controller/UserPublicControllerSpec.java

@@ -93,6 +93,23 @@ public interface UserPublicControllerSpec {
     })
     ResponseEntity<CommonApiResponse<GenerateTokenResponseDto>> createUser(@Valid CreateUserRequestDto request);
 
+    @Operation(summary = "소셜 계정으로 회원가입을 수행한다")
+    @ApiResponses(value = {
+        @ApiResponse(responseCode = "200", description = "소셜 회원 가입 및 로그인 성공 (JWT 응답)"),
+        @ApiResponse(responseCode = "400", description = "실패 케이스",
+            content = @Content(
+                mediaType = "application/json",
+                schema = @Schema(implementation = ErrorResponse.class),
+                examples = {
+                    @ExampleObject(name = "회원 가입 세션이 존재하지 않음",  value = "{\"code\" : \"A006\"}"),
+                    @ExampleObject(name = "사용자 닉네임 중복",            value = "{\"code\" : \"A008\"}"),
+                    @ExampleObject(name = "사용자 휴대폰 번호 중복",         value = "{\"code\" : \"A009\"}"),
+                    @ExampleObject(name = "소셜 플랫폼 ID 중복",           value = "{\"code\" : \"A005\"}"),
+                    @ExampleObject(name = "소셜 토큰 만료 (재 로그인 필요)", value = "{\"code\" : \"A007\"}")
+                }))
+    })
+    ResponseEntity<CommonApiResponse<GenerateTokenResponseDto>> createUserWithSocial(@Valid CreateUserWithSocialRequestDto request);
+
     @Operation(summary = "사용자 닉네임 중복 체크")
     @ApiResponses(value = {
         @ApiResponse(responseCode = "200", description = "닉네임 중복 체크 성공")

src/main/java/com/dreamteam/alter/adapter/inbound/general/user/controller/UserSelfController.java

@@ -57,6 +57,9 @@ public class UserSelfController implements UserSelfControllerSpec {
     @Resource(name = "verifyEmailVerificationCode")
     private final VerifyEmailVerificationCodeUseCase verifyEmailVerificationCode;
 
+    @Resource(name = "updatePassword")
+    private final UpdatePasswordUseCase updatePassword;
+
     @Override
     @GetMapping
     public ResponseEntity<CommonApiResponse<UserSelfInfoResponseDto>> getUserSelfInfo() {
@@ -154,4 +157,14 @@ public ResponseEntity<CommonApiResponse<VerifyEmailVerificationCodeResponseDto>>
         return ResponseEntity.ok(CommonApiResponse.of(verifyEmailVerificationCode.execute(request)));
     }
 
+    @Override
+    @PutMapping("/password")
+    public ResponseEntity<CommonApiResponse<Void>> updatePassword(
+        @Valid @RequestBody UpdatePasswordRequestDto request
+    ) {
+        AppActor actor = AppActionContext.getInstance().getActor();
+        updatePassword.execute(actor, request);
+        return ResponseEntity.ok(CommonApiResponse.empty());
+    }
+
 }

src/main/java/com/dreamteam/alter/adapter/inbound/general/user/controller/UserSelfControllerSpec.java

@@ -215,4 +215,25 @@ ResponseEntity<CommonApiResponse<Void>> updateUserSelfCertificate(
     })
     ResponseEntity<CommonApiResponse<VerifyEmailVerificationCodeResponseDto>> verifyVerificationCode(@RequestBody @Valid VerifyEmailVerificationCodeRequestDto request);
 
+    @Operation(summary = "비밀번호 변경", description = "비밀번호가 설정된 사용자는 currentPassword 필수. 소셜 전용 사용자는 생략 가능.")
+    @ApiResponses(value = {
+        @ApiResponse(responseCode = "200", description = "비밀번호 변경 성공"),
+        @ApiResponse(responseCode = "400", description = "실패 케이스",
+            content = @Content(
+                mediaType = "application/json",
+                schema = @Schema(implementation = ErrorResponse.class),
+                examples = {
+                    @ExampleObject(
+                        name = "현재 비밀번호 불일치",
+                        value = "{\"code\": \"A017\", \"message\": \"현재 비밀번호가 올바르지 않습니다.\"}"
+                    ),
+                    @ExampleObject(
+                        name = "비밀번호 형식 오류",
+                        value = "{\"code\": \"A014\", \"message\": \"비밀번호는 8~16자 이내 영문, 숫자, 특수문자를 각각 1개 이상 포함해야 합니다.\"}"
+                    )
+                }
+            ))
+    })
+    ResponseEntity<CommonApiResponse<Void>> updatePassword(@RequestBody @Valid UpdatePasswordRequestDto request);
+
 }

src/main/java/com/dreamteam/alter/adapter/inbound/general/user/controller/UserSocialController.java

@@ -2,9 +2,13 @@
 
 import com.dreamteam.alter.adapter.inbound.common.dto.CommonApiResponse;
 import com.dreamteam.alter.adapter.inbound.general.user.dto.LinkSocialAccountRequestDto;
-import com.dreamteam.alter.application.user.usecase.LinkSocialAccount;
+import com.dreamteam.alter.adapter.inbound.general.user.dto.UnlinkSocialAccountRequestDto;
 import com.dreamteam.alter.application.aop.AppActionContext;
 import com.dreamteam.alter.domain.user.context.AppActor;
+import com.dreamteam.alter.domain.user.port.inbound.LinkSocialAccountUseCase;
+import com.dreamteam.alter.domain.user.port.inbound.UnlinkSocialAccountUseCase;
+import com.dreamteam.alter.domain.user.type.SocialProvider;
+import jakarta.annotation.Resource;
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
 import org.springframework.http.ResponseEntity;
@@ -15,16 +19,29 @@
 @RequiredArgsConstructor
 public class UserSocialController implements UserSocialControllerSpec {
 
-    private final LinkSocialAccount linkSocialAccount;
+    @Resource(name = "linkSocialAccount")
+    private final LinkSocialAccountUseCase linkSocialAccount;
+
+    @Resource(name = "unlinkSocialAccount")
+    private final UnlinkSocialAccountUseCase unlinkSocialAccount;
 
     @Override
     @PostMapping("/link")
     public ResponseEntity<CommonApiResponse<Void>> linkSocialAccount(
         @Valid @RequestBody LinkSocialAccountRequestDto request
     ) {
         AppActor actor = AppActionContext.getInstance().getActor();
-
         linkSocialAccount.execute(actor, request);
         return ResponseEntity.ok(CommonApiResponse.empty());
     }
+
+    @Override
+    @DeleteMapping("/unlink/{provider}")
+    public ResponseEntity<CommonApiResponse<Void>> unlinkSocialAccount(
+        @PathVariable SocialProvider provider
+    ) {
+        AppActor actor = AppActionContext.getInstance().getActor();
+        unlinkSocialAccount.execute(actor, new UnlinkSocialAccountRequestDto(provider));
+        return ResponseEntity.ok(CommonApiResponse.empty());
+    }
 }

src/main/java/com/dreamteam/alter/adapter/inbound/general/user/controller/UserSocialControllerSpec.java

@@ -2,6 +2,7 @@
 
 import com.dreamteam.alter.adapter.inbound.common.dto.CommonApiResponse;
 import com.dreamteam.alter.adapter.inbound.general.user.dto.LinkSocialAccountRequestDto;
+import com.dreamteam.alter.domain.user.type.SocialProvider;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.media.Content;
 import io.swagger.v3.oas.annotations.media.ExampleObject;
@@ -11,6 +12,7 @@
 import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.validation.Valid;
 import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.PathVariable;
 
 @Tag(name = "사용자 - 소셜 계정 연동")
 public interface UserSocialControllerSpec {
@@ -39,4 +41,25 @@ public interface UserSocialControllerSpec {
             ))
     })
     ResponseEntity<CommonApiResponse<Void>> linkSocialAccount(@Valid LinkSocialAccountRequestDto request);
+
+    @Operation(summary = "소셜 계정 연동 해제")
+    @ApiResponses(value = {
+        @ApiResponse(responseCode = "200", description = "소셜 계정 연동 해제 성공"),
+        @ApiResponse(responseCode = "400", description = "실패 케이스",
+            content = @Content(
+                mediaType = "application/json",
+                schema = @Schema(implementation = com.dreamteam.alter.adapter.inbound.common.dto.ErrorResponse.class),
+                examples = {
+                    @ExampleObject(
+                        name = "연동되지 않은 소셜 플랫폼",
+                        value = "{\"code\": \"A015\", \"message\": \"연동되지 않은 소셜 플랫폼입니다.\"}"
+                    ),
+                    @ExampleObject(
+                        name = "마지막 소셜 계정 해제 불가",
+                        value = "{\"code\": \"A016\", \"message\": \"비밀번호가 설정되지 않은 경우 마지막 소셜 계정은 해제할 수 없습니다.\"}"
+                    )
+                }
+            ))
+    })
+    ResponseEntity<CommonApiResponse<Void>> unlinkSocialAccount(@PathVariable SocialProvider provider);
 }

src/main/java/com/dreamteam/alter/adapter/inbound/general/user/dto/CreateUserWithSocialRequestDto.java

@@ -0,0 +1,72 @@
+package com.dreamteam.alter.adapter.inbound.general.user.dto;
+
+import com.dreamteam.alter.domain.user.type.PlatformType;
+import com.dreamteam.alter.domain.user.type.SocialProvider;
+import com.dreamteam.alter.domain.user.type.UserGender;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor
+@AllArgsConstructor
+@Schema(description = "소셜 회원가입 요청 DTO")
+public class CreateUserWithSocialRequestDto {
+
+    @NotBlank
+    @Size(max = 64)
+    @Schema(description = "회원가입 세션 ID", example = "UUID")
+    private String signupSessionId;
+
+    @NotNull
+    @Schema(description = "소셜 로그인 플랫폼", example = "KAKAO")
+    private SocialProvider provider;
+
+    @Valid
+    @Schema(description = "OAuth 토큰")
+    private OauthLoginTokenDto oauthToken;
+
+    @Schema(description = "OAuth 인가 코드", example = "authorizationCode")
+    private String authorizationCode;
+
+    @NotNull
+    @Schema(description = "플랫폼 타입", example = "WEB / NATIVE")
+    private PlatformType platformType;
+
+    @NotBlank
+    @Size(max = 12)
+    @Schema(description = "성명", example = "김철수")
+    private String name;
+
+    @NotBlank
+    @Size(max = 64)
+    @Schema(description = "닉네임", example = "유땡땡")
+    private String nickname;
+
+    @NotNull
+    @Schema(description = "성별", example = "GENDER_MALE")
+    private UserGender gender;
+
+    @NotBlank
+    @Size(min = 8, max = 8)
+    @Schema(description = "생년월일", example = "YYYYMMDD")
+    private String birthday;
+
+    @AssertTrue(message = "WEB 플랫폼은 authorizationCode가 필수입니다")
+    private boolean isWebPlatformValid() {
+        if (platformType != PlatformType.WEB) return true;
+        return authorizationCode != null && !authorizationCode.isBlank();
+    }
+
+    @AssertTrue(message = "NATIVE 플랫폼은 oauthToken이 필수입니다")
+    private boolean isNativePlatformValid() {
+        if (platformType != PlatformType.NATIVE) return true;
+        return oauthToken != null;
+    }
+}

src/main/java/com/dreamteam/alter/adapter/inbound/general/user/dto/UnlinkSocialAccountRequestDto.java

@@ -0,0 +1,19 @@
+package com.dreamteam.alter.adapter.inbound.general.user.dto;
+
+import com.dreamteam.alter.domain.user.type.SocialProvider;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor
+@AllArgsConstructor
+@Schema(description = "소셜 계정 연동 해제 요청 DTO")
+public class UnlinkSocialAccountRequestDto {
+
+    @NotNull
+    @Schema(description = "해제할 소셜 플랫폼", example = "KAKAO")
+    private SocialProvider provider;
+}

src/main/java/com/dreamteam/alter/adapter/inbound/general/user/dto/UpdatePasswordRequestDto.java

@@ -0,0 +1,30 @@
+package com.dreamteam.alter.adapter.inbound.general.user.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor
+@AllArgsConstructor
+@Schema(description = "비밀번호 변경 요청 DTO")
+public class UpdatePasswordRequestDto {
+
+    @Schema(description = "현재 비밀번호 (비밀번호가 설정된 사용자는 필수, 소셜 전용 사용자는 생략 가능)", example = "currentPass1!")
+    private String currentPassword;
+
+    @NotBlank
+    @Size(min = 8, max = 16)
+    @Schema(description = "새 비밀번호 (8~16자, 영문·숫자·특수문자 각 1개 이상)", example = "newPass1!")
+    private String newPassword;
+
+    @AssertTrue(message = "새 비밀번호는 현재 비밀번호와 달라야 합니다")
+    private boolean isNewPasswordDifferent() {
+        if (currentPassword == null || newPassword == null) return true;
+        return !currentPassword.equals(newPassword);
+    }
+}

src/main/java/com/dreamteam/alter/adapter/outbound/user/persistence/SignupSessionCacheRepository.java

@@ -0,0 +1,40 @@
+package com.dreamteam.alter.adapter.outbound.user.persistence;
+
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.redis.core.StringRedisTemplate;
+import org.springframework.stereotype.Repository;
+import org.springframework.transaction.annotation.Propagation;
+import org.springframework.transaction.annotation.Transactional;
+import java.time.Duration;
+import java.util.List;
+
+@Repository
+@RequiredArgsConstructor
+public class SignupSessionCacheRepository {
+
+    private final StringRedisTemplate redisTemplate;
+
+    public void save(String key, String value) {
+        redisTemplate.opsForValue().set(key, value);
+    }
+
+    public void save(String key, String value, Duration ttl) {
+        redisTemplate.opsForValue().set(key, value, ttl);
+    }
+
+    public String get(String key) {
+        return redisTemplate.opsForValue().get(key);
+    }
+
+    @Transactional(propagation = Propagation.REQUIRES_NEW)
+    public void delete(String key) {
+        redisTemplate.delete(key);
+    }
+
+    @Transactional(propagation = Propagation.REQUIRES_NEW)
+    public void deleteAll(List<String> keys) {
+        if (!keys.isEmpty()) {
+            redisTemplate.delete(keys);
+        }
+    }
+}

src/main/java/com/dreamteam/alter/adapter/outbound/user/persistence/UserSocialJpaRepository.java

@@ -0,0 +1,7 @@
+package com.dreamteam.alter.adapter.outbound.user.persistence;
+
+import com.dreamteam.alter.domain.user.entity.UserSocial;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface UserSocialJpaRepository extends JpaRepository<UserSocial, Long> {
+}