29WxOrder/OrderSupportTicket/Models/TicketClientOptions.cs

using AllBase;
using AllBase.Model.DBModel;
using System;
using System.Collections.Generic;
using System.Configuration;
using System.Globalization;
using System.Linq;

namespace OrderSupportTicket.Models;

/// <summary>
/// 工单页运行参数。APPID 与拍单账号由宿主程序注入，页面内不硬编码账号。
/// </summary>
public sealed class TicketClientOptions
{
    public TicketClientOptions()
    {
        AppIds = new List<string>();
        Orders = new List<TicketOrderOption>();
    }

    /// <summary>
    /// 当前拍单账号，对应接口字段 purchaseAccount。
    /// </summary>
    public string UserName { get; set; }

    /// <summary>
    /// 当前账号需要订阅和查询的店铺 APPID 集合，最多 50 个。
    /// </summary>
    public IList<string> AppIds { get; set; }

    /// <summary>
    /// 可关联到新工单的本地订单集合。
    /// </summary>
    public IList<TicketOrderOption> Orders { get; set; }

    /// <summary>
    /// 创建参数副本，避免宿主与页面共享可变集合。
    /// </summary>
    public TicketClientOptions Clone()
    {
        return new TicketClientOptions
        {
            UserName = UserName,
            AppIds = (AppIds ?? Enumerable.Empty<string>())
                .Where(appId => !string.IsNullOrWhiteSpace(appId))
                .Select(appId => appId.Trim())
                .Distinct(StringComparer.Ordinal)
                .ToList(),
            Orders = (Orders ?? Enumerable.Empty<TicketOrderOption>())
                .Where(order => order != null)
                .ToList()
        };
    }

    public static TicketClientOptions FromApplicationSettings()
    {
        var purchaseAccount =
            ConfigurationManager.AppSettings["CustomerWorkOrder.PurchaseAccount"];
        var appIds = ConfigurationManager.AppSettings["CustomerWorkOrder.AppIds"];

        return new TicketClientOptions
        {
            UserName = purchaseAccount,
            AppIds = (appIds ?? string.Empty)
                .Split(new[] { ',', ';', ' ' }, StringSplitOptions.RemoveEmptyEntries)
                .Select(a => a.Trim())
                .Where(a => a.Length > 0)
                .Distinct(StringComparer.OrdinalIgnoreCase)
                .ToList()
        };
    }
}

/// <summary>
/// 新建工单时需要在本地订单列表中关联的订单。
/// 微信订单号始终是字符串，禁止转换为 Number。
/// </summary>
public sealed class TicketOrderOption
{
    /// <summary>
    /// 订单所属店铺的 APPID，格式为 wx 加 16 位小写十六进制字符。
    /// </summary>
    public string AppId { get; set; }

    /// <summary>
    /// 微信订单号。接口要求保持为 10～64 位数字字符串，禁止转换为 Number。
    /// </summary>
    public string OrderId { get; set; }

    /// <summary>
    /// 商品名称，用于订单筛选和页面展示。
    /// </summary>
    public string GoodsName { get; set; }

    /// <summary>
    /// 商品缩略图地址，用于新建工单页展示关联商品。
    /// </summary>
    public string ImageUrl { get; set; }

    /// <summary>
    /// 订单金额，单位元，使用 decimal 保存原始金额，不在模型中保存格式化文本。
    /// </summary>
    public decimal Amount { get; set; }

    /// <summary>
    /// 订单下单时间。
    /// </summary>
    public DateTime OrderedAt { get; set; }

    /// <summary>
    /// 下拉列表显示文本，订单号在前、商品名在后，避免长商品名遮挡订单号。
    /// </summary>
    public string DisplayText
    {
        get
        {
            var product = string.IsNullOrWhiteSpace(GoodsName)
                ? "未命名商品"
                : GoodsName;
            return $"{OrderId} · {product}";
        }
    }

    /// <summary>
    /// 订单详情展示文本。商品名已包含在 <see cref="DisplayText"/> 中，这里只展示金额和下单时间。
    /// </summary>
    public string ProductDescription
    {
        get
        {
            var amount = "¥ " + Amount.ToString("N2", CultureInfo.GetCultureInfo("zh-CN"));
            var orderedAt = OrderedAt == default
                ? "下单时间未知"
                : OrderedAt.ToString("yyyy-MM-dd HH:mm", CultureInfo.CurrentCulture);
            return $"金额 {amount} · {orderedAt}";
        }
    }

    /// <summary>
    /// 从本地订单生成工单关联订单信息，统一商品名、缩略图、金额和下单时间的取值规则。
    /// </summary>
    public static TicketOrderOption FromWechatOrder(
        oms_wei_order_info order,
        string appId)
    {
        if (order == null)
            return null;

        var goodsName = string.Join(
            "、",
            (order.orderItems ?? Enumerable.Empty<oms_wei_order_item_info>())
                .Select(item => item.title)
                .Where(title => !string.IsNullOrWhiteSpace(title))
                .Distinct());
        if (goodsName.Length > 200)
            goodsName = goodsName.Substring(0, 200) + "…";

        return new TicketOrderOption
        {
            AppId = appId?.Trim(),
            OrderId = order.order_id,
            GoodsName = goodsName,
            ImageUrl = (order.orderItems ?? Enumerable.Empty<oms_wei_order_item_info>())
                .Select(item => item.thumb_img)
                .FirstOrDefault(url => !string.IsNullOrWhiteSpace(url)),
            Amount = (order.order_price ?? 0) / 100m,
            OrderedAt = order.create_time > 0
                ? BaseClass.StampToDateTime(order.create_time)
                : default
        };
    }

    /// <summary>
    /// 当前工单的唯一订单键，由 APPID 和微信订单号共同组成。
    /// </summary>
    public string OrderKey => $"{AppId}|{OrderId}";
}