[TB-23] 영수증 카테고리 비율 조회 API 구현 (#27)

baekjaehyuk · web-flow · commit a86e52cfc55e · 2025-05-03T04:13:47.000+09:00
diff --git a/src/main/java/com/ClubAccount_BE/core/config/SecurityConfig.java b/src/main/java/com/ClubAccount_BE/core/config/SecurityConfig.java
@@ -49,6 +49,7 @@ public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
                                 API_V1_PREFIX + "/auth/reset-password",
                                 API_V1_PREFIX + "/{link}/receipts",
                                 API_V1_PREFIX + "/{link}/receipts/{receiptId}",
+                                API_V1_PREFIX + "/{link}/receipts/category",
                                 "/api-docs",
                                 "/swagger-custom-ui.html",
                                 "/v3/api-docs",
diff --git a/src/main/java/com/ClubAccount_BE/receipt/adapter/in/web/CreateReceiptController.java b/src/main/java/com/ClubAccount_BE/receipt/adapter/in/web/CreateReceiptController.java
@@ -3,7 +3,6 @@
 import com.ClubAccount_BE.core.meta.LoginUser;
 import com.ClubAccount_BE.receipt.adapter.in.web.api.CreateReceiptApi;
 import com.ClubAccount_BE.receipt.adapter.in.web.dto.request.ReceiptRequest;
-import com.ClubAccount_BE.receipt.adapter.in.web.dto.response.ReceiptCreateResponse;
 import com.ClubAccount_BE.receipt.application.port.in.CreateReceiptUseCase;
 import com.ClubAccount_BE.user.domain.User;
 import jakarta.validation.Valid;
@@ -22,7 +21,7 @@ public class CreateReceiptController implements CreateReceiptApi {
     private final CreateReceiptUseCase createReceiptUseCase;
 
     @PostMapping("/create")
-    public ReceiptCreateResponse createReceipt(
+    public Long createReceipt(
             @LoginUser User user,
             @RequestPart(value = "image", required = false) MultipartFile image,
             @Valid @RequestPart(value = "request") ReceiptRequest receiptRequest
diff --git a/src/main/java/com/ClubAccount_BE/receipt/adapter/in/web/FindReceiptController.java b/src/main/java/com/ClubAccount_BE/receipt/adapter/in/web/FindReceiptController.java
@@ -2,6 +2,7 @@
 
 import com.ClubAccount_BE.core.response.PagingResponse;
 import com.ClubAccount_BE.receipt.adapter.in.web.api.FindReceiptApi;
+import com.ClubAccount_BE.receipt.adapter.in.web.dto.response.ReceiptCategoryResponse;
 import com.ClubAccount_BE.receipt.adapter.in.web.dto.response.ReceiptDetailResponse;
 import com.ClubAccount_BE.receipt.adapter.in.web.dto.response.ReceiptResponse;
 import com.ClubAccount_BE.receipt.application.port.in.FindReceiptUseCase;
@@ -37,4 +38,11 @@ public ReceiptDetailResponse getReceipt(
     ) {
         return findReceiptUseCase.getReceipt(link, receiptId);
     }
+
+    @GetMapping("/{link}/receipts/category")
+    public ReceiptCategoryResponse getReceiptCategoryRatio(
+            @PathVariable(value = "link") UUID link
+    ) {
+        return findReceiptUseCase.getReceiptCategoryRatio(link);
+    }
 }
diff --git a/src/main/java/com/ClubAccount_BE/receipt/adapter/in/web/api/CreateReceiptApi.java b/src/main/java/com/ClubAccount_BE/receipt/adapter/in/web/api/CreateReceiptApi.java
@@ -2,7 +2,6 @@
 
 import com.ClubAccount_BE.core.meta.LoginUser;
 import com.ClubAccount_BE.receipt.adapter.in.web.dto.request.ReceiptRequest;
-import com.ClubAccount_BE.receipt.adapter.in.web.dto.response.ReceiptCreateResponse;
 import com.ClubAccount_BE.user.domain.User;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
@@ -14,7 +13,7 @@
 public interface CreateReceiptApi {
 
     @Operation(summary = "영수증 등록", description = "파싱된 영수증 정보를 등록한다.")
-    ReceiptCreateResponse createReceipt(
+    Long createReceipt(
             @LoginUser User user,
             @RequestPart(value = "image", required = false) MultipartFile image,
             @Valid @RequestPart(value = "request") ReceiptRequest receiptRequest
diff --git a/src/main/java/com/ClubAccount_BE/receipt/adapter/in/web/api/FindReceiptApi.java b/src/main/java/com/ClubAccount_BE/receipt/adapter/in/web/api/FindReceiptApi.java
@@ -1,6 +1,7 @@
 package com.ClubAccount_BE.receipt.adapter.in.web.api;
 
 import com.ClubAccount_BE.core.response.PagingResponse;
+import com.ClubAccount_BE.receipt.adapter.in.web.dto.response.ReceiptCategoryResponse;
 import com.ClubAccount_BE.receipt.adapter.in.web.dto.response.ReceiptDetailResponse;
 import com.ClubAccount_BE.receipt.adapter.in.web.dto.response.ReceiptResponse;
 import io.swagger.v3.oas.annotations.Operation;
@@ -25,4 +26,9 @@ ReceiptDetailResponse getReceipt(
             @PathVariable(value = "link") UUID link,
             @PathVariable("receiptId") Long receiptId
     );
+
+    @Operation(summary = "영수증 카테고리 비율 조회", description = "등록된 영수증의 카테고리 비율을 조회한다.")
+    ReceiptCategoryResponse getReceiptCategoryRatio(
+            @PathVariable(value = "link") UUID link
+    );
 }
diff --git a/src/main/java/com/ClubAccount_BE/receipt/adapter/in/web/dto/response/ReceiptCategoryResponse.java b/src/main/java/com/ClubAccount_BE/receipt/adapter/in/web/dto/response/ReceiptCategoryResponse.java
@@ -0,0 +1,35 @@
+package com.ClubAccount_BE.receipt.adapter.in.web.dto.response;
+
+import com.ClubAccount_BE.receipt.domain.DetailCategoryResult;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Builder;
+
+@Builder
+public record ReceiptCategoryResponse(
+        @Schema(description = "회식비 비율")
+        float groupDiningRatio,
+
+        @Schema(description = "물품 구매비 비율")
+        float supplyPurchaseRatio,
+
+        @Schema(description = "정기 구독비 비율")
+        float subscriptionRatio,
+
+        @Schema(description = "대관비 비율")
+        float venueRentalRatio,
+
+        @Schema(description = "기타 비율")
+        float otherRatio
+) {
+
+    public static ReceiptCategoryResponse of(DetailCategoryResult result) {
+        return ReceiptCategoryResponse.builder()
+                .groupDiningRatio(result.getGroupDiningRatio())
+                .supplyPurchaseRatio(result.getSupplyPurchaseRatio())
+                .subscriptionRatio(result.getSubscriptionRatio())
+                .venueRentalRatio(result.getVenueRentalRatio())
+                .otherRatio(result.getOtherRatio())
+                .build();
+    }
+
+}
diff --git a/src/main/java/com/ClubAccount_BE/receipt/adapter/in/web/dto/response/ReceiptCreateResponse.java b/src/main/java/com/ClubAccount_BE/receipt/adapter/in/web/dto/response/ReceiptCreateResponse.java
diff --git a/src/main/java/com/ClubAccount_BE/receipt/adapter/out/ReceiptRepositoryAdapter.java b/src/main/java/com/ClubAccount_BE/receipt/adapter/out/ReceiptRepositoryAdapter.java
@@ -46,6 +46,15 @@ public Receipt getReceipt(User user, Long receiptId) {
                 .orElseThrow(() -> new IllegalArgumentException("Receipt not found"));
     }
 
+    @Override
+    public List<Receipt> getReceiptCategoryList(User user) {
+        return receiptRepository
+                .findAllByUserId(user.getId())
+                .stream()
+                .map(ReceiptMapper::toDomain)
+                .toList();
+    }
+
     @Override
     public Long updateReceipt(
             Long receiptId,
diff --git a/src/main/java/com/ClubAccount_BE/receipt/adapter/out/persistence/repository/ReceiptRepository.java b/src/main/java/com/ClubAccount_BE/receipt/adapter/out/persistence/repository/ReceiptRepository.java
@@ -1,6 +1,7 @@
 package com.ClubAccount_BE.receipt.adapter.out.persistence.repository;
 
 import com.ClubAccount_BE.receipt.adapter.out.persistence.entity.ReceiptEntity;
+import java.util.List;
 import java.util.Optional;
 import org.springframework.data.domain.Page;
 import org.springframework.data.domain.Pageable;
@@ -11,6 +12,8 @@ public interface ReceiptRepository extends JpaRepository<ReceiptEntity, Long> {
 
     Page<ReceiptEntity> findAllByUserId(Long id, Pageable pageable);
 
+    List<ReceiptEntity> findAllByUserId(Long id);
+
     @EntityGraph(attributePaths = "receiptItems")
     Optional<ReceiptEntity> findReceiptById(Long receiptId);
 }
diff --git a/src/main/java/com/ClubAccount_BE/receipt/application/port/in/CreateReceiptUseCase.java b/src/main/java/com/ClubAccount_BE/receipt/application/port/in/CreateReceiptUseCase.java
@@ -1,13 +1,12 @@
 package com.ClubAccount_BE.receipt.application.port.in;
 
 import com.ClubAccount_BE.receipt.adapter.in.web.dto.request.ReceiptRequest;
-import com.ClubAccount_BE.receipt.adapter.in.web.dto.response.ReceiptCreateResponse;
 import com.ClubAccount_BE.user.domain.User;
 import org.springframework.web.multipart.MultipartFile;
 
 public interface CreateReceiptUseCase {
 
-    ReceiptCreateResponse createReceipt(
+    Long createReceipt(
             User user,
             MultipartFile image,
             ReceiptRequest receiptRequest
diff --git a/src/main/java/com/ClubAccount_BE/receipt/application/port/in/FindReceiptUseCase.java b/src/main/java/com/ClubAccount_BE/receipt/application/port/in/FindReceiptUseCase.java
@@ -1,13 +1,16 @@
 package com.ClubAccount_BE.receipt.application.port.in;
 
 import com.ClubAccount_BE.core.response.PagingResponse;
+import com.ClubAccount_BE.receipt.adapter.in.web.dto.response.ReceiptCategoryResponse;
 import com.ClubAccount_BE.receipt.adapter.in.web.dto.response.ReceiptDetailResponse;
 import com.ClubAccount_BE.receipt.adapter.in.web.dto.response.ReceiptResponse;
 import java.util.UUID;
 import org.springframework.data.domain.Pageable;
 
 public interface FindReceiptUseCase {
 
+    ReceiptCategoryResponse getReceiptCategoryRatio(UUID link);
+
     PagingResponse<ReceiptResponse> getReceiptList(UUID link, Pageable pageable);
 
     ReceiptDetailResponse getReceipt(UUID link, Long receiptId);
diff --git a/src/main/java/com/ClubAccount_BE/receipt/application/port/out/FindReceiptPort.java b/src/main/java/com/ClubAccount_BE/receipt/application/port/out/FindReceiptPort.java
@@ -2,12 +2,15 @@
 
 import com.ClubAccount_BE.receipt.domain.Receipt;
 import com.ClubAccount_BE.user.domain.User;
+import java.util.List;
 import org.springframework.data.domain.Page;
 import org.springframework.data.domain.Pageable;
 
 public interface FindReceiptPort {
 
     Page<Receipt> getReceiptList(User user, Pageable pageable);
 
+    List<Receipt> getReceiptCategoryList(User user);
+
     Receipt getReceipt(User user, Long receiptId);
 }
diff --git a/src/main/java/com/ClubAccount_BE/receipt/application/service/CreateReceiptService.java b/src/main/java/com/ClubAccount_BE/receipt/application/service/CreateReceiptService.java
@@ -3,7 +3,6 @@
 import static com.ClubAccount_BE.core.constant.CommonConstant.DEFAULT_IMAGE;
 
 import com.ClubAccount_BE.receipt.adapter.in.web.dto.request.ReceiptRequest;
-import com.ClubAccount_BE.receipt.adapter.in.web.dto.response.ReceiptCreateResponse;
 import com.ClubAccount_BE.receipt.application.port.in.CreateReceiptUseCase;
 import com.ClubAccount_BE.receipt.application.port.out.CreateReceiptPort;
 import com.ClubAccount_BE.receipt.application.port.out.UploadReceiptPort;
@@ -27,7 +26,7 @@ public class CreateReceiptService implements CreateReceiptUseCase {
     private final ReceiptItemEditor receiptItemEditor;
 
     @Override
-    public ReceiptCreateResponse createReceipt(
+    public Long createReceipt(
             User user,
             MultipartFile image,
             ReceiptRequest receiptRequest
@@ -44,7 +43,6 @@ public ReceiptCreateResponse createReceipt(
         );
 
         List<ReceiptItem> receiptItems = receiptItemEditor.toReceiptItems(receiptRequest, receipt);
-        Long receiptId = createReceiptPort.createReceipt(receipt, receiptItems);
-        return ReceiptCreateResponse.of(receiptId, receipt);
+        return createReceiptPort.createReceipt(receipt, receiptItems);
     }
 }
diff --git a/src/main/java/com/ClubAccount_BE/receipt/application/service/FindReceiptService.java b/src/main/java/com/ClubAccount_BE/receipt/application/service/FindReceiptService.java
@@ -1,13 +1,17 @@
 package com.ClubAccount_BE.receipt.application.service;
 
 import com.ClubAccount_BE.core.response.PagingResponse;
+import com.ClubAccount_BE.receipt.adapter.in.web.dto.response.ReceiptCategoryResponse;
 import com.ClubAccount_BE.receipt.adapter.in.web.dto.response.ReceiptDetailResponse;
 import com.ClubAccount_BE.receipt.adapter.in.web.dto.response.ReceiptResponse;
 import com.ClubAccount_BE.receipt.application.port.in.FindReceiptUseCase;
 import com.ClubAccount_BE.receipt.application.port.out.FindReceiptPort;
+import com.ClubAccount_BE.receipt.domain.DetailCategoryResult;
 import com.ClubAccount_BE.receipt.domain.Receipt;
+import com.ClubAccount_BE.receipt.domain.service.ReceiptEditor;
 import com.ClubAccount_BE.user.application.port.out.FindUserPort;
 import com.ClubAccount_BE.user.domain.User;
+import java.util.List;
 import java.util.UUID;
 import lombok.RequiredArgsConstructor;
 import org.springframework.data.domain.Page;
@@ -22,7 +26,17 @@ public class FindReceiptService implements FindReceiptUseCase {
 
     private final FindReceiptPort findReceiptPort;
     private final FindUserPort findUserPort;
+    private final ReceiptEditor receiptEditor;
 
+    @Override
+    public ReceiptDetailResponse getReceipt(UUID link, Long receiptId) {
+
+        User user = findUserPort.getUserByLink(link);
+        Receipt receipt = findReceiptPort.getReceipt(user, receiptId);
+        return ReceiptDetailResponse.of(receipt);
+    }
+
+    
     @Override
     public PagingResponse<ReceiptResponse> getReceiptList(UUID link, Pageable pageable) {
 
@@ -35,10 +49,11 @@ public PagingResponse<ReceiptResponse> getReceiptList(UUID link, Pageable pageab
     }
 
     @Override
-    public ReceiptDetailResponse getReceipt(UUID link, Long receiptId) {
+    public ReceiptCategoryResponse getReceiptCategoryRatio(UUID link) {
 
         User user = findUserPort.getUserByLink(link);
-        Receipt receipt = findReceiptPort.getReceipt(user, receiptId);
-        return ReceiptDetailResponse.of(receipt);
+        List<Receipt> receiptList = findReceiptPort.getReceiptCategoryList(user);
+        DetailCategoryResult result = receiptEditor.calculateCategoryRatio(receiptList);
+        return ReceiptCategoryResponse.of(result);
     }
 }
diff --git a/src/main/java/com/ClubAccount_BE/receipt/domain/DetailCategoryResult.java b/src/main/java/com/ClubAccount_BE/receipt/domain/DetailCategoryResult.java
@@ -0,0 +1,45 @@
+package com.ClubAccount_BE.receipt.domain;
+
+import lombok.Builder;
+import lombok.Getter;
+
+@Getter
+public class DetailCategoryResult {
+
+    private final float groupDiningRatio;
+    private final float supplyPurchaseRatio;
+    private final float subscriptionRatio;
+    private final float venueRentalRatio;
+    private final float otherRatio;
+
+    @Builder
+    private DetailCategoryResult(
+            float groupDiningRatio,
+            float supplyPurchaseRatio,
+            float subscriptionRatio,
+            float venueRentalRatio,
+            float otherRatio
+    ) {
+        this.groupDiningRatio = groupDiningRatio;
+        this.supplyPurchaseRatio = supplyPurchaseRatio;
+        this.subscriptionRatio = subscriptionRatio;
+        this.venueRentalRatio = venueRentalRatio;
+        this.otherRatio = otherRatio;
+    }
+
+    public static DetailCategoryResult of(
+            float groupDiningRatio,
+            float supplyPurchaseRatio,
+            float subscriptionRatio,
+            float venueRentalRatio,
+            float otherRatio
+    ) {
+        return DetailCategoryResult.builder()
+                .groupDiningRatio(groupDiningRatio)
+                .supplyPurchaseRatio(supplyPurchaseRatio)
+                .subscriptionRatio(subscriptionRatio)
+                .venueRentalRatio(venueRentalRatio)
+                .otherRatio(otherRatio)
+                .build();
+    }
+}
diff --git a/src/main/java/com/ClubAccount_BE/receipt/domain/service/ReceiptEditor.java b/src/main/java/com/ClubAccount_BE/receipt/domain/service/ReceiptEditor.java
@@ -0,0 +1,39 @@
+package com.ClubAccount_BE.receipt.domain.service;
+
+import com.ClubAccount_BE.receipt.domain.DetailCategoryResult;
+import com.ClubAccount_BE.receipt.domain.Receipt;
+import com.ClubAccount_BE.receipt.domain.type.ReceiptCategory;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+import org.springframework.stereotype.Service;
+
+@Service
+public class ReceiptEditor {
+
+    /**
+     * 영수증 카테고리 비율 계산
+     */
+    public DetailCategoryResult calculateCategoryRatio(List<Receipt> receipts) {
+        int total = receipts.size();
+
+        if (total == 0) {
+            return DetailCategoryResult.of(0f, 0f, 0f, 0f, 0f);
+        }
+
+        Map<ReceiptCategory, Long> counts = receipts.stream()
+                .collect(Collectors.groupingBy(Receipt::getCategory, Collectors.counting()));
+
+        return DetailCategoryResult.of(
+                ratio(counts.get(ReceiptCategory.GROUP_DINING), total),
+                ratio(counts.get(ReceiptCategory.SUPPLY_PURCHASE), total),
+                ratio(counts.get(ReceiptCategory.SUBSCRIPTION), total),
+                ratio(counts.get(ReceiptCategory.VENUE_RENTAL), total),
+                ratio(counts.get(ReceiptCategory.OTHER), total)
+        );
+    }
+
+    private float ratio(Long count, int total) {
+        return count == null ? 0f : (count * 100f / total);
+    }
+}
