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

namespace Oms.Application.Dtos.Orders;

using Oms.Application.Dtos.Marketing;

/// <summary>
/// 订单运费试算结果出参。
/// </summary>
public class OrderPriceCheckOutput
{
    /// <summary>
    /// 主键。
    /// </summary>
    public int Id { get; set; }

    /// <summary>
    /// 运输方式。
    /// </summary>
    public string ShippingMethod { get; set; } = string.Empty;

    /// <summary>
    /// 货物类型编码（字典 cargo_attribute）。
    /// </summary>
    public string? CargoType { get; set; }

    /// <summary>
    /// 货物类型名称（展示用）。
    /// </summary>
    public string? CargoTypeName { get; set; }

    /// <summary>
    /// 仓库主键。
    /// </summary>
    public int? WarehouseId { get; set; }

    /// <summary>
    /// 仓库名称。
    /// </summary>
    public string? Warehouse { get; set; }

    /// <summary>
    /// 派送时效。
    /// </summary>
    public string DeliveryTime { get; set; } = string.Empty;

    /// <summary>
    /// 贸易条款：DDP / DDU。
    /// </summary>
    public string? TradeTerms { get; set; }

    /// <summary>
    /// 销售产品分组编码（字典 sales_product_group）。
    /// </summary>
    public string? ProductGroup { get; set; }

    /// <summary>
    /// 销售产品分组名称（展示用）。
    /// </summary>
    public string? ProductGroupName { get; set; }

    /// <summary>
    /// 产品说明（线路简要说明，对客展示）。
    /// </summary>
    public string? ProductDescription { get; set; }

    /// <summary>
    /// 体积重量。
    /// </summary>
    public decimal? VolumetricWeight { get; set; }

    /// <summary>
    /// 计费重量。
    /// </summary>
    public decimal? ChargeableWeight { get; set; }

    /// <summary>
    /// 成本公式。
    /// </summary>
    public string CostFormula { get; set; } = string.Empty;

    /// <summary>
    /// 运费。
    /// </summary>
    public decimal Freight { get; set; }

    /// <summary>
    /// 其他费用。
    /// </summary>
    public decimal OtherFees { get; set; }

    /// <summary>
    /// 非运费明细（操作费等，含名称与金额）。
    /// </summary>
    public List<OrderPriceCheckFeeOutput> OtherFeeList { get; set; } = [];

    /// <summary>
    /// 总成本。
    /// </summary>
    public decimal TotalCost { get; set; }

    /// <summary>
    /// 最大派送天数。
    /// </summary>
    public int? MaxDeliveryDays { get; set; }

    /// <summary>
    /// 总成本数值。
    /// </summary>
    public decimal TotalCostNum { get; set; }

    /// <summary>
    /// 产品编码。
    /// </summary>
    public string? ProductCode { get; set; }

    /// <summary>
    /// 绑定的规则快照版本。
    /// </summary>
    public string? RulesVersion { get; set; }

    /// <summary>
    /// 绑定的价格快照版本。
    /// </summary>
    public string? PriceVersion { get; set; }

    /// <summary>
    /// 是否偏远。
    /// </summary>
    public bool IsRemote { get; set; }

    /// <summary>
    /// 报价精度：exact / estimated。
    /// </summary>
    public string QuoteLevel { get; set; } = PriceCheckQuoteLevelCodes.Exact;

    /// <summary>
    /// 本行报价涉及的缺失条件编码。
    /// </summary>
    public List<string> MissingFieldCodes { get; set; } = [];

    /// <summary>
    /// 本行对客提示（如未填邮编、未填尺寸等）。
    /// </summary>
    public List<string> Disclaimers { get; set; } = [];

    /// <summary>
    /// 命中的价格分区名称/键（展示用）。
    /// </summary>
    public string? ZoneName { get; set; }

    /// <summary>
    /// 营销叠加计费明细。
    /// </summary>
    public MarketingPriceBreakdown? PriceBreakdown { get; set; }
}