feat: 장부 생성 시 증빙자료, 영수증을 증빙자료로 통합한다.

Author: pott-101

src/main/java/com/moneymong/domain/ledger/api/LedgerControllerV2.java

@@ -2,8 +2,10 @@
 
 import com.moneymong.domain.ledger.api.request.*;
 import com.moneymong.domain.ledger.api.response.LedgerDetailInfoView;
+import com.moneymong.domain.ledger.api.response.LedgerDetailInfoViewV2;
 import com.moneymong.domain.ledger.api.response.ledger.LedgerInfoViewV2;
 import com.moneymong.domain.ledger.service.manager.LedgerDetailService;
+import com.moneymong.domain.ledger.service.manager.LedgerService;
 import com.moneymong.domain.ledger.service.reader.LedgerReader;
 import com.moneymong.global.security.token.dto.jwt.JwtAuthentication;
 import io.swagger.v3.oas.annotations.Operation;
@@ -19,9 +21,24 @@
 @RestController
 @RequiredArgsConstructor
 public class LedgerControllerV2 {
+    private final LedgerService ledgerService;
     private final LedgerReader ledgerReader;
     private final LedgerDetailService ledgerDetailService;
 
+    @Operation(summary = "장부 내역 등록 API V2")
+    @PostMapping("/{id}")
+    public LedgerDetailInfoViewV2 createLedger(
+            @AuthenticationPrincipal JwtAuthentication user,
+            @PathVariable("id") final Long ledgerId,
+            @RequestBody @Valid final CreateLedgerRequestV2 request
+    ) {
+        return ledgerService.createLedgerV2(
+                user.getId(),
+                ledgerId,
+                request
+        );
+    }
+
     @Operation(summary = " 장부 내역 조회 API")
     @GetMapping("/{id}")
     public LedgerInfoViewV2 search(

src/main/java/com/moneymong/domain/ledger/api/request/CreateLedgerRequestV2.java

@@ -0,0 +1,35 @@
+package com.moneymong.domain.ledger.api.request;
+
+import com.moneymong.domain.ledger.entity.enums.FundType;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+import java.time.ZonedDateTime;
+import java.util.List;
+
+@Getter
+@NoArgsConstructor
+@AllArgsConstructor
+public class CreateLedgerRequestV2 {
+    @NotBlank(message = "storeInfo를 입력해주세요.")
+    private String storeInfo;
+
+    @NotNull(message = "fundType(INCOME, EXPENSE)를 입력해주세요.")
+    private FundType fundType;
+
+    @NotNull(message = "amount를 입력해주세요.")
+    private Integer amount;
+
+    @NotBlank(message = "description를 입력해주세요.")
+    private String description;
+
+    @NotNull(message = "paymentDate를 입력해주세요.")
+    private ZonedDateTime paymentDate;
+
+    @Size(max = 12, message = "증빙 자료 12개 이하 입력해주세요.")
+    private List<String> documentImageUrls;
+}

src/main/java/com/moneymong/domain/ledger/api/response/LedgerDetailInfoViewV2.java

@@ -0,0 +1,50 @@
+package com.moneymong.domain.ledger.api.response;
+
+import com.moneymong.domain.ledger.entity.LedgerDetail;
+import com.moneymong.domain.ledger.entity.LedgerDocument;
+import com.moneymong.domain.ledger.entity.enums.FundType;
+import com.moneymong.domain.user.entity.User;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+
+import java.time.ZonedDateTime;
+import java.util.List;
+
+@Getter
+@Builder
+@AllArgsConstructor
+public class LedgerDetailInfoViewV2 {
+    private Long id;
+    private String storeInfo;
+    private Integer amount;
+    private FundType fundType;
+    private String description;
+    private ZonedDateTime paymentDate;
+    private List<LedgerDocumentInfoView> documentImageUrls;
+    private String authorName;
+
+    public static LedgerDetailInfoViewV2 of(
+            final LedgerDetail ledgerDetail,
+            final List<LedgerDocument> ledgerDocuments,
+            final User user
+    ) {
+        return LedgerDetailInfoViewV2
+                .builder()
+                .id(ledgerDetail.getId())
+                .storeInfo(ledgerDetail.getStoreInfo())
+                .amount(ledgerDetail.getAmount())
+                .fundType(ledgerDetail.getFundType())
+                .description(ledgerDetail.getDescription())
+                .paymentDate(ledgerDetail.getPaymentDate())
+                .documentImageUrls(
+                        ledgerDocuments
+                                .stream()
+                                .map(ledgerDocument -> LedgerDocumentInfoView.from(ledgerDocument.getId(),
+                                        ledgerDocument.getDocumentImageUrl()))
+                                .toList()
+                )
+                .authorName(user.getNickname())
+                .build();
+    }
+}

src/main/java/com/moneymong/domain/ledger/service/manager/LedgerService.java

@@ -4,8 +4,10 @@
 import com.moneymong.domain.agency.entity.enums.AgencyUserRole;
 import com.moneymong.domain.agency.repository.AgencyUserRepository;
 import com.moneymong.domain.ledger.api.request.CreateLedgerRequest;
+import com.moneymong.domain.ledger.api.request.CreateLedgerRequestV2;
 import com.moneymong.domain.ledger.api.request.UpdateLedgerRequest;
 import com.moneymong.domain.ledger.api.response.LedgerDetailInfoView;
+import com.moneymong.domain.ledger.api.response.LedgerDetailInfoViewV2;
 import com.moneymong.domain.ledger.entity.Ledger;
 import com.moneymong.domain.ledger.entity.LedgerDetail;
 import com.moneymong.domain.ledger.entity.LedgerDocument;
@@ -35,6 +37,53 @@ public class LedgerService {
     private final LedgerRepository ledgerRepository;
     private final LedgerDetailRepository ledgerDetailRepository;
 
+    @Transactional
+    public LedgerDetailInfoViewV2 createLedgerV2(
+            final Long userId,
+            final Long ledgerId,
+            final CreateLedgerRequestV2 request
+    ) {
+        // === 유저 ===
+        User user = getUser(userId);
+
+        Ledger ledger = getLedger(ledgerId);
+
+        // === 소속 ===
+        AgencyUser agencyUser = getAgencyUser(userId, ledger);
+
+        // === 권한 ===
+        validateStaffUserRole(agencyUser.getAgencyUserRole());
+
+        // 장부 내역 등록
+        LedgerDetail ledgerDetail = ledgerDetailService.createLedgerDetail(
+                ledger,
+                user,
+                request.getStoreInfo(),
+                request.getFundType(),
+                request.getAmount(),
+                ledger.getTotalBalance(),
+                request.getDescription(),
+                request.getPaymentDate()
+        );
+
+        // 장부 증빙 자료 등록
+        List<LedgerDocument> ledgerDocuments = List.of();
+        List<String> requestDocumentImageUrls = request.getDocumentImageUrls();
+
+        if (!requestDocumentImageUrls.isEmpty()) {
+            ledgerDocuments = ledgerDocumentManager.createLedgerDocuments(
+                    ledgerDetail.getId(),
+                    requestDocumentImageUrls
+            );
+        }
+
+        return LedgerDetailInfoViewV2.of(
+                ledgerDetail,
+                ledgerDocuments,
+                user
+        );
+    }
+
     @Transactional
     public LedgerDetailInfoView createLedger(
             final Long userId,