develop -> main

src/main/java/in/koreatech/koin/admin/benefit/controller/AdminBenefitApi.java

@@ -12,7 +12,7 @@
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RequestParam;
 
-import in.koreatech.koin.admin.benefit.dto.AdminBenefitCategoryResponse;
+import in.koreatech.koin.admin.benefit.dto.AdminBenefitCategoriesResponse;
 import in.koreatech.koin.admin.benefit.dto.AdminBenefitShopsResponse;
 import in.koreatech.koin.admin.benefit.dto.AdminCreateBenefitCategoryRequest;
 import in.koreatech.koin.admin.benefit.dto.AdminCreateBenefitCategoryResponse;
@@ -21,6 +21,7 @@
 import in.koreatech.koin.admin.benefit.dto.AdminDeleteShopsRequest;
 import in.koreatech.koin.admin.benefit.dto.AdminModifyBenefitCategoryRequest;
 import in.koreatech.koin.admin.benefit.dto.AdminModifyBenefitCategoryResponse;
+import in.koreatech.koin.admin.benefit.dto.AdminModifyBenefitShopsRequest;
 import in.koreatech.koin.admin.benefit.dto.AdminSearchBenefitShopsResponse;
 import in.koreatech.koin.global.auth.Auth;
 import io.swagger.v3.oas.annotations.Operation;
@@ -44,7 +45,7 @@ public interface AdminBenefitApi {
     )
     @Operation(summary = "상점 혜택 카테고리를 모두 조회한다.")
     @GetMapping("/categories")
-    ResponseEntity<AdminBenefitCategoryResponse> getBenefitCategories(
+    ResponseEntity<AdminBenefitCategoriesResponse> getBenefitCategories(
         @Auth(permit = {ADMIN}) Integer adminId
     );
 
@@ -127,6 +128,22 @@ ResponseEntity<AdminCreateBenefitShopsResponse> createBenefitShops(
         @Auth(permit = {ADMIN}) Integer adminId
     );
 
+    @ApiResponses(
+        value = {
+            @ApiResponse(responseCode = "201"),
+            @ApiResponse(responseCode = "400", content = @Content(schema = @Schema(hidden = true))),
+            @ApiResponse(responseCode = "401", content = @Content(schema = @Schema(hidden = true))),
+            @ApiResponse(responseCode = "403", content = @Content(schema = @Schema(hidden = true))),
+            @ApiResponse(responseCode = "404", content = @Content(schema = @Schema(hidden = true))),
+        }
+    )
+    @Operation(summary = "특정 혜택을 제공하는 상점을 수정한다.")
+    @PutMapping
+    ResponseEntity<Void> modifyBenefitShops(
+        @RequestBody AdminModifyBenefitShopsRequest request,
+        @Auth(permit = {ADMIN}) Integer adminId
+    );
+
     @ApiResponses(
         value = {
             @ApiResponse(responseCode = "204"),

src/main/java/in/koreatech/koin/admin/benefit/controller/AdminBenefitController.java

@@ -14,7 +14,7 @@
 import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
-import in.koreatech.koin.admin.benefit.dto.AdminBenefitCategoryResponse;
+import in.koreatech.koin.admin.benefit.dto.AdminBenefitCategoriesResponse;
 import in.koreatech.koin.admin.benefit.dto.AdminBenefitShopsResponse;
 import in.koreatech.koin.admin.benefit.dto.AdminCreateBenefitCategoryRequest;
 import in.koreatech.koin.admin.benefit.dto.AdminCreateBenefitCategoryResponse;
@@ -23,6 +23,7 @@
 import in.koreatech.koin.admin.benefit.dto.AdminDeleteShopsRequest;
 import in.koreatech.koin.admin.benefit.dto.AdminModifyBenefitCategoryRequest;
 import in.koreatech.koin.admin.benefit.dto.AdminModifyBenefitCategoryResponse;
+import in.koreatech.koin.admin.benefit.dto.AdminModifyBenefitShopsRequest;
 import in.koreatech.koin.admin.benefit.dto.AdminSearchBenefitShopsResponse;
 import in.koreatech.koin.admin.benefit.service.AdminBenefitService;
 import in.koreatech.koin.global.auth.Auth;
@@ -36,10 +37,10 @@ public class AdminBenefitController implements AdminBenefitApi {
     private final AdminBenefitService adminBenefitService;
 
     @GetMapping("/categories")
-    public ResponseEntity<AdminBenefitCategoryResponse> getBenefitCategories(
+    public ResponseEntity<AdminBenefitCategoriesResponse> getBenefitCategories(
         @Auth(permit = {ADMIN}) Integer adminId
     ) {
-        AdminBenefitCategoryResponse response = adminBenefitService.getBenefitCategories();
+        AdminBenefitCategoriesResponse response = adminBenefitService.getBenefitCategories();
         return ResponseEntity.ok(response);
     }
 
@@ -90,6 +91,15 @@ public ResponseEntity<AdminCreateBenefitShopsResponse> createBenefitShops(
         return ResponseEntity.status(HttpStatus.CREATED).body(response);
     }
 
+    @PutMapping
+    public ResponseEntity<Void> modifyBenefitShops(
+        @RequestBody AdminModifyBenefitShopsRequest request,
+        @Auth(permit = {ADMIN}) Integer adminId
+    ) {
+        adminBenefitService.modifyBenefitShops(request);
+        return ResponseEntity.ok().build();
+    }
+
     @DeleteMapping("/{id}/shops")
     public ResponseEntity<Void> deleteBenefitShops(
         @PathVariable("id") Integer benefitId,

src/main/java/in/koreatech/koin/admin/benefit/dto/AdminBenefitCategoryResponse.java → src/main/java/in/koreatech/koin/admin/benefit/dto/AdminBenefitCategoriesResponse.java

@@ -9,13 +9,13 @@
 import io.swagger.v3.oas.annotations.media.Schema;
 
 @JsonNaming(SnakeCaseStrategy.class)
-public record AdminBenefitCategoryResponse(
+public record AdminBenefitCategoriesResponse(
     @Schema(description = "혜택 카테고리 리스트")
     List<InnerBenefitResponse> benefits
 ) {
 
-    public static AdminBenefitCategoryResponse from(List<BenefitCategory> benefitCategories) {
-        return new AdminBenefitCategoryResponse(
+    public static AdminBenefitCategoriesResponse from(List<BenefitCategory> benefitCategories) {
+        return new AdminBenefitCategoriesResponse(
             benefitCategories.stream().map(InnerBenefitResponse::from).toList()
         );
     }

src/main/java/in/koreatech/koin/admin/benefit/dto/AdminBenefitShopsResponse.java

@@ -5,9 +5,11 @@
 import com.fasterxml.jackson.databind.PropertyNamingStrategies.SnakeCaseStrategy;
 import com.fasterxml.jackson.databind.annotation.JsonNaming;
 
+import in.koreatech.koin.domain.benefit.model.BenefitCategoryMap;
 import in.koreatech.koin.domain.shop.model.shop.Shop;
 import io.swagger.v3.oas.annotations.media.Schema;
 
+@JsonNaming(SnakeCaseStrategy.class)
 public record AdminBenefitShopsResponse(
     @Schema(example = "3", description = "상점 개수")
     Integer count,
@@ -16,27 +18,36 @@ public record AdminBenefitShopsResponse(
     List<InnerShopResponse> shops
 ) {
 
-    public static AdminBenefitShopsResponse from(List<Shop> shops) {
+    public static AdminBenefitShopsResponse from(List<BenefitCategoryMap> benefitCategoryMaps) {
         return new AdminBenefitShopsResponse(
-            shops.size(),
-            shops.stream()
+            benefitCategoryMaps.size(),
+            benefitCategoryMaps.stream()
                 .map(InnerShopResponse::from)
                 .toList()
         );
     }
 
+    @JsonNaming(SnakeCaseStrategy.class)
     private record InnerShopResponse(
+        @Schema(example = "1", description = "상점혜택 매핑id")
+        Integer shopBenefitMapId,
+
         @Schema(example = "1", description = "고유 id")
         Integer id,
 
         @Schema(example = "수신반점", description = "이름")
-        String name
+        String name,
+
+        @Schema(example = "4인 이상 픽업서비스", description = "혜택 미리보기 문구")
+        String detail
     ) {
 
-        public static InnerShopResponse from(Shop shop) {
+        public static InnerShopResponse from(BenefitCategoryMap benefitCategoryMap) {
             return new InnerShopResponse(
-                shop.getId(),
-                shop.getName()
+                benefitCategoryMap.getId(),
+                benefitCategoryMap.getShop().getId(),
+                benefitCategoryMap.getShop().getName(),
+                benefitCategoryMap.getDetail()
             );
         }
     }

src/main/java/in/koreatech/koin/admin/benefit/dto/AdminCreateBenefitShopsRequest.java

@@ -9,14 +9,27 @@
 
 import in.koreatech.koin.global.validation.NotBlankElement;
 import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
 import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
 
 @JsonNaming(SnakeCaseStrategy.class)
 public record AdminCreateBenefitShopsRequest(
-    @Schema(description = "상점 ID 리스트", example = "[1, 2, 5]", requiredMode = REQUIRED)
-    @NotNull(message = "상점 ID 리스트는 필수입니다.")
-    @NotBlankElement(message = "상점 ID 리스트는 빈 요소가 존재할 수 없습니다.")
-    List<Integer> shopIds
+    @NotNull(message = "상점정보 리스트는 필수입니다.")
+    @NotBlankElement(message = "상점정보 리스트는 빈 요소가 존재할 수 없습니다.")
+    List<InnerBenefitShopsRequest> shopDetails
 ) {
 
+    @JsonNaming(SnakeCaseStrategy.class)
+    public record InnerBenefitShopsRequest(
+        @Schema(description = "상점 고유 id", example = "2", requiredMode = REQUIRED)
+        @NotNull(message = "상점은 필수입니다.")
+        Integer shopId,
+
+        @Schema(description = "혜택 미리보기 문구", example = "4인 이상 픽업서비스", requiredMode = REQUIRED)
+        @NotBlank(message = "혜택 미리보기 문구는 필수입니다.")
+        @Size(min = 2, max = 15, message = "혜택 미리보기 문구는 최소 2자 최대 15자입니다.")
+        String detail
+    ) {
+    }
 }

src/main/java/in/koreatech/koin/admin/benefit/dto/AdminCreateBenefitShopsResponse.java

@@ -5,16 +5,19 @@
 import com.fasterxml.jackson.databind.PropertyNamingStrategies.SnakeCaseStrategy;
 import com.fasterxml.jackson.databind.annotation.JsonNaming;
 
+import in.koreatech.koin.domain.benefit.model.BenefitCategoryMap;
 import in.koreatech.koin.domain.shop.model.shop.Shop;
 import io.swagger.v3.oas.annotations.media.Schema;
 
 public record AdminCreateBenefitShopsResponse(
-    @Schema(description = "상점 리스트")
+    @Schema(description = "상점 정보")
     List<InnerShopResponse> shops
 ) {
-    public static AdminCreateBenefitShopsResponse from(List<Shop> shops) {
+    public static AdminCreateBenefitShopsResponse from(List<BenefitCategoryMap> benefitCategoryMaps) {
         return new AdminCreateBenefitShopsResponse(
-            shops.stream().map(InnerShopResponse::from).toList()
+            benefitCategoryMaps.stream()
+                .map(InnerShopResponse::from)
+                .toList()
         );
     }
 
@@ -23,13 +26,17 @@ private record InnerShopResponse(
         Integer id,
 
         @Schema(description = "상점 이름", example = "수신반점")
-        String name
+        String name,
+
+        @Schema(example = "4인 이상 픽업서비스", description = "혜택 미리보기 문구")
+        String detail
     ) {
 
-        public static InnerShopResponse from(Shop shop) {
+        public static InnerShopResponse from(BenefitCategoryMap benefitCategoryMap) {
             return new InnerShopResponse(
-                shop.getId(),
-                shop.getName()
+                benefitCategoryMap.getShop().getId(),
+                benefitCategoryMap.getShop().getName(),
+                benefitCategoryMap.getDetail()
             );
         }
     }

src/main/java/in/koreatech/koin/admin/benefit/dto/AdminModifyBenefitShopsRequest.java

@@ -0,0 +1,35 @@
+package in.koreatech.koin.admin.benefit.dto;
+
+import static com.fasterxml.jackson.databind.PropertyNamingStrategies.*;
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+
+import java.util.List;
+
+import com.fasterxml.jackson.databind.annotation.JsonNaming;
+
+import in.koreatech.koin.global.validation.NotBlankElement;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+
+@JsonNaming(SnakeCaseStrategy.class)
+public record AdminModifyBenefitShopsRequest(
+    @NotNull(message = "혜택문구 변경정보 리스트는 필수입니다.")
+    @NotBlankElement(message = "혜택문구 변경정보 리스트는 빈 요소가 존재할 수 없습니다.")
+    List<InnerBenefitShopsRequest> modifyDetails
+) {
+
+    @JsonNaming(SnakeCaseStrategy.class)
+    public record InnerBenefitShopsRequest(
+        @Schema(description = "상점혜택 매핑id", example = "2", requiredMode = REQUIRED)
+        @NotNull(message = "상점혜택 매핑id는 필수입니다.")
+        Integer shopBenefitMapId,
+
+        @Schema(description = "혜택 미리보기 문구", example = "4인 이상 픽업서비스", requiredMode = REQUIRED)
+        @NotBlank(message = "혜택 미리보기 문구는 필수입니다.")
+        @Size(min = 2, max = 15, message = "혜택 미리보기 문구는 최소 2자 최대 15자입니다.")
+        String detail
+    ) {
+    }
+}

src/main/java/in/koreatech/koin/admin/benefit/exception/BenefitMapNotFoundException.java

@@ -0,0 +1,20 @@
+package in.koreatech.koin.admin.benefit.exception;
+
+import in.koreatech.koin.global.exception.DataNotFoundException;
+
+public class BenefitMapNotFoundException extends DataNotFoundException {
+
+    private static final String DEFAULT_MESSAGE = "해당 혜택 카테고리에 존재하지 않는 입니다.";
+
+    public BenefitMapNotFoundException(String message) {
+        super(message);
+    }
+
+    public BenefitMapNotFoundException(String message, String detail) {
+        super(message, detail);
+    }
+
+    public static BenefitMapNotFoundException withDetail(String detail) {
+        return new BenefitMapNotFoundException(DEFAULT_MESSAGE, detail);
+    }
+}

src/main/java/in/koreatech/koin/admin/benefit/repository/AdminBenefitCategoryMapRepository.java

@@ -4,14 +4,14 @@
 
 import org.springframework.data.jpa.repository.Modifying;
 import org.springframework.data.jpa.repository.Query;
-import org.springframework.data.repository.Repository;
+import org.springframework.data.repository.CrudRepository;
 
 import in.koreatech.koin.domain.benefit.model.BenefitCategoryMap;
 import org.springframework.data.repository.query.Param;
 
-public interface AdminBenefitCategoryMapRepository extends Repository<BenefitCategoryMap, Integer> {
+public interface AdminBenefitCategoryMapRepository extends CrudRepository<BenefitCategoryMap, Integer> {
 
-    void save(BenefitCategoryMap benefitCategoryMap);
+    List<BenefitCategoryMap> findAllByIdIn(List<Integer> ids);
 
     @Query("""
         SELECT bcm 
@@ -22,6 +22,16 @@ public interface AdminBenefitCategoryMapRepository extends Repository<BenefitCat
         """)
     List<BenefitCategoryMap> findAllByBenefitCategoryIdOrderByShopName(@Param("benefitId") Integer benefitId);
 
+    @Query("""
+        SELECT bcm
+        FROM BenefitCategoryMap bcm
+        WHERE bcm.benefitCategory.id = :benefitId AND bcm.shop.id IN :shopIds
+    """)
+    List<BenefitCategoryMap> findAllByBenefitCategoryIdAndShopIds(
+        @Param("benefitId") Integer benefitId,
+        @Param("shopIds") List<Integer> shopIds
+    );
+
     @Modifying
     @Query("""
         DELETE FROM BenefitCategoryMap bcm