Merge pull request #836 from Clubber2024/feat/#834-feat-관리자-캘린더-조회-api-구현

Feat/#834 feat 관리자 캘린더 조회 api 구현

Author: mjKim1229

…endar/controller/CalendarController.java …/controller/CalendarAdminController.javasrc/main/java/com/clubber/ClubberServer/domain/calendar/controller/CalendarController.java renamed to src/main/java/com/clubber/ClubberServer/domain/calendar/controller/CalendarAdminController.java src/main/java/com/clubber/ClubberServer/domain/calendar/controller/CalendarController.java renamed to src/main/java/com/clubber/ClubberServer/domain/calendar/controller/CalendarAdminController.java

@@ -5,39 +5,47 @@
 import com.clubber.ClubberServer.domain.calendar.dto.GetCalendarResponse;
 import com.clubber.ClubberServer.domain.calendar.dto.UpdateCalendarRequest;
 import com.clubber.ClubberServer.domain.calendar.entity.Calendar;
-import com.clubber.ClubberServer.domain.calendar.service.AdminCalendarService;
+import com.clubber.ClubberServer.domain.calendar.service.CalendarAdminService;
 import com.clubber.ClubberServer.global.common.page.PageResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.RequiredArgsConstructor;
 import org.springframework.data.domain.Pageable;
 import org.springframework.web.bind.annotation.*;
 
 @RestController
 @RequiredArgsConstructor
 @RequestMapping("/api/v1/admins/calendars")
-public class CalendarController {
-    private final AdminCalendarService calendarService;
+@Tag(name = "[관리자 캘린더 관련 API]")
+public class CalendarAdminController {
+    private final CalendarAdminService calendarService;
 
     @PostMapping
+    @Operation(summary = "미연동 캘린더 생성")
     public CreateCalendarResponse createCalendar(@RequestBody CreateCalendarRequest request) {
         return calendarService.createCalendar(request);
     }
 
     @GetMapping
+    @Operation(summary = "캘린더 목록 (페이지) 조회")
     public PageResponse<Calendar> getCalendars(Pageable pageable) {
         return calendarService.getCalenderPages(pageable);
     }
 
     @GetMapping("/{id}")
+    @Operation(summary = "특정 캘린더 (단일) 조회")
     public GetCalendarResponse getCalendar(@PathVariable Long id) {
         return calendarService.getCalendar(id);
     }
 
     @PatchMapping("/{id}")
+    @Operation(summary = "특정 캘린더 수정")
     public void updateCalendar(@PathVariable Long id, @RequestBody UpdateCalendarRequest request) {
         calendarService.updateCalendar(request, id);
     }
 
-    @DeleteMapping("/calendars/{id}")
+    @DeleteMapping("/{id}")
+    @Operation(summary = "특정 캘린더 삭제")
     public void deleteCalendar(@PathVariable Long id) {
         calendarService.deleteCalendar(id);
     }

…lendar/service/AdminCalendarService.java …lendar/service/CalendarAdminService.javasrc/main/java/com/clubber/ClubberServer/domain/calendar/service/AdminCalendarService.java renamed to src/main/java/com/clubber/ClubberServer/domain/calendar/service/CalendarAdminService.java src/main/java/com/clubber/ClubberServer/domain/calendar/service/AdminCalendarService.java renamed to src/main/java/com/clubber/ClubberServer/domain/calendar/service/CalendarAdminService.java

@@ -20,7 +20,7 @@
 @Service
 @RequiredArgsConstructor
 @Transactional
-public class AdminCalendarService {
+public class CalendarAdminService {
     private final CalendarAppender calendarAppender;
     private final CalendarReader calendarReader;
     private final AdminReader adminReader;

src/main/java/com/clubber/ClubberServer/domain/recruit/controller/RecruitLinkedCalendarController.java

@@ -3,21 +3,26 @@
 import com.clubber.ClubberServer.domain.recruit.dto.recruitCalendar.CreateLinkedCalendarRequest;
 import com.clubber.ClubberServer.domain.recruit.dto.recruitCalendar.CreateLinkedCalenderResponse;
 import com.clubber.ClubberServer.domain.recruit.service.RecruitLinkedCalendarService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.RequiredArgsConstructor;
 import org.springframework.web.bind.annotation.*;
 
 @RestController
-@RequestMapping("/calendars/link")
+@RequestMapping("/api/v1/admins/calendars/link")
 @RequiredArgsConstructor
+@Tag(name = "[관리자 연동 캘린더 관련 API]")
 public class RecruitLinkedCalendarController {
 
     private final RecruitLinkedCalendarService recruitLinkedCalendarService;
 
+    @Operation(summary = "연동 캘린더 생성(모집글 생성 이후 호출)")
     @PostMapping
     public CreateLinkedCalenderResponse createLinkedCalender(@RequestBody CreateLinkedCalendarRequest request) {
         return recruitLinkedCalendarService.createLinkedCalender(request);
     }
 
+    @Operation(summary = "특정 캘린더 연동 해제")
     @PatchMapping("/{id}/unlink")
     public void unlinkCalendar(@PathVariable Long id) {
         recruitLinkedCalendarService.unlinkCalendar(id);