[T3-106] 감정구슬 테이블 구축, API 개발 (#24)

* feat: 감정구슬 테이블 구축, API 개발

* chore: 감정구슬 case 매

* remove: 불필요한 주석 제거

* remove: caseName 필드 삭제

Author: thisishwan2

src/main/java/bitnagil/bitnagil_backend/emotionMarble/controller/EmotionMarbleController.java

@@ -0,0 +1,33 @@
+package bitnagil.bitnagil_backend.emotionMarble.controller;
+
+import bitnagil.bitnagil_backend.emotionMarble.controller.spec.EmotionMarbleSpec;
+import bitnagil.bitnagil_backend.emotionMarble.domain.EmotionMarble;
+import bitnagil.bitnagil_backend.emotionMarble.domain.enums.EmotionMarbleType;
+import bitnagil.bitnagil_backend.emotionMarble.request.RegisterEmotionMarbleRequest;
+import bitnagil.bitnagil_backend.emotionMarble.response.EmotionMarbleTypeResponse;
+import bitnagil.bitnagil_backend.emotionMarble.response.RegisterEmotionMarbleResponse;
+import bitnagil.bitnagil_backend.emotionMarble.service.EmotionMarbleService;
+import bitnagil.bitnagil_backend.global.annotation.CurrentUser;
+import bitnagil.bitnagil_backend.global.response.CustomResponseDto;
+import bitnagil.bitnagil_backend.user.domain.User;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.*;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping(value = "/api/v1/emotion-marbles")
+public class EmotionMarbleController implements EmotionMarbleSpec {
+    private final EmotionMarbleService emotionMarbleService;
+
+    // 감정구슬 조회 API
+    @GetMapping("")
+    public CustomResponseDto<EmotionMarbleTypeResponse> getEmotionMarbles() {
+        return CustomResponseDto.from(emotionMarbleService.getEmotionMarbles());
+    }
+
+    // 감정구슬 등록 API
+    @PostMapping("")
+    public CustomResponseDto<RegisterEmotionMarbleResponse> registryEmotionMarble(@CurrentUser User user, @RequestBody RegisterEmotionMarbleRequest request) {
+        return CustomResponseDto.from(emotionMarbleService.registryEmotionMarble(user, request));
+    }
+}

src/main/java/bitnagil/bitnagil_backend/emotionMarble/controller/spec/EmotionMarbleSpec.java

@@ -0,0 +1,23 @@
+package bitnagil.bitnagil_backend.emotionMarble.controller.spec;
+
+import bitnagil.bitnagil_backend.emotionMarble.request.RegisterEmotionMarbleRequest;
+import bitnagil.bitnagil_backend.emotionMarble.response.EmotionMarbleTypeResponse;
+import bitnagil.bitnagil_backend.emotionMarble.response.RegisterEmotionMarbleResponse;
+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.user.domain.User;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+
+@Tag(name = ApiTags.EMOTION_MARBLE)
+public interface EmotionMarbleSpec {
+
+    @Operation(summary = "감정 구슬을 조회합니다")
+    public CustomResponseDto<EmotionMarbleTypeResponse> getEmotionMarbles();
+
+    @Operation(summary = "감정 구슬을 등록합니다. 감정 구슬에 따른 추천 루틴을 응답합니다.")
+    @ApiErrorCodeExamples({ErrorCode.NOT_FOUND_RECOMMENDED_ROUTINE})
+    public CustomResponseDto<RegisterEmotionMarbleResponse> registryEmotionMarble(User user, RegisterEmotionMarbleRequest request);
+}

src/main/java/bitnagil/bitnagil_backend/emotionMarble/domain/EmotionMarble.java

@@ -0,0 +1,62 @@
+package bitnagil.bitnagil_backend.emotionMarble.domain;
+
+import bitnagil.bitnagil_backend.emotionMarble.domain.enums.EmotionMarbleType;
+import bitnagil.bitnagil_backend.global.entity.BaseTimeEntity;
+import bitnagil.bitnagil_backend.global.entity.HistoryPk;
+import bitnagil.bitnagil_backend.onboarding.domain.Case;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotNull;
+import lombok.AccessLevel;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.UUID;
+
+@Getter
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@Entity
+public class EmotionMarble extends BaseTimeEntity {
+
+    @EmbeddedId
+    @AttributeOverrides({
+            @AttributeOverride(name = "id", column = @Column(name = "emotion_marble_id")),
+            @AttributeOverride(name = "historySeq", column = @Column(name = "history_seq"))
+    })
+    private HistoryPk emotionMarblePk;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(columnDefinition = "varchar(40)")
+    private EmotionMarbleType emotionMarbleType;
+
+    @NotNull
+    private LocalDate date;
+
+    @NotNull
+    private UUID userId;
+
+    @NotNull
+    private LocalDateTime historyStartDateTime;
+
+    @NotNull
+    private LocalDateTime historyEndDateTime;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "case_id", nullable = false)
+    private Case resultCase;
+
+    @Builder
+    public EmotionMarble(HistoryPk emotionMarblePk, EmotionMarbleType emotionMarbleType, LocalDate date, UUID userId,
+                         LocalDateTime historyStartDateTime, LocalDateTime historyEndDateTime, Case resultCase) {
+        this.emotionMarblePk = emotionMarblePk;
+        this.emotionMarbleType = emotionMarbleType;
+        this.date = date;
+        this.userId = userId;
+        this.historyStartDateTime = historyStartDateTime;
+        this.historyEndDateTime = historyEndDateTime;
+        this.resultCase = resultCase;
+    }
+}

src/main/java/bitnagil/bitnagil_backend/emotionMarble/domain/enums/EmotionMarbleType.java

@@ -0,0 +1,20 @@
+package bitnagil.bitnagil_backend.emotionMarble.domain.enums;
+
+import bitnagil.bitnagil_backend.enums.EnumType;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@RequiredArgsConstructor
+@Getter
+public enum EmotionMarbleType implements EnumType {
+    CALM("평온함", 5L),
+    VITALITY("활기참", 6L),
+    LETHARGY("무기력함", 7L),
+    ANXIETY("불안함", 8L),
+    SATISFACTION("만족함", 9L),
+    FATIGUE("피로함", 10L)
+    ;
+
+    private final String description;
+    private final Long caseId;
+}

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

@@ -0,0 +1,8 @@
+package bitnagil.bitnagil_backend.emotionMarble.repository;
+
+import bitnagil.bitnagil_backend.emotionMarble.domain.EmotionMarble;
+import bitnagil.bitnagil_backend.global.entity.HistoryPk;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface EmotionMarbleRepository extends JpaRepository<EmotionMarble, HistoryPk> {
+}

src/main/java/bitnagil/bitnagil_backend/emotionMarble/request/RegisterEmotionMarbleRequest.java

@@ -0,0 +1,21 @@
+package bitnagil.bitnagil_backend.emotionMarble.request;
+
+import bitnagil.bitnagil_backend.emotionMarble.domain.enums.EmotionMarbleType;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+/**
+ * 감정구슬의 종류를 조회하는 dto 입니다.
+ */
+@Getter
+@NoArgsConstructor
+@Schema(description = "감정구슬 등록 요청 DTO")
+public class RegisterEmotionMarbleRequest {
+
+    @Schema(description = "감정구술 enum 값",
+            example = "CALM", required = true)
+    @NotNull
+    private EmotionMarbleType emotionMarbleType;
+}

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

@@ -0,0 +1,20 @@
+package bitnagil.bitnagil_backend.emotionMarble.response;
+
+import bitnagil.bitnagil_backend.emotionMarble.domain.enums.EmotionMarbleType;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+
+@Getter
+@AllArgsConstructor
+@Builder
+@Schema(description = "감정 구슬 조회 DTO")
+public class EmotionMarbleTypeResponse {
+    @Schema(
+            description = "감정 구슬 enum 배열",
+            type = "array",
+            example = "[\"CALM\", \"VITALITY\", \"LETHARGY\", \"ANXIETY\", \"SATISFACTION\", \"FATIGUE\"]"
+    )
+    private EmotionMarbleType[] emotionMarbleTypes;
+}

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

@@ -0,0 +1,26 @@
+package bitnagil.bitnagil_backend.emotionMarble.response;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+
+import java.util.List;
+
+/**
+ * 추천 루틴에 대한 DTO 클래스
+ */
+@Getter
+@AllArgsConstructor
+@Builder
+public class RecommendedRoutineDto {
+
+    // 추천 루틴 ID
+    private Long recommendedRoutineId;
+    // 추천 루틴 이름
+    private String recommendedRoutineName;
+    // 추천 루틴 설명
+    private String routineDescription;
+
+    // 추천 루틴 상세 정보
+    List<RecommendedSubRoutineDto> recommendedSubRoutines;
+}

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

@@ -0,0 +1,18 @@
+package bitnagil.bitnagil_backend.emotionMarble.response;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+
+/**
+ * 추천 루틴 상세에 대한 DTO 클래스
+ */
+@Getter
+@AllArgsConstructor
+@Builder
+public class RecommendedSubRoutineDto {
+    // 추천 루틴 상세 ID
+    private Long recommendedSubRoutineId;
+    // 추천 루틴 상세 이름
+    private String recommendedSubRoutineName;
+}

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

@@ -0,0 +1,21 @@
+package bitnagil.bitnagil_backend.emotionMarble.response;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+
+import java.util.List;
+
+/**
+ * 구슬 선택에 대한 추천 루틴 응답 DTO 클래스
+ */
+@Getter
+@AllArgsConstructor
+@Builder
+@Schema(description = "감정 구슬 등록 응답 DTO")
+public class RegisterEmotionMarbleResponse {
+
+    private List<RecommendedRoutineDto> recommendedRoutines;
+
+}