feat/KD-48-api: schedule 조회 로직 구현

Author: dkdltm221

aics-api/src/main/java/kgu/developers/api/schedule/application/ScheduleFacade.java

@@ -0,0 +1,32 @@
+package kgu.developers.api.schedule.application;
+
+import kgu.developers.domain.schedule.application.command.ScheduleService;
+import kgu.developers.domain.schedule.application.query.ScheduleQueryService;
+import kgu.developers.domain.schedule.domain.Schedule;
+import kgu.developers.domain.schedule.domain.SubmissionType;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Component;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+
+@Component
+@RequiredArgsConstructor
+@Transactional(readOnly = true)
+public class ScheduleFacade {
+    private final ScheduleQueryService scheduleQueryService;
+
+    public List<Schedule> findAll() {
+        return scheduleQueryService.getAllScheduleManagements();
+    }
+    public Schedule findBySubmissionType(SubmissionType submissionType) {
+        return scheduleQueryService.getBySubmissionType(submissionType);
+    }
+
+    public Schedule findById(Long id) {
+        return scheduleQueryService.getScheduleManagement(id);
+    }
+
+
+
+}

aics-api/src/main/java/kgu/developers/api/schedule/presentation/ScheduleController.java

@@ -0,0 +1,43 @@
+package kgu.developers.api.schedule.presentation;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import kgu.developers.api.schedule.presentation.response.ScheduleListResponse;
+import kgu.developers.api.schedule.presentation.response.ScheduleSummaryResponse;
+import kgu.developers.api.schedule.presentation.response.ScheduleTypeContentResponse;
+import kgu.developers.domain.schedule.domain.SubmissionType;
+import org.springframework.http.ResponseEntity;
+
+@Tag(name = "Schedule", description = "일정관리 API")
+public interface ScheduleController {
+
+    @Operation(summary = "전체 일정 조회 API", description = """
+        - Description : 이 API는 모든 일정을 조회합니다.
+        - Assignee : 주윤빈
+    """)
+    @ApiResponse(
+            responseCode = "200",
+            content = @Content(schema = @Schema(implementation = ScheduleListResponse.class)))
+    ResponseEntity<ScheduleListResponse> getScheduleList();
+
+    @Operation(summary = "유형별 일정 본문 조회 API", description = """
+        - Description : 이 API는 제출유형별 본문만 조회합니다.
+        - Assignee : 주윤빈
+    """)
+    @ApiResponse(
+            responseCode = "200",
+            content = @Content(schema = @Schema(implementation = ScheduleTypeContentResponse.class)))
+    ResponseEntity<ScheduleTypeContentResponse> getSchedulesByType(SubmissionType type);
+
+    @Operation(summary = "단일 일정 조회 API", description = """
+        - Description : 이 API는 단일 일정을 조회합니다.
+        - Assignee : 주윤빈
+    """)
+    @ApiResponse(
+            responseCode = "200",
+            content = @Content(schema = @Schema(implementation = ScheduleSummaryResponse.class)))
+    ResponseEntity<ScheduleSummaryResponse> getScheduleById(Long id);
+}

aics-api/src/main/java/kgu/developers/api/schedule/presentation/ScheduleControllerImpl.java

@@ -0,0 +1,43 @@
+package kgu.developers.api.schedule.presentation;
+
+import kgu.developers.api.schedule.application.ScheduleFacade;
+import kgu.developers.api.schedule.presentation.response.ScheduleListResponse;
+import kgu.developers.api.schedule.presentation.response.ScheduleSummaryResponse;
+import kgu.developers.api.schedule.presentation.response.ScheduleTypeContentResponse;
+import kgu.developers.domain.schedule.domain.SubmissionType;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.time.LocalDateTime;
+
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/api/v1/schedules")
+public class ScheduleControllerImpl implements ScheduleController {
+    private final ScheduleFacade scheduleFacade;
+
+    @Override
+    @GetMapping
+    public ResponseEntity<ScheduleListResponse> getScheduleList() {
+        LocalDateTime referenceTime = LocalDateTime.now();
+        return ResponseEntity.ok(ScheduleListResponse.from(scheduleFacade.findAll(),referenceTime));
+    }
+
+    @Override
+    @GetMapping("/type/{type}")
+    public ResponseEntity<ScheduleTypeContentResponse> getSchedulesByType(@PathVariable SubmissionType type){
+        return ResponseEntity.ok(ScheduleTypeContentResponse.from(scheduleFacade.findBySubmissionType(type)));
+    }
+
+    @Override
+    @GetMapping("/{id}")
+    public ResponseEntity<ScheduleSummaryResponse> getScheduleById(@PathVariable Long id){
+        LocalDateTime referenceTime = LocalDateTime.now();
+        return ResponseEntity.ok(ScheduleSummaryResponse.from(scheduleFacade.findById(id), referenceTime ));
+    }
+}

aics-api/src/main/java/kgu/developers/api/schedule/presentation/response/ScheduleListResponse.java

@@ -0,0 +1,35 @@
+package kgu.developers.api.schedule.presentation.response;
+
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import kgu.developers.domain.schedule.domain.Schedule;
+import lombok.Builder;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Builder
+public record ScheduleListResponse(
+    @Schema(description = "일정 리스트",
+                example = """
+        [{
+            "id": 1,
+            "submissionType": "MIDTHESIS",
+            "title": "중간논문 제출 안내",
+            "startDate": "2025-05-01",
+            "endDate": "2025-12-31",
+            "status": "IN_PROGRESS"
+        }]
+        """,
+                requiredMode = REQUIRED)
+    List<ScheduleSummaryResponse> contents
+) {
+    public static ScheduleListResponse from(List<Schedule> schedules,LocalDateTime referenceTime) {
+        return ScheduleListResponse.builder()
+                .contents(schedules.stream()
+                        .map(schedule -> ScheduleSummaryResponse.from(schedule,referenceTime))
+                        .toList())
+                .build();
+    }
+}

aics-api/src/main/java/kgu/developers/api/schedule/presentation/response/ScheduleSummaryResponse.java

@@ -0,0 +1,47 @@
+package kgu.developers.api.schedule.presentation.response;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import kgu.developers.domain.schedule.domain.Schedule;
+import lombok.Builder;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+
+@Builder
+public record ScheduleSummaryResponse(
+    @Schema(description = "일정 id", example = "1", requiredMode = REQUIRED)
+    Long id,
+
+    @Schema(description = "제출 유형", example = "MIDTHESIS", requiredMode = REQUIRED)
+    String submissionType,
+
+    @Schema(description = "일정 제목", example = "중간논문 제출 안내", requiredMode = REQUIRED)
+    String title,
+
+    @Schema(description = "시작일", example = "2025-05-01", requiredMode = REQUIRED)
+    @DateTimeFormat(pattern = "yyyy-MM-dd")
+    String startDate,
+
+    @Schema(description = "종료일", example = "2025-12-31", requiredMode = REQUIRED)
+    @DateTimeFormat(pattern = "yyyy-MM-dd")
+    String endDate,
+
+    @Schema(description = "상태(대기/진행/마감)", example = "IN_PROGRESS", requiredMode = REQUIRED)
+    String status
+) {
+    private static final DateTimeFormatter DATE_FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM-dd");
+
+    public static ScheduleSummaryResponse from(Schedule schedule, LocalDateTime referenceTime) {
+        return ScheduleSummaryResponse.builder()
+                .id(schedule.getId())
+                .submissionType(schedule.getSubmissionType().name())
+                .title(schedule.getTitle())
+                .startDate(schedule.getStartDate().format(DATE_FORMATTER))
+                .endDate(schedule.getEndDate().format(DATE_FORMATTER))
+                .status(schedule.determineStatusAt(referenceTime).name())
+                .build();
+    }
+}

aics-api/src/main/java/kgu/developers/api/schedule/presentation/response/ScheduleTypeContentResponse.java

@@ -0,0 +1,23 @@
+package kgu.developers.api.schedule.presentation.response;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import kgu.developers.domain.schedule.domain.Schedule;
+import lombok.Builder;
+
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+
+@Builder
+public record ScheduleTypeContentResponse(
+    @Schema(description = "제출 유형", example = "MIDTHESIS", requiredMode = REQUIRED)
+    String submissionType,
+
+    @Schema(description = "일정 본문 내용", example = "매학기 개강 후 2주 이내에 신청서를 작성하여 접수해야 합니다.",requiredMode = REQUIRED)
+    String content
+) {
+    public static ScheduleTypeContentResponse from(Schedule schedule) {
+        return ScheduleTypeContentResponse.builder()
+                .submissionType(schedule.getSubmissionType().name())
+                .content(schedule.getContent())
+                .build();
+    }
+}