[Feature] 카카오 Gift Biz 기프티콘 발송 및 팅 거래 기록 추가

manabom/src/main/java/mannabom_server/manabom/application/admin/dto/request/AdminConfigureGifticonTokenRequest.java

@@ -0,0 +1,19 @@
+package mannabom_server.manabom.application.admin.dto.request;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor
+public class AdminConfigureGifticonTokenRequest {
+
+    @NotBlank(message = "templateToken은 필수입니다.")
+    @Size(max = 512, message = "templateToken은 512자를 초과할 수 없습니다.")
+    private String templateToken;
+
+    @NotBlank(message = "reason은 필수입니다.")
+    @Size(max = 500, message = "reason은 500자를 초과할 수 없습니다.")
+    private String reason;
+}

manabom/src/main/java/mannabom_server/manabom/application/admin/dto/request/AdminGifticonPaymentActionRequest.java

@@ -0,0 +1,11 @@
+package mannabom_server.manabom.application.admin.dto.request;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+
+public record AdminGifticonPaymentActionRequest(
+        @NotBlank(message = "reason은 필수입니다.")
+        @Size(max = 500, message = "reason은 500자를 초과할 수 없습니다.")
+        String reason
+) {
+}

manabom/src/main/java/mannabom_server/manabom/application/admin/dto/request/AdminUpdatePolicyRequest.java

@@ -4,13 +4,15 @@
 import lombok.Getter;
 import lombok.NoArgsConstructor;
 
+import java.math.BigDecimal;
+
 @Getter
 @NoArgsConstructor
 public class AdminUpdatePolicyRequest {
     @NotBlank(message = "key는 필수입니다.")
     private String key;
 
-    private Integer value;
+    private BigDecimal value;
 
     private boolean resetToDefault;
 

manabom/src/main/java/mannabom_server/manabom/application/admin/dto/response/AdminGifticonPaymentPageResponse.java

@@ -0,0 +1,12 @@
+package mannabom_server.manabom.application.admin.dto.response;
+
+import java.util.List;
+
+public record AdminGifticonPaymentPageResponse(
+        List<AdminGifticonPaymentResponse> contents,
+        long totalCount,
+        int totalPages,
+        int page,
+        int size
+) {
+}

manabom/src/main/java/mannabom_server/manabom/application/admin/dto/response/AdminGifticonPaymentResponse.java

@@ -0,0 +1,45 @@
+package mannabom_server.manabom.application.admin.dto.response;
+
+import mannabom_server.manabom.domain.gifticon.enums.GifticonMessageCreationStatus;
+import mannabom_server.manabom.domain.gifticon.enums.GifticonPaymentStatus;
+import mannabom_server.manabom.domain.messageRequest.enums.MessageRequestStatus;
+
+import java.time.Instant;
+import java.util.List;
+
+public record AdminGifticonPaymentResponse(
+        Long gifticonPaymentId,
+        String orderId,
+        String maskedPaymentKey,
+        Long userId,
+        Long targetProfileId,
+        Long gifticonProductId,
+        String productName,
+        int amount,
+        GifticonPaymentStatus paymentStatus,
+        String paymentStatusDescription,
+        GifticonMessageCreationStatus messageCreationStatus,
+        String messageCreationStatusDescription,
+        int messageCreationAttemptCount,
+        Instant lastMessageCreationAttemptAt,
+        String messageCreationFailureReason,
+        Long messageRequestId,
+        MessageRequestStatus messageRequestStatus,
+        int refundAttemptCount,
+        Instant lastRefundAttemptAt,
+        String paymentFailureReason,
+        Instant approvedAt,
+        Instant refundedAt,
+        Instant createdAt,
+        Instant updatedAt,
+        List<AttentionReason> attentionReasons,
+        String tossPaymentStatus,
+        Boolean tossStatusMismatch,
+        String tossVerificationError
+) {
+    public record AttentionReason(
+            String code,
+            String description
+    ) {
+    }
+}

manabom/src/main/java/mannabom_server/manabom/application/admin/dto/response/AdminGifticonProductResponse.java

@@ -0,0 +1,35 @@
+package mannabom_server.manabom.application.admin.dto.response;
+
+import mannabom_server.manabom.domain.gifticon.entity.GifticonProduct;
+
+import java.time.Instant;
+
+public record AdminGifticonProductResponse(
+        Long gifticonProductId,
+        String templateTraceId,
+        String templateName,
+        String productName,
+        String brandName,
+        String productThumbnailImageUrl,
+        int productPrice,
+        int salePrice,
+        boolean available,
+        boolean templateTokenConfigured,
+        Instant lastSyncedAt
+) {
+    public static AdminGifticonProductResponse from(GifticonProduct product) {
+        return new AdminGifticonProductResponse(
+                product.getGifticonProductId(),
+                String.valueOf(product.getTemplateTraceId()),
+                product.getTemplateName(),
+                product.getProductName(),
+                product.getBrandName(),
+                product.getProductThumbnailImageUrl(),
+                product.getProductPrice(),
+                product.getSalePrice(),
+                product.isAvailable(),
+                product.hasTemplateToken(),
+                product.getLastSyncedAt()
+        );
+    }
+}

manabom/src/main/java/mannabom_server/manabom/application/admin/dto/response/AdminGifticonProductSliceResponse.java

@@ -0,0 +1,10 @@
+package mannabom_server.manabom.application.admin.dto.response;
+
+import java.util.List;
+
+public record AdminGifticonProductSliceResponse(
+        List<AdminGifticonProductResponse> contents,
+        Long nextCursor,
+        boolean hasNext
+) {
+}

manabom/src/main/java/mannabom_server/manabom/application/admin/dto/response/AdminGifticonSyncResponse.java

@@ -0,0 +1,9 @@
+package mannabom_server.manabom.application.admin.dto.response;
+
+import java.time.Instant;
+
+public record AdminGifticonSyncResponse(
+        int synchronizedCount,
+        Instant synchronizedAt
+) {
+}

manabom/src/main/java/mannabom_server/manabom/application/admin/enums/GifticonPaymentAttentionReason.java

@@ -0,0 +1,21 @@
+package mannabom_server.manabom.application.admin.enums;
+
+public enum GifticonPaymentAttentionReason {
+    REFUND_FAILED("환불 요청이 실패하여 운영자 확인이 필요합니다."),
+    REFUND_PROCESSING_STALE("환불 처리가 제한 시간을 넘겨 멈춰 있습니다."),
+    REFUND_ATTEMPTS_EXHAUSTED("자동 환불 최대 시도 횟수를 소진했습니다."),
+    MESSAGE_CREATION_STALE("결제 후 메시지가 장시간 생성되지 않았습니다."),
+    MESSAGE_CREATION_FAILED_WITHOUT_REFUND("메시지 생성이 실패했지만 환불이 시작되지 않았습니다."),
+    PAID_WITHOUT_MESSAGE("결제는 완료됐지만 연결된 메시지 요청이 없습니다."),
+    TOSS_STATUS_MISMATCH("애플리케이션 결제 상태와 토스 결제 상태가 일치하지 않습니다.");
+
+    private final String description;
+
+    GifticonPaymentAttentionReason(String description) {
+        this.description = description;
+    }
+
+    public String getDescription() {
+        return description;
+    }
+}

manabom/src/main/java/mannabom_server/manabom/application/admin/service/AdminAuditService.java

@@ -99,7 +99,12 @@ private PageRequest pageRequest(int page, int size) {
     }
 
     private void requireAuditReadable(AdminPrincipal admin) {
-        if (admin.hasAnyRole(AdminRole.SUPER_ADMIN, AdminRole.OPERATOR, AdminRole.SUPPORT)) {
+        if (admin.hasAnyRole(
+                AdminRole.SUPER_ADMIN,
+                AdminRole.OPERATOR,
+                AdminRole.SUPPORT,
+                AdminRole.FINANCE
+        )) {
             return;
         }
         throw new SecurityException("감사 로그를 조회할 권한이 없습니다.");