feat: Todo 생성 구현

Author: KSH0326

src/main/java/com/back/domain/study/plan/service/StudyPlanService.java

@@ -582,16 +582,16 @@ private void validateTimeConflict(Long userId, Long planIdToExclude, LocalDateTi
 
         for (StudyPlan plan : conflictingOriginalPlans) {
             if (plan.getRepeatRule() == null) {
-                // 2-1. 단발성 계획: 쿼리에서 이미 시간 범위가 겹친다고 걸러졌지만, 최종 확인
+                // 2-1. 단발성 계획 -> 쿼리에서 이미 시간 범위가 겹친다고 걸러졌지만 재확인
                 if (isOverlapping(plan.getStartDate(), plan.getEndDate(), newStart, newEnd)) {
                     throw new CustomException(ErrorCode.PLAN_TIME_CONFLICT);
                 }
             } else {
-                // 2-2. 반복 계획: 기존 헬퍼를 사용해 요청 날짜의 가상 인스턴스를 생성하고 검사
+                // 2-2. 반복 계획 -> 기존 메서드를 사용해 요청 날짜의 가상 인스턴스를 생성하고 검사
                 StudyPlanResponse virtualPlan = createVirtualPlanForDate(plan, newPlanDate);
 
                 if (virtualPlan != null) {
-                    // 가상 인스턴스가 존재하고 (삭제되지 않았고)
+                    // 가상 인스턴스가 존재하고
                     // 해당 인스턴스의 확정된 시간이 새 계획과 겹치는지 최종 확인
                     if (isOverlapping(virtualPlan.getStartDate(), virtualPlan.getEndDate(), newStart, newEnd)) {
                         throw new CustomException(ErrorCode.PLAN_TIME_CONFLICT);

src/main/java/com/back/domain/study/todo/controller/TodoController.java

@@ -1,7 +1,18 @@
 package com.back.domain.study.todo.controller;
 
+import com.back.domain.study.todo.dto.TodoRequestDto;
+import com.back.domain.study.todo.dto.TodoResponseDto;
+import com.back.domain.study.todo.service.TodoService;
+import com.back.global.common.dto.RsData;
+import com.back.global.security.user.CustomUserDetails;
+import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+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;
 
@@ -10,5 +21,16 @@
 @RequestMapping("/api/todos")
 @Tag(name = "Todo", description = "할 일 관련 API")
 public class TodoController {
+    private final TodoService todoService;
+
+    @PostMapping
+    @Operation(summary = "할 일 생성", description = "새로운 할 일을 생성합니다.")
+    public ResponseEntity<RsData<TodoResponseDto>> createTodo(
+            @AuthenticationPrincipal CustomUserDetails userDetails,
+            @Valid @RequestBody TodoRequestDto requestDto
+    ) {
+        TodoResponseDto response = todoService.createTodo(userDetails.getUserId(), requestDto);
+        return ResponseEntity.ok(RsData.success("할 일이 생성되었습니다.", response));
+    }
 
 }

src/main/java/com/back/domain/study/todo/dto/TodoRequestDto.java

@@ -0,0 +1,15 @@
+package com.back.domain.study.todo.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+
+import java.time.LocalDate;
+
+public record TodoRequestDto(
+        @NotBlank(message = "할 일 설명은 필수입니다.")
+        String description,
+        @NotNull(message = "날짜는 필수입니다.")
+        LocalDate date
+) {
+}

src/main/java/com/back/domain/study/todo/dto/TodoResponseDto.java

@@ -0,0 +1,23 @@
+package com.back.domain.study.todo.dto;
+
+import com.back.domain.study.todo.entity.Todo;
+import io.swagger.v3.oas.annotations.media.Schema;
+
+import java.time.LocalDate;
+
+public record TodoResponseDto(
+        Long id,
+        String description,
+        boolean isComplete,
+        LocalDate date
+) {
+    // entity -> DTO
+    public static TodoResponseDto from(Todo todo) {
+        return new TodoResponseDto(
+                todo.getId(),
+                todo.getDescription(),
+                todo.isComplete(),
+                todo.getDate()
+        );
+    }
+}

src/main/java/com/back/domain/study/todo/entity/Todo.java

@@ -15,7 +15,7 @@
 @Getter
 @NoArgsConstructor
 public class Todo extends BaseEntity {
-    @ManyToOne(fetch = FetchType.LAZY)
+    @ManyToOne(fetch = FetchType.LAZY, cascade = CascadeType.ALL)
     @JoinColumn(name = "user_id")
     private User user;
 
@@ -25,4 +25,11 @@ public class Todo extends BaseEntity {
 
     private LocalDate date;
 
+    public Todo(User user, String description, LocalDate date) {
+        this.user = user;
+        this.description = description;
+        this.date = date;
+        this.isComplete = false;
+    }
+
 }

src/main/java/com/back/domain/study/todo/service/TodoService.java

@@ -1,7 +1,43 @@
 package com.back.domain.study.todo.service;
 
+import com.back.domain.study.todo.dto.TodoRequestDto;
+import com.back.domain.study.todo.dto.TodoResponseDto;
+import com.back.domain.study.todo.entity.Todo;
+import com.back.domain.study.todo.repository.TodoRepository;
+import com.back.domain.user.entity.User;
+import com.back.domain.user.repository.UserRepository;
+import com.back.global.exception.CustomException;
+import com.back.global.exception.ErrorCode;
+import com.back.global.security.user.CustomUserDetails;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
 
 @Service
+@RequiredArgsConstructor
+@Transactional(readOnly = true)
 public class TodoService {
+    private final TodoRepository todoRepository;
+    private final UserRepository userRepository;
+
+    // ==================== 생성 ===================
+    public TodoResponseDto createTodo(Long userId, TodoRequestDto request) {
+        User user = userRepository.findById(userId)
+                .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND));
+        Todo todo = new Todo(
+                user,
+                request.description(),
+                request.date()
+        );
+
+        Todo savedTodo = todoRepository.save(todo);
+        return TodoResponseDto.from(savedTodo);
+    }
+
+    // ==================== 조회 ===================
+
+    // ==================== 수정 ===================
+
+    // ==================== 삭제 ===================
 }

src/main/java/com/back/global/exception/ErrorCode.java

@@ -43,7 +43,7 @@ public enum ErrorCode {
     PLAN_ORIGINAL_REPEAT_NOT_FOUND(HttpStatus.NOT_FOUND, "PLAN_004", "해당 날짜에 원본 반복 계획을 찾을 수 없습니다."),
     INVALID_DATE_FORMAT(HttpStatus.BAD_REQUEST, "PLAN_005", "날짜 형식이 올바르지 않습니다. (YYYY-MM-DD 형식을 사용해주세요)"),
     PLAN_INVALID_TIME_RANGE(HttpStatus.BAD_REQUEST, "PLAN_006", "시작 시간은 종료 시간보다 빨라야 합니다."),
-    PLAN_TIME_CONFLICT(HttpStatus.CONFLICT, "PLAN_007", "이미 존재하는 학습 계획과 시간이 겹칩니다."),
+    PLAN_TIME_CONFLICT(HttpStatus.CONFLICT, "PLAN_007", "이미 존재하는 학습 계획과 시간이 겹칩니다. 기존 종료 시간과 겹치는 경우는 제외됩니다."),
     PLAN_CANNOT_UPDATE(HttpStatus.BAD_REQUEST, "PLAN_008", "수정 스위치 로직 탈출. 어떤 경우인지 파악이 필요합니다."),
     REPEAT_INVALID_UNTIL_DATE(HttpStatus.BAD_REQUEST, "REPEAT_001", "반복 계획의 종료 날짜는 시작 날짜 이전일 수 없습니다."),
     REPEAT_BYDAY_REQUIRED(HttpStatus.BAD_REQUEST, "REPEAT_002", "주간 반복 계획의 경우 요일(byDay) 정보가 필요합니다."),