feat(client): show inbound business relationships

src/modules/first-leg/views/FirstLegOrdersView.test.mjs

@@ -223,9 +223,10 @@ test('uses only fields present on C02 rows before loading full detail', () => {
 test('shows and searches the inbound code after a draft is submitted', () => {
   assert.match(source, /label: '入仓码 \/ SKU'/)
   assert.match(source, /order\.businessSummary\.inboundCode/)
-  assert.match(source, /<template #inboundCode="\{ row \}"><span class="table-ellipsis table-code"[^>]*>\{\{ displayListValue\(\(row as FirstLegOrder\)\.businessSummary\.inboundCode\) \}\}<\/span><\/template>/)
-  assert.match(source, /v-if="order\.businessSummary\.inboundCode"[^>]*>入仓码/)
-  assert.match(source, /v-if="detailOrder\.businessSummary\.inboundCode"><dt>入仓码<\/dt>/)
+  assert.match(source, /<template #inboundCode="\{ row \}">[\s\S]*?class="inbound-code-link table-ellipsis table-code"/)
+  assert.match(source, /v-if="order\.businessSummary\.inboundCode" class="order-reference inbound-code-link"/)
+  assert.match(source, /<dt>入仓码<\/dt><dd><button v-if="detailOrder\.businessSummary\.inboundCode"/)
+  assert.match(source, /<span v-else>—<\/span>/)
 })
 
 test('keeps the seven-stage progress and business summary usable on mobile', () => {
@@ -495,6 +496,16 @@ test('copies reactive order drafts into plain request data', () => {
   assert.doesNotMatch(source, /structuredClone\((?:form|order\.)/)
 })
 
+test('opens the server-owned inbound-code association from desktop, mobile, and order detail', () => {
+  assert.match(source, /import InboundCodeAssociationDialog/)
+  assert.match(source, /function openInboundCodeAssociation\(inboundCode: string\)/)
+  assert.match(source, /#inboundCode[\s\S]*?openInboundCodeAssociation\(\(row as FirstLegOrder\)\.businessSummary\.inboundCode\)/)
+  assert.match(source, /class="order-reference inbound-code-link"[\s\S]*?openInboundCodeAssociation\(order\.businessSummary\.inboundCode\)/)
+  assert.match(source, /<dt>入仓码<\/dt><dd><button[\s\S]*?openInboundCodeAssociation\(detailOrder\.businessSummary\.inboundCode\)/)
+  assert.match(source, /<InboundCodeAssociationDialog[\s\S]*?:inbound-code="inboundAssociationCode"/)
+  assert.doesNotMatch(source, /openInboundCodeAssociation\([^)]*\.id\)/)
+})
+
 test('opens customer customs documents only for server-confirmed loaded tax-refund orders', () => {
   assert.match(source, /order\.status !== 'LOADED'/)
   assert.match(source, /item\.orderId === order\.id && item\.taxMode === 'TAX_REFUND'/)

src/modules/first-leg/views/FirstLegOrdersView.vue

@@ -9,6 +9,7 @@ import DataTable, { type DataTableColumn } from '@/components/common/DataTable.v
 import { ApiError } from '@/api/http'
 import FirstLegOrderEditorShell from '@/modules/first-leg/components/FirstLegOrderEditorShell.vue'
 import InboundBillingPanel from '@/modules/first-leg/components/InboundBillingPanel.vue'
+import InboundCodeAssociationDialog from '@/modules/first-leg/components/InboundCodeAssociationDialog.vue'
 import OrderProgressPanel from '@/modules/first-leg/components/OrderProgressPanel.vue'
 import CustomsDocumentsDialog from '@/modules/first-leg/components/CustomsDocumentsDialog.vue'
 import { getMerchantInboundBilling } from '@/modules/first-leg/api/inboundBilling'
@@ -193,6 +194,8 @@ const customsByOrder = reactive<Record<string, MerchantCustomsContainer | null |
 const customsEligibilityPending = new Set<string>()
 const customsDialogOpen = ref(false)
 const customsDialogOrderId = ref('')
+const inboundAssociationOpen = ref(false)
+const inboundAssociationCode = ref('')
 const supportingDataLoading = ref(false)
 const supportingDataErrors = ref<string[]>([])
 const destinationWarehousesLoading = ref(false)
@@ -335,7 +338,7 @@ const packageTypeLabels: Readonly<Record<string, string>> = {
 }
 
 function displayValue(value: string | null | undefined) {
-  return value?.trim() || '-'
+  return value?.trim() || '—'
 }
 
 function emptyDraft(): FirstLegOrderDraft {
@@ -494,6 +497,13 @@ function openCustomsDocuments(order: FirstLegOrder) {
   customsDialogOpen.value = true
 }
 
+function openInboundCodeAssociation(inboundCode: string) {
+  const code = inboundCode.trim()
+  if (!code) return
+  inboundAssociationCode.value = code
+  inboundAssociationOpen.value = true
+}
+
 function updateCustomsDetail(value: MerchantCustomsContainer) {
   if (customsDialogOrderId.value) customsByOrder[customsDialogOrderId.value] = value
 }
@@ -522,7 +532,7 @@ const progressSummaryItems = computed(() => {
     { label: '实测体积', value: formatMetric(summary.actualVolumeCbm ?? inbound?.actualVolumeCbm, 'm³') },
     { label: '预装清单', value: preloadStatus ? `${preloadStatus}${summary.preloadItemCount == null ? '' : ` · ${summary.preloadItemCount} 项`}` : '待更新' },
     { label: '拣货进度', value: pickingProgress },
-    { label: '柜次进度', value: summary.cabinetNo || summary.containerNo || '待更新' },
+    { label: '柜次进度', value: summary.cabinetNo || summary.containerNo || '—' },
     { label: '船期摘要', value: transportReference || '待更新' },
     { label: '计费重量', value: formatMetric(summary.chargeableWeightKg, 'kg') },
     { label: '后续履约', value: summary.deliveryTrackingNo || (summary.deliveryCompletedAt ? `海外回传于 ${formatDateTime(summary.deliveryCompletedAt)}` : '待海外同步') },
@@ -1220,7 +1230,7 @@ function removeCargoItem(index: number) {
 }
 
 function displayListValue(value: string | number | null | undefined) {
-  return value === '' || value == null ? '-' : String(value)
+  return value === '' || value == null ? '—' : String(value)
 }
 
 function orderMatchesCargoKeyword(order: FirstLegOrder, keyword: string) {
@@ -1653,9 +1663,18 @@ async function searchOrders(model: QueryModel) {
             </div>
           </template>
           <template #order="{ row }">
-            <button class="order-number-link table-code" type="button" :title="(row as FirstLegOrder).orderNo || '未提交草稿'" @click="openDetail(row as FirstLegOrder)">{{ (row as FirstLegOrder).orderNo || '未提交草稿' }}</button>
+            <button class="order-number-link table-code" type="button" :title="(row as FirstLegOrder).orderNo || '—'" @click="openDetail(row as FirstLegOrder)">{{ (row as FirstLegOrder).orderNo || '—' }}</button>
+          </template>
+          <template #inboundCode="{ row }">
+            <button
+              v-if="(row as FirstLegOrder).businessSummary.inboundCode"
+              class="inbound-code-link table-ellipsis table-code"
+              type="button"
+              :title="`查看入仓码 ${(row as FirstLegOrder).businessSummary.inboundCode} 的关联摘要`"
+              @click="openInboundCodeAssociation((row as FirstLegOrder).businessSummary.inboundCode)"
+            >{{ (row as FirstLegOrder).businessSummary.inboundCode }}</button>
+            <span v-else>—</span>
           </template>
-          <template #inboundCode="{ row }"><span class="table-ellipsis table-code" :title="displayListValue((row as FirstLegOrder).businessSummary.inboundCode)">{{ displayListValue((row as FirstLegOrder).businessSummary.inboundCode) }}</span></template>
           <template #channel="{ row }"><span class="table-ellipsis" :title="displayListValue((row as FirstLegOrder).channelName)">{{ displayListValue((row as FirstLegOrder).channelName) }}</span></template>
           <template #transportMode="{ row }">{{ (row as FirstLegOrder).transportMode ? getFirstLegTransportModeLabel((row as FirstLegOrder).transportMode) : '-' }}</template>
           <template #pickupMethod="{ row }">{{ pickupMethodLabels[(row as FirstLegOrder).pickupMethod] }}</template>
@@ -1695,10 +1714,11 @@ async function searchOrders(model: QueryModel) {
       <div v-loading="store.loading" class="mobile-order-surface">
       <div v-if="filteredOrders.length" class="mobile-order-list">
         <article v-for="order in filteredOrders" :key="order.id" class="mobile-order-card">
-          <header><button type="button" @click="openDetail(order)">{{ order.orderNo || '未提交草稿' }}</button><el-tag :type="getFirstLegStatusTone(order.status)" effect="light">{{ getFirstLegStatusLabel(order.status) }}</el-tag></header>
-          <span v-if="order.businessSummary.inboundCode" class="order-reference">入仓码 {{ order.businessSummary.inboundCode }}</span>
-          <span class="order-reference">{{ order.referenceNo || '无 Reference ID' }}</span>
-          <dl><div><dt>目的地</dt><dd>{{ order.destination || '待更新' }}</dd></div><div><dt>目的仓类型</dt><dd>{{ destinationTypeLabels[order.destinationType] }}</dd></div><div><dt>收货仓</dt><dd>{{ order.receivingWarehouseName || '待更新' }}</dd></div><div><dt>货物摘要</dt><dd>{{ getOrderCargoSummary(order) }}</dd></div><div><dt>运输方式</dt><dd>{{ order.transportMode ? getFirstLegTransportModeLabel(order.transportMode) : '待更新' }}</dd></div><div><dt>交货方式</dt><dd>{{ pickupMethodLabels[order.pickupMethod] }}</dd></div><div><dt>预约提货时间</dt><dd>{{ order.pickupMethod === 'PICKUP' && order.requestedPickupAt ? formatDateTime(order.requestedPickupAt) : '-' }}</dd></div><div v-if="order.businessSummary.cabinetNo || order.businessSummary.containerNo"><dt>柜号 / 柜次</dt><dd>{{ order.businessSummary.cabinetNo || order.businessSummary.containerNo }}</dd></div><div v-if="order.businessSummary.vesselName || order.businessSummary.voyageNo"><dt>船名 / 航次</dt><dd>{{ [order.businessSummary.vesselName, order.businessSummary.voyageNo].filter(Boolean).join(' · ') }}</dd></div><div v-if="order.businessSummary.sailingAt"><dt>预计船期</dt><dd>{{ formatDateTime(order.businessSummary.sailingAt) }}</dd></div></dl>
+          <header><button type="button" @click="openDetail(order)">{{ order.orderNo || '—' }}</button><el-tag :type="getFirstLegStatusTone(order.status)" effect="light">{{ getFirstLegStatusLabel(order.status) }}</el-tag></header>
+          <button v-if="order.businessSummary.inboundCode" class="order-reference inbound-code-link" type="button" @click="openInboundCodeAssociation(order.businessSummary.inboundCode)">入仓码 {{ order.businessSummary.inboundCode }}</button>
+          <span v-else class="order-reference">入仓码 —</span>
+          <span class="order-reference">{{ order.referenceNo || '跟踪编号 —' }}</span>
+          <dl><div><dt>目的地</dt><dd>{{ order.destination || '待更新' }}</dd></div><div><dt>目的仓类型</dt><dd>{{ destinationTypeLabels[order.destinationType] }}</dd></div><div><dt>收货仓</dt><dd>{{ order.receivingWarehouseName || '—' }}</dd></div><div><dt>货物摘要</dt><dd>{{ getOrderCargoSummary(order) }}</dd></div><div><dt>运输方式</dt><dd>{{ order.transportMode ? getFirstLegTransportModeLabel(order.transportMode) : '待更新' }}</dd></div><div><dt>交货方式</dt><dd>{{ pickupMethodLabels[order.pickupMethod] }}</dd></div><div><dt>预约提货时间</dt><dd>{{ order.pickupMethod === 'PICKUP' && order.requestedPickupAt ? formatDateTime(order.requestedPickupAt) : '—' }}</dd></div><div><dt>柜号 / 柜次</dt><dd>{{ order.businessSummary.cabinetNo || order.businessSummary.containerNo || '—' }}</dd></div><div v-if="order.businessSummary.vesselName || order.businessSummary.voyageNo"><dt>船名 / 航次</dt><dd>{{ [order.businessSummary.vesselName, order.businessSummary.voyageNo].filter(Boolean).join(' · ') }}</dd></div><div v-if="order.businessSummary.sailingAt"><dt>预计船期</dt><dd>{{ formatDateTime(order.businessSummary.sailingAt) }}</dd></div></dl>
           <footer>
             <span>更新于 {{ formatDateTime(order.updatedAt) }}</span>
             <div>
@@ -1864,13 +1884,13 @@ async function searchOrders(model: QueryModel) {
       </div>
       <template v-else-if="detailOrder">
         <div class="order-detail-heading">
-          <div><span>{{ getFirstLegTransportModeLabel(detailOrder.transportMode) }}</span><h2>{{ detailOrder.orderNo || '未提交草稿' }}</h2><p>{{ detailOrder.origin || '起运地待更新' }} → {{ detailOrder.destination || '目的地待更新' }}</p></div>
+          <div><span>{{ getFirstLegTransportModeLabel(detailOrder.transportMode) }}</span><h2>{{ detailOrder.orderNo || '—' }}</h2><p>{{ detailOrder.origin || '起运地待更新' }} → {{ detailOrder.destination || '目的地待更新' }}</p></div>
           <el-tag :type="getFirstLegStatusTone(detailOrder.status)" effect="light">{{ getFirstLegStatusLabel(detailOrder.status) }}</el-tag>
         </div>
         <section class="detail-section">
           <h3>订单与运输</h3>
           <dl class="order-detail-grid">
-            <div v-if="detailOrder.businessSummary.inboundCode"><dt>入仓码</dt><dd>{{ detailOrder.businessSummary.inboundCode }}</dd></div>
+            <div><dt>入仓码</dt><dd><button v-if="detailOrder.businessSummary.inboundCode" class="inbound-code-link table-code" type="button" @click="openInboundCodeAssociation(detailOrder.businessSummary.inboundCode)">{{ detailOrder.businessSummary.inboundCode }}</button><span v-else>—</span></dd></div>
             <div><dt>创建时间</dt><dd>{{ formatDateTime(detailOrder.createdAt) }}</dd></div>
             <div><dt>运输方式</dt><dd>{{ getFirstLegTransportModeLabel(detailOrder.transportMode) }}</dd></div>
             <div><dt>贸易条款</dt><dd>{{ displayValue(detailOrder.tradeTerm) }}</dd></div>
@@ -1878,7 +1898,7 @@ async function searchOrders(model: QueryModel) {
             <div><dt>预约提货时间</dt><dd>{{ detailOrder.pickupMethod === 'PICKUP' && detailOrder.requestedPickupAt ? formatDateTime(detailOrder.requestedPickupAt) : '-' }}</dd></div>
             <div><dt>报关方式</dt><dd>{{ taxModeLabels[detailOrder.taxMode] }}</dd></div>
             <div><dt>运输渠道</dt><dd>{{ detailOrder.channelName || detailOrder.channelCode || '-' }}<span v-if="detailOrder.channelName && detailOrder.channelCode" class="detail-subline">{{ detailOrder.channelCode }}</span></dd></div>
-            <div><dt>国内收货仓</dt><dd>{{ detailOrder.receivingWarehouseSnapshot?.name || detailOrder.receivingWarehouseName || '-' }}<span v-if="detailOrder.receivingWarehouseSnapshot" class="detail-subline">{{ detailOrder.receivingWarehouseSnapshot.code || '仓库编码待更新' }} · {{ detailOrder.receivingWarehouseSnapshot.province }}{{ detailOrder.receivingWarehouseSnapshot.city }}{{ detailOrder.receivingWarehouseSnapshot.address }}</span></dd></div>
+            <div><dt>国内收货仓</dt><dd>{{ detailOrder.receivingWarehouseSnapshot?.name || detailOrder.receivingWarehouseName || '—' }}<span v-if="detailOrder.receivingWarehouseSnapshot" class="detail-subline">{{ detailOrder.receivingWarehouseSnapshot.code || '—' }} · {{ detailOrder.receivingWarehouseSnapshot.province }}{{ detailOrder.receivingWarehouseSnapshot.city }}{{ detailOrder.receivingWarehouseSnapshot.address }}</span></dd></div>
             <div><dt>收货要求</dt><dd>{{ displayValue(detailOrder.receivingTime) }}</dd></div>
             <div><dt>目的仓类型</dt><dd>{{ destinationTypeLabels[detailOrder.destinationType] }}</dd></div>
             <div><dt>目的国家 / 仓库</dt><dd>{{ detailOrder.destinationCountryCode || '-' }} · {{ detailOrder.destinationWarehouseName || '-' }}</dd></div>
@@ -1907,9 +1927,9 @@ async function searchOrders(model: QueryModel) {
           <h3>柜次进度</h3>
           <div v-if="cabinetProgressItems.length" class="cabinet-progress-list">
             <article v-for="cabinet in cabinetProgressItems" :key="cabinet.cabinetId" class="cabinet-progress-card">
-              <header><strong>{{ cabinet.cabinetNo || '柜次待分配' }}</strong><el-tag size="small" effect="plain">{{ cabinet.status || '待更新' }}</el-tag></header>
+              <header><strong>{{ cabinet.cabinetNo || '—' }}</strong><el-tag size="small" effect="plain">{{ cabinet.status || '待更新' }}</el-tag></header>
               <dl>
-                <div><dt>柜号</dt><dd>{{ cabinet.cabinetNo || '待分配' }}</dd></div>
+                <div><dt>柜号</dt><dd>{{ cabinet.cabinetNo || '—' }}</dd></div>
                 <div><dt>船名 / 航次</dt><dd>{{ [cabinet.vesselName, cabinet.voyageNo].filter(Boolean).join(' · ') || '待更新' }}</dd></div>
                 <div><dt>预计船期</dt><dd>{{ cabinet.sailingAt ? formatDateTime(cabinet.sailingAt) : '待更新' }}</dd></div>
               </dl>
@@ -1986,6 +2006,10 @@ async function searchOrders(model: QueryModel) {
       :initial-detail="customsByOrder[customsDialogOrderId]"
       @updated="updateCustomsDetail"
     />
+    <InboundCodeAssociationDialog
+      v-model="inboundAssociationOpen"
+      :inbound-code="inboundAssociationCode"
+    />
   </section>
 </template>
 
@@ -2062,6 +2086,9 @@ async function searchOrders(model: QueryModel) {
 .mobile-order-surface { display: none; min-height: 220px; }
 .mobile-order-list { display: none; }
 .order-number-link { display: block; width: 100%; max-width: 100%; overflow: hidden; padding: 0; border: 0; background: none; color: var(--primary); cursor: pointer; font-size: 11px; font-weight: 700; line-height: 18px; text-align: left; text-overflow: ellipsis; white-space: nowrap; }
+.inbound-code-link { max-width: 100%; overflow: hidden; padding: 0; border: 0; background: transparent; color: var(--primary); cursor: pointer; text-align: left; text-decoration: underline; text-decoration-color: transparent; text-underline-offset: 3px; text-overflow: ellipsis; white-space: nowrap; }
+.inbound-code-link:hover, .inbound-code-link:focus-visible { text-decoration-color: currentColor; }
+.inbound-code-link:focus-visible { outline: 2px solid var(--primary); outline-offset: 2px; }
 .order-number-link:focus-visible { outline: 2px solid var(--primary); outline-offset: 3px; }
 .order-reference { display: block; margin-top: 4px; color: var(--muted); font-size: 11px; font-weight: 400; }
 .order-row-actions { align-items: center; justify-content: center; gap: 6px; white-space: nowrap; }

src/modules/first-leg/views/QuickOrderView.test.mjs

@@ -78,7 +78,10 @@ test('requires the old inbound code globally only while legacy manual mode is ac
 
 test('shows every created draft and keeps failed rows available for retry', () => {
   assert.match(source, /v-for="result in draftResults"/)
-  assert.match(source, /入仓码将在提交订单时生成/)
+  assert.match(source, /result\.orderNo \|\| '订单号 —'/)
+  assert.match(source, /result\.inboundCode \? `入仓码 \$\{result\.inboundCode\}` : '入仓码 —'/)
+  assert.doesNotMatch(source, /result\.orderNo \|\| `草稿 \$\{result\.draftId\}`/)
+  assert.doesNotMatch(source, /item\.orderNo \|\| item\.draftId/)
   assert.match(source, /@click="editDraft\(result\)"/)
   assert.match(source, /if \(rows\.length === 0\) rows\.push\(createRow\(\)\)/)
   assert.match(source, /resultDialogOpen\.value = successes\.length > 0/)

src/modules/first-leg/views/QuickOrderView.vue

@@ -394,8 +394,10 @@ async function submitQuickOrder() {
       await Promise.all(successes.map((item) => store.loadDraftDetail(item.draftId)))
       workspace.close(['first-leg-quick-order'])
       await router.push({ name: 'first-leg-orders' })
-      const orderNumbers = successes.map((item) => item.orderNo || item.draftId).join('、')
-      ElMessage.success(`已生成 ${successes.length} 张草稿单：${orderNumbers}`)
+      const orderNumbers = successes.map((item) => item.orderNo).filter(Boolean).join('、')
+      ElMessage.success(orderNumbers
+        ? `已生成 ${successes.length} 张草稿单：${orderNumbers}`
+        : `已生成 ${successes.length} 张草稿单，订单号 —`)
     }
   } catch (error) {
     ElMessage.error(error instanceof Error ? error.message : '批量草稿生成失败')
@@ -529,7 +531,7 @@ onMounted(loadChannels)
     <el-dialog v-model="resultDialogOpen" class="quick-result-dialog" title="草稿单生成结果" width="min(700px, 94vw)">
       <div class="quick-draft-results">
         <article v-for="result in draftResults" :key="result.rowId">
-          <div><strong>{{ result.orderNo || `草稿 ${result.draftId}` }}</strong><span>SKU {{ result.sku }}</span><span>{{ result.inboundCode ? `入仓码 ${result.inboundCode}` : '入仓码将在提交订单时生成' }}</span></div>
+          <div><strong>{{ result.orderNo || '订单号 —' }}</strong><span>SKU {{ result.sku }}</span><span>{{ result.inboundCode ? `入仓码 ${result.inboundCode}` : '入仓码 —' }}</span></div>
           <el-button type="primary" plain @click="editDraft(result)">编辑明细</el-button>
         </article>
       </div>

src/modules/first-leg/views/businessIdentifiers.test.mjs

@@ -0,0 +1,27 @@
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import test from 'node:test'
+
+const firstLeg = readFileSync(new URL('./FirstLegOrdersView.vue', import.meta.url), 'utf8')
+const quickOrder = readFileSync(new URL('./QuickOrderView.vue', import.meta.url), 'utf8')
+const customs = readFileSync(new URL('../components/CustomsDocumentsDialog.vue', import.meta.url), 'utf8')
+const overseas = readFileSync(new URL('../../overseas-warehouse/views/WarehouseServiceView.vue', import.meta.url), 'utf8')
+
+test('uses business identifiers and names without visible internal-ID fallbacks', () => {
+  assert.match(firstLeg, /label: '入仓码'/)
+  assert.match(firstLeg, /label: '订单号'/)
+  assert.match(firstLeg, /label: '柜号 \/ 柜次'/)
+  assert.match(firstLeg, /label: '国内收货仓'/)
+  assert.doesNotMatch(quickOrder, /result\.orderNo \|\| `草稿 \$\{result\.draftId\}`/)
+  assert.doesNotMatch(quickOrder, /item\.orderNo \|\| item\.draftId/)
+  assert.doesNotMatch(customs, /detail\.planNo \|\| detail\.loadingPlanId/)
+  assert.doesNotMatch(overseas, /overseasWarehouseName \|\| (?:item|candidate)\.overseasWarehouseId/)
+  assert.doesNotMatch(overseas, /row\(\[[^\]]*(?:item\.overseasWarehouseId|item\.operatingWarehouseId)/)
+})
+
+test('keeps internal IDs only as non-rendered routing, selection, and request values', () => {
+  assert.match(quickOrder, /params: \{ draftId: result\.draftId \}/)
+  assert.match(customs, /uploadMerchantCustomsDocument\(detail\.value\.loadingPlanId/)
+  assert.match(overseas, /:value="candidate\.orderId"/)
+  assert.match(firstLeg, /detailId\.value = order\.id/)
+})