新增退款凭证

internal/service/refund/service.go

@@ -7,6 +7,7 @@ import (
 	"context"
 	"fmt"
 	"math/rand"
+	"strings"
 	"time"
 
 	"go.uber.org/zap"
@@ -99,6 +100,10 @@ func (s *Service) Create(ctx context.Context, req *dto.CreateRefundRequest) (*dt
 	if err := validateRequestedRefundAmountByOrder(req.RequestedRefundAmount, order); err != nil {
 		return nil, err
 	}
+	refundVoucherKey, err := normalizeRefundVoucherKey(req.RefundVoucherKey)
+	if err != nil {
+		return nil, err
+	}
 
 	// 检查是否存在活跃退款申请（待审批、已通过、已退回状态）
 	existing, err := s.refundStore.FindActiveByOrderID(ctx, req.OrderID)
@@ -126,6 +131,7 @@ func (s *Service) Create(ctx context.Context, req *dto.CreateRefundRequest) (*dt
 		ShopID:                shopID,
 		ActualReceivedAmount:  req.ActualReceivedAmount,
 		RequestedRefundAmount: req.RequestedRefundAmount,
+		RefundVoucherKey:      refundVoucherKey,
 		RefundReason:          req.RefundReason,
 		Status:                model.RefundStatusPending,
 	}
@@ -606,6 +612,14 @@ func (s *Service) Resubmit(ctx context.Context, id uint, req *dto.ResubmitRefund
 	if req.RequestedRefundAmount != nil {
 		requestedRefundAmount = *req.RequestedRefundAmount
 	}
+	refundVoucherKey := refund.RefundVoucherKey
+	if req.RefundVoucherKey != nil {
+		refundVoucherKey = *req.RefundVoucherKey
+	}
+	refundVoucherKey, err = normalizeRefundVoucherKey(refundVoucherKey)
+	if err != nil {
+		return err
+	}
 
 	order, err := s.orderStore.GetByID(ctx, refund.OrderID)
 	if err != nil {
@@ -627,6 +641,9 @@ func (s *Service) Resubmit(ctx context.Context, id uint, req *dto.ResubmitRefund
 	if req.RequestedRefundAmount != nil {
 		updates["requested_refund_amount"] = *req.RequestedRefundAmount
 	}
+	if req.RefundVoucherKey != nil {
+		updates["refund_voucher_key"] = refundVoucherKey
+	}
 	if req.RefundReason != nil {
 		updates["refund_reason"] = *req.RefundReason
 	}
@@ -892,6 +909,17 @@ func validateApprovedRefundAmount(approvedAmount int64, requestedRefundAmount in
 	return validateRequestedRefundAmountByOrder(approvedAmount, order)
 }
 
+func normalizeRefundVoucherKey(voucherKey string) (string, error) {
+	normalized := strings.TrimSpace(voucherKey)
+	if normalized == "" {
+		return "", errors.New(errors.CodeInvalidParam, "退款申请必须上传退款凭证")
+	}
+	if len(normalized) > 500 {
+		return "", errors.New(errors.CodeInvalidParam, "退款凭证长度不能超过500")
+	}
+	return normalized, nil
+}
+
 // buildRefundResponse 将退款 Model 转换为 DTO 响应
 func buildRefundResponse(r *model.RefundRequest) *dto.RefundResponse {
 	assetType := ""
@@ -916,6 +944,7 @@ func buildRefundResponse(r *model.RefundRequest) *dto.RefundResponse {
 		ActualReceivedAmount:  r.ActualReceivedAmount,
 		RequestedRefundAmount: r.RequestedRefundAmount,
 		ApprovedRefundAmount:  r.ApprovedRefundAmount,
+		RefundVoucherKey:      r.RefundVoucherKey,
 		RefundReason:          r.RefundReason,
 		Status:                r.Status,
 		StatusName:            constants.GetRefundStatusName(r.Status),