Merge pull request #33 from prgrms-web-devcourse-final-project/feature/EA3-74-calender-api

[EA3-74] feature: 캘린더 엔티티 및 스웨거 작성

Author: dbrkdgus00

src/main/java/grep/neogul_coder/domain/calender/controller/PersonalCalenderController.java

@@ -0,0 +1,45 @@
+package grep.neogul_coder.domain.calender.controller;
+
+import grep.neogul_coder.domain.calender.controller.dto.PersonalCalenderRequest;
+import grep.neogul_coder.domain.calender.controller.dto.PersonalCalenderResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import grep.neogul_coder.global.response.ApiResponse;
+
+import java.time.LocalDateTime;
+import java.util.List;
+import org.springframework.web.bind.annotation.*;
+
+@RestController
+@RequestMapping("/api/calendar/personal")
+public class PersonalCalenderController implements PersonalCalenderSpecification {
+
+    @PostMapping
+    public ApiResponse<Void> create(@RequestBody PersonalCalenderRequest request) {
+        return ApiResponse.success(null);
+    }
+
+    @GetMapping
+    public ApiResponse<List<PersonalCalenderResponse>> findAll() {
+        return ApiResponse.success(List.of(
+            PersonalCalenderResponse.builder().build()
+        ));
+    }
+
+    @GetMapping("/{scheduleId}")
+    public ApiResponse<PersonalCalenderResponse> findOne(@PathVariable Long scheduleId) {
+        return ApiResponse.success(
+            PersonalCalenderResponse.builder().build());
+    }
+
+    @PutMapping("/{scheduleId}")
+    public ApiResponse<Void> update(@PathVariable Long scheduleId, @RequestBody PersonalCalenderRequest request) {
+        return ApiResponse.success(null);
+    }
+
+    @DeleteMapping("/{scheduleId}")
+    public ApiResponse<Void> delete(@PathVariable Long scheduleId) {
+        return ApiResponse.success(null);
+    }
+}
+

src/main/java/grep/neogul_coder/domain/calender/controller/PersonalCalenderSpecification.java

@@ -0,0 +1,30 @@
+package grep.neogul_coder.domain.calender.controller;
+
+import grep.neogul_coder.domain.calender.controller.dto.PersonalCalenderRequest;
+import grep.neogul_coder.domain.calender.controller.dto.PersonalCalenderResponse;
+import grep.neogul_coder.global.response.ApiResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestBody;
+
+import java.util.List;
+
+@Tag(name = "개인 캘린더", description = "개인 캘린더 API (Swagger 인터페이스)")
+public interface PersonalCalenderSpecification {
+
+    @Operation(summary = "개인 일정 생성", description = "사용자의 개인 일정을 생성합니다.")
+    ApiResponse<Void> create(@RequestBody PersonalCalenderRequest request);
+
+    @Operation(summary = "개인 일정 전체 조회", description = "모든 개인 일정을 조회합니다.")
+    ApiResponse<List<PersonalCalenderResponse>> findAll();
+
+    @Operation(summary = "개인 일정 상세 조회", description = "개별 일정 상세정보를 조회합니다.")
+    ApiResponse<PersonalCalenderResponse> findOne(@PathVariable Long scheduleId);
+
+    @Operation(summary = "개인 일정 수정", description = "개별 일정을 수정합니다.")
+    ApiResponse<Void> update(@PathVariable Long scheduleId, @RequestBody PersonalCalenderRequest request);
+
+    @Operation(summary = "개인 일정 삭제", description = "개별 일정을 삭제합니다.")
+    ApiResponse<Void> delete(@PathVariable Long scheduleId);
+}

src/main/java/grep/neogul_coder/domain/calender/controller/TeamCalenderController.java

@@ -0,0 +1,47 @@
+package grep.neogul_coder.domain.calender.controller;
+
+import grep.neogul_coder.domain.calender.controller.dto.PersonalCalenderResponse;
+import grep.neogul_coder.domain.calender.controller.dto.TeamCalenderRequest;
+import grep.neogul_coder.domain.calender.controller.dto.TeamCalenderResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import grep.neogul_coder.global.response.ApiResponse;
+
+import org.springframework.web.bind.annotation.*;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@RestController
+@RequestMapping("/api/calendar/team")
+public class TeamCalenderController implements TeamCalenderSpecification {
+
+    @PostMapping
+    public ApiResponse<Void> create(@RequestBody TeamCalenderRequest request) {
+        return ApiResponse.success(null);
+    }
+
+    @GetMapping
+    public ApiResponse<List<TeamCalenderResponse>> findAll() {
+        return ApiResponse.success(List.of(
+            TeamCalenderResponse.builder().build()
+        ));
+    }
+
+    @GetMapping("/{scheduleId}")
+    public ApiResponse<TeamCalenderResponse> findOne(@PathVariable Long scheduleId) {
+        return ApiResponse.success(
+            TeamCalenderResponse.builder().build());
+    }
+
+    @PutMapping("/{scheduleId}")
+    public ApiResponse<Void> update(@PathVariable Long scheduleId, @RequestBody TeamCalenderRequest request) {
+        return ApiResponse.success(null);
+    }
+
+    @DeleteMapping("/{scheduleId}")
+    public ApiResponse<Void> delete(@PathVariable Long scheduleId) {
+        return ApiResponse.success(null);
+    }
+}
+

src/main/java/grep/neogul_coder/domain/calender/controller/TeamCalenderSpecification.java

@@ -0,0 +1,30 @@
+package grep.neogul_coder.domain.calender.controller;
+
+import grep.neogul_coder.domain.calender.controller.dto.TeamCalenderRequest;
+import grep.neogul_coder.domain.calender.controller.dto.TeamCalenderResponse;
+import grep.neogul_coder.global.response.ApiResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestBody;
+
+import java.util.List;
+
+@Tag(name = "팀 캘린더", description = "팀 캘린더 API (Swagger 인터페이스)")
+public interface TeamCalenderSpecification {
+
+    @Operation(summary = "팀 일정 전체 조회", description = "모든 팀 일정을 조회합니다.")
+    ApiResponse<List<TeamCalenderResponse>> findAll();
+
+    @Operation(summary = "팀 일정 상세 조회", description = "특정 팀 일정 상세정보를 조회합니다.")
+    ApiResponse<TeamCalenderResponse> findOne(@PathVariable Long scheduleId);
+
+    @Operation(summary = "팀 일정 생성", description = "새로운 팀 일정을 생성합니다.")
+    ApiResponse<Void> create(@RequestBody TeamCalenderRequest request);
+
+    @Operation(summary = "팀 일정 수정", description = "기존 팀 일정을 수정합니다.")
+    ApiResponse<Void> update(@PathVariable Long scheduleId, @RequestBody TeamCalenderRequest request);
+
+    @Operation(summary = "팀 일정 삭제", description = "기존 팀 일정을 삭제합니다.")
+    ApiResponse<Void> delete(@PathVariable Long scheduleId);
+}

src/main/java/grep/neogul_coder/domain/calender/controller/dto/PersonalCalenderRequest.java

@@ -0,0 +1,24 @@
+package grep.neogul_coder.domain.calender.controller.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import java.time.LocalDateTime;
+import lombok.Getter;
+
+
+@Schema(description = "개인 캘린더 요청 DTO")
+@Getter
+public class PersonalCalenderRequest {
+
+    @Schema(description = "일정 제목", example = "면접 준비")
+    private String title;
+
+    @Schema(description = "일정 설명", example = "코테 대비 공부")
+    private String description;
+
+    @Schema(description = "시작 시간", example = "2025-07-10T09:00:00")
+    private LocalDateTime startTime;
+
+    @Schema(description = "종료 시간", example = "2025-07-10T10:00:00")
+    private LocalDateTime endTime;
+
+}

src/main/java/grep/neogul_coder/domain/calender/controller/dto/PersonalCalenderResponse.java

@@ -0,0 +1,40 @@
+package grep.neogul_coder.domain.calender.controller.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+
+import java.time.LocalDateTime;
+import lombok.Builder;
+import lombok.Getter;
+
+@Getter
+@Schema(description = "개인 캘린더 응답 DTO")
+public class PersonalCalenderResponse {
+
+    @Schema(description = "일정 ID", example = "1001")
+    private Long scheduleId;
+
+    @Schema(description = "사용자 ID", example = "1")
+    private Long userId;
+
+    @Schema(description = "일정 제목", example = "면접 준비")
+    private String title;
+
+    @Schema(description = "일정 설명", example = "코테 대비 공부")
+    private String description;
+
+    @Schema(description = "시작 시간", example = "2025-07-10T09:00:00")
+    private LocalDateTime startTime;
+
+    @Schema(description = "종료 시간", example = "2025-07-10T10:00:00")
+    private LocalDateTime endTime;
+
+    @Builder
+    private PersonalCalenderResponse(Long scheduleId, Long userId, String title, String description, LocalDateTime startTime, LocalDateTime endTime) {
+        this.scheduleId = scheduleId;
+        this.userId = userId;
+        this.title = title;
+        this.description = description;
+        this.startTime = startTime;
+        this.endTime = endTime;
+    }
+}

src/main/java/grep/neogul_coder/domain/calender/controller/dto/TeamCalenderRequest.java

@@ -0,0 +1,23 @@
+package grep.neogul_coder.domain.calender.controller.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import java.time.LocalDateTime;
+import lombok.Getter;
+
+@Getter
+@Schema(description = "팀 캘린더 요청 DTO")
+public class TeamCalenderRequest {
+
+    @Schema(description = "일정 제목", example = "주간 회의")
+    private String title;
+
+    @Schema(description = "일정 설명", example = "스터디 진행 사항 공유")
+    private String description;
+
+    @Schema(description = "시작 시간", example = "2025-07-12T14:00:00")
+    private LocalDateTime startTime;
+
+    @Schema(description = "종료 시간", example = "2025-07-12T15:00:00")
+    private LocalDateTime endTime;
+
+}

src/main/java/grep/neogul_coder/domain/calender/controller/dto/TeamCalenderResponse.java

@@ -0,0 +1,39 @@
+package grep.neogul_coder.domain.calender.controller.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import java.time.LocalDateTime;
+import lombok.Builder;
+import lombok.Getter;
+
+@Getter
+@Schema(description = "팀 캘린더 응답 DTO")
+public class TeamCalenderResponse {
+
+    @Schema(description = "일정 ID", example = "2001")
+    private Long scheduleId;
+
+    @Schema(description = "팀 ID", example = "101")
+    private Long teamId;
+
+    @Schema(description = "일정 제목", example = "스터디A")
+    private String title;
+
+    @Schema(description = "일정 설명", example = "기획 회의")
+    private String description;
+
+    @Schema(description = "시작 시간", example = "2025-07-12T14:00:00")
+    private LocalDateTime startTime;
+
+    @Schema(description = "종료 시간", example = "2025-07-12T15:00:00")
+    private LocalDateTime endTime;
+
+    @Builder
+    private TeamCalenderResponse(Long scheduleId, Long teamId, String title, String description, LocalDateTime startTime, LocalDateTime endTime) {
+        this.scheduleId = scheduleId;
+        this.teamId = teamId;
+        this.title = title;
+        this.description = description;
+        this.startTime = startTime;
+        this.endTime = endTime;
+    }
+}

src/main/java/grep/neogul_coder/domain/calender/entity/Calender.java

@@ -0,0 +1,27 @@
+package grep.neogul_coder.domain.calender.entity;
+
+import grep.neogul_coder.global.entity.BaseEntity;
+import jakarta.persistence.*;
+import java.time.LocalDateTime;
+import lombok.Getter;
+
+@Entity
+@Getter
+public class Calender extends BaseEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @Column(nullable = false)
+    private LocalDateTime scheduledStart;
+
+    @Column(nullable = false)
+    private LocalDateTime scheduledEnd;
+
+    @Column(nullable = false)
+    private String title;
+
+    private String content;
+
+}

src/main/java/grep/neogul_coder/domain/calender/entity/PersonalCalender.java

@@ -0,0 +1,22 @@
+package grep.neogul_coder.domain.calender.entity;
+
+import grep.neogul_coder.domain.users.entity.User;
+import grep.neogul_coder.global.entity.BaseEntity;
+import jakarta.persistence.*;
+import lombok.Getter;
+
+@Entity
+@Getter
+public class PersonalCalender extends BaseEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    private Calender calendar;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    private User user;
+}
+