feat(consignment): 匹配日志新增寄卖单号列并中文化原因

apps/frontend/src/components/admin/ConsignmentMatchLogsModal.tsx

@@ -1,6 +1,6 @@
 import { ReloadOutlined } from '@ant-design/icons'
 import { useQuery } from '@tanstack/react-query'
-import { Input, Modal, Select, Space, Tag, Typography } from 'antd'
+import { Input, Modal, Select, Space, Tag, Tooltip, Typography } from 'antd'
 import { useState } from 'react'
 
 import PercentTable from '@/components/common/PercentTable'
@@ -8,6 +8,8 @@ import { fetchAdminConsignmentMatchLogs } from '@/services/admin/consignment'
 import type { ConsignmentMatchLogItem } from '@/types/consignment-match-log'
 import { formatDateTime } from '@/utils/date-time'
 
+import { resolveConsignmentMatchReasonLabel } from './consignment-match-log-labels'
+
 const { Text } = Typography
 
 const TRIGGER_LABELS: Record<string, string> = {
@@ -68,6 +70,28 @@ export default function ConsignmentMatchLogsModal({
       render: (_: string, record: ConsignmentMatchLogItem) =>
         record.workOrderNo || (record.workOrderId ? `#${record.workOrderId}` : '-'),
     },
+    {
+      title: '寄卖单号',
+      dataIndex: 'consignmentNos',
+      width: 160,
+      render: (_: string[], record: ConsignmentMatchLogItem) => {
+        const consignmentNos = Array.isArray(record.consignmentNos)
+          ? record.consignmentNos.filter(Boolean)
+          : []
+        if (consignmentNos.length === 0) return '-'
+        const text = consignmentNos.join('、')
+        const inventoryNos = Array.isArray(record.inventoryNos)
+          ? record.inventoryNos.filter(Boolean)
+          : []
+        return inventoryNos.length > 0 ? (
+          <Tooltip title={`库存号：${inventoryNos.join('、')}`}>
+            <span>{text}</span>
+          </Tooltip>
+        ) : (
+          text
+        )
+      },
+    },
     {
       title: '触发',
       dataIndex: 'triggerType',
@@ -96,16 +120,17 @@ export default function ConsignmentMatchLogsModal({
     {
       title: '原因',
       dataIndex: 'reasonText',
-      render: (value: string, record: ConsignmentMatchLogItem) => (
-        <div style={{ display: 'grid', gap: 2 }}>
-          <Text>{value || '-'}</Text>
-          {record.reasonCode ? (
-            <Text type="secondary" style={{ fontSize: 12 }}>
-              {record.reasonCode}
-            </Text>
-          ) : null}
-        </div>
-      ),
+      render: (value: string, record: ConsignmentMatchLogItem) => {
+        const label = resolveConsignmentMatchReasonLabel(record.reasonCode, value)
+        // 英文 reasonCode 只做排查用途，收进悬浮提示，列表里始终显示中文。
+        return record.reasonCode ? (
+          <Tooltip title={record.reasonCode}>
+            <Text style={{ cursor: 'help' }}>{label}</Text>
+          </Tooltip>
+        ) : (
+          <Text>{label}</Text>
+        )
+      },
     },
     {
       title: '操作人',

apps/frontend/src/components/admin/consignment-match-log-labels.ts

@@ -0,0 +1,54 @@
+/**
+ * 寄卖匹配日志原因码 → 中文文案。
+ *
+ * 后端的 `reason_code` 有两种来源：匹配引擎固定写入的流程原因，以及
+ * `extractConsignmentErrorCode` 透传的业务错误码。新增登记点时必须同步补齐，
+ * `tests/consignment-match-log-reasons.test.ts` 会扫描后端源码校验覆盖率。
+ */
+export const CONSIGNMENT_MATCH_REASON_LABELS: Record<string, string> = {
+  // 自动 / 重新匹配流程
+  before_effective_from: '早于匹配生效时间',
+  no_candidate: '无可用寄卖库存',
+  quantity_insufficient: '库存数量不足',
+  auto_matched_before_hall: '发布前已自动匹配',
+  apply_not_applied: '匹配未生效（库存已变化）',
+  exception: '匹配异常',
+  rematch_started: '已重新发起匹配',
+  // 拼单
+  auto_sharing_matched_before_hall: '发布前已自动拼单匹配',
+  sharing_quantity_insufficient: '拼单份数不足',
+  sharing_not_applied: '拼单匹配未生效',
+  // 手动匹配
+  manual_matched: '手动匹配成功',
+  manual_not_applied: '手动匹配未生效',
+  // 业务校验错误码
+  work_order_not_found: '工单不存在',
+  work_order_not_matchable: '工单状态不允许匹配',
+  consignment_inventory_required: '未选择可用寄卖库存',
+  consignment_spec_mismatch: '所选库存与订单规格不一致',
+  consignment_match_reason_required: '非精确匹配未填写原因',
+  consignment_sharing_quantity_insufficient: '所选库存不够一次拼满',
+  consignment_sharing_not_applied: '工单状态或库存已变化',
+  consignment_multiple_inventory_not_allowed: '整单匹配只能选一条库存',
+  consignment_inventory_quantity_insufficient: '库存剩余数量不足',
+  consignment_inventory_not_found: '寄卖库存不存在',
+  consignment_inventory_unavailable: '寄卖库存不可用',
+  consignment_inventory_race_condition: '库存被并发占用',
+  consignment_deposit_insufficient: '押金不足',
+  work_order_conflict: '工单状态冲突',
+}
+
+/**
+ * 原因列展示文案：优先用后端带的详细说明，其次用中文映射，未知码兜底原文
+ * （英文码只在前端未覆盖时出现，正常情况全部命中映射）。
+ */
+export function resolveConsignmentMatchReasonLabel(
+  reasonCode: string,
+  reasonText?: string,
+): string {
+  const text = String(reasonText || '').trim()
+  if (text) return text
+  const code = String(reasonCode || '').trim()
+  if (!code) return '-'
+  return CONSIGNMENT_MATCH_REASON_LABELS[code] || code
+}

apps/frontend/src/types/consignment-match-log.ts

@@ -21,6 +21,10 @@ export type ConsignmentMatchLogItem = {
   actorId: string
   durationMs: number
   payload: Record<string, unknown>
+  /** 本次日志涉及的寄卖单号（提报单号优先，无则库存号），由后端按 payload 库存 ID 反查。 */
+  consignmentNos: string[]
+  /** 对应库存号，用于悬浮提示。 */
+  inventoryNos: string[]
   createdAt: string
 }