[dev -> main] 2025.10.25 02:16

src/main/java/DiffLens/back_end/domain/library/controller/LibraryController.java

@@ -1,25 +1,151 @@
 package DiffLens.back_end.domain.library.controller;
 
+import DiffLens.back_end.domain.library.dto.LibraryRequestDto;
 import DiffLens.back_end.domain.library.dto.LibraryResponseDTO;
+import DiffLens.back_end.domain.library.service.LibraryService;
+import DiffLens.back_end.domain.members.entity.Member;
+import DiffLens.back_end.domain.members.service.auth.CurrentUserService;
 import DiffLens.back_end.global.responses.exception.ApiResponse;
 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.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.bind.annotation.*;
 
 @Tag(name = "라이브러리 API")
 @RestController
 @RequestMapping("/libraries")
 @RequiredArgsConstructor
 public class LibraryController {
 
-    @GetMapping
-    @Operation(summary = "라이브러리 목록 조회 ( 미구현 )")
-    public ApiResponse<LibraryResponseDTO.ListResult> libraryList( /* 파라미터 추가 필요 */ ){
-        LibraryResponseDTO.ListResult result = new LibraryResponseDTO.ListResult();
-        return ApiResponse.onSuccess(result);
-    }
+        private final LibraryService libraryService;
+        private final CurrentUserService currentUserService;
 
+        @GetMapping
+        @Operation(summary = "라이브러리 목록 조회", description = """
+
+                        ## 개요
+                        인증된 사용자가 생성한 라이브러리 목록을 조회하는 API입니다.
+
+                        ## 응답
+                        - libraries : 라이브러리 목록 배열
+                          - library_id : 라이브러리 ID
+                          - library_name : 라이브러리 이름
+                          - tags : 라이브러리 분류 태그 리스트
+                          - panel_count : 저장된 패널 개수
+                          - created_at : 생성 시간
+                        - page_info : 페이징 정보 (현재는 null, 추후 구현 예정)
+
+                        ## 권한
+                        본인이 생성한 라이브러리만 조회할 수 있습니다.
+
+                        ## 정렬
+                        최근 생성된 순서로 정렬됩니다.
+
+                        """)
+        public ApiResponse<LibraryResponseDTO.ListResult> libraryList() {
+                Member member = currentUserService.getCurrentUser();
+                LibraryResponseDTO.ListResult result = libraryService.getLibrariesByMember(member);
+                return ApiResponse.onSuccess(result);
+        }
+
+        @PostMapping
+        @Operation(summary = "라이브러리 생성", description = """
+
+                        ## 개요
+                        검색 기록을 기반으로 라이브러리를 생성하는 API입니다.
+
+                        ## Request Body
+                        - search_history_id : 저장할 검색 기록의 ID (필수)
+                        - library_name : 라이브러리 이름 (필수)
+                        - tags : 라이브러리 분류 태그 리스트 (필수)
+                        - panel_ids : 저장할 패널 ID 리스트 (선택, null이면 검색 기록의 모든 패널 저장)
+
+                        ## 응답
+                        - library_id : 생성된 라이브러리 ID
+                        - library_name : 라이브러리 이름
+                        - search_history_id : 연결된 검색 기록 ID
+                        - panel_count : 저장된 패널 개수
+                        - created_at : 생성 시간
+
+                        ## 권한
+                        본인의 검색 기록만 라이브러리로 저장할 수 있습니다.
+
+                        """)
+        public ApiResponse<LibraryResponseDTO.CreateResult> createLibrary(
+                        @RequestBody @Valid LibraryRequestDto.Create request) {
+                Member member = currentUserService.getCurrentUser();
+                LibraryService.LibraryCreateResult createResult = libraryService.createLibrary(request, member);
+
+                LibraryResponseDTO.CreateResult result = LibraryResponseDTO.CreateResult.from(
+                                createResult.getLibrary(),
+                                request.getSearchHistoryId(),
+                                createResult.getPanelCount());
+                return ApiResponse.onSuccess(result);
+        }
+
+        @GetMapping("/{libraryId}")
+        @Operation(summary = "특정 라이브러리 상세 조회", description = """
+                        ## 개요
+                        특정 라이브러리의 상세 정보를 조회하는 API입니다.
+
+                        ## Path Parameters
+                        - libraryId : 조회할 라이브러리 ID
+
+                        ## 응답 데이터
+                        - 라이브러리 기본 정보 (이름, 태그, 생성일, 수정일)
+                        - 포함된 패널들의 상세 정보
+                        - 연결된 검색기록들 -> 혹시 몰라 추가한 로직으로 필요 없다고 판단될 시 안쓰셔도 됩니다.
+                        - 패널 통계 정보 (성별, 연령대, 거주지 분포) -> 혹시 몰라 추가한 로직으로 필요 없다고 판단될 시 안쓰셔도 됩니다.
+
+                        ## 권한
+                        본인이 생성한 라이브러리만 조회할 수 있습니다.
+                        """)
+        public ApiResponse<LibraryResponseDTO.LibraryDetail> getLibraryDetail(@PathVariable Long libraryId) {
+                Member member = currentUserService.getCurrentUser();
+                LibraryResponseDTO.LibraryDetail result = libraryService.getLibraryDetail(libraryId, member);
+                return ApiResponse.onSuccess(result);
+        }
+
+        @PutMapping("/{libraryId}/search-histories/{searchHistoryId}")
+        @Operation(summary = "기존 라이브러리에 새로운 검색기록 추가(병합)", description = """
+
+                        ## 개요
+                        기존 라이브러리에 검색기록을 추가하는 API입니다.
+                        라이브러리의 패널 ID와 검색기록의 패널 ID를 병합하여 중복을 제거합니다.
+
+                        ## Path Parameters
+                        - libraryId : 라이브러리 ID
+                        - searchHistoryId : 추가할 검색기록 ID
+
+                        ## 응답
+                        - library_id : 라이브러리 ID
+                        - library_name : 라이브러리 이름
+                        - search_history_id : 추가된 검색기록 ID
+                        - panel_count : 새로 추가된 패널 개수
+                        - panel_ids : 병합된 전체 패널 ID 리스트
+                        - created_at : 생성 시간
+
+                        ## 권한
+                        본인의 라이브러리와 검색기록만 사용할 수 있습니다.
+
+                        ## 예시
+                        - 라이브러리 1번에 패널 ID [1, 2, 3]이 있음
+                        - 검색기록 2번에 패널 ID [3, 4, 5]가 있음
+                        - 결과: 라이브러리 1번에 패널 ID [1, 2, 3, 4, 5]가 됨
+
+                        """)
+        public ApiResponse<LibraryResponseDTO.CreateResult> addSearchHistoryToLibrary(
+                        @PathVariable Long libraryId,
+                        @PathVariable Long searchHistoryId) {
+                Member member = currentUserService.getCurrentUser();
+                LibraryService.LibraryCreateResult createResult = libraryService.addSearchHistoryToLibrary(libraryId,
+                                searchHistoryId, member);
+
+                LibraryResponseDTO.CreateResult result = LibraryResponseDTO.CreateResult.from(
+                                createResult.getLibrary(),
+                                searchHistoryId,
+                                createResult.getPanelCount());
+                return ApiResponse.onSuccess(result);
+        }
 }

src/main/java/DiffLens/back_end/domain/library/dto/LibraryRequestDto.java

@@ -0,0 +1,36 @@
+package DiffLens.back_end.domain.library.dto;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+import java.util.List;
+
+public class LibraryRequestDto {
+
+    @Getter
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class Create {
+
+        @NotNull(message = "검색 기록 ID는 필수입니다")
+        @JsonProperty("search_history_id")
+        private Long searchHistoryId;
+
+        @NotBlank(message = "라이브러리 이름은 필수입니다")
+        @JsonProperty("library_name")
+        private String libraryName;
+
+        @NotNull(message = "태그는 필수입니다")
+        private List<String> tags;
+
+        @JsonProperty("panel_ids")
+        private List<String> panelIds; // 선택적: null이면 SearchHistory의 panelIds 사용
+    }
+
+}