feat: 발주처 목록 조회 기능 구현

src/main/java/com/almang/inventory/global/api/SuccessMessage.java

@@ -31,6 +31,7 @@ public enum SuccessMessage {
     CREATE_VENDOR_SUCCESS("발주처 등록 성공"),
     UPDATE_VENDOR_SUCCESS("발주처 수정 성공"),
     GET_VENDOR_DETAIL_SUCCESS("발주처 상세 조회 성공"),
+    GET_VENDOR_LIST_SUCCESS("발주처 목록 조회 성공"),
     ;
 
     private final String message;

src/main/java/com/almang/inventory/global/util/PaginationUtil.java

@@ -0,0 +1,17 @@
+package com.almang.inventory.global.util;
+
+import org.springframework.data.domain.PageRequest;
+import org.springframework.data.domain.Sort;
+import org.springframework.data.domain.Sort.Direction;
+
+public class PaginationUtil {
+
+    private PaginationUtil() {} // 인스턴스 생성 방지
+
+    public static PageRequest createPageRequest(Integer page, Integer size, String sortBy) {
+        int pageIndex = (page == null || page < 1) ? 0 : page - 1;
+        int pageSize = (size == null || size < 1) ? 20 : size;
+
+        return PageRequest.of(pageIndex, pageSize, Sort.by(Direction.ASC, sortBy));
+    }
+}

src/main/java/com/almang/inventory/product/service/ProductService.java

@@ -3,6 +3,7 @@
 import com.almang.inventory.global.api.PageResponse;
 import com.almang.inventory.global.exception.BaseException;
 import com.almang.inventory.global.exception.ErrorCode;
+import com.almang.inventory.global.util.PaginationUtil;
 import com.almang.inventory.product.domain.Product;
 import com.almang.inventory.product.dto.request.CreateProductRequest;
 import com.almang.inventory.product.dto.request.UpdateProductRequest;
@@ -80,7 +81,7 @@ public PageResponse<ProductResponse> getProductList(
         Store store = user.getStore();
 
         log.info("[ProductService] 품목 목록 조회 요청 - userId: {}, storeId: {}", userId, store.getId());
-        PageRequest pageable = createPageRequest(page, size);
+        PageRequest pageable = PaginationUtil.createPageRequest(page, size, "name");
         Page<Product> productPage = findProductsByFilter(store.getId(), isActivate, nameKeyword, pageable);
         Page<ProductResponse> mapped = productPage.map(ProductResponse::from);
 
@@ -134,13 +135,6 @@ private void validateStoreAccess(Product product, User user) {
         }
     }
 
-    private PageRequest createPageRequest(Integer page, Integer size) {
-        int pageIndex = (page == null || page < 1) ? 0 : page - 1; // 0-based로 변환
-        int pageSize = (size == null || size < 1) ? 20 : size;
-
-        return PageRequest.of(pageIndex, pageSize, Sort.by(Sort.Direction.ASC, "name"));
-    }
-
     private Page<Product> findProductsByFilter(
             Long storeId, Boolean isActivate, String nameKeyword, PageRequest pageable
     ) {

src/main/java/com/almang/inventory/vendor/controller/VendorController.java

@@ -1,6 +1,7 @@
 package com.almang.inventory.vendor.controller;
 
 import com.almang.inventory.global.api.ApiResponse;
+import com.almang.inventory.global.api.PageResponse;
 import com.almang.inventory.global.api.SuccessMessage;
 import com.almang.inventory.global.security.principal.CustomUserPrincipal;
 import com.almang.inventory.vendor.dto.request.CreateVendorRequest;
@@ -20,6 +21,7 @@
 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.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
 @Slf4j
@@ -76,4 +78,24 @@ public ResponseEntity<ApiResponse<VendorResponse>> getVendorDetail(
                 ApiResponse.success(SuccessMessage.GET_VENDOR_DETAIL_SUCCESS.getMessage(), response)
         );
     }
+
+    @GetMapping
+    @Operation(summary = "발주처 목록 조회", description = "발주처 목록을 페이지네이션, 활성 여부, 이름 검색 조건과 함께 조회합니다.")
+    public ResponseEntity<ApiResponse<PageResponse<VendorResponse>>> getVendorList(
+            @AuthenticationPrincipal CustomUserPrincipal userPrincipal,
+            @RequestParam(value = "page", required = false) Integer page,
+            @RequestParam(value = "size", required = false) Integer size,
+            @RequestParam(value = "isActivate", required = false) Boolean isActivate,
+            @RequestParam(value = "name", required = false) String nameKeyword
+    ) {
+        Long userId = userPrincipal.getId();
+        log.info("[VendorController] 발주처 목록 조회 요청 - userId: {}, page: {}, size: {}, isActivate: {}, name: {}",
+                userId, page, size, isActivate, nameKeyword);
+        PageResponse<VendorResponse> response =
+                vendorService.getVendorList(userId, page, size, isActivate, nameKeyword);
+
+        return ResponseEntity.ok(
+                ApiResponse.success(SuccessMessage.GET_VENDOR_LIST_SUCCESS.getMessage(), response)
+        );
+    }
 }

src/main/java/com/almang/inventory/vendor/repository/VendorRepository.java

@@ -1,7 +1,23 @@
 package com.almang.inventory.vendor.repository;
 
 import com.almang.inventory.vendor.domain.Vendor;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
 import org.springframework.data.jpa.repository.JpaRepository;
 
 public interface VendorRepository extends JpaRepository<Vendor, Long> {
+
+    Page<Vendor> findAllByStoreId(Long storeId, Pageable pageable);
+
+    Page<Vendor> findAllByStoreIdAndActivatedTrue(
+            Long storeId, Pageable pageable
+    );
+
+    Page<Vendor> findAllByStoreIdAndNameContainingIgnoreCase(
+            Long storeId, String name, Pageable pageable
+    );
+
+    Page<Vendor> findAllByStoreIdAndActivatedTrueAndNameContainingIgnoreCase(
+            Long storeId, String name, Pageable pageable
+    );
 }

src/main/java/com/almang/inventory/vendor/service/VendorService.java

@@ -1,7 +1,10 @@
 package com.almang.inventory.vendor.service;
 
+import com.almang.inventory.global.api.PageResponse;
 import com.almang.inventory.global.exception.BaseException;
 import com.almang.inventory.global.exception.ErrorCode;
+import com.almang.inventory.global.util.PaginationUtil;
+import com.almang.inventory.store.domain.Store;
 import com.almang.inventory.user.domain.User;
 import com.almang.inventory.user.repository.UserRepository;
 import com.almang.inventory.vendor.domain.Vendor;
@@ -11,6 +14,8 @@
 import com.almang.inventory.vendor.repository.VendorRepository;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.PageRequest;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 
@@ -57,6 +62,22 @@ public VendorResponse getVendorDetail(Long vendorId, Long userId) {
         return VendorResponse.from(vendor);
     }
 
+    @Transactional(readOnly = true)
+    public PageResponse<VendorResponse> getVendorList(
+            Long userId, Integer page, Integer size, Boolean isActivate, String nameKeyword
+    ) {
+        User user = findUserById(userId);
+        Store store = user.getStore();
+
+        log.info("[VendorService] 발주처 목록 조회 요청 - userId: {}, storeId: {}", userId, store.getId());
+        PageRequest pageable = PaginationUtil.createPageRequest(page, size, "name");
+        Page<Vendor> vendorPage = findVendorsByFilter(store.getId(), isActivate, nameKeyword, pageable);
+        Page<VendorResponse> mapped = vendorPage.map(VendorResponse::from);
+
+        log.info("[VendorService] 발주처 목록 조회 성공 - userId: {}, storeId: {}", userId, store.getId());
+        return PageResponse.from(mapped);
+    }
+
     private Vendor toEntity(CreateVendorRequest request, User user) {
         return Vendor.builder()
                 .store(user.getStore())
@@ -83,4 +104,32 @@ private Vendor findVendorByIdAndValidateAccess(Long vendorId, User user) {
 
         return vendor;
     }
+
+    private Page<Vendor> findVendorsByFilter(
+            Long storeId, Boolean isActivate, String nameKeyword, PageRequest pageable
+    ) {
+        boolean hasName = nameKeyword != null && !nameKeyword.isBlank();
+
+        // 필터 없음
+        if (isActivate == null && !hasName) {
+            return vendorRepository.findAllByStoreId(storeId, pageable);
+        }
+
+        // 활성 여부
+        if (isActivate != null && !hasName) {
+            return vendorRepository.findAllByStoreIdAndActivatedTrue(storeId, pageable);
+        }
+
+        // 이름 검색
+        if (isActivate == null) {
+            return vendorRepository.findAllByStoreIdAndNameContainingIgnoreCase(
+                    storeId, nameKeyword, pageable
+            );
+        }
+
+        // 활성 여부 + 이름 검색
+        return vendorRepository.findAllByStoreIdAndActivatedTrueAndNameContainingIgnoreCase(
+                storeId, nameKeyword, pageable
+        );
+    }
 }

src/test/java/com/almang/inventory/vendor/controller/VendorControllerTest.java

@@ -9,6 +9,7 @@
 import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
 import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
 
+import com.almang.inventory.global.api.PageResponse;
 import com.almang.inventory.global.api.SuccessMessage;
 import com.almang.inventory.global.config.TestSecurityConfig;
 import com.almang.inventory.global.exception.BaseException;
@@ -289,4 +290,97 @@ private UsernamePasswordAuthenticationToken auth() {
                 .andExpect(jsonPath("$.message").value(ErrorCode.VENDOR_NOT_FOUND.getMessage()))
                 .andExpect(jsonPath("$.data").doesNotExist());
     }
+
+    @Test
+    void 발주처_목록_조회에_성공한다() throws Exception {
+        // given
+        PageResponse<VendorResponse> response = new PageResponse<>(
+                List.of(
+                        new VendorResponse(1L, "테스트1", VendorChannel.KAKAO, "010-1111-1111", "메모1", true, 1L),
+                        new VendorResponse(2L, "테스트2", VendorChannel.EMAIL, "010-2222-2222", "메모2", true, 1L)
+                ),
+                1,
+                20,
+                2,
+                1,
+                true
+        );
+
+        when(vendorService.getVendorList(anyLong(), any(), any(), any(), any()))
+                .thenReturn(response);
+
+        // when & then
+        mockMvc.perform(get("/api/v1/vendor")
+                        .with(authentication(auth()))
+                        .contentType(MediaType.APPLICATION_JSON))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.status").value(200))
+                .andExpect(jsonPath("$.message")
+                        .value(SuccessMessage.GET_VENDOR_LIST_SUCCESS.getMessage()))
+                .andExpect(jsonPath("$.data.content").isArray())
+                .andExpect(jsonPath("$.data.content.length()").value(2))
+                .andExpect(jsonPath("$.data.page").value(1))
+                .andExpect(jsonPath("$.data.totalElements").value(2));
+    }
+
+    @Test
+    void 발주처_목록_조회_시_활성_필터가_적용된다() throws Exception {
+        // given
+        PageResponse<VendorResponse> response = new PageResponse<>(
+                List.of(
+                        new VendorResponse(1L, "활성 발주처", VendorChannel.KAKAO, "010-3333-3333", "메모", true, 1L)
+                ),
+                1,
+                20,
+                1,
+                1,
+                true
+        );
+
+        when(vendorService.getVendorList(anyLong(), any(), any(), any(), any()))
+                .thenReturn(response);
+
+        // when & then
+        mockMvc.perform(get("/api/v1/vendor")
+                        .with(authentication(auth()))
+                        .param("isActivate", "true")
+                        .contentType(MediaType.APPLICATION_JSON))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.status").value(200))
+                .andExpect(jsonPath("$.message")
+                        .value(SuccessMessage.GET_VENDOR_LIST_SUCCESS.getMessage()))
+                .andExpect(jsonPath("$.data.content.length()").value(1))
+                .andExpect(jsonPath("$.data.content[0].activated").value(true))
+                .andExpect(jsonPath("$.data.content[0].name").value("활성 발주처"));
+    }
+
+    @Test
+    void 발주처_목록_조회_시_이름검색_필터가_적용된다() throws Exception {
+        // given
+        PageResponse<VendorResponse> response = new PageResponse<>(
+                List.of(
+                        new VendorResponse(1L, "사과 공장", VendorChannel.KAKAO, "010-4444-4444", "메모", true, 1L)
+                ),
+                1,
+                20,
+                1,
+                1,
+                true
+        );
+
+        when(vendorService.getVendorList(anyLong(), any(), any(), any(), any()))
+                .thenReturn(response);
+
+        // when & then
+        mockMvc.perform(get("/api/v1/vendor")
+                        .with(authentication(auth()))
+                        .param("name", "사과")
+                        .contentType(MediaType.APPLICATION_JSON))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.status").value(200))
+                .andExpect(jsonPath("$.message")
+                        .value(SuccessMessage.GET_VENDOR_LIST_SUCCESS.getMessage()))
+                .andExpect(jsonPath("$.data.content.length()").value(1))
+                .andExpect(jsonPath("$.data.content[0].name").value("사과 공장"));
+    }
 }