admin/src/Oms.Application/Dtos/Orders/OrderPayDtos.cs

using Oms.Application.Dtos.Marketing;

namespace Oms.Application.Dtos.Orders;

/// <summary>
/// 订单支付入参（支付时选券）。
/// </summary>
public class OrderPayInput : OrderActionInput
{
    /// <summary>
    /// 选用的优惠券实例 Id：null 沿用订单已绑定的券（不可用则不使用）；0 不使用券；大于 0 使用指定券。
    /// </summary>
    public int? CouponInstanceId { get; set; }
}

/// <summary>
/// 订单支付预览入参。
/// </summary>
public class OrderPayPreviewInput
{
    /// <summary>
    /// 订单主键。
    /// </summary>
    public int Id { get; set; }

    /// <summary>
    /// 试算用券：null 自动推荐（优先已绑定券，否则选优惠最大且优于会员折的券）；0 不使用券；大于 0 使用指定券。
    /// </summary>
    public int? CouponInstanceId { get; set; }
}

/// <summary>
/// 订单支付预览：应付拆解与可选券。
/// </summary>
public class OrderPayPreviewOutput
{
    /// <summary>
    /// 订单主键。
    /// </summary>
    public int Id { get; set; }

    /// <summary>
    /// 应收小计（折前）。
    /// </summary>
    public decimal ReceivableSubtotal { get; set; }

    /// <summary>
    /// 基础运费（券门槛与抵扣口径）。
    /// </summary>
    public decimal BaseFreightAmount { get; set; }

    /// <summary>
    /// 会员折扣金额（与券互斥，用券时为 0）。
    /// </summary>
    public decimal LevelDiscountAmount { get; set; }

    /// <summary>
    /// 优惠券抵扣金额。
    /// </summary>
    public decimal CouponDiscountAmount { get; set; }

    /// <summary>
    /// 实际应付金额（支付扣款金额）。
    /// </summary>
    public decimal PayableAmount { get; set; }

    /// <summary>
    /// 会员等级名称。
    /// </summary>
    public string? MemberLevelName { get; set; }

    /// <summary>
    /// 本次试算实际生效的券实例 Id；为空表示未用券。
    /// </summary>
    public int? AppliedCouponInstanceId { get; set; }

    /// <summary>
    /// 当前客户可选券（CanUse=false 时附不可用原因，含「优惠不高于会员折扣」）。
    /// </summary>
    public List<CouponAvailableOutput> AvailableCoupons { get; set; } = [];
}