[Feature] 몰입도 기록 API 구현

src/main/java/timify/com/common/apiPayload/exception/handler/StudyTimeHandler.java

@@ -0,0 +1,10 @@
+package timify.com.common.apiPayload.exception.handler;
+
+import timify.com.common.apiPayload.code.BaseErrorCode;
+import timify.com.common.apiPayload.exception.GeneralException;
+
+public class StudyTimeHandler extends GeneralException {
+    public StudyTimeHandler(BaseErrorCode code) {
+        super(code);
+    }
+}

src/main/java/timify/com/member/domain/Member.java

@@ -19,13 +19,13 @@
 import lombok.Getter;
 import lombok.NoArgsConstructor;
 import timify.com.domain.MemberMission;
+import timify.com.studytime.domain.StudyTime;
+import timify.com.todo.domain.Todo;
 import timify.com.domain.common.BaseDateTimeEntity;
 import timify.com.study.domain.StudyMethod;
 import timify.com.study.domain.StudyPlace;
 import timify.com.study.domain.StudyType;
-import timify.com.studytime.domain.StudyTime;
 import timify.com.subject.domain.Subject;
-import timify.com.todo.domain.Todo;
 
 @Entity
 @Getter

src/main/java/timify/com/studytime/StudyTimeConverter.java

@@ -0,0 +1,33 @@
+package timify.com.studytime;
+
+import static timify.com.utils.DateTimeUtil.stringToLocalTime;
+
+import java.time.Duration;
+import timify.com.studytime.domain.StudyTime;
+import timify.com.studytime.dto.StudyTimeRequest.studyTimeRequest;
+import timify.com.studytime.dto.StudyTimeResponse;
+
+public class StudyTimeConverter {
+
+    public static StudyTime toStudyTime(studyTimeRequest request, double temp) {
+
+        return StudyTime.builder()
+            .startTime(stringToLocalTime(request.getStartTime()))
+            .endTime(stringToLocalTime(request.getEndTime()))
+            .grade(request.getGrade())
+            .temp(temp)
+            .build();
+
+    }
+
+    public static StudyTimeResponse.studyTimeDto toStudyTimeDto(StudyTime studyTime) {
+        return StudyTimeResponse.studyTimeDto.builder()
+            .studyTimeId(studyTime.getId())
+            .startTime(studyTime.getStartTime())
+            .endTime(studyTime.getEndTime())
+            .totalTime((int) Duration.between(studyTime.getStartTime(), studyTime.getEndTime()).toMinutes())
+            .temp(studyTime.getTemp())
+            .build();
+    }
+
+}

src/main/java/timify/com/studytime/StudyTimeService.java

@@ -0,0 +1,60 @@
+package timify.com.studytime;
+
+import static timify.com.common.apiPayload.code.status.ErrorStatus.STUDY_TYPE_NOT_FOUND;
+import static timify.com.utils.DateTimeUtil.stringToLocalTime;
+
+import java.time.Duration;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import timify.com.common.apiPayload.exception.handler.StudyTimeHandler;
+import timify.com.member.domain.Member;
+import timify.com.studytime.domain.StudyTime;
+import timify.com.studytime.dto.StudyTimeRequest.studyTimeRequest;
+import timify.com.studytime.repository.StudyTimeRepository;
+import timify.com.todo.domain.Todo;
+import timify.com.todo.repository.TodoRepository;
+
+@Service
+@RequiredArgsConstructor
+public class StudyTimeService {
+
+    private final static double DEFAULT_TEMP = 50d;
+    private final StudyTimeRepository studyTimeRepository;
+    private final TodoRepository todoRepository;
+
+    @Transactional
+    public StudyTime startTodo(Member member, Long todoId, studyTimeRequest request) {
+
+        Todo todo = todoRepository.findById(todoId)
+            .orElseThrow(() -> new StudyTimeHandler(STUDY_TYPE_NOT_FOUND));
+
+        double temp = calculateTemp(request);
+
+        StudyTime studyTime = StudyTimeConverter.toStudyTime(request, temp);
+
+        studyTime.associateMember(member);
+        studyTime.associateSubject(todo.getSubject());
+        studyTime.associateTodo(todo);
+
+        return studyTimeRepository.save(studyTime);
+    }
+
+    private double calculateTemp(studyTimeRequest request) {
+        LocalDateTime startTime = stringToLocalTime(request.getStartTime());
+        LocalDateTime endTime = stringToLocalTime(request.getEndTime());
+
+        long countStudyTime = studyTimeRepository.count();
+
+        if (countStudyTime == 0) {
+            int minutes = (int) Duration.between(startTime, endTime).toMinutes();
+            return DEFAULT_TEMP + minutes * request.getGrade().getScore();
+        }
+
+        int minutes = (int) Duration.between(startTime, endTime).toMinutes();
+        return minutes * request.getGrade().getScore();
+    }
+}

src/main/java/timify/com/studytime/controller/StudyTimeController.java

@@ -0,0 +1,33 @@
+package timify.com.studytime.controller;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Parameters;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestBody;
+import timify.com.auth.annotation.AuthMember;
+import timify.com.common.apiPayload.ApiResponse;
+import timify.com.member.domain.Member;
+import timify.com.studytime.dto.StudyTimeRequest.studyTimeRequest;
+import timify.com.studytime.dto.StudyTimeResponse.studyTimeDto;
+
+@Tag(name = "StudyTime", description = "StudyTime 관련 API")
+public interface StudyTimeController {
+
+    @Operation(summary = "할 일 스톱워치 API", description = "할 일 스톱워치 API 입니다.")
+    @Parameters(value = {
+        @Parameter(name = "todoId", description = "몰입도를 기록할 할 일에 해당하는 todoId 을 입력해 주세요.")
+    })
+    ApiResponse<studyTimeDto> startTodo(@AuthMember Member member,
+        @PathVariable Long todoId,
+        @RequestBody studyTimeRequest request);
+
+    @Operation(summary = "시간 기록 삭제 API", description = "시간 기록 삭제 API 입니다.")
+    @Parameters(value = {
+        @Parameter(name = "studyTimeId", description = "기록을 삭제할 StudyTimeId 을 입력해 주세요.")
+    })
+    ApiResponse<studyTimeDto> deleteStudyTime(@AuthMember Member member,
+        @PathVariable Long studyTimeId);
+
+}

src/main/java/timify/com/studytime/controller/StudyTimeControllerImpl.java

@@ -0,0 +1,43 @@
+package timify.com.studytime.controller;
+
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+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;
+import timify.com.auth.annotation.AuthMember;
+import timify.com.common.apiPayload.ApiResponse;
+import timify.com.common.apiPayload.code.status.SuccessStatus;
+import timify.com.member.domain.Member;
+import timify.com.studytime.StudyTimeConverter;
+import timify.com.studytime.StudyTimeService;
+import timify.com.studytime.domain.StudyTime;
+import timify.com.studytime.dto.StudyTimeRequest.studyTimeRequest;
+import timify.com.studytime.dto.StudyTimeResponse.studyTimeDto;
+
+@RestController
+@RequiredArgsConstructor
+@Slf4j
+@RequestMapping("/v1/subject/todo/{todoId}")
+public class StudyTimeControllerImpl implements StudyTimeController{
+
+    private final StudyTimeService studyTimeService;
+
+    @PostMapping("/study_time/start")
+    public ApiResponse<studyTimeDto> startTodo(@AuthMember Member member,
+        @PathVariable Long todoId,
+        @RequestBody studyTimeRequest request) {
+
+        StudyTime studyTime = studyTimeService.startTodo(member, todoId, request);
+
+        return ApiResponse.onSuccess(StudyTimeConverter.toStudyTimeDto(studyTime));
+    }
+
+    @DeleteMapping("/study_time/delete")
+    public ApiResponse<studyTimeDto> deleteStudyTime(Member member, Long studyTimeId) {
+        return null;
+    }
+}

src/main/java/timify/com/studytime/domain/StudyTime.java

@@ -38,7 +38,7 @@ public class StudyTime extends BaseDateTimeEntity {
     private LocalDateTime endTime;
 
     @Column(nullable = false)
-    private double score;
+    private StudyTimeGrade grade; // 최상
 
     @Column(nullable = false)
     private double temp;
@@ -54,4 +54,53 @@ public class StudyTime extends BaseDateTimeEntity {
     @ManyToOne(fetch = FetchType.LAZY)
     @JoinColumn(name = "todo_id", nullable = false)
     private Todo todo;
+
+    public void associateMember(Member member) {
+        if (this.member != null) {
+            this.member.getStudyTimeList().remove(this);
+        }
+        this.member = member;
+        this.member.getStudyTimeList().add(this);
+    }
+
+    public void disassociateMember(Member member) {
+        if (member != null) {
+            member.getStudyTimeList().remove(this);
+            this.member = null;
+        }
+    }
+
+    public void associateSubject(Subject subject) {
+        if (this.subject != null) {
+            this.subject.getStudyTimeList().remove(this);
+        }
+        this.subject = subject;
+        this.subject.getStudyTimeList().add(this);
+    }
+
+    // 연관관계 해제 메소드
+    public void disassociateSubject(Subject subject) {
+        if (subject != null) {
+            subject.getStudyTimeList().remove(this);
+            this.subject = null;
+        }
+    }
+
+    public void associateTodo(Todo todo) {
+        if (this.todo != null) {
+            this.todo.getStudyTimeList().remove(this);
+        }
+        this.todo = todo;
+        this.todo.getStudyTimeList().add(this);
+    }
+
+    // 연관관계 해제 메소드
+    public void disassociateTodo(Todo todo) {
+        if (todo != null) {
+            todo.getStudyTimeList().remove(this);
+            this.todo = null;
+        }
+    }
+
+
 }

src/main/java/timify/com/studytime/domain/StudyTimeGrade.java

@@ -0,0 +1,19 @@
+package timify.com.studytime.domain;
+
+import lombok.Getter;
+
+@Getter
+public enum StudyTimeGrade {
+    EXCELLENT(2.0),      // 최상
+    GOOD(1.5),           // 상
+    AVERAGE(1.2),        // 중
+    BELOW_AVERAGE(1.0),  // 하
+    POOR(1.0);            // 최하
+
+    private double score;
+
+    StudyTimeGrade(double score) {
+        this.score = score;
+    }
+
+}

src/main/java/timify/com/studytime/dto/StudyTimeRequest.java

@@ -0,0 +1,23 @@
+package timify.com.studytime.dto;
+
+import jakarta.validation.constraints.NotBlank;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import timify.com.studytime.domain.StudyTimeGrade;
+
+public class StudyTimeRequest {
+
+    @Getter
+    @NoArgsConstructor
+    public static class studyTimeRequest {
+
+        @NotBlank
+        String startTime;
+
+        @NotBlank
+        String endTime;
+
+        @NotBlank
+        StudyTimeGrade grade; //최상
+    }
+}

src/main/java/timify/com/studytime/dto/StudyTimeResponse.java

@@ -0,0 +1,32 @@
+package timify.com.studytime.dto;
+
+import java.time.LocalDateTime;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import timify.com.studytime.domain.StudyTimeGrade;
+
+public class StudyTimeResponse {
+
+    @Builder
+    @Getter
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class studyTimeDto {
+
+        Long studyTimeId;
+
+        LocalDateTime startTime;
+
+        LocalDateTime endTime;
+
+        int totalTime;
+
+        double temp;
+
+        StudyTimeGrade score;
+
+        Double status;
+    }
+}

src/main/java/timify/com/subject/domain/Subject.java

@@ -19,10 +19,10 @@
 import lombok.Builder;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
-import timify.com.domain.common.BaseDateTimeEntity;
-import timify.com.member.domain.Member;
 import timify.com.studytime.domain.StudyTime;
 import timify.com.todo.domain.Todo;
+import timify.com.domain.common.BaseDateTimeEntity;
+import timify.com.member.domain.Member;
 
 @Entity
 @Getter

src/main/java/timify/com/todo/domain/Todo.java

@@ -59,15 +59,15 @@ public class Todo extends BaseDateTimeEntity {
     private Subject subject;
 
     @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "study_type_id", nullable = false)
+    @JoinColumn(name = "study_type_id")
     private StudyType studyType;
 
     @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "study_method_id", nullable = false)
+    @JoinColumn(name = "study_method_id")
     private StudyMethod studyMethod;
 
     @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "study_place_id", nullable = false)
+    @JoinColumn(name = "study_place_id")
     private StudyPlace studyPlace;
 
     // studyTime 양방향 매핑

src/main/java/timify/com/utils/DateTimeUtil.java

@@ -1,6 +1,8 @@
 package timify.com.utils;
 
 import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
 import java.time.format.DateTimeFormatter;
 
 public class DateTimeUtil {
@@ -16,4 +18,16 @@ public static LocalDate stringToLocalDate(String dateString) {
         return LocalDate.parse(dateString, formatter);
     }
 
+    /**
+     * HHMMSS 형식의 string을 LocalTime type으로 변환
+     *
+     * @param timeString
+     * @return
+     */
+    public static LocalDateTime stringToLocalTime(String timeString) {
+        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("HHmmss");
+        LocalTime localTime = LocalTime.parse(timeString, formatter);
+        return LocalDateTime.of(LocalDate.now(), localTime);
+    }
+
 }