admin/src/Oms.Application/Dtos/Customers/CustomerPaginatedOutput.cs

using Oms.Domain.CustomersAggregate.Enums;

namespace Oms.Application.Dtos.Customers;

/// <summary>
/// 客户分页列表项出参。
/// </summary>
public class CustomerPaginatedOutput
{
    /// <summary>
    /// 主键。
    /// </summary>
    public int Id { get; set; }

    /// <summary>
    /// 父客户ID，空表示主客户。
    /// </summary>
    public int? ParentCustomerId { get; set; }

    /// <summary>
    /// 关联用户编号。
    /// </summary>
    public int UserId { get; set; }

    /// <summary>
    /// 客户编码。
    /// </summary>
    public string CustomerCode { get; set; } = string.Empty;

    /// <summary>
    /// 客户名称。
    /// </summary>
    public string CustomerName { get; set; } = string.Empty;

    /// <summary>
    /// WechatAvatar。
    /// </summary>
    public string? WechatAvatar { get; set; }

    /// <summary>
    /// WechatNickname。
    /// </summary>
    public string? WechatNickname { get; set; }

    /// <summary>
    /// 邮箱。
    /// </summary>
    public string? Email { get; set; }

    /// <summary>
    /// 手机号。
    /// </summary>
    public string Phone { get; set; } = string.Empty;

    /// <summary>
    /// 余额。
    /// </summary>
    public decimal Balance { get; set; }

    /// <summary>
    /// 总额度。
    /// </summary>
    public decimal TotalQuota { get; set; }

    /// <summary>
    /// 已用额度。
    /// </summary>
    public decimal UsedQuota { get; set; }

    /// <summary>
    /// 状态。
    /// </summary>
    public CustomerStatus Status { get; set; }

    /// <summary>
    /// 备注。
    /// </summary>
    public string? Remark { get; set; }

    /// <summary>
    /// 销售人员（遗留字段，管理端已改用 AgentId）。
    /// </summary>
    public string? Salesman { get; set; }

    /// <summary>
    /// 所属顾问。
    /// </summary>
    public string? CustomerService { get; set; }

    /// <summary>绑定渠道代理 Id。</summary>
    public int? AgentId { get; set; }

    /// <summary>绑定代理编号。</summary>
    public string? AgentCode { get; set; }

    /// <summary>绑定代理名称。</summary>
    public string? AgentName { get; set; }

    /// <summary>
    /// 客户分组。
    /// </summary>
    public CustomerGroup? CustomerGroup { get; set; }

    /// <summary>
    /// 会员等级 Id。
    /// </summary>
    public int? MemberLevelId { get; set; }

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

    /// <summary>
    /// 价区键。
    /// </summary>
    public string? PriceTierKey { get; set; }

    /// <summary>
    /// 最后登录 IP。
    /// </summary>
    public string? LastLoginIp { get; set; }

    /// <summary>
    /// 最后登录时间。
    /// </summary>
    public DateTime? LastLoginTime { get; set; }

    /// <summary>
    /// 创建时间。
    /// </summary>
    public DateTime CreateTime { get; set; }

    /// <summary>
    /// 创建人（展示名称）。
    /// </summary>
    public string? CreateBy { get; set; }

    /// <summary>
    /// 更新时间。
    /// </summary>
    public DateTime? UpdateTime { get; set; }

    /// <summary>
    /// 更新人（展示名称）。
    /// </summary>
    public string? UpdateBy { get; set; }
}