[T3-108] 추천 루틴 조회 API (#28)

* fix: OneToOne에서 ManyToOne으로 변

* feat: 추천 루틴 조회 API

* feat: swagger 추가

* feat: 루틴, 서브루틴 완료 ID 응답값 추가

* fix: 감정 구슬 1일 1회 선택여부 확인 validation 추가

* fix: onboarding 명세 수정

* feat: 추천 루틴 조회시 응답에 감정구슬 enum 값 추가

* fix: 명세 추가

* fix: 명세 수정

Author: thisishwan2

src/main/java/bitnagil/bitnagil_backend/emotionMarble/repository/EmotionMarbleRepository.java

@@ -3,6 +3,16 @@
 import bitnagil.bitnagil_backend.emotionMarble.domain.EmotionMarble;
 import bitnagil.bitnagil_backend.global.entity.HistoryPk;
 import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
 
+import java.time.LocalDate;
+import java.util.UUID;
+
+@Repository
 public interface EmotionMarbleRepository extends JpaRepository<EmotionMarble, HistoryPk> {
+    EmotionMarble findByUserId(UUID id);
+
+    EmotionMarble findByUserIdAndDateIs(UUID userId, LocalDate now);
+
+    boolean existsByUserIdAndDate(UUID userId, LocalDate nowDate);
 }

src/main/java/bitnagil/bitnagil_backend/emotionMarble/response/RegisterEmotionMarbleResponse.java

@@ -16,6 +16,7 @@
 @Schema(description = "감정 구슬 등록 응답 DTO")
 public class RegisterEmotionMarbleResponse {
 
+    @Schema(description = "추천 루틴 목록")
     private List<RecommendedRoutineDto> recommendedRoutines;
 
 }

src/main/java/bitnagil/bitnagil_backend/emotionMarble/service/EmotionMarbleService.java

@@ -43,29 +43,34 @@ public EmotionMarbleTypeResponse getEmotionMarbles() {
         return EmotionMarbleTypeResponse.builder().emotionMarbleTypes(values).build();
     }
 
-    // 감정 구술 등록
+    // 감정 구슬 등록(1일 1회)
     @Transactional
     public RegisterEmotionMarbleResponse registryEmotionMarble(User user, RegisterEmotionMarbleRequest request) {
         LocalDate nowDate = LocalDate.now();
         LocalDateTime nowDateTime = LocalDateTime.now();
         LocalDateTime endDateTime = LocalDateTime.of(nowDate, LocalTime.of(23, 59, 59));
 
+        // 감정구슬은 1일 1회만 선택할 수 있으므로, 존재 여부를 확인한다.
+        if (emotionMarbleRepository.existsByUserIdAndDate(user.getUserPk().getId(), nowDate)) {
+            throw new CustomException(ErrorCode.ALREADY_REGISTERED_EMOTION_MARBLE);
+        }
+
         EmotionMarble emotionMarble = EmotionMarble.builder()
                 .emotionMarblePk(new HistoryPk(UUID.randomUUID(), 1L))
                 .emotionMarbleType(request.getEmotionMarbleType())
                 .date(nowDate)
                 .userId(user.getUserPk().getId())
                 .historyStartDateTime(nowDateTime)
                 .historyEndDateTime(endDateTime) // historyEndDateTime은 당일 11시 59분 59초로 설정(하루씩 설정되기 때문. 이러면 매일 감정 갱신이 불필요함)
-                .resultCase( // 감정 구술에 따른 추천 루틴을 찾기 위해 Case 객체를 생성
+                .resultCase( // 감정 구슬에 따른 추천 루틴을 찾기 위해 Case 객체를 생성
                         Case.builder()
                                 .caseId(request.getEmotionMarbleType().getCaseId())
                                 .build()
                 ).build();
 
         emotionMarbleRepository.save(emotionMarble);
 
-        // 감정 구술에 따른 추천 루틴 응답
+        // 감정 구슬에 따른 추천 루틴 응답
         List<RecommendedRoutine> recommendedRoutines = recommendRoutineRepository.findByResultCase(emotionMarble.getResultCase());
         if (recommendedRoutines.isEmpty()) {
             throw new CustomException(ErrorCode.NOT_FOUND_RECOMMENDED_ROUTINE);

src/main/java/bitnagil/bitnagil_backend/global/errorcode/ErrorCode.java

@@ -74,7 +74,9 @@ public enum ErrorCode {
 
     // 온보딩 관련 에러 코드
     NOT_FOUND_RECOMMENDED_ROUTINE("ON000", HttpStatus.NOT_FOUND, "조건에 맞는 추천 루틴을 찾을 수 없습니다."),
-    ;
+
+    // 감정구슬 관련 에러코드
+    ALREADY_REGISTERED_EMOTION_MARBLE("EM000", HttpStatus.CONFLICT, "감정구슬은 하루에 한번만 등록할 수 있습니다.");
 
 
 

src/main/java/bitnagil/bitnagil_backend/global/swagger/ApiTags.java

@@ -10,4 +10,5 @@ public class ApiTags {
     public static final String ROUTINE = "루틴 API";
     public static final String ONBOARDING = "온보딩 API";
     public static final String EMOTION_MARBLE = "감정구슬 API";
+    public static final String RECOMMENDED_ROUTINE = "추천 루틴 API";
 }

src/main/java/bitnagil/bitnagil_backend/onboarding/request/OnboardingRequest.java

@@ -18,13 +18,13 @@
 @AllArgsConstructor
 public class OnboardingRequest {
 
-    @Schema(description = "시간대", required = true, example = "08:00:00")
+    @Schema(description = "어떤 시간대를 더 잘 보내고 싶나요?", required = true, example = "08:00:00")
     private LocalTime timeSlot;
-    @Schema(description = "서비스 이용약관 동의", required = true)
+    @Schema(description = "요즘 어떤 회복이 필요하신가요?", required = true)
     private EmotionType emotionType;
-    @Schema(description = "서비스 이용약관 동의", required = true)
+    @Schema(description = "최근 얼마나 자주 바깥바람을 쐬시나요?", required = true)
     private RealOutingFrequency realOutingFrequency;
-    @Schema(description = "서비스 이용약관 동의",  required = true)
+    @Schema(description = "일주일에 몇번 외출하고 싶으신가요?",  required = true)
     private TargetOutingFrequency targetOutingFrequency;
 
 }

src/main/java/bitnagil/bitnagil_backend/recommendedRoutine/controller/RecommendedRoutineController.java

@@ -0,0 +1,24 @@
+package bitnagil.bitnagil_backend.recommendedRoutine.controller;
+
+import bitnagil.bitnagil_backend.global.annotation.CurrentUser;
+import bitnagil.bitnagil_backend.global.response.CustomResponseDto;
+import bitnagil.bitnagil_backend.recommendedRoutine.controller.spec.RecommendedRoutineSpec;
+import bitnagil.bitnagil_backend.recommendedRoutine.response.RecommendedRoutineSearchResponse;
+import bitnagil.bitnagil_backend.recommendedRoutine.service.RecommendedRoutineService;
+import bitnagil.bitnagil_backend.user.domain.User;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping(value = "/api/v1/recommend-routines")
+public class RecommendedRoutineController implements RecommendedRoutineSpec {
+    private final RecommendedRoutineService recommendedRoutineService;
+
+    @GetMapping("")
+    public CustomResponseDto<RecommendedRoutineSearchResponse> searchRecommendedRoutines(@CurrentUser User user) {
+        return CustomResponseDto.from(recommendedRoutineService.searchRecommendedRoutines(user));
+    }
+}

src/main/java/bitnagil/bitnagil_backend/recommendedRoutine/controller/spec/RecommendedRoutineSpec.java

@@ -0,0 +1,23 @@
+package bitnagil.bitnagil_backend.recommendedRoutine.controller.spec;
+
+import bitnagil.bitnagil_backend.auth.jwt.TokenResponse;
+import bitnagil.bitnagil_backend.global.annotation.CurrentUser;
+import bitnagil.bitnagil_backend.global.errorcode.ErrorCode;
+import bitnagil.bitnagil_backend.global.response.CustomResponseDto;
+import bitnagil.bitnagil_backend.global.swagger.ApiErrorCodeExamples;
+import bitnagil.bitnagil_backend.global.swagger.ApiTags;
+import bitnagil.bitnagil_backend.recommendedRoutine.response.RecommendedRoutineSearchResponse;
+import bitnagil.bitnagil_backend.user.domain.User;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+
+@Tag(name = ApiTags.RECOMMENDED_ROUTINE)
+public interface RecommendedRoutineSpec {
+
+    @Operation(summary = "추천 루틴을 조회합니다.")
+    @ApiErrorCodeExamples({
+            ErrorCode.NOT_FOUND_USER
+    })
+    CustomResponseDto<RecommendedRoutineSearchResponse> searchRecommendedRoutines(User user);
+
+}

src/main/java/bitnagil/bitnagil_backend/recommendedRoutine/domain/enums/RecommendedRoutineType.java

@@ -7,6 +7,7 @@
 @RequiredArgsConstructor
 @Getter
 public enum RecommendedRoutineType implements EnumType {
+    PERSONALIZED("맞춤 추천"),
     OUTING("나가봐요"),
     OUTING_REPORT("나가봐요-제보"),
     GROW("성장해요"),

src/main/java/bitnagil/bitnagil_backend/recommendedRoutine/repository/RecommendedRoutineRepository.java

@@ -2,12 +2,15 @@
 
 import bitnagil.bitnagil_backend.onboarding.domain.Case;
 import bitnagil.bitnagil_backend.recommendedRoutine.domain.RecommendedRoutine;
+import bitnagil.bitnagil_backend.recommendedRoutine.domain.enums.RecommendedRoutineType;
 import org.springframework.data.jpa.repository.JpaRepository;
 import org.springframework.stereotype.Repository;
 
 import java.util.List;
 
 @Repository
 public interface RecommendedRoutineRepository extends JpaRepository<RecommendedRoutine, Long> {
-    List findByResultCase(Case resultCase);
+    List<RecommendedRoutine> findByResultCase(Case resultCase);
+
+    List<RecommendedRoutine> findTop4ByRecommendedRoutineTypeOrderByRecommendedRoutineIdAsc(RecommendedRoutineType value);
 }