[Feat] #29 온보딩 완료 기능 구현

Author: yeonjuncho

src/main/java/com/leets7th/job_is_be/domain/user/controller/ProfileController.java

@@ -10,6 +10,7 @@
 import org.springframework.security.oauth2.jwt.Jwt;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PutMapping;
+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.RestController;
@@ -45,6 +46,14 @@ public ResponseEntity<ApiResponse<ProfileDraftResponse>> saveDraft(
         );
     }
 
+    @PostMapping("/onboarding/complete")
+    public ResponseEntity<ApiResponse<Void>> completeOnboarding(
+            @AuthenticationPrincipal Jwt jwt
+    ) {
+        profileService.completeOnboarding(userId(jwt));
+        return ApiResponse.success(SuccessStatus.PROFILE_ONBOARDING_COMPLETE_SUCCESS);
+    }
+
     private Long userId(Jwt jwt) {
         return Long.valueOf(jwt.getSubject());
     }

src/main/java/com/leets7th/job_is_be/domain/user/service/ProfileService.java

@@ -14,12 +14,14 @@
 import com.leets7th.job_is_be.domain.user.repository.UserProfileRepository;
 import com.leets7th.job_is_be.domain.user.repository.UserRegionRepository;
 import com.leets7th.job_is_be.domain.user.repository.UserRepository;
+import com.leets7th.job_is_be.domain.user.enums.OnboardingStep;
 import com.leets7th.job_is_be.global.exception.GeneralException;
 import com.leets7th.job_is_be.global.status.ErrorStatus;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 
 import java.util.ArrayList;
+import java.time.LocalDateTime;
 import java.util.LinkedHashSet;
 import java.util.List;
 import java.util.Map;
@@ -105,6 +107,31 @@ public ProfileDraftResponse getDraft(Long userId) {
         return toDraftResponse(profile, findJobCategories(userId), findRegion(userId));
     }
 
+    @Transactional
+    public void completeOnboarding(Long userId) {
+        UserProfile profile = userProfileRepository.findByUserId(userId)
+                .orElseThrow(() -> new GeneralException(ErrorStatus.PROFILE_NOT_FOUND));
+        if (profile.isOnboardingCompleted()) {
+            throw new GeneralException(ErrorStatus.PROFILE_ALREADY_COMPLETED);
+        }
+        if (profile.getOnboardingStep() != OnboardingStep.REVIEW) {
+            throw new GeneralException(ErrorStatus.PROFILE_ONBOARDING_NOT_READY);
+        }
+
+        List<UserJobCategory> jobCategories = findJobCategories(userId);
+        long primaryCount = jobCategories.stream().filter(UserJobCategory::isPrimary).count();
+        boolean missingRequiredValue = jobCategories.isEmpty()
+                || jobCategories.size() > MAX_JOB_CATEGORIES
+                || primaryCount != 1
+                || findRegion(userId) == null
+                || profile.getCareerLevel() == null;
+        if (missingRequiredValue) {
+            throw new GeneralException(ErrorStatus.PROFILE_REQUIRED_FIELDS_MISSING);
+        }
+
+        profile.completeOnboarding(LocalDateTime.now());
+    }
+
     private List<JobCategory> resolveJobCategories(List<Long> requestedIds, Long primaryId) {
         List<Long> ids = requestedIds == null ? List.of() : requestedIds;
         LinkedHashSet<Long> uniqueIds = new LinkedHashSet<>(ids);

src/main/java/com/leets7th/job_is_be/global/status/ErrorStatus.java

@@ -49,9 +49,12 @@ public enum ErrorStatus implements BaseStatus {
     PROFILE_JOB_CATEGORY_COUNT_INVALID(HttpStatus.BAD_REQUEST, "PROFILE_400_2", "관심 직무는 중복 없이 최대 3개까지 선택할 수 있습니다."),
     PROFILE_PRIMARY_JOB_CATEGORY_INVALID(HttpStatus.BAD_REQUEST, "PROFILE_400_3", "대표 관심 직무는 선택한 관심 직무에 포함되어야 합니다."),
     PROFILE_VALUE_TOO_LONG(HttpStatus.BAD_REQUEST, "PROFILE_400_4", "프로필 입력값이 허용 길이를 초과했습니다."),
+    PROFILE_REQUIRED_FIELDS_MISSING(HttpStatus.BAD_REQUEST, "PROFILE_400_5", "온보딩 완료에 필요한 프로필 항목을 입력해 주세요."),
+    PROFILE_NOT_FOUND(HttpStatus.NOT_FOUND, "PROFILE_404_1", "완료된 프로필을 찾을 수 없습니다."),
     PROFILE_JOB_CATEGORY_NOT_FOUND(HttpStatus.NOT_FOUND, "PROFILE_404_2", "선택한 관심 직무를 찾을 수 없습니다."),
     PROFILE_REGION_NOT_FOUND(HttpStatus.NOT_FOUND, "PROFILE_404_3", "선택한 희망 지역을 찾을 수 없습니다."),
     PROFILE_ALREADY_COMPLETED(HttpStatus.CONFLICT, "PROFILE_409_1", "이미 온보딩을 완료한 프로필입니다."),
+    PROFILE_ONBOARDING_NOT_READY(HttpStatus.CONFLICT, "PROFILE_409_2", "온보딩 확인 단계에서 완료할 수 있습니다."),
 
     /**
      * Deck

src/main/java/com/leets7th/job_is_be/global/status/SuccessStatus.java

@@ -27,6 +27,7 @@ public enum SuccessStatus implements BaseStatus {
      */
     PROFILE_DRAFT_GET_SUCCESS(HttpStatus.OK, "PROFILE_200_3", "온보딩 임시저장을 조회했습니다."),
     PROFILE_DRAFT_SAVE_SUCCESS(HttpStatus.OK, "PROFILE_200_4", "온보딩 내용을 임시저장했습니다."),
+    PROFILE_ONBOARDING_COMPLETE_SUCCESS(HttpStatus.OK, "PROFILE_200_5", "온보딩을 완료했습니다."),
 
 
     /**