Feat/#141 예산 수정 - 네이버 광고 예산 수정 API 구현

src/main/java/com/whereyouad/WhereYouAd/domains/advertisement/domain/service/NaverAdApiService.java

@@ -1,5 +1,15 @@
 package com.whereyouad.WhereYouAd.domains.advertisement.domain.service;
 
+import com.whereyouad.WhereYouAd.domains.advertisement.persistence.entity.AdCampaign;
+import com.whereyouad.WhereYouAd.domains.advertisement.persistence.entity.AdGroup;
+import com.whereyouad.WhereYouAd.domains.advertisement.persistence.repository.AdCampaignRepository;
+import com.whereyouad.WhereYouAd.domains.advertisement.persistence.repository.AdGroupRepository;
+import com.whereyouad.WhereYouAd.domains.organization.domain.constant.OrgRole;
+import com.whereyouad.WhereYouAd.domains.organization.exception.handler.OrgHandler;
+import com.whereyouad.WhereYouAd.domains.organization.exception.code.OrgErrorCode;
+import com.whereyouad.WhereYouAd.domains.organization.persistence.entity.OrgMember;
+import com.whereyouad.WhereYouAd.domains.organization.persistence.repository.OrgMemberRepository;
+import com.whereyouad.WhereYouAd.domains.platform.persistence.entity.PlatformConnection;
 import com.whereyouad.WhereYouAd.domains.platform.persistence.repository.PlatformConnectionRepository;
 import com.whereyouad.WhereYouAd.global.utils.AdApiAuthUtil;
 import com.whereyouad.WhereYouAd.global.adapi.dto.AdAuthRequest;
@@ -25,8 +35,11 @@
 public class NaverAdApiService {
 
     private final PlatformConnectionRepository connectionRepository;
+    private final OrgMemberRepository orgMemberRepository;
     private final AdApiAuthUtil adApiAuthUtil;
     private final NaverClient naverClient;
+    private final AdGroupRepository adGroupRepository;
+    private final AdCampaignRepository adCampaignRepository;
 
     // 캠페인 목록 조회
     @Transactional(readOnly = true)
@@ -166,6 +179,94 @@ public NaverDTO.RawReportResponse downloadReport(Long connectionId, String downl
         }
     }
 
+    // 캠페인 예산 수정
+    @Transactional
+    public NaverDTO.CampaignResponse updateCampaignBudget(Long userId, Long connectionId, String campaignId, NaverDTO.UpdateCampaignBudgetRequest request) {
+        PlatformConnection connection = validateAdminOwnership(userId, connectionId);
+        if (request.dailyBudget() != null) {
+            if (request.dailyBudget() % 10 != 0) {
+                throw new AdvertisementHandler(NaverAdErrorCode.NAVER_INVALID_BUDGET_VALUE);
+            }
+            if (request.dailyBudget() < 50 || request.dailyBudget() > 1_000_000_000) {
+                throw new AdvertisementHandler(NaverAdErrorCode.NAVER_INVALID_BUDGET_RANGE);
+            }
+        }
+        try {
+            Map<String, String> headers = adApiAuthUtil.generateAuthHeaders(
+                    connectionId, AdAuthRequest.forMethodAndPath("PUT", "/ncc/campaigns/" + campaignId));
+            NaverDTO.UpdateCampaignBudgetBody body =
+                    new NaverDTO.UpdateCampaignBudgetBody(campaignId, request.useDailyBudget(), request.dailyBudget());
+            NaverDTO.CampaignResponse result = naverClient.updateCampaignBudget(headers, campaignId, "budget", body);
+
+            adCampaignRepository
+                    .findByPlatformAccountAndExternalCampaignId(connection.getPlatformAccount(), campaignId)
+                    .ifPresent(campaign -> campaign.updateBudget(request.dailyBudget()));
+
+            return result;
+        } catch (Exception e) {
+            log.error("[NAVER] 캠페인 예산 수정 실패 - connectionId={}, campaignId={}", connectionId, campaignId, e);
+            throw new AdvertisementHandler(NaverAdErrorCode.NAVER_CAMPAIGN_BUDGET_UPDATE_FAILED);
+        }
+    }
+
+    // 광고그룹 예산 수정
+    @Transactional
+    public NaverDTO.AdGroupResponse updateAdGroupBudget(Long userId, Long connectionId, String adgroupId, NaverDTO.UpdateAdGroupBudgetRequest request) {
+        PlatformConnection connection = validateAdminOwnership(userId, connectionId);
+        if (request.dailyBudget() != null) {
+            if (request.dailyBudget() % 10 != 0) {
+                throw new AdvertisementHandler(NaverAdErrorCode.NAVER_INVALID_BUDGET_VALUE);
+            }
+            if (request.dailyBudget() < 50 || request.dailyBudget() > 1_000_000_000) {
+                throw new AdvertisementHandler(NaverAdErrorCode.NAVER_INVALID_BUDGET_RANGE);
+            }
+        }
+        if (request.bidAmt() != null) {
+            if (request.bidAmt() % 10 != 0) {
+                throw new AdvertisementHandler(NaverAdErrorCode.NAVER_INVALID_BUDGET_VALUE);
+            }
+            if (request.bidAmt() < 70 || request.bidAmt() > 100_000) {
+                throw new AdvertisementHandler(NaverAdErrorCode.NAVER_INVALID_BID_AMOUNT_RANGE);
+            }
+        }
+        try {
+            Map<String, String> headers = adApiAuthUtil.generateAuthHeaders(
+                    connectionId, AdAuthRequest.forMethodAndPath("PUT", "/ncc/adgroups/" + adgroupId));
+            // 네이버 API 제약: budget과 bidAmt는 fields에 함께 넣어도 bidAmt가 무시됨 → 각각 별도 호출 필요
+            NaverDTO.AdGroupResponse result = null;
+            if (request.dailyBudget() != null || request.useDailyBudget() != null) {
+                result = naverClient.updateAdGroupBudget(headers, adgroupId, "budget",
+                        new NaverDTO.UpdateAdGroupBudgetBody(adgroupId, request.useDailyBudget(), request.dailyBudget(), null));
+            }
+            if (request.bidAmt() != null) {
+                result = naverClient.updateAdGroupBudget(headers, adgroupId, "bidAmt",
+                        new NaverDTO.UpdateAdGroupBudgetBody(adgroupId, null, null, request.bidAmt()));
+            }
+
+            adGroupRepository
+                    .findByAdCampaign_PlatformAccountAndExternalGroupId(connection.getPlatformAccount(), adgroupId)
+                    .ifPresent(adGroup -> adGroup.updateBudget(request.dailyBudget(), request.bidAmt()));
+
+            return result;
+        } catch (Exception e) {
+            log.error("[NAVER] 광고그룹 예산 수정 실패 - connectionId={}, adgroupId={}", connectionId, adgroupId, e);
+            throw new AdvertisementHandler(NaverAdErrorCode.NAVER_AD_GROUP_BUDGET_UPDATE_FAILED);
+        }
+    }
+
+    @Transactional(readOnly = true)
+    private PlatformConnection validateAdminOwnership(Long userId, Long connectionId) {
+        PlatformConnection connection = connectionRepository.findWithAccountAndOrgById(connectionId)
+                .orElseThrow(() -> new AdvertisementHandler(NaverAdErrorCode.NAVER_CONNECTION_NOT_FOUND));
+        Long orgId = connection.getPlatformAccount().getOrganization().getId();
+        OrgMember orgMember = orgMemberRepository.findByUserIdAndOrgId(userId, orgId)
+                .orElseThrow(() -> new OrgHandler(OrgErrorCode.ORG_MEMBER_NOT_FOUND));
+        if (orgMember.getRole() != OrgRole.ADMIN) {
+            throw new OrgHandler(OrgErrorCode.ORG_MEMBER_FORBIDDEN);
+        }
+        return connection;
+    }
+
     // 일별 기본 지표 조회 (/stats, 기본 일 단위)
     @Transactional(readOnly = true)
     public List<NaverDTO.StatResponse> getDailyStats(Long connectionId, String id, String since, String until) {

src/main/java/com/whereyouad/WhereYouAd/domains/advertisement/exception/code/NaverAdErrorCode.java

@@ -11,6 +11,12 @@ public enum NaverAdErrorCode implements BaseErrorCode {
 
     // 400
     NAVER_INVALID_DOWNLOAD_URL(HttpStatus.BAD_REQUEST, "NAVER_400_1", "유효하지 않은 다운로드 URL입니다."),
+    NAVER_INVALID_BUDGET_VALUE(HttpStatus.BAD_REQUEST, "NAVER_400_2", "예산 및 입찰가는 10원 단위로 입력해야 합니다."),
+    NAVER_INVALID_BUDGET_RANGE(HttpStatus.BAD_REQUEST, "NAVER_400_3", "예산은 50원 이상 1,000,000,000원 이하로 입력해야 합니다."),
+    NAVER_INVALID_BID_AMOUNT_RANGE(HttpStatus.BAD_REQUEST, "NAVER_400_4", "입찰가는 70원 이상 100,000원 이하로 입력해야 합니다."),
+
+    // 404
+    NAVER_CONNECTION_NOT_FOUND(HttpStatus.NOT_FOUND, "NAVER_404_1", "플랫폼 연결 정보를 찾을 수 없습니다."),
 
     // 500
     NAVER_CAMPAIGN_FETCH_FAILED(HttpStatus.INTERNAL_SERVER_ERROR, "NAVER_500_1", "네이버 캠페인 목록 조회에 실패했습니다."),
@@ -21,6 +27,8 @@ public enum NaverAdErrorCode implements BaseErrorCode {
     NAVER_REPORT_STATUS_CHECK_FAILED(HttpStatus.INTERNAL_SERVER_ERROR, "NAVER_500_6", "네이버 성과 보고서 상태 조회에 실패했습니다."),
     NAVER_REPORT_DOWNLOAD_FAILED(HttpStatus.INTERNAL_SERVER_ERROR, "NAVER_500_7", "네이버 성과 보고서 원문 다운로드에 실패했습니다."),
     NAVER_HOURLY_STAT_FETCH_FAILED(HttpStatus.INTERNAL_SERVER_ERROR, "NAVER_500_8", "네이버 시간대별 통계 조회에 실패했습니다."),
+    NAVER_CAMPAIGN_BUDGET_UPDATE_FAILED(HttpStatus.INTERNAL_SERVER_ERROR, "NAVER_500_9", "네이버 캠페인 예산 수정에 실패했습니다."),
+    NAVER_AD_GROUP_BUDGET_UPDATE_FAILED(HttpStatus.INTERNAL_SERVER_ERROR, "NAVER_500_10", "네이버 광고 그룹 예산 수정에 실패했습니다."),
     ;
 
     private final HttpStatus httpStatus;

src/main/java/com/whereyouad/WhereYouAd/domains/advertisement/persistence/entity/AdCampaign.java

@@ -94,4 +94,8 @@ public void update(String name, Status status, Long budget, Goal goal,
             this.description = description;
         }
     }
+
+    public void updateBudget(Long budget) {
+        this.budget = budget;
+    }
 }

src/main/java/com/whereyouad/WhereYouAd/domains/advertisement/persistence/entity/AdGroup.java

@@ -43,6 +43,12 @@ public class AdGroup extends BaseEntity {
     @OneToMany(mappedBy = "adGroup", cascade = CascadeType.ALL)
     private List<AdContent> adContents = new ArrayList<>();
 
+    @Column(name = "budget")
+    private Long budget;
+
+    @Column(name = "bid_amount")
+    private Long bidAmount;
+
     @ManyToOne(fetch = FetchType.LAZY)
     @JoinColumn(name = "ad_campaign_id")
     private AdCampaign adCampaign;
@@ -55,4 +61,9 @@ public void update(String name, Status status, String targetingInfo) {
             this.targetingInfo = targetingInfo;
         }
     }
+
+    public void updateBudget(Long budget, Long bidAmount) {
+        if (budget != null) this.budget = budget;
+        if (bidAmount != null) this.bidAmount = bidAmount;
+    }
 }

src/main/java/com/whereyouad/WhereYouAd/domains/advertisement/presentation/NaverAdApiController.java

@@ -10,6 +10,7 @@
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
 import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
@@ -139,4 +140,28 @@ public ResponseEntity<DataResponse<AdvertisementResponse.NaverStatSyncResponse>>
     ) {
         return ResponseEntity.ok(DataResponse.from(naverAdSyncService.syncConversionReports(connectionId, statDate)));
     }
+
+    // 캠페인 예산 수정
+    @PutMapping("/campaigns/{campaignId}/budget")
+    public ResponseEntity<DataResponse<NaverDTO.CampaignResponse>> updateCampaignBudget(
+            @AuthenticationPrincipal(expression = "userId") Long userId,
+            @PathVariable Long connectionId,
+            @PathVariable String campaignId,
+            @RequestBody NaverDTO.UpdateCampaignBudgetRequest request
+    ) {
+        return ResponseEntity.ok(DataResponse.from(
+                naverAdApiService.updateCampaignBudget(userId, connectionId, campaignId, request)));
+    }
+
+    // 광고그룹 예산 수정
+    @PutMapping("/adgroups/{adgroupId}/budget")
+    public ResponseEntity<DataResponse<NaverDTO.AdGroupResponse>> updateAdGroupBudget(
+            @AuthenticationPrincipal(expression = "userId") Long userId,
+            @PathVariable Long connectionId,
+            @PathVariable String adgroupId,
+            @RequestBody NaverDTO.UpdateAdGroupBudgetRequest request
+    ) {
+        return ResponseEntity.ok(DataResponse.from(
+                naverAdApiService.updateAdGroupBudget(userId, connectionId, adgroupId, request)));
+    }
 }