[FU-346] 날짜별 스케줄 API 개발 (#90)

* FU-346 feat: 날짜별 스케줄 entity 구현

* FU-346 feat: 날짜별 스케줄 CRUD 기능 개발

* FU-346 feat: 중복되는 날짜별 스케줄 검증 쿼리 보완

- 기존: 시간대만 비교
- 수정: 날짜가 동일한 경우 start time, end time 비교

* FU-346 feat: 날짜별 스케줄 조회 요청에 대한 응답 형식 보완

scheduleId를 추가로 반환

* FU-346 feat: 날짜별 스케줄 중복 및 현시점 이후의 데이터 검증 로직 보완

- 날짜별 스케줄 수정 시, 기존 로직에서는 동일한 스케줄과 시간대가 중복되는 경우를 처리하지 못하였음. 이를 보완하는 오버로딩 함수 정의하였음
- 날짜별 스케줄 조회 시 현시점 이후의 데이터만 조회해옴. 등록 및 수정 시에도 현시점 이후의 데이터만 등록할 수 있도록 검증함

* FU-346 feat: 테스트 작성 시 현재시간 모킹을 위한 clock 객체 Bean 등록

테스트 코드 작성 시 LocalDateTime.now()를 모킹하기 위해 Clock을 빈으로 등록하였음

* FU-346 feat: 날짜별 스케줄의 비즈니스 로직 검증 용 테스트코드 작성

* FU-346 feat: 날짜별스케줄 조회 가능 범위 변경

기존: 현시점 이후의 스케줄만 조회 가능
변경: 과거 데이터를 포함한 월별 스케줄 조회 가능

* FU-346 feat: 날짜별 스케줄 월별 조회 시 year 정보도 포함

* FU-346 feat: 날짜별 스케줄 등록/수정 시 시간대 검증 추가

시작시간이 종료시간과 같거나, 종료시간이 시작시간보다 더 앞인 경우 예외 발생

* FU-346 chore: qodana_code_quality.yml 파일 제거

Author: rheeri

.github/workflows/qodana_code_quality.yml

@@ -0,0 +1,14 @@
+package com.foru.freebe.config;
+
+import java.time.Clock;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+@Configuration
+public class ClockConfig {
+    @Bean
+    public Clock clock() {
+        return Clock.systemDefaultZone();
+    }
+}

src/main/java/com/foru/freebe/config/ClockConfig.java

@@ -6,10 +6,11 @@
 @Getter
 @RequiredArgsConstructor
 public enum ScheduleErrorCode implements ErrorCode {
-
+    DAILY_SCHEDULE_NOT_FOUND(500, "해당하는 날짜별 스케줄을 찾을 수 없습니다."),
+    DAILY_SCHEDULE_OVERLAP(400, "해당 일정에 이미 등록된 스케줄이 있습니다."),
+    DAILY_SCHEDULE_IN_PAST(400, "현재 시점 이전의 스케줄은 등록할 수 없습니다."),
     START_TIME_AFTER_END_TIME(400, "시작시간과 종료시간이 올바르지 않습니다.");
 
-
     private final int httpStatus;
     private final String message;
-}
+}

src/main/java/com/foru/freebe/errors/errorcode/ScheduleErrorCode.java

@@ -0,0 +1,99 @@
+package com.foru.freebe.schedule.controller;
+
+import java.util.List;
+
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import com.foru.freebe.auth.model.MemberAdapter;
+import com.foru.freebe.common.dto.ResponseBody;
+import com.foru.freebe.member.entity.Member;
+import com.foru.freebe.schedule.dto.DailyScheduleAddResponse;
+import com.foru.freebe.schedule.dto.DailyScheduleMonthlyRequest;
+import com.foru.freebe.schedule.dto.DailyScheduleRequest;
+import com.foru.freebe.schedule.dto.DailyScheduleResponse;
+import com.foru.freebe.schedule.service.DailyScheduleService;
+
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.Positive;
+import lombok.RequiredArgsConstructor;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/photographer")
+public class DailyScheduleController {
+    private final DailyScheduleService dailyScheduleService;
+
+    @GetMapping("/schedule/daily")
+    public ResponseEntity<ResponseBody<List<DailyScheduleResponse>>> getDailySchedules(
+        @AuthenticationPrincipal MemberAdapter memberAdapter, @Valid @RequestBody DailyScheduleMonthlyRequest request) {
+
+        Member photographer = memberAdapter.getMember();
+        List<DailyScheduleResponse> responses = dailyScheduleService.getDailySchedules(photographer, request);
+
+        ResponseBody<List<DailyScheduleResponse>> responseBody = ResponseBody.<List<DailyScheduleResponse>>builder()
+            .message("Successfully get daily schedules")
+            .data(responses)
+            .build();
+
+        return ResponseEntity.status(HttpStatus.OK.value())
+            .body(responseBody);
+    }
+
+    @PostMapping("/schedule/daily")
+    public ResponseEntity<ResponseBody<DailyScheduleAddResponse>> addDailySchedule(
+        @AuthenticationPrincipal MemberAdapter memberAdapter, @Valid @RequestBody DailyScheduleRequest request) {
+
+        Member photographer = memberAdapter.getMember();
+        DailyScheduleAddResponse response = dailyScheduleService.addDailySchedule(photographer, request);
+
+        ResponseBody<DailyScheduleAddResponse> responseBody = ResponseBody.<DailyScheduleAddResponse>builder()
+            .message("Successfully add daily schedule")
+            .data(response)
+            .build();
+
+        return ResponseEntity.status(HttpStatus.OK.value())
+            .body(responseBody);
+    }
+
+    @PutMapping("/schedule/daily/{scheduleId}")
+    public ResponseEntity<ResponseBody<Void>> updateDailySchedule(@AuthenticationPrincipal MemberAdapter memberAdapter,
+        @Positive @PathVariable("scheduleId") Long scheduleId, @Valid @RequestBody DailyScheduleRequest request) {
+
+        Member photographer = memberAdapter.getMember();
+        dailyScheduleService.updateDailySchedule(photographer, scheduleId, request);
+
+        ResponseBody<Void> responseBody = ResponseBody.<Void>builder()
+            .message("Successfully update daily schedule")
+            .data(null)
+            .build();
+
+        return ResponseEntity.status(HttpStatus.OK.value())
+            .body(responseBody);
+    }
+
+    @DeleteMapping("/schedule/daily/{scheduleId}")
+    public ResponseEntity<ResponseBody<Void>> deleteDailySchedule(
+        @AuthenticationPrincipal MemberAdapter memberAdapter, @Positive @PathVariable("scheduleId") Long scheduleId) {
+
+        Member photographer = memberAdapter.getMember();
+        dailyScheduleService.deleteDailySchedule(photographer, scheduleId);
+
+        ResponseBody<Void> responseBody = ResponseBody.<Void>builder()
+            .message("Successfully delete daily schedule")
+            .data(null)
+            .build();
+
+        return ResponseEntity.status(HttpStatus.OK.value())
+            .body(responseBody);
+    }
+}

src/main/java/com/foru/freebe/schedule/controller/DailyScheduleController.java

@@ -0,0 +1,12 @@
+package com.foru.freebe.schedule.dto;
+
+import jakarta.validation.constraints.NotNull;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+@Getter
+@AllArgsConstructor
+public class DailyScheduleAddResponse {
+    @NotNull
+    private Long scheduleID;
+}

src/main/java/com/foru/freebe/schedule/dto/DailyScheduleAddResponse.java

@@ -0,0 +1,15 @@
+package com.foru.freebe.schedule.dto;
+
+import jakarta.validation.constraints.NotNull;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+@Getter
+@AllArgsConstructor
+public class DailyScheduleMonthlyRequest {
+    @NotNull(message = "Year must not be null")
+    private int year;
+
+    @NotNull(message = "Month value must not be null")
+    private int monthValue;
+}

src/main/java/com/foru/freebe/schedule/dto/DailyScheduleMonthlyRequest.java

@@ -0,0 +1,35 @@
+package com.foru.freebe.schedule.dto;
+
+import java.time.LocalDate;
+import java.time.LocalTime;
+
+import com.foru.freebe.schedule.entity.ScheduleStatus;
+
+import jakarta.validation.constraints.NotNull;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor
+public class DailyScheduleRequest {
+    @NotNull(message = "ScheduleStatus must not be null")
+    private ScheduleStatus scheduleStatus;
+
+    @NotNull(message = "Date must not be null")
+    private LocalDate date;
+
+    @NotNull(message = "Start time must not be null")
+    private LocalTime startTime;
+
+    @NotNull(message = "End time must not be null")
+    private LocalTime endTime;
+
+    @Builder
+    public DailyScheduleRequest(ScheduleStatus scheduleStatus, LocalDate date, LocalTime startTime, LocalTime endTime) {
+        this.scheduleStatus = scheduleStatus;
+        this.date = date;
+        this.startTime = startTime;
+        this.endTime = endTime;
+    }
+}

src/main/java/com/foru/freebe/schedule/dto/DailyScheduleRequest.java

@@ -0,0 +1,40 @@
+package com.foru.freebe.schedule.dto;
+
+import java.time.LocalDate;
+import java.time.LocalTime;
+
+import com.foru.freebe.schedule.entity.ScheduleStatus;
+
+import jakarta.validation.constraints.NotNull;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor
+public class DailyScheduleResponse {
+    @NotNull(message = "Daily schedule id must not be null")
+    private Long scheduleId;
+
+    @NotNull(message = "ScheduleStatus must not be null")
+    private ScheduleStatus scheduleStatus;
+
+    @NotNull(message = "Date must not be null")
+    private LocalDate date;
+
+    @NotNull(message = "Start time must not be null")
+    private LocalTime startTime;
+
+    @NotNull(message = "End time must not be null")
+    private LocalTime endTime;
+
+    @Builder
+    public DailyScheduleResponse(Long scheduleId, ScheduleStatus scheduleStatus, LocalDate date, LocalTime startTime,
+        LocalTime endTime) {
+        this.scheduleId = scheduleId;
+        this.scheduleStatus = scheduleStatus;
+        this.date = date;
+        this.startTime = startTime;
+        this.endTime = endTime;
+    }
+}

src/main/java/com/foru/freebe/schedule/dto/DailyScheduleResponse.java

@@ -0,0 +1,76 @@
+package com.foru.freebe.schedule.entity;
+
+import java.time.LocalDate;
+import java.time.LocalTime;
+
+import com.foru.freebe.common.entity.BaseEntity;
+import com.foru.freebe.member.entity.Member;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.EnumType;
+import jakarta.persistence.Enumerated;
+import jakarta.persistence.FetchType;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.JoinColumn;
+import jakarta.persistence.ManyToOne;
+import jakarta.validation.constraints.NotNull;
+import lombok.AccessLevel;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Entity
+@Getter
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+public class DailySchedule extends BaseEntity {
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(name = "daily_schedule_id")
+    private Long id;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "member_id")
+    private Member member;
+
+    @Enumerated(EnumType.STRING)
+    @NotNull(message = "ScheduleStatus must not be null")
+    private ScheduleStatus scheduleStatus;
+
+    @NotNull(message = "Date must not be null")
+    private LocalDate date;
+
+    @NotNull(message = "Start time must not be null")
+    private LocalTime startTime;
+
+    @NotNull(message = "End time must not be null")
+    private LocalTime endTime;
+
+    @Builder
+    public DailySchedule(Member member, ScheduleStatus scheduleStatus, LocalDate date, LocalTime startTime,
+        LocalTime endTime) {
+        this.member = member;
+        this.scheduleStatus = scheduleStatus;
+        this.date = date;
+        this.startTime = startTime;
+        this.endTime = endTime;
+    }
+
+    public void updateScheduleStatus(ScheduleStatus newScheduleStatus) {
+        this.scheduleStatus = newScheduleStatus;
+    }
+
+    public void updateDate(LocalDate date) {
+        this.date = date;
+    }
+
+    public void updateStartTime(LocalTime startTime) {
+        this.startTime = startTime;
+    }
+
+    public void updateEndTime(LocalTime endTime) {
+        this.endTime = endTime;
+    }
+}

src/main/java/com/foru/freebe/schedule/entity/DailySchedule.java

@@ -0,0 +1,7 @@
+package com.foru.freebe.schedule.entity;
+
+public enum ScheduleStatus {
+    OPEN,
+    CLOSED,
+    CONFIRMED
+}