Merge pull request #62 from YAPP-Github/feat/T3-164

[T3-164] 루틴 완료 여부 갱신 API

Author: yuseok0215

src/main/java/bitnagil/bitnagil_backend/routine/controller/spec/RoutineSpec.java

@@ -39,7 +39,7 @@ public interface RoutineSpec {
         ErrorCode.ROUTINE_USER_NOT_MATCHED})
     CustomResponseDto<Object> updateRoutine(User user, UpdateRoutineRequest updateRoutineRequest);
 
-    @Operation(summary = "루틴 및 서브 루틴을 모두 삭제합니다.")
+    @Operation(summary = "(V2) 모든 날짜에서 루틴을 삭제합니다. (루틴 전체 삭제)")
     @ApiErrorCodeExamples({ErrorCode.NOT_FOUND_ROUTINE, ErrorCode.ROUTINE_USER_NOT_MATCHED})
     CustomResponseDto<Object> deleteRoutine(User user, String routineId);
 

src/main/java/bitnagil/bitnagil_backend/routineV2/controller/RoutineV2Controller.java

@@ -1,5 +1,6 @@
 package bitnagil.bitnagil_backend.routineV2.controller;
 
+import bitnagil.bitnagil_backend.routineV2.request.UpdateRoutineCompletionRequest;
 import bitnagil.bitnagil_backend.routineV2.response.RoutineV2SearchResponse;
 import bitnagil.bitnagil_backend.routineV2.response.RoutineV2SearchResultDto;
 import jakarta.validation.constraints.NotNull;
@@ -43,4 +44,18 @@ public CustomResponseDto<Object> registerRoutine(@CurrentUser User user, @Reques
 
         return CustomResponseDto.from(null);
     }
+
+    /*
+     * 루틴 완료 여부를 갱신하는 API 입니다.
+     * 멱등성이 보장되는 업데이트 API이므로 PUT Method를 사용했습니다.
+     */
+    @PutMapping("")
+    public CustomResponseDto<Object> updateRoutineCompletionStatus(
+        @CurrentUser User user, @RequestBody UpdateRoutineCompletionRequest request) {
+
+        routineV2Service.updateRoutineCompletionStatus(user, request);
+
+        return CustomResponseDto.from(null);
+    }
+
 }

src/main/java/bitnagil/bitnagil_backend/routineV2/controller/spec/RoutineV2Spec.java

@@ -1,10 +1,12 @@
 package bitnagil.bitnagil_backend.routineV2.controller.spec;
 
+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.routineV2.request.RegisterRoutineV2Request;
+import bitnagil.bitnagil_backend.routineV2.request.UpdateRoutineCompletionRequest;
 import bitnagil.bitnagil_backend.routineV2.response.RoutineV2SearchResponse;
 import bitnagil.bitnagil_backend.routineV2.response.RoutineV2SearchResultDto;
 import bitnagil.bitnagil_backend.user.domain.User;
@@ -17,6 +19,8 @@
 import java.time.LocalDate;
 import java.util.UUID;
 
+import org.springframework.web.bind.annotation.RequestBody;
+
 @Tag(name = ApiTags.ROUTINEV2)
 public interface RoutineV2Spec {
 
@@ -35,4 +39,9 @@ public interface RoutineV2Spec {
 
     @Operation(summary = "루틴 정보 등록 및 루틴 시작, 종료일자 사이에서 반복요일에 해당하는 날짜로 루틴 데이터를 생성합니다.")
     CustomResponseDto<Object> registerRoutine(User user, RegisterRoutineV2Request request);
+
+    @Operation(summary = "여러 루틴의 완료 여부를 갱신합니다. (여러 루틴의 완료 여부를 리스트로 만들어 요청하는 방식입니다.)")
+    @ApiErrorCodeExamples({ErrorCode.NOT_FOUND_ROUTINE})
+    CustomResponseDto<Object> updateRoutineCompletionStatus(
+        @CurrentUser User user, @RequestBody UpdateRoutineCompletionRequest request);
 }

src/main/java/bitnagil/bitnagil_backend/routineV2/domain/RoutineV2.java

@@ -63,4 +63,10 @@ public RoutineV2(LocalDate routineDate, Boolean routineCompleteYn, List<String>
         this.subRoutineCompleteYn = subRoutineCompleteYn;
         this.routineInfo = routineInfo;
     }
+
+    // 루틴 완료 여부 갱신
+    public void updateRoutineCompleteYn(Boolean routineCompleteYn, List<Boolean> subRoutineCompleteYn) {
+        this.routineCompleteYn = routineCompleteYn;
+        this.subRoutineCompleteYn = subRoutineCompleteYn;
+    }
 }

src/main/java/bitnagil/bitnagil_backend/routineV2/request/UpdateRoutineCompletionInfo.java

@@ -0,0 +1,31 @@
+package bitnagil.bitnagil_backend.routineV2.request;
+
+import java.util.List;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor
+public class UpdateRoutineCompletionInfo {
+
+    @Schema(description = "루틴 완료 여부를 갱신할 루틴 ID 값입니다.",
+            example = "4",
+            required = true)
+    @NotNull
+    private Long routineId;
+
+    @Schema(description = "메인 루틴의 완료 여부입니다.",
+            example = "true",
+            required = true)
+    @NotNull
+    private Boolean routineCompleteYn;
+
+    @Schema(description = "서브루틴 완료 여부 리스트입니다.",
+            example = "[true, false, true]",
+            required = true)
+    @NotNull
+    private List<Boolean> subRoutineCompleteYn;
+}

src/main/java/bitnagil/bitnagil_backend/routineV2/request/UpdateRoutineCompletionRequest.java

@@ -0,0 +1,19 @@
+package bitnagil.bitnagil_backend.routineV2.request;
+
+import java.util.List;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor
+@Schema(description = "루틴 완료 여부 갱신 DTO")
+public class UpdateRoutineCompletionRequest {
+
+    @Schema(description = "루틴 완료 여부를 갱신할 루틴 정보 리스트입니다.",
+            required = true)
+    @NotNull
+    List<UpdateRoutineCompletionInfo> routineCompletionInfos;
+}

src/main/java/bitnagil/bitnagil_backend/routineV2/service/RoutineV2Service.java

@@ -6,6 +6,8 @@
 
 import bitnagil.bitnagil_backend.global.errorcode.ErrorCode;
 import bitnagil.bitnagil_backend.global.exception.CustomException;
+import bitnagil.bitnagil_backend.routineV2.request.UpdateRoutineCompletionInfo;
+import bitnagil.bitnagil_backend.routineV2.request.UpdateRoutineCompletionRequest;
 import bitnagil.bitnagil_backend.routineV2.response.RoutineV2SearchResponse;
 import bitnagil.bitnagil_backend.routineV2.response.RoutineV2SearchResultDto;
 import org.springframework.stereotype.Service;
@@ -101,6 +103,18 @@ public void registerRoutineV2(User user, RegisterRoutineV2Request request) {
         routineV2Repository.saveAll(routinesToRegister);
     }
 
+    // 루틴 완료 여부를 업데이트 하는 메서드
+    @Transactional
+    public void updateRoutineCompletionStatus(User user, UpdateRoutineCompletionRequest request) {
+        for (UpdateRoutineCompletionInfo info : request.getRoutineCompletionInfos()) {
+            RoutineV2 routineV2 = routineV2Repository.findByUserAndRoutineId(user, info.getRoutineId())
+                .orElseThrow(() -> new CustomException(ErrorCode.NOT_FOUND_ROUTINE));
+
+            // 루틴, 서브루틴 완료 여부 갱신
+            routineV2.updateRoutineCompleteYn(info.getRoutineCompleteYn(), info.getSubRoutineCompleteYn());
+        }
+    }
+
     /**
      * 날짜 범위에서 주어진 요일(repeatDays)에 해당하는 날짜만 반환
      */