feat: 여행 설문조사 기반 아바타 매칭 시스템 구현

src/main/java/com/dduru/gildongmu/auth/service/OauthAuthService.java

@@ -11,6 +11,8 @@
 import com.dduru.gildongmu.common.exception.BusinessException;
 import com.dduru.gildongmu.common.exception.ErrorCode;
 import com.dduru.gildongmu.common.jwt.JwtTokenProvider;
+import com.dduru.gildongmu.profile.domain.Profile;
+import com.dduru.gildongmu.profile.repository.ProfileRepository;
 import com.dduru.gildongmu.user.domain.User;
 import com.dduru.gildongmu.user.enums.OauthType;
 import com.dduru.gildongmu.user.enums.Role;
@@ -30,6 +32,7 @@ public class OauthAuthService {
 
     private final OauthFactory oauthFactory;
     private final UserRepository userRepository;
+    private final ProfileRepository profileRepository;
     private final JwtTokenProvider jwtTokenProvider;
     private final RefreshTokenService refreshTokenService;
 
@@ -145,22 +148,27 @@ private record UserCreationResult(User user, boolean isNewUser) {
     }
 
     private User createNewUser(OauthUserInfo oauthUserInfo) {
-        // 추가 정보는 회원가입 이후 별도 입력으로 변경
-        // 닉네임은 온보딩에서 설정하므로 null로 초기화
-
         User newUser = User.builder()
                 .email(oauthUserInfo.email())
                 .name(oauthUserInfo.name())
-                .nickname(null)
-                .profileImage(oauthUserInfo.profileImage())
                 .oauthId(oauthUserInfo.oauthId())
                 .oauthType(oauthUserInfo.loginType())
                 .role(Role.USER)
+                .build();
+
+        User savedUser = userRepository.save(newUser);
+
+        Profile profile = Profile.builder()
+                .user(savedUser)
+                .profileImage(null)
+                .nickname(null)
                 .gender(null)
                 .phoneNumber(null)
                 .birthday(null)
                 .build();
 
-        return userRepository.save(newUser);
+        profileRepository.save(profile);
+
+        return savedUser;
     }
 }

src/main/java/com/dduru/gildongmu/comment/dto/CommentResponse.java

@@ -34,8 +34,8 @@ public static CommentResponse from(Comment comment) {
             authorProfileImage = null;
         } else {
             content = comment.getContent();
-            author = comment.getUser().getNickname();
-            authorProfileImage = comment.getUser().getProfileImage();
+            author = comment.getUser().getProfile().getNickname();
+            authorProfileImage = comment.getUser().getProfile().getProfileImage();
         }
 
         return new CommentResponse(

src/main/java/com/dduru/gildongmu/common/annotation/ApiErrorResponses.java

@@ -0,0 +1,28 @@
+package com.dduru.gildongmu.common.annotation;
+
+import com.dduru.gildongmu.common.exception.ErrorCode;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * API 엔드포인트에 자동으로 에러 응답을 추가하기 위한 어노테이션
+ * ErrorCode enum을 지정하면 해당 ErrorCode의 HTTP 상태 코드가 자동으로 사용됩니다.
+ * 
+ * 사용 예시:
+ * <pre>
+ * {@code @ApiErrorResponses({ErrorCode.NICKNAME_ALREADY_TAKEN, ErrorCode.PROFILE_NOT_FOUND})}
+ * ResponseEntity<ApiResult<Response>> method();
+ * </pre>
+ */
+@Target({ElementType.METHOD, ElementType.TYPE})
+@Retention(RetentionPolicy.RUNTIME)
+public @interface ApiErrorResponses {
+    /**
+     * 추가할 ErrorCode enum 목록 (예: ErrorCode.NICKNAME_ALREADY_TAKEN, ErrorCode.PROFILE_NOT_FOUND)
+     * 각 ErrorCode의 HTTP 상태 코드가 자동으로 사용됩니다.
+     */
+    ErrorCode[] value();
+}

src/main/java/com/dduru/gildongmu/common/exception/ApiErrorResponseDocsCustomizer.java

@@ -0,0 +1,175 @@
+package com.dduru.gildongmu.common.exception;
+
+import com.dduru.gildongmu.common.annotation.ApiErrorResponses;
+import io.swagger.v3.oas.models.Components;
+import io.swagger.v3.oas.models.examples.Example;
+import io.swagger.v3.oas.models.media.Content;
+import io.swagger.v3.oas.models.media.MediaType;
+import io.swagger.v3.oas.models.media.Schema;
+import io.swagger.v3.oas.models.responses.ApiResponse;
+import lombok.extern.slf4j.Slf4j;
+import org.springdoc.core.customizers.OperationCustomizer;
+import org.springdoc.core.customizers.OpenApiCustomizer;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+import java.lang.reflect.Method;
+import java.util.HashMap;
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+/**
+ * OpenAPI 에러 응답 자동 추가 커스터마이저
+ * 
+ * @ApiErrorResponses 어노테이션에 ErrorCode enum을 지정하면,
+ * 해당 ErrorCode의 HTTP 상태 코드와 메시지가 자동으로 사용됩니다.
+ */
+@Slf4j
+@Configuration
+public class ApiErrorResponseDocsCustomizer {
+
+    /**
+     * ErrorResponse 스키마를 Components에 등록
+     */
+    @Bean
+    public OpenApiCustomizer errorResponseSchemaCustomizer() {
+        return openApi -> {
+            Components components = openApi.getComponents();
+            if (components == null) {
+                components = new Components();
+                openApi.setComponents(components);
+            }
+
+            // ErrorResponse 스키마 정의
+            Schema<?> errorResponseSchema = new Schema<>()
+                    .type("object")
+                    .addProperty("status", new Schema<>().type("integer").format("int32").example(400))
+                    .addProperty("data", new Schema<>()
+                            .type("object")
+                            .addProperty("errorCode", new Schema<>().type("string").example("INVALID_INPUT_VALUE"))
+                            .addProperty("field", new Schema<>().type("string").nullable(true))
+                            .addProperty("message", new Schema<>().type("string").example("잘못된 입력 값입니다.")));
+
+            components.addSchemas("ErrorResponse", errorResponseSchema);
+        };
+    }
+
+    /**
+     * @ApiErrorResponses 어노테이션에 지정된 ErrorCode enum을 기반으로 에러 응답 자동 추가
+     */
+    @Bean
+    public OperationCustomizer operationCustomizer() {
+        return (operation, handlerMethod) -> {
+            ErrorCode[] errorCodes = new ErrorCode[0];
+
+            Method method = handlerMethod.getMethod();
+            Class<?> declaringClass = method.getDeclaringClass();
+            String methodName = method.getName();
+
+            // 모든 인터페이스에서 메서드를 찾아 어노테이션 확인
+            for (Class<?> iface : declaringClass.getInterfaces()) {
+                // 인터페이스의 모든 메서드 검색 (파라미터 타입이 다를 수 있으므로)
+                for (Method interfaceMethod : iface.getMethods()) {
+                    // 메서드 이름이 같고 어노테이션이 있으면 사용
+                    if (interfaceMethod.getName().equals(methodName) 
+                            && interfaceMethod.isAnnotationPresent(ApiErrorResponses.class)) {
+                        errorCodes = interfaceMethod.getAnnotation(ApiErrorResponses.class).value();
+                        break;
+                    }
+                }
+                if (errorCodes.length > 0) {
+                    break;
+                }
+
+                // 인터페이스 레벨 어노테이션 확인
+                if (iface.isAnnotationPresent(ApiErrorResponses.class)) {
+                    errorCodes = iface.getAnnotation(ApiErrorResponses.class).value();
+                    break;
+                }
+            }
+
+            // 클래스 레벨 어노테이션 확인
+            if (errorCodes.length == 0 && declaringClass.isAnnotationPresent(ApiErrorResponses.class)) {
+                errorCodes = declaringClass.getAnnotation(ApiErrorResponses.class).value();
+            }
+
+            // 메서드 레벨 어노테이션 확인 (메서드 레벨이 우선)
+            if (method.isAnnotationPresent(ApiErrorResponses.class)) {
+                errorCodes = method.getAnnotation(ApiErrorResponses.class).value();
+            }
+
+            if (errorCodes.length > 0) {
+                addErrorResponses(operation, errorCodes);
+            }
+
+            return operation;
+        };
+    }
+
+    /**
+     * ErrorCode enum 배열을 기반으로 에러 응답 추가
+     * 각 ErrorCode에 대해 해당하는 HTTP 상태 코드의 응답을 추가하고, 예시를 포함합니다.
+     * 같은 HTTP 상태 코드를 가진 여러 ErrorCode가 있으면 모두 examples에 추가합니다.
+     */
+    private void addErrorResponses(io.swagger.v3.oas.models.Operation operation, ErrorCode[] errorCodes) {
+        // ErrorResponse 스키마 참조
+        Schema<?> errorResponseSchema = new Schema<>()
+                .$ref("#/components/schemas/ErrorResponse");
+
+        // HTTP 상태 코드별로 ErrorCode들을 그룹화
+        Map<String, java.util.List<ErrorCode>> statusCodeToErrorCodes = new HashMap<>();
+
+        for (ErrorCode errorCode : errorCodes) {
+            String statusCode = String.valueOf(errorCode.getStatus());
+            statusCodeToErrorCodes.computeIfAbsent(statusCode, k -> new java.util.ArrayList<>()).add(errorCode);
+        }
+
+        // 각 상태 코드에 대해 에러 응답 추가
+        for (Map.Entry<String, java.util.List<ErrorCode>> entry : statusCodeToErrorCodes.entrySet()) {
+            String statusCode = entry.getKey();
+            java.util.List<ErrorCode> errorCodeList = entry.getValue();
+
+            // 이미 해당 상태 코드의 응답이 있으면 스킵
+            if (operation.getResponses().containsKey(statusCode)) {
+                continue;
+            }
+
+            // 첫 번째 ErrorCode를 기본으로 사용 (description)
+            ErrorCode primaryErrorCode = errorCodeList.get(0);
+
+            // 각 ErrorCode에 대한 예시 생성
+            Map<String, Example> examples = new HashMap<>();
+            for (ErrorCode errorCode : errorCodeList) {
+                Map<String, Object> errorResponseMap = new LinkedHashMap<>();
+                errorResponseMap.put("status", errorCode.getStatus());
+
+                Map<String, Object> dataMap = new LinkedHashMap<>();
+                dataMap.put("errorCode", errorCode.name());
+                dataMap.put("field", null);
+                dataMap.put("message", errorCode.getMessage());
+                errorResponseMap.put("data", dataMap);
+
+                Example example = new Example();
+                example.setValue(errorResponseMap);
+                example.setSummary(errorCode.getMessage());
+                examples.put(errorCode.name(), example);
+            }
+
+            // MediaType 생성 (여러 예시가 있으면 examples 사용, 하나만 있으면 example 사용)
+            MediaType mediaType = new MediaType().schema(errorResponseSchema);
+            if (examples.size() > 1) {
+                mediaType.setExamples(examples);
+            } else if (examples.size() == 1) {
+                Example singleExample = examples.values().iterator().next();
+                mediaType.setExample(singleExample.getValue());
+            }
+
+            // 에러 응답 생성
+            ApiResponse apiResponse = new ApiResponse()
+                    .description(primaryErrorCode.getMessage())
+                    .content(new Content().addMediaType("application/json", mediaType));
+
+            operation.getResponses().addApiResponse(statusCode, apiResponse);
+        }
+    }
+}

src/main/java/com/dduru/gildongmu/common/exception/ErrorCode.java

@@ -14,7 +14,7 @@ public enum ErrorCode {
     UNAUTHORIZED(HttpStatus.UNAUTHORIZED, "인증되지 않은 사용자입니다."),
     DUPLICATE_EMAIL(HttpStatus.CONFLICT, "이미 다른 소셜 계정으로 가입된 이메일입니다."),
 
-    // 닉네임 (NICKNAME) - 이전 '온보딩 (ONBD)'
+    // 닉네임 (NICKNAME)
     NICKNAME_NOT_BLANK(HttpStatus.BAD_REQUEST, "닉네임은 공백일 수 없습니다."),
     NICKNAME_INVALID_LENGTH(HttpStatus.BAD_REQUEST, "닉네임은 2자 이상 14자 이하로 입력해주세요."),
     NICKNAME_INVALID_CHARACTERS(HttpStatus.BAD_REQUEST, "닉네임은 한글, 영어, 숫자만 사용 가능합니다."),
@@ -25,6 +25,7 @@ public enum ErrorCode {
 
     // 사용자 (USER)
     USER_NOT_FOUND(HttpStatus.NOT_FOUND, "사용자를 찾을 수 없습니다."),
+    PROFILE_NOT_FOUND(HttpStatus.NOT_FOUND, "해당 유저의 프로필을 찾을 수 없습니다."),
 
     // 게시글 (POST)
     POST_NOT_FOUND(HttpStatus.NOT_FOUND, "게시글을 찾을 수 없습니다."),
@@ -61,7 +62,7 @@ public enum ErrorCode {
     INVALID_FILE_EXTENSION(HttpStatus.BAD_REQUEST, "허용되지 않는 파일 확장자입니다."),
 
     // 설문 (SURVEY)
-    UNKNOWN_SURVEY_ANSWER_CODE(HttpStatus.BAD_REQUEST, "알 수 없는 설문조사 답변 코드입니다."),
+    SURVEY_RESULT_NOT_FOUND(HttpStatus.NOT_FOUND, "설문 결과를 찾을 수 없습니다."),
 
     // 휴대폰 인증 (VERIFICATION)
     SMS_SEND_FAILED(HttpStatus.INTERNAL_SERVER_ERROR, "SMS 발송에 실패했습니다."),