track/src/SJZY.Track.Application.Contract/Dtos/ProvideServices/UpsertTrackInput.cs

using System.ComponentModel.DataAnnotations;

namespace SJZY.Track.Application.Contract.Dtos.ProvideServices;

public class UpsertTrackInput : OrderNoInfo
{
    /// <summary>
    /// true新增，false更新
    /// </summary>
    public bool IsAdd { get; set; }

    /// <summary>
    /// 轨迹唯一标识(可选)
    /// </summary>
    public string? EsId { get; set; }

    /// <summary>
    /// 轨迹内容代码
    /// </summary>
    [Required]
    [MaxLength(50)]
    public string TrackCode { get; set; } = null!;

    /// <summary>
    /// 轨迹发生地
    /// </summary>
    [Required]
    [MaxLength(200)]
    public string TrackPlace { get; set; } = null!;

    /// <summary>
    /// 轨迹发生时间
    /// </summary>
    [Required]
    public DateTime TrackTime { get; set; }

    /// <summary>
    /// 新的轨迹发生时间
    /// 如果是新增，那么优先级高于TrackTime
    /// 如果要修改TrackTime，请同时传递TrackTime(旧的用于匹配),和NewTrackTime
    /// </summary>
    public DateTime? NewTrackTime { get; set; }

    /// <summary>
    /// 轨迹发生时区
    /// </summary>
    // [Required]
    // [Range(-12, 12)]
    public float? TrackTimeZone { get; set; }

    /// <summary>
    /// 客户是否可见
    /// </summary>
    [Obsolete("废弃的，请使用IsExternal")]
    public bool IsVisibility { get; set; }

    /// <summary>
    /// 是否对外(可选的)
    /// 如果未填则按照【轨迹内容】中的【是否可见】做为默认值
    /// </summary>
    public bool? IsExternal { get; set; }

    /// <summary>
    /// 数据来源：1外部服务商创建，2内部系统创建，3人工创建
    /// </summary>
    [Required]
    public int Source { get; set; }

    /// <summary>
    /// 轨迹备注
    /// </summary>
    public string? Remarks { get; set; }

    /// <summary>
    /// 附件集合
    /// </summary>
    public List<FileItemDto>? Files { get; set; }

    /// <summary>
    /// 轨迹内容，若为空则取轨迹内容表中该轨迹Code对应的轨迹内容
    /// </summary>
    public string? Content { get; set; }

    /// <summary>
    /// 轨迹内容英文，若为空则取轨迹内容表中该轨迹Code对应的轨迹英文内容
    /// </summary>
    public string? EnStatus { get; set; }

    /// <summary>
    /// 轨迹发生地（城市）
    /// </summary>
    public string? TrackPlaceCity { get; set; }

    /// <summary>
    /// 轨迹发生地（城市）Id
    /// </summary>
    public int? TrackPlaceCityId { get; set; }

    /// <summary>
    /// 轨迹发生地（省/州）
    /// </summary>
    public string? TrackPlaceProvince { get; set; }

    /// <summary>
    /// 轨迹发生地（省/州）Id
    /// </summary>
    public int? TrackPlaceProvinceId { get; set; }

    /// <summary>
    /// 轨迹发生地（国家/地区）
    /// </summary>
    public string? TrackPlaceNation { get; set; }

    /// <summary>
    /// 轨迹发生地（国家/地区）Id
    /// </summary>
    public int? TrackPlaceNationId { get; set; }

    /// <summary>
    /// 轨迹发生地邮编
    /// </summary>
    public string? TrackPlacePostcode { get; set; }

    /// <summary>
    /// 预计到达时间
    /// </summary>
    public DateTime? EstimatedDeliveryDate { get; set; }

    /// <summary>
    /// 目的地时区
    /// </summary>
    [Range(-12, 12)]
    public float? DestinationTimeZone { get; set; }

    /// <summary>
    /// 当前操作人
    /// </summary>
    public int OptionUserId { get; set; }

    /// <summary>
    /// 重复的情况下，用什么比较
    /// </summary>
    public string? CompareFields { get; set; }

    /// <summary>
    /// 扩展信息字段，用与轨迹推送的附加字段
    /// </summary>
    public string? Extra { get; set; }

    /// <summary>
    /// 新的扩展信息，
    /// 如果是新增，那么优先级高于Extra
    /// 如果要修改Extra，请同时传递Extra(用于匹配旧的)和NewExtra
    /// </summary>
    public string? NewExtra { get; set; }

    /// <summary>
    /// 是否强制推送
    /// </summary>
    public bool ForcedPush { get; set; }

    /// <summary>
    /// 指定是否推送
    /// </summary>
    public bool IsToMq { get; set; }
}