添加订单押金暂扣与归还

backend/internal/modules/dispute/arbitration.go

@@ -79,8 +79,10 @@ func (r *Repository) Arbitrate(ctx context.Context, adminID uint64, id uint64, r
 		if err := wallet.AppendEntries(tx, settlement.Entries...); err != nil {
 			return err
 		}
-		if settlement.RenterRefundAmountCent > 0 {
-			action, err := r.prepareRefund(&order, settlement.RenterRefundAmountCent, "arbitration_refund", "仲裁退款原路退还")
+		// 押金暂扣：若订单被暂扣，则把本次退款中的押金部分挂起不退，仅退还剩余部分。
+		refundAmountCent := order.ApplyDepositHold(settlement.RenterRefundAmountCent, settlement.RenterDepositRefundCent)
+		if refundAmountCent > 0 {
+			action, err := r.prepareRefund(&order, refundAmountCent, "arbitration_refund", "仲裁退款原路退还")
 			if err != nil {
 				return err
 			}
@@ -169,6 +171,7 @@ func (r *Repository) Arbitrate(ctx context.Context, adminID uint64, id uint64, r
 type arbitrationSettlement struct {
 	Entries                 []wallet.Entry
 	RenterRefundAmountCent  int64
+	RenterDepositRefundCent int64
 	OwnerIncomeAmountCent   int64
 	DepositDeductAmountCent int64
 }
@@ -223,15 +226,19 @@ func buildArbitrationSettlement(order model.RentalOrder, req ArbitrateRequest, r
 	switch req.Result {
 	case "full_refund":
 		addRenterRefund(totalCent, "仲裁全额退款")
+		settlement.RenterDepositRefundCent = depositAmountCent
 	case "partial_refund":
 		if req.AmountCent <= 0 || req.AmountCent > totalCent {
 			return settlement, ErrInvalidDispute
 		}
 		addRenterRefund(req.AmountCent, "仲裁部分退款")
+		// 部分退款为合并金额，无法精确拆分租金/押金，按押金优先归类以便暂扣。
+		settlement.RenterDepositRefundCent = money.MinCent(req.AmountCent, depositAmountCent)
 		addOwnerIncome(money.MinCent(totalCent-req.AmountCent, ownerRentAmountCent+depositAmountCent), "仲裁剩余金额结算给号主")
 	case "release_deposit":
 		addOwnerIncome(ownerRentAmountCent, "仲裁确认订单金额结算给号主")
 		addRenterRefund(depositAmountCent, "仲裁释放押金给租客")
+		settlement.RenterDepositRefundCent = depositAmountCent
 	case "deduct_deposit", "compensate_owner":
 		deductAmountCent := req.AmountCent
 		if deductAmountCent <= 0 {
@@ -243,6 +250,7 @@ func buildArbitrationSettlement(order model.RentalOrder, req ArbitrateRequest, r
 		settlement.DepositDeductAmountCent = deductAmountCent
 		addOwnerIncome(ownerRentAmountCent+deductAmountCent, "仲裁订单金额及押金赔付结算给号主")
 		addRenterRefund(depositAmountCent-deductAmountCent, "仲裁退回剩余押金给租客")
+		settlement.RenterDepositRefundCent = depositAmountCent - deductAmountCent
 	case "order_close":
 		// Only release frozen funds. No available-balance settlement happens in development mode.
 	case "mark_abnormal":