develop

src/main/java/com/process/clash/adapter/persistence/shop/product/ProductJpaEntity.java

@@ -65,4 +65,7 @@ public class ProductJpaEntity {
 
     @Column(nullable = false)
     private Boolean isSeasonal;
+
+    @Column(nullable = false, columnDefinition = "BOOLEAN DEFAULT TRUE")
+    private Boolean isAblePurchase;
 }

src/main/java/com/process/clash/adapter/persistence/shop/product/ProductJpaMapper.java

@@ -26,7 +26,8 @@ public ProductJpaEntity toJpaEntity(Product product) {
                 product.description(),
                 product.popularity(),
                 product.season() != null ? seasonJpaMapper.toJpaEntity(product.season()) : null,
-                product.isSeasonal()
+                product.isSeasonal(),
+                product.isAblePurchase()
         );
     }
 
@@ -48,7 +49,8 @@ public Product toDomain(ProductJpaEntity productJpaEntity) {
                 productJpaEntity.getDescription(),
                 productJpaEntity.getPopularity(),
                 season,
-                productJpaEntity.getIsSeasonal()
+                productJpaEntity.getIsSeasonal(),
+                productJpaEntity.getIsAblePurchase()
         );
     }
 }

src/main/java/com/process/clash/adapter/web/shop/product/docs/controller/ProductAdminControllerDocument.java

@@ -53,7 +53,8 @@ com.process.clash.adapter.web.common.ApiResponse<CreateProductDto.Response> crea
                                       "price": 12000,
                                       "discount": 10,
                                       "description": "프로세스 삼겹살 헌터",
-                                      "seasonId": 1
+                                      "seasonId": 1,
+                                      "isAblePurchase": true
                                     }
                                     """)
                     ))
@@ -91,7 +92,8 @@ com.process.clash.adapter.web.common.ApiResponse<UpdateProductDto.Response> upda
                                       "price": 15000,
                                       "discount": 15,
                                       "description": "리마스터 버전입니다.",
-                                      "seasonId": null
+                                      "seasonId": null,
+                                      "isAblePurchase": false
                                     }
                                     """)
                     ))

src/main/java/com/process/clash/adapter/web/shop/product/docs/request/CreateProductRequestDocument.java

@@ -29,4 +29,7 @@ public class CreateProductRequestDocument {
 
     @Schema(description = "시즌 ID (시즌 상품이 아닌 경우 null)")
     public Long seasonId;
+
+    @Schema(description = "구매 가능 여부 (기본값: true)", defaultValue = "true")
+    public Boolean isAblePurchase;
 }

src/main/java/com/process/clash/adapter/web/shop/product/docs/request/UpdateProductRequestDocument.java

@@ -29,4 +29,7 @@ public class UpdateProductRequestDocument {
 
     @Schema(description = "시즌 ID (시즌 상품이 아닌 경우 null)")
     public Long seasonId;
+
+    @Schema(description = "구매 가능 여부 (null이면 기존 값 유지)")
+    public Boolean isAblePurchase;
 }

src/main/java/com/process/clash/adapter/web/shop/product/dto/CommonProductDto.java

@@ -15,6 +15,7 @@ public record CommonProductDto(
         Long popularity,
         String seasonName,
         Boolean isSeasonal,
+        Boolean isAblePurchase,
         Boolean isBought,
         Instant createdAt
 ) {
@@ -31,6 +32,7 @@ public static CommonProductDto from(ProductVo product) {
                 product.popularity(),
                 product.seasonName(),
                 product.isSeasonal(),
+                product.isAblePurchase(),
                 product.isBought(),
                 product.createdAt()
         );

src/main/java/com/process/clash/adapter/web/shop/product/dto/CreateProductDto.java

@@ -28,7 +28,8 @@ public record Request(
             @Max(value = 100, message = "할인율은 100 이하여야 합니다.")
             Integer discount,
             String description,
-            Long seasonId  // 시즌 상품이 아니면 null
+            Long seasonId,  // 시즌 상품이 아니면 null
+            Boolean isAblePurchase
     ) {
         public CreateProductData.Command toCommand(Actor actor) {
             return new CreateProductData.Command(
@@ -40,7 +41,8 @@ public CreateProductData.Command toCommand(Actor actor) {
                     price,
                     discount,
                     description,
-                    seasonId
+                    seasonId,
+                    isAblePurchase
             );
         }
     }

src/main/java/com/process/clash/adapter/web/shop/product/dto/UpdateProductDto.java

@@ -27,7 +27,8 @@ public record Request(
             @Max(value = 100, message = "할인율은 100 이하여야 합니다.")
             Integer discount,
             String description,
-            Long seasonId
+            Long seasonId,
+            Boolean isAblePurchase
     ) {
         public UpdateProductData.Command toCommand(Long productId, Actor actor) {
             return new UpdateProductData.Command(
@@ -40,7 +41,8 @@ public UpdateProductData.Command toCommand(Long productId, Actor actor) {
                     price,
                     discount,
                     description,
-                    seasonId
+                    seasonId,
+                    isAblePurchase
             );
         }
     }

src/main/java/com/process/clash/application/shop/product/data/CreateProductData.java

@@ -14,7 +14,8 @@ public record Command(
             Long price,
             Integer discount,
             String description,
-            Long seasonId
+            Long seasonId,
+            Boolean isAblePurchase
     ) {}
 
     public record Result(

src/main/java/com/process/clash/application/shop/product/data/UpdateProductData.java

@@ -17,7 +17,8 @@ public record Command(
             Long price,
             Integer discount,
             String description,
-            Long seasonId
+            Long seasonId,
+            Boolean isAblePurchase
     ) {}
 
     public record Result(

src/main/java/com/process/clash/application/shop/product/exception/exception/badrequest/NotAblePurchaseException.java

@@ -0,0 +1,10 @@
+package com.process.clash.application.shop.product.exception.exception.badrequest;
+
+import com.process.clash.application.common.exception.exception.BadRequestException;
+import com.process.clash.application.shop.product.exception.status.ProductStatusCode;
+
+public class NotAblePurchaseException extends BadRequestException {
+    public NotAblePurchaseException() {
+        super(ProductStatusCode.NOT_ABLE_PURCHASE);
+    }
+}

src/main/java/com/process/clash/application/shop/product/exception/status/ProductStatusCode.java

@@ -13,6 +13,7 @@ public enum ProductStatusCode implements StatusCode {
     INVALID_TITLE("INVALID_TITLE", "상품 제목은 필수입니다.", HttpStatus.BAD_REQUEST),
     INVALID_PRICE("INVALID_PRICE", "가격은 0 이상이어야 합니다.", HttpStatus.BAD_REQUEST),
     INVALID_DISCOUNT("INVALID_DISCOUNT", "할인율은 0~100 사이여야 합니다.", HttpStatus.BAD_REQUEST),
+    NOT_ABLE_PURCHASE("NOT_ABLE_PURCHASE", "구매할 수 없는 상품입니다.", HttpStatus.BAD_REQUEST),
     ;
 
     private final String code;

src/main/java/com/process/clash/application/shop/product/service/CreateProductService.java

@@ -39,7 +39,8 @@ public CreateProductData.Result execute(CreateProductData.Command command) {
                 command.price(),
                 command.discount(),
                 command.description(),
-                season
+                season,
+                command.isAblePurchase()
         );
 
         Product savedProduct = productRepositoryPort.save(product);

src/main/java/com/process/clash/application/shop/product/service/UpdateProductService.java

@@ -43,7 +43,8 @@ public UpdateProductData.Result execute(UpdateProductData.Command command) {
                 command.price(),
                 command.discount(),
                 command.description(),
-                season
+                season,
+                command.isAblePurchase()
         );
 
         Product savedProduct = productRepositoryPort.save(updatedProduct);

src/main/java/com/process/clash/application/shop/product/vo/ProductVo.java

@@ -16,6 +16,7 @@ public record ProductVo(
         Long popularity,
         String seasonName,
         Boolean isSeasonal,
+        Boolean isAblePurchase,
         Boolean isBought,
         Instant createdAt
 ) {
@@ -38,6 +39,7 @@ public static ProductVo from(Product domain, boolean isBought) {
                 domain.popularity(),
                 seasonName,
                 domain.isSeasonal(),
+                domain.isAblePurchase(),
                 isBought,
                 domain.createdAt()
         );

src/main/java/com/process/clash/application/shop/purchase/service/CreatePurchaseService.java

@@ -6,6 +6,7 @@
 import com.process.clash.application.shop.purchase.exception.exception.badrequest.PriceTooLargeException;
 import com.process.clash.application.shop.purchase.port.in.CreatePurchaseUseCase;
 import com.process.clash.application.shop.purchase.port.out.PurchaseRepositoryPort;
+import com.process.clash.application.shop.product.exception.exception.badrequest.NotAblePurchaseException;
 import com.process.clash.application.shop.product.exception.exception.notfound.ProductNotFoundException;
 import com.process.clash.application.shop.product.port.out.ProductRepositoryPort;
 import com.process.clash.application.user.user.exception.exception.notfound.UserNotFoundException;
@@ -39,6 +40,10 @@ public CreatePurchaseData.Result execute(CreatePurchaseData.Command command) {
         Product product = productRepositoryPort.findById(command.productId())
                 .orElseThrow(ProductNotFoundException::new);
 
+        if (!product.isAblePurchase()) {
+            throw new NotAblePurchaseException();
+        }
+
         Long userId = command.actor().id();
 
         if (userItemRepositoryPort.existsByUserIdAndProductId(userId, product.id())) {

src/main/java/com/process/clash/domain/shop/product/entity/Product.java

@@ -20,7 +20,8 @@ public record Product(
         String description,
         Long popularity,
         Season season,
-        Boolean isSeasonal
+        Boolean isSeasonal,
+        Boolean isAblePurchase
 ) {
     public Product {
         if (title == null || title.isBlank()) {
@@ -42,7 +43,8 @@ public static Product create(
             Long price,
             Integer discount,
             String description,
-            Season season
+            Season season,
+            Boolean isAblePurchase
     ) {
         return new Product(
                 null,
@@ -57,7 +59,8 @@ public static Product create(
                 description,
                 0L,
                 season,
-                season != null
+                season != null,
+                isAblePurchase != null ? isAblePurchase : true
         );
     }
 
@@ -69,7 +72,8 @@ public Product update(
             Long price,
             Integer discount,
             String description,
-            Season season
+            Season season,
+            Boolean isAblePurchase
     ) {
         return new Product(
                 this.id,
@@ -84,7 +88,8 @@ public Product update(
                 description,
                 this.popularity,
                 season,
-                season != null
+                season != null,
+                isAblePurchase != null ? isAblePurchase : this.isAblePurchase
         );
     }
 
@@ -103,7 +108,8 @@ public Product increasePopularity() {
                 this.description,
                 nextPopularity,
                 this.season,
-                this.isSeasonal
+                this.isSeasonal,
+                this.isAblePurchase
         );
     }
 }

src/main/resources/db/migration/V41__add_is_able_purchase_to_products.sql

@@ -0,0 +1,5 @@
+ALTER TABLE products
+    ADD COLUMN is_able_purchase BOOLEAN NOT NULL DEFAULT TRUE;
+
+UPDATE products
+SET is_able_purchase = TRUE;

src/test/java/com/process/clash/adapter/web/shop/product/controller/ProductAdminControllerTest.java

@@ -77,7 +77,8 @@ void createProduct_returnsCreatedResponse() throws Exception {
                                   "price": 12000,
                                   "discount": 10,
                                   "description": "설명",
-                                  "seasonId": 1
+                                  "seasonId": 1,
+                                  "isAblePurchase": true
                                 }
                                 """))
                 .andExpect(status().isCreated())
@@ -87,6 +88,7 @@ void createProduct_returnsCreatedResponse() throws Exception {
         ArgumentCaptor<CreateProductData.Command> captor = ArgumentCaptor.forClass(CreateProductData.Command.class);
         verify(createProductUseCase).execute(captor.capture());
         org.assertj.core.api.Assertions.assertThat(captor.getValue().seasonId()).isEqualTo(1L);
+        org.assertj.core.api.Assertions.assertThat(captor.getValue().isAblePurchase()).isTrue();
     }
 
     @Test
@@ -97,14 +99,17 @@ void updateProduct_returnsSuccessResponse() throws Exception {
 
         mockMvc.perform(put("/api/admin/shop/products/100")
                         .contentType(MediaType.APPLICATION_JSON)
-                        .content(objectMapper.writeValueAsString(java.util.Map.of(
-                                "title", "수정 상품",
-                                "category", "BANNER",
-                                "image", "https://cdn.example.com/products/100-v2.png",
-                                "price", 15000,
-                                "discount", 15,
-                                "description", "수정 설명"
-                        ))))
+                        .content("""
+                                {
+                                  "title": "수정 상품",
+                                  "category": "BANNER",
+                                  "image": "https://cdn.example.com/products/100-v2.png",
+                                  "price": 15000,
+                                  "discount": 15,
+                                  "description": "수정 설명",
+                                  "isAblePurchase": false
+                                }
+                                """))
                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.message").value("상품 수정에 성공했습니다."))
                 .andExpect(jsonPath("$.data.productId").value(100));
@@ -113,6 +118,32 @@ void updateProduct_returnsSuccessResponse() throws Exception {
         verify(updateProductUseCase).execute(captor.capture());
         org.assertj.core.api.Assertions.assertThat(captor.getValue().productId()).isEqualTo(100L);
         org.assertj.core.api.Assertions.assertThat(captor.getValue().title()).isEqualTo("수정 상품");
+        org.assertj.core.api.Assertions.assertThat(captor.getValue().isAblePurchase()).isFalse();
+    }
+
+    @Test
+    @DisplayName("POST /api/admin/shop/products isAblePurchase 미입력 시 Command에 null로 전달된다")
+    void createProduct_withoutIsAblePurchase_passesNullToCommand() throws Exception {
+        when(createProductUseCase.execute(any()))
+                .thenReturn(new CreateProductData.Result(101L));
+
+        mockMvc.perform(post("/api/admin/shop/products")
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .content("""
+                                {
+                                  "title": "신규 상품",
+                                  "category": "NAMEPLATE",
+                                  "image": "https://cdn.example.com/products/101.png",
+                                  "price": 10000,
+                                  "discount": 0,
+                                  "description": "설명"
+                                }
+                                """))
+                .andExpect(status().isCreated());
+
+        ArgumentCaptor<CreateProductData.Command> captor = ArgumentCaptor.forClass(CreateProductData.Command.class);
+        verify(createProductUseCase).execute(captor.capture());
+        org.assertj.core.api.Assertions.assertThat(captor.getValue().isAblePurchase()).isNull();
     }
 
     @Test

src/test/java/com/process/clash/application/profile/service/EquipMyItemServiceTest.java

@@ -147,7 +147,8 @@ private Product product(Long id, ProductCategory category) {
                 "desc",
                 0L,
                 null,
-                false
+                false,
+                true
         );
     }
 }

src/test/java/com/process/clash/application/profile/service/GetMyItemsServiceTest.java

@@ -81,7 +81,8 @@ private Product product(Long id, ProductCategory category) {
                 "desc",
                 0L,
                 null,
-                false
+                false,
+                true
         );
     }
 }

src/test/java/com/process/clash/application/profile/service/UnequipMyItemServiceTest.java

@@ -78,7 +78,8 @@ private Product product(Long id, ProductCategory category) {
                 "desc",
                 0L,
                 null,
-                false
+                false,
+                true
         );
     }
 }