feat(AIChatSidebar): 添加销售退款回款记录功能支持

云

6 天以前 54a14c766c182d2e45bc63e047dc338e2e44e7dd

feat(AIChatSidebar): 添加销售退款回款记录功能支持

- 更新销售退货标签为销售退款/回款记录
- 新增采购统计数据类型
- 添加退款回款相关字段映射
- 实现销售退款列表数据标准化处理
- 添加销售类型列表项标准化函数
- 实现按类型推断销售列的功能
- 支持销售退款回款记录的结果显示
- 新增结构化描述解析功能
- 优化描述显示逻辑使用统一的解析方法

 src/components/AIChatSidebar/index.vue

@@ -1007,7 +1007,7 @@
  sales_customer_profile_list: '客户档案',
  sales_quotation_list: '销售报价',
  sales_ledger_list: '销售台账',
  sales_return_list: '销售退货',
  sales_return_list: '销售退款/回款记录',
  sales_customer_interaction_list: '客户往来',
  sales_shipping_list: '发货台账',
  sales_dashboard: '销售指标统计',
@@ -1016,6 +1016,7 @@
}
const purchaseTypeLabelMap = {
  purchase_material_rank: '采购物料金额排行',
  purchase_stats: '采购统计',
  purchase_pending_payment_list: '待付款采购单'
}
const financialStructuredTypeSet = new Set([
@@ -1108,6 +1109,26 @@
  stockQty: '库存量'
}
Object.assign(structuredFieldLabelMap, {
  refundId: '退款/回款单号',
  collectionNumber: '收款单号',
  collectionAmount: '收款金额',
  actualAmount: '收款金额(兼容)',
  customerId: '客户ID',
  salesLedgerId: '销售台账ID',
  projectName: '项目名称',
  receiptPaymentDate: '收付款日期',
  receiptPaymentAmount: '收付款金额',
  receiptPaymentType: '收付款类型',
  registrant: '登记人',
  returnAmount: '回款金额汇总',
  totalReceiptAmount: '收款总额',
  customerCount: '客户数',
  paidAmount: '已付款金额',
  contractAmount: '合同金额',
  paymentCount: '付款笔数',
  invoiceCount: '发票笔数',
  paymentAmount: '付款金额',
  invoiceAmount: '发票金额',
  customerName: '客户名称',
  riskLevel: '风险等级',
  riskScore: '风险评分',
@@ -1554,12 +1575,41 @@
  return items.filter(item => isPlainObject(item))
}

const normalizeSalesReturnListItems = (items = []) => {
  return normalizeSalesListItems(items).map((item) => {
    const collectionAmount = item.collectionAmount ?? item.actualAmount
    const collectionNumber = item.collectionNumber || item.refundId || ''
    return {
      ...item,
      refundId: item.refundId || collectionNumber,
      collectionNumber,
      collectionAmount: collectionAmount ?? 0,
      actualAmount: item.actualAmount ?? collectionAmount ?? 0
    }
  })
}

const normalizeSalesTypeListItems = (type = '', items = []) => {
  if (type === 'sales_return_list') {
    return normalizeSalesReturnListItems(items)
  }
  return normalizeSalesListItems(items)
}

const inferSalesColumnsByType = (type = '', listItems = []) => {
  const columns = inferSalesColumns(listItems)
  if (type === 'sales_return_list') {
    return columns.filter(column => column !== 'actualAmount')
  }
  return columns
}

const buildSalesStructuredData = (parsedData) => {
  const type = String(parsedData?.type || '')
  if (!salesStructuredTypeSet.has(type)) return null

  const rawData = isPlainObject(parsedData?.data) ? parsedData.data : {}
  const listItems = normalizeSalesListItems(rawData.items)
  const listItems = normalizeSalesTypeListItems(type, rawData.items)
  const topCustomers = normalizeSalesListItems(rawData.topCustomers)
  const contractTrend = normalizeSalesListItems(rawData.contractTrend)

@@ -1567,7 +1617,7 @@
    type,
    summaryEntries: normalizeManufacturingSummaryEntries(parsedData?.summary),
    listItems,
    columns: inferSalesColumns(listItems),
    columns: inferSalesColumnsByType(type, listItems),
    topCustomers,
    topCustomerColumns: inferSalesColumns(topCustomers),
    contractTrend,
@@ -2399,6 +2449,8 @@
    if (parsedData.type === 'sales_customer_churn_risk') return '已为您生成客户流失风险分析。'
    if (parsedData.type === 'sales_collection_quote_strategy') return '已为您生成回款与报价策略建议。'
    if (parsedData.type === 'sales_dashboard') return '已为您生成销售指标统计。'
    if (parsedData.type === 'sales_return_list') return '已返回销售退款/回款记录。'
    if (parsedData.type === 'sales_customer_interaction_list') return '已返回客户往来数据。'
    return '已返回销售查询结果。'
  }
  if (manufacturingStructuredTypeSet.has(parsedData.type)) {
@@ -2411,6 +2463,27 @@
  if (String(parsedData.type || '').startsWith('purchase_')) return '已返回采购查询结果。'
  if (parsedData.charts && Object.keys(parsedData.charts).length > 0) return '已为您生成分析图表。'
  return '正在为您展示分析结果...'
}

const resolveStructuredDescription = (parsedData) => {
  if (!parsedData) return ''
  if (parsedData.action === 'confirm_required') {
    return getPurchaseConfirmDescription(parsedData)
  }

  const description = String(parsedData.description || '').trim()
  if (!description) return ''

  if (parsedData.type === 'sales_customer_interaction_list') {
    if (description === 'no_customer_interactions') return '该时间范围暂无客户往来记录。'
    if (description === 'ok') return '已返回客户往来数据。'
  }

  if (description === 'ok' || description === 'success') {
    return getStructuredFallbackText(parsedData)
  }

  return description
}

const buildPurchaseMaterialRankCharts = (parsedData) => {
@@ -3790,10 +3863,9 @@
      display = ''
    }

    if (parsed.description) {
      display = parsed.action === 'confirm_required'
        ? getPurchaseConfirmDescription(parsed)
        : parsed.description
    const resolvedDescription = resolveStructuredDescription(parsed)
    if (resolvedDescription) {
      display = resolvedDescription
    }

    if (!display) {
@@ -3812,10 +3884,9 @@
          display = ''
        }

        if (parsed.description) {
          display = parsed.action === 'confirm_required'
            ? getPurchaseConfirmDescription(parsed)
            : parsed.description
        const resolvedDescription = resolveStructuredDescription(parsed)
        if (resolvedDescription) {
          display = resolvedDescription
        }

        if (!display) {