优化

src/modules/overseas-business/CONTRACT_GAPS.md

@@ -6,14 +6,16 @@
 
 - 海外采购：客户候选、采购仓候选、列表、详情操作流水及 `PATCH` 三态编辑；缺失字段不修改，显式 `null` 清空。
 - 采购审核 `review`：采购详情页只对待审核订单和独立审核权限开放，提交订单版本、通过/拒绝决定、稳定幂等键和可选备注。
-- 本土卡车：平台列表、详情、创建和仅待审核状态允许的普通编辑。
+- 本土卡车：平台列表、独立详情页、创建和仅待审核状态允许的普通编辑；详情页使用 `truck:status` 权限接入订单审核、累计实收、超托审核、托盘分配、待派车、已派车、发运、完成及取消。全部命令提交当前版本和稳定幂等键，结果不明时保留原请求供重试；失败保留表单与错误关联信息。
+- 本土卡车拼车来源订单保持承运安排只读，状态随既有来货、排车和签收事实推进；不展示独立单审核或状态命令。
 - 本土散板：独立稳定子域的列表、详情数据承载、创建和仅待接单状态允许的编辑；详情只用于既有编辑页预填，不新增详情路由。
 - canonical 权限统一为 `platform:overseas-business:*`；长整型 ID 与 decimal 字段在适配层归一化。
 
 明确不接入：
 
 - 采购出库不提供独立 `/outbounds` 端点；采购编辑通过出库明细维护出库量并派生待出库、部分出库、全部出库状态，不直接操作海外仓 PDA 可用库存。
-- 卡车状态推进、收托盘和散板状态推进：后端存在，但当前原型没有对应操作承载方式。
+- 散板独立单状态推进：后端存在，但当前原型没有对应操作承载方式。
+- 独立卡车履约记录使用现有卡车接口，不自动生成 WMS 库存、海外仓排车单、出库单或派送单；派车、发运和完成按实际发生情况由平台确认。
 - 海外出库、海外派送和 Merchant API。
 
 剩余验收项仅为真实 Gateway/Token 环境 HTTP 验收及 `1920×1080`、浏览器缩放 `100%` 的人工页面操作和截图确认。

src/modules/overseas-business/PROTOTYPE_MATRIX.md

@@ -29,7 +29,7 @@
 | 本土卡车 | 列表 | `page-overseas-truck` 58–80 行；`renderTruckOrderList()` 13550–13566 行 | 独立列表页 | 正式列表；操作列按根规则移到第一列 |
 | 本土卡车 | 新增 | `page-overseas-truck-add` 83–130 行；`saveTruckOrder()` 13567–13579 行 | 独立页面 | 建立正式新增路由；使用平台创建接口真实提交并显式选择客户 |
 | 本土卡车 | 编辑 | `page-overseas-truck-edit` 313–362 行；`editTruckOrder()`、`saveTruckOrderEdit()` 13630–13674 行 | 独立页面 | 建立正式编辑路由；仅 `PENDING_REVIEW` 可真实提交 |
-| 本土卡车 | 详情 | 列表渲染函数 13563 行仅提示“详情开发中” | 原型未定义 | 不建立详情路由 |
+| 本土卡车 | 详情、审核与后续履约 | 原型未定义；2026-10-20 用户明确要求补齐流程并加审核 | 独立详情页 + 居中操作确认弹框 | 列表待审核单显示审核入口，其他状态可查看详情；独立单使用既有具名命令，按状态与 truck:status 权限展示审核、实收、超托审核、分配、待派车、派车、发运、完成与取消。展示资料、托盘和审核操作历史；拼车来源沿承运安排只读。待人工 1920×1080、100% 截图确认 |
 | 本土散板 | 列表 | `page-overseas-looseboard` 222–244 行；`renderLooseboardList()` 13589–13605 行 | 独立列表页 | 正式列表；操作列按根规则移到第一列 |
 | 本土散板 | 新增 | `page-overseas-looseboard-add` 247–310 行；`saveLooseboardOrder()` 13606–13622 行 | 独立页面 | 建立正式新增路由；使用独立稳定子域真实提交并显式选择客户 |
 | 本土散板 | 编辑 | `page-overseas-looseboard-edit` 365–430 行；`editLooseboardOrder()`、`saveLooseboardOrderEdit()` 13676–13726 行 | 独立页面 | 建立正式编辑路由；仅 `PENDING_ACCEPTANCE` 可真实提交 |

src/modules/overseas-business/api/platformOverseasBusiness.test.ts

@@ -7,10 +7,11 @@ import {
   createLocalLooseboardOrder, createUsTruckOrder, getLocalLooseboardOrder, getOverseasPurchase, getOverseasPurchaseEditor, getUsTruckOrder,
   listLocalLooseboardOrders, listOverseasPurchaseCustomerOptions, listOverseasPurchases,
   listOverseasPurchaseWarehouseOptions, listUsTruckOrders, updateLocalLooseboardOrder, updateOverseasPurchase,
-  updateUsTruckOrder,
+  updateUsTruckOrder, executeUsTruckCommand,
 } from './platformOverseasBusiness'
 import type { UpdateLocalTransportOrderRequest } from '../types'
 import { readPendingProcurement } from '../procurementPending'
+import type { TruckOperation } from '../truckWorkflow'
 
 const envelope = <T>(data: T) => ({ code: '200', message: 'success', data })
 const purchaseSummary = {
@@ -92,7 +93,7 @@ describe('platform overseas business API adapter', () => {
     expect(overseas.patch).toHaveBeenCalledWith('/platform/v1/last-leg/overseas-procurements/OP%2F1', { version: 4, remark: '内部' }, { params: { customerId: '10001' } })
   })
 
-  it('supports platform truck list/detail/create/update without status endpoints', async () => {
+  it('supports platform truck list/detail/create/update', async () => {
     const detail = { summary: truckSummary, pallets: [{ id: '9007199254741001', warehousePalletId: '9007199254741003', palletNo: 'P-1' }], histories: [] }
     overseas.get.mockResolvedValueOnce(envelope({ records: [truckSummary], page: '1', size: '20', total: '1', pages: '1' })).mockResolvedValueOnce(envelope(detail))
     expect((await listUsTruckOrders({ routeKeyword: ' LA ' })).records[0]?.totalWeightKg).toBe('123.45')
@@ -106,6 +107,32 @@ describe('platform overseas business API adapter', () => {
     expect(overseas.patch).toHaveBeenCalledWith('/platform/v1/last-leg/us-truck-orders/TR-1', update, { params: { customerId: '9007199254741999' } })
   })
 
+  it.each<TruckOperation>([
+    { command: 'review', payload: { version: 2, idempotencyKey: 'review-key', decision: 'APPROVE' } },
+    { command: 'review', payload: { version: 2, idempotencyKey: 'reject-key', decision: 'REJECT', remark: '资料不全' } },
+    { command: 'receive-pallets', payload: { version: 2, idempotencyKey: 'receive-key', actualPalletCount: 3, packageCount: 10 } },
+    { command: 'review-pallet-overage', payload: { version: 2, idempotencyKey: 'overage-key', decision: 'APPROVE' } },
+    { command: 'allocate-pallets', payload: { version: 2, idempotencyKey: 'allocate-key', palletIds: ['9007199254741001'] } },
+    ...(['prepare-dispatch', 'dispatch', 'start-transit', 'complete'] as const).map(command => ({ command, payload: { version: 2, idempotencyKey: command } })),
+    { command: 'cancel', payload: { version: 2, idempotencyKey: 'cancel-key', status: 'CANCELLED', remark: '客户取消' } },
+  ])('sends the scoped named truck command $command with version and unchanged replay key', async operation => {
+    const response = envelope({ summary: { ...truckSummary, version: '3', palletCount: '2', packageCount: '10', receivedPalletCount: '1', allocatedPalletCount: '0' }, pallets: [{ id: '9007199254741001', warehousePalletId: null }], histories: [] })
+    overseas.post.mockResolvedValue(response); overseas.patch.mockResolvedValue(response)
+    const result = await executeUsTruckCommand('TR/1', '9007199254741999', operation)
+    const mutation = operation.command === 'cancel' ? overseas.patch : overseas.post
+    expect(mutation).toHaveBeenCalledWith(`/platform/v1/last-leg/us-truck-orders/TR%2F1/${operation.command === 'cancel' ? 'status' : operation.command}`, operation.payload, { params: { customerId: '9007199254741999' } })
+    expect(result).toMatchObject({ version: 3, palletCount: 2, receivedPalletCount: 1, allocatedPalletCount: 0 })
+    expect(result.pallets[0].id).toBe('9007199254741001')
+    expect(operation.command === 'cancel' ? overseas.post : overseas.patch).not.toHaveBeenCalled()
+  })
+
+  it('propagates a truck command version conflict without fallback status writes', async () => {
+    overseas.post.mockResolvedValue({ code: 'A0409', message: '版本冲突', data: null, requestId: 'TRUCK-409' })
+    await expect(executeUsTruckCommand('TR-1', '10002', { command: 'complete', payload: { version: 2, idempotencyKey: 'original' } })).rejects.toMatchObject({ code: 'A0409', requestId: 'TRUCK-409' })
+    expect(overseas.post).toHaveBeenCalledTimes(1)
+    expect(overseas.patch).not.toHaveBeenCalled()
+  })
+
   it('supports looseboard list/detail/create and PUT update', async () => {
     const detail = { summary: looseboardSummary, originAddress: null, destinationAddress: null, remark: null, createdBy: '7', histories: [] }
     overseas.get.mockResolvedValueOnce(envelope({ records: [looseboardSummary], page: 1, size: 20, total: 1, pages: 1 })).mockResolvedValueOnce(envelope(detail))

src/modules/overseas-business/api/platformOverseasBusiness.ts

@@ -1,4 +1,5 @@
 import type { PlatformProcurement } from '../procurementTypes'
+import type { TruckOperation } from '../truckWorkflow'
 import { http, unwrapApiResponse, type ApiEnvelope } from '@/shared/api/http'
 
 import type {
@@ -32,15 +33,15 @@ interface LooseboardDetailPayload {
 function normalizePage<TPayload, TResult>(payload: PagePayload<TPayload>, normalize: (value: TPayload) => TResult): OverseasBusinessPage<TResult> {
   return { records: (payload.records || []).map(normalize), page: Number(payload.page), size: Number(payload.size), total: Number(payload.total), pages: Number(payload.pages) }
 }
-function procurementInteger(value: unknown): number {
-  if ((typeof value !== 'number' && typeof value !== 'string') || !/^\d+$/.test(String(value)) || !Number.isSafeInteger(Number(value))) throw new Error('采购数据中的数量或版本无效，请刷新后重试')
+function procurementInteger(value: unknown, business = '采购'): number {
+  if ((typeof value !== 'number' && typeof value !== 'string') || !/^\d+$/.test(String(value)) || !Number.isSafeInteger(Number(value))) throw new Error(`${business}数据中的数量或版本无效，请刷新后重试`)
   return Number(value)
 }
 function procurementSummary(value: ProcurementSummaryPayload): OverseasPurchaseSummary {
   return { ...value, version: procurementInteger(value.version), purchaseQuantity: procurementInteger(value.purchaseQuantity), id: String(value.id), purchaseWarehouseId: value.purchaseWarehouseId == null ? null : String(value.purchaseWarehouseId), budgetUnitPrice: value.budgetUnitPrice == null ? null : String(value.budgetUnitPrice) }
 }
 function truckSummary(value: TruckSummaryPayload): LocalTransportOrder {
-  return { ...value, id: String(value.id), totalWeightKg: String(value.totalWeightKg), totalVolumeCbm: String(value.totalVolumeCbm), budgetAmount: value.budgetAmount == null ? null : String(value.budgetAmount) }
+  return { ...value, id: String(value.id), customerId: String(value.customerId), version: procurementInteger(value.version, '卡车'), palletCount: procurementInteger(value.palletCount, '卡车'), packageCount: procurementInteger(value.packageCount, '卡车'), receivedPalletCount: procurementInteger(value.receivedPalletCount, '卡车'), allocatedPalletCount: procurementInteger(value.allocatedPalletCount, '卡车'), totalWeightKg: String(value.totalWeightKg), totalVolumeCbm: String(value.totalVolumeCbm), budgetAmount: value.budgetAmount == null ? null : String(value.budgetAmount) }
 }
 function truckDetail(value: TruckDetailPayload): LocalTransportDetail {
   return { ...truckSummary(value.summary), originAddress: value.originAddress || null, destinationAddress: value.destinationAddress || null, remark: value.remark || null, createdBy: value.createdBy || null, pallets: (value.pallets || []).map((item) => ({ ...item, id: String(item.id), warehousePalletId: item.warehousePalletId == null ? null : String(item.warehousePalletId) })), histories: value.histories || [] }
@@ -130,6 +131,14 @@ export async function updateUsTruckOrder(orderNo: string, customerId: string, pa
   const response = await http.patch<ApiEnvelope<TruckDetailPayload>, ApiEnvelope<TruckDetailPayload>>(`${truckBasePath}/${encodeURIComponent(orderNo)}`, payload, { params: { customerId } })
   return truckDetail(unwrapApiResponse(response))
 }
+/** 正向履约使用具名命令，通用状态接口仅用于取消。 */
+export async function executeUsTruckCommand(orderNo: string, customerId: string, operation: TruckOperation) {
+  const path = `${truckBasePath}/${encodeURIComponent(orderNo)}/${operation.command === 'cancel' ? 'status' : operation.command}`
+  const response = operation.command === 'cancel'
+    ? await http.patch<ApiEnvelope<TruckDetailPayload>, ApiEnvelope<TruckDetailPayload>>(path, operation.payload, { params: { customerId } })
+    : await http.post<ApiEnvelope<TruckDetailPayload>, ApiEnvelope<TruckDetailPayload>>(path, operation.payload, { params: { customerId } })
+  return truckDetail(unwrapApiResponse(response))
+}
 export async function listLocalLooseboardOrders(query: LocalLooseboardQuery = {}) {
   const response = await http.get<ApiEnvelope<PagePayload<LooseboardSummaryPayload>>, ApiEnvelope<PagePayload<LooseboardSummaryPayload>>>(looseboardBasePath, { params: { ...query, customerId: query.customerId || undefined, orderNo: query.orderNo?.trim() || undefined, routeKeyword: query.routeKeyword?.trim() || undefined, status: query.status || undefined } })
   return normalizePage(unwrapApiResponse(response), looseboardSummary)

src/modules/overseas-business/components/TruckOrderActions.vue

@@ -0,0 +1,117 @@
+<script setup lang="ts">
+import { computed, reactive, ref, watch } from 'vue'
+import { ElMessage } from 'element-plus'
+import AppDialog from '@/shared/components/AppDialog.vue'
+import ApiErrorMeta from '@/shared/components/ApiErrorMeta.vue'
+import { useAccessPreviewStore } from '@/core/access/accessPreview'
+import { useUnsavedWorkRegistration } from '@/core/unsaved-work/useUnsavedWorkRegistration'
+import { getApiErrorDetails, type ApiErrorDetails } from '@/shared/api/http'
+import { executeUsTruckCommand } from '../api/platformOverseasBusiness'
+import { overseasBusinessPermissions } from '../permissions'
+import { availableTruckCommands, truckCommandHints, truckCommandLabels, type TruckCommand, type TruckOperation } from '../truckWorkflow'
+import type { LocalTransportDetail } from '../types'
+
+const props = defineProps<{ detail: LocalTransportDetail }>()
+const emit = defineEmits<{ updated: [detail: LocalTransportDetail] }>()
+const access = useAccessPreviewStore()
+const commands = computed(() => access.can(overseasBusinessPermissions.truckStatus) ? availableTruckCommands(props.detail) : [])
+const open = ref(false), saving = ref(false)
+const active = ref<TruckCommand | null>(null)
+const error = ref<ApiErrorDetails | null>(null), validationError = ref('')
+// 响应丢失时保留原命令、版本和幂等键，重试不得变更请求内容。
+const pending = ref<TruckOperation | null>(null)
+const form = reactive({ decision: 'APPROVE' as 'APPROVE' | 'REJECT', actualPalletCount: 1, packageCount: undefined as number | undefined, palletIds: [] as string[], remark: '' })
+const selectablePallets = computed(() => props.detail.pallets.filter(pallet => pallet.status === 'RECEIVED'))
+const review = computed(() => active.value === 'review' || active.value === 'review-pallet-overage')
+const { captureBaseline } = useUnsavedWorkRegistration({ key: 'truck-order-command', label: computed(() => active.value ? truckCommandLabels[active.value] : '卡车单据操作'), isOpen: open, model: form, requiredPermission: computed(() => overseasBusinessPermissions.truckStatus) })
+
+watch(() => [props.detail.customerId, props.detail.orderNo, props.detail.version], () => {
+  pending.value = null; open.value = false; active.value = null; error.value = null
+})
+
+function start(command: TruckCommand) {
+  if (saving.value || !commands.value.includes(command)) return
+  if (pending.value) {
+    active.value = pending.value.command; open.value = true
+    return
+  }
+  active.value = command; error.value = null; validationError.value = ''
+  Object.assign(form, { decision: 'APPROVE', actualPalletCount: Math.max(1, props.detail.receivedPalletCount), packageCount: undefined, palletIds: [], remark: '' })
+  open.value = true; captureBaseline()
+}
+
+function buildOperation(): TruckOperation | null {
+  if (!active.value) return null
+  const base = { version: props.detail.version, idempotencyKey: crypto.randomUUID(), remark: form.remark.trim() || undefined }
+  if ((active.value === 'cancel' || (review.value && form.decision === 'REJECT')) && !base.remark) {
+    validationError.value = '请填写拒绝或取消原因'; return null
+  }
+  switch (active.value) {
+    case 'review': case 'review-pallet-overage': return { command: active.value, payload: { ...base, decision: form.decision } }
+    case 'receive-pallets':
+      if (!Number.isSafeInteger(form.actualPalletCount) || form.actualPalletCount < Math.max(1, props.detail.receivedPalletCount)) {
+        validationError.value = '累计实收托数须为正整数，且不能少于已实收托数'; return null
+      }
+      if (form.packageCount != null && (!Number.isSafeInteger(form.packageCount) || form.packageCount < 0)) {
+        validationError.value = '实收件数须为非负整数'; return null
+      }
+      return { command: active.value, payload: { ...base, actualPalletCount: form.actualPalletCount, ...(form.packageCount == null ? {} : { packageCount: form.packageCount }) } }
+    case 'allocate-pallets':
+      if (!form.palletIds.length || form.palletIds.some(id => !selectablePallets.value.some(pallet => pallet.id === id))) {
+        validationError.value = '请至少选择一个已实收且未分配的托盘'; return null
+      }
+      return { command: active.value, payload: { ...base, palletIds: [...form.palletIds] } }
+    case 'cancel': return { command: active.value, payload: { ...base, status: 'CANCELLED' } }
+    default: return { command: active.value, payload: base }
+  }
+}
+
+async function submit() {
+  if (saving.value || !active.value || !commands.value.includes(active.value)) return
+  validationError.value = ''; error.value = null
+  const operation = pending.value ?? buildOperation()
+  if (!operation) return
+  pending.value = operation; saving.value = true
+  const customerId = props.detail.customerId, orderNo = props.detail.orderNo
+  try {
+    const updated = await executeUsTruckCommand(orderNo, customerId, operation)
+    if (props.detail.customerId !== customerId || props.detail.orderNo !== orderNo) return
+    pending.value = null; open.value = false; captureBaseline()
+    ElMessage.success(`${truckCommandLabels[operation.command]}成功`)
+    emit('updated', updated)
+  } catch (cause) {
+    if (props.detail.customerId === customerId && props.detail.orderNo === orderNo) error.value = getApiErrorDetails(cause, '操作未确认成功，请重试或刷新订单核对最新记录')
+  } finally { saving.value = false }
+}
+</script>
+
+<template>
+  <div v-if="commands.length" class="truck-order-actions">
+    <el-button v-for="command in commands" :key="command" :type="command === 'cancel' ? 'danger' : 'primary'" :plain="command === 'cancel'" :disabled="saving" @click="start(command)">{{ truckCommandLabels[command] }}</el-button>
+    <p v-if="pending && !open" role="status">上次操作尚未确认结果，请重新打开重试，或刷新订单核对最新记录。</p>
+  </div>
+  <AppDialog v-model="open" class="admin-density-dialog" :title="active ? truckCommandLabels[active] : '单据操作'" width="680px" :confirm-text="pending ? '重试原操作' : '确认提交'" :confirm-type="active === 'cancel' || (review && form.decision === 'REJECT') ? 'danger' : 'primary'" :confirm-loading="saving" :confirm-disabled="!active || !commands.includes(active)" @confirm="submit">
+    <template v-if="active">
+      <p>{{ detail.orderNo }} · {{ truckCommandHints[active] }}</p>
+      <el-alert v-if="validationError" :title="validationError" type="warning" :closable="false" role="alert" />
+      <div v-if="error" role="alert"><el-alert :title="error.message" type="error" :closable="false" /><ApiErrorMeta :details="error" /><p>可重试原操作；如提示版本冲突，请关闭弹框并刷新订单，核对最新状态及操作记录。</p></div>
+      <el-form :model="form" label-width="130px" :disabled="saving || !!pending" @submit.prevent="submit">
+        <el-form-item v-if="review" label="审核结果"><el-radio-group v-model="form.decision"><el-radio value="APPROVE">通过</el-radio><el-radio value="REJECT">拒绝</el-radio></el-radio-group></el-form-item>
+        <template v-if="active === 'receive-pallets'">
+          <el-form-item label="累计实收托数" required><el-input-number v-model="form.actualPalletCount" :min="Math.max(1, detail.receivedPalletCount)" :precision="0" /></el-form-item>
+          <el-form-item label="实收件数"><el-input-number v-model="form.packageCount" :min="0" :precision="0" placeholder="选填" /></el-form-item>
+        </template>
+        <el-form-item v-if="active === 'allocate-pallets'" label="分配托盘" required>
+          <el-checkbox-group v-model="form.palletIds"><el-checkbox v-for="pallet in selectablePallets" :key="pallet.id" :value="pallet.id">{{ pallet.palletNo }}（{{ pallet.packageCount ?? '未登记' }} 件）</el-checkbox></el-checkbox-group>
+          <p v-if="!selectablePallets.length">暂无可分配托盘，请刷新核对实收记录。</p>
+        </el-form-item>
+        <el-form-item :label="review ? '审核意见' : '操作说明'" :required="active === 'cancel' || (review && form.decision === 'REJECT')"><el-input v-model="form.remark" type="textarea" :rows="3" maxlength="1000" show-word-limit /></el-form-item>
+      </el-form>
+    </template>
+  </AppDialog>
+</template>
+
+<style scoped>
+.truck-order-actions { display: flex; align-items: center; flex-wrap: wrap; gap: 8px; }
+.truck-order-actions p { flex-basis: 100%; margin: 0; color: var(--cc-muted); }
+</style>

src/modules/overseas-business/pages/TransportOrdersView.vue

@@ -1,7 +1,7 @@
 <script setup lang="ts">
 import '@/styles/adminDensity.css'
 import { inquiryReturnTarget, TransportRouteDialog, routeLocation, type RouteLocation } from '@/modules/overseas-master-data'
-import { computed, onMounted, ref, watch } from 'vue'
+import { computed, onActivated, onMounted, ref, watch } from 'vue'
 import { useRoute, useRouter } from 'vue-router'
 import { Plus } from '@lucide/vue'
 import AdminPage from '@/shared/components/AdminPage.vue'
@@ -11,6 +11,8 @@ import ListPageLayout from '@/shared/components/ListPageLayout.vue'
 import LoadErrorState from '@/shared/components/LoadErrorState.vue'
 import QueryToolbar, { type QueryField, type QueryModel } from '@/shared/components/QueryToolbar.vue'
 import AppDialog from '@/shared/components/AppDialog.vue'
+import RowActions, { type RowActionItem } from '@/shared/components/RowActions.vue'
+import { truckStatusLabels } from '../truckWorkflow'
 import FleetArrangementSummary from '../components/FleetArrangementSummary.vue'
 import { poolOrderStatusLabels, type FleetArrangement } from '../fleetArrangement'
 import { getApiErrorDetails, type ApiErrorDetails } from '@/shared/api/http'
@@ -37,7 +39,6 @@ const page = ref(1); const pageSize = ref(20); const total = ref(0)
 const arrangementOpen = ref(false), arrangement = ref<FleetArrangement | null>(null)
 function showArrangement(row: LocalTransportOrder | LocalLooseboardOrder) { arrangement.value = row.fleetArrangement; arrangementOpen.value = true }
 const filters = ref<QueryModel>({ orderNo: String(route.query.orderNo || ''), status: '', routeKeyword: '' }); const applied = ref({ ...filters.value })
-const truckStatusLabels: Record<LocalTransportStatus, string> = { PENDING_REVIEW: '待审核', WAITING_INBOUND: '待入仓', RECEIVING: '收货中', WAITING_CONSOLIDATION: '待合托', PALLET_OVERAGE_REVIEW: '超托待审', PARTIALLY_ALLOCATED: '部分分配', ALLOCATED: '已分配', PENDING_DISPATCH: '待派车', DISPATCHED: '已派车', IN_TRANSIT: '运输中', COMPLETED: '已完成', REJECTED: '已拒绝', CANCELLED: '已取消' }
 const looseboardStatusLabels: Record<LocalLooseboardStatus, string> = { PENDING_ACCEPTANCE: '待接单', WAITING_INBOUND: '待入仓', RECEIVING: '收货中', WAITING_CONSOLIDATION: '待合托', PENDING_DISPATCH: '待派车', DISPATCHED: '已派车', IN_TRANSIT: '运输中', COMPLETED: '已完成', CANCELLED: '已取消', ...poolOrderStatusLabels }
 const transportTypeLabels: Record<LocalTransportType, string> = { PORT_PICKUP: '港口提柜', WAREHOUSE_TO_WAREHOUSE: '仓到仓', WAREHOUSE_TO_DOOR: '仓到门' }
 const fields = computed<QueryField[]>(() => [
@@ -46,7 +47,7 @@ const fields = computed<QueryField[]>(() => [
   { key: 'routeKeyword', type: 'input', label: '运输路线', placeholder: '起运地/目的地', width: 240 },
 ])
 const truckColumns: DataTableColumn[] = [
-  { key: 'actions', label: '操作', width: 110, fixed: 'left', slotName: 'actions' }, { key: 'orderNo', prop: 'orderNo', label: '订单编号', minWidth: 170 },
+  { key: 'actions', label: '操作', width: 220, fixed: 'left', slotName: 'actions' }, { key: 'orderNo', prop: 'orderNo', label: '订单编号', minWidth: 170 },
   { key: 'vehicleType', label: '车辆类型', minWidth: 110, formatter: (row: LocalTransportOrder) => row.vehicleType ? ({ PALLET_15: '15拖', PALLET_30: '30拖' })[row.vehicleType] : '—' },
   { key: 'origin', prop: 'origin', label: '起运地', minWidth: 145 }, { key: 'destination', prop: 'destination', label: '目的地', minWidth: 145 },
   { key: 'originContactName', prop: 'originContactName', label: '起运地联系人', minWidth: 125 }, { key: 'originContactPhone', prop: 'originContactPhone', label: '起运地联系电话', minWidth: 155 },
@@ -97,6 +98,20 @@ function search(model: QueryModel) { applied.value = { ...model }; if (page.valu
 function openCreate() { void router.push({ name: isLooseboard.value ? 'overseas-business-looseboard-new' : 'overseas-business-truck-new' }) }
 function canEdit(row: LocalTransportOrder | LocalLooseboardOrder) { return !row.fleetArrangement && (isLooseboard.value ? row.status === 'PENDING_ACCEPTANCE' : row.status === 'PENDING_REVIEW') }
 function openEdit(row: LocalTransportOrder | LocalLooseboardOrder) { if (!canEdit(row)) return; void router.push({ name: isLooseboard.value ? 'overseas-business-looseboard-edit' : 'overseas-business-truck-edit', params: { orderId: row.orderNo }, query: { customerId: row.customerId } }) }
+function truckActions(row: LocalTransportOrder): RowActionItem[] {
+  return [
+    { key: 'detail', label: row.status === 'PENDING_REVIEW' && !row.fleetArrangement && access.can(overseasBusinessPermissions.truckStatus) ? '审核' : '详情', priority: 10 },
+    { key: 'edit', label: '编辑', visible: !row.fleetArrangement && access.can(editPermission.value), disabled: !canEdit(row) },
+    { key: 'arrangement', label: '承运安排', visible: !!row.fleetArrangement },
+  ]
+}
+function handleTruckAction(key: string, row: LocalTransportOrder) {
+  if (key === 'edit') openEdit(row)
+  else if (key === 'arrangement') showArrangement(row)
+  else if (key === 'detail') void router.push({ name: 'overseas-business-truck-detail', params: { orderId: row.orderNo }, query: { customerId: row.customerId } })
+}
+let activatedOnce = false
+onActivated(() => { if (activatedOnce) void load(); else activatedOnce = true })
 watch([page, pageSize], () => { void load() }); watch([isLooseboard, () => route.query.orderNo], () => { page.value = 1; applied.value = { orderNo: String(route.query.orderNo || ''), status: '', routeKeyword: '' }; filters.value = { ...applied.value }; void load() }); onMounted(() => { void load() })
 </script>
 
@@ -111,7 +126,7 @@ watch([page, pageSize], () => { void load() }); watch([isLooseboard, () => route
 
 
       <template #toolbar-actions><el-button v-if="access.can(createPermission)" type="primary" @click="openCreate"><Plus :size="16" />新增订单</el-button></template>
-      <template #actions="{ row }"><div class="row-actions density-actions admin-text-actions"><el-button v-if="row.fleetArrangement" class="density-action" @click="showArrangement(row as LocalTransportOrder | LocalLooseboardOrder)">承运安排</el-button><el-tooltip v-if="!row.fleetArrangement && access.can(editPermission)" :disabled="canEdit(row as LocalTransportOrder | LocalLooseboardOrder)" content="当前状态不可编辑"><span><el-button class="density-action" data-tone="neutral" size="small" :disabled="!canEdit(row as LocalTransportOrder | LocalLooseboardOrder)" @click="openEdit(row as LocalTransportOrder | LocalLooseboardOrder)">编辑</el-button></span></el-tooltip></div></template>
+      <template #actions="{ row }"><RowActions v-if="!isLooseboard" :actions="truckActions(row as LocalTransportOrder)" text-actions @action="handleTruckAction($event, row as LocalTransportOrder)" /><div v-else class="row-actions density-actions admin-text-actions"><el-button v-if="row.fleetArrangement" class="density-action" @click="showArrangement(row as LocalTransportOrder | LocalLooseboardOrder)">承运安排</el-button><el-tooltip v-if="!row.fleetArrangement && access.can(editPermission)" :disabled="canEdit(row as LocalTransportOrder | LocalLooseboardOrder)" content="当前状态不可编辑"><span><el-button class="density-action" data-tone="neutral" size="small" :disabled="!canEdit(row as LocalTransportOrder | LocalLooseboardOrder)" @click="openEdit(row as LocalTransportOrder | LocalLooseboardOrder)">编辑</el-button></span></el-tooltip></div></template>
       <template #pagination-left>共 {{ total }} 条{{ domainLabel }}订单</template>
       <template #routeMap="{ row }"><el-button v-if="row.orderNo" link type="primary" @click="openRoute(row as LocalLooseboardOrder)">查看路线</el-button></template>
     </DataTable></section>

src/modules/overseas-business/pages/TruckOrderDetailView.test.ts

@@ -0,0 +1,194 @@
+import ElementPlus from 'element-plus'
+import { createPinia, setActivePinia } from 'pinia'
+import { enableAutoUnmount, flushPromises, mount, type VueWrapper } from '@vue/test-utils'
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import { useAuthStore } from '@/core/auth/auth'
+import { useAccessPreviewStore } from '@/core/access/accessPreview'
+import { ApiResponseError } from '@/shared/api/http'
+import AppDialog from '@/shared/components/AppDialog.vue'
+import TruckOrderActions from '../components/TruckOrderActions.vue'
+import { executeUsTruckCommand, getUsTruckOrder } from '../api/platformOverseasBusiness'
+import { overseasBusinessPermissions as permissions } from '../permissions'
+import type { LocalTransportDetail } from '../types'
+import TruckOrderDetailView from './TruckOrderDetailView.vue'
+
+const routing = vi.hoisted(() => ({ push: vi.fn(), route: { params: { orderId: 'TR-TEST' }, query: { customerId: '9007199254741999' } as Record<string, string> } }))
+vi.mock('vue-router', () => ({ useRoute: () => routing.route, useRouter: () => ({ push: routing.push }) }))
+vi.mock('../api/platformOverseasBusiness', () => ({ getUsTruckOrder: vi.fn(), executeUsTruckCommand: vi.fn() }))
+vi.mock('@/core/unsaved-work/useUnsavedWorkRegistration', () => ({ useUnsavedWorkRegistration: () => ({ captureBaseline: vi.fn() }) }))
+
+function order(overrides: Partial<LocalTransportDetail> = {}): LocalTransportDetail {
+  return {
+    id: '9007199254741001', orderNo: 'TR-TEST', customerId: '9007199254741999', fleetArrangement: null,
+    vehicleType: 'PALLET_15', origin: 'LA', originAddress: '起运仓地址', destination: 'ONT', destinationAddress: '目的仓地址',
+    originContactName: '发货人', originContactPhone: '10001', destinationContactName: '收货人', destinationContactPhone: '10002',
+    pickupAt: '2026-10-20T09:30:00', deliveryAt: '2026-10-20T15:45:00',
+    palletCount: 0, receivedPalletCount: 0, allocatedPalletCount: 0, shippedPalletCount: 0, packageCount: 20,
+    totalWeightKg: '100', totalVolumeCbm: '2', budgetAmount: '500', currency: 'USD',
+    status: 'PENDING_REVIEW', version: 1, remark: '运输备注', createdBy: '7', createdAt: '2026-10-20T08:00:00', updatedAt: '2026-10-20T08:00:00',
+    pallets: [], histories: [], ...overrides,
+  }
+}
+function mountDetail(manage = true) {
+  const pinia = createPinia(); setActivePinia(pinia)
+  const auth = useAuthStore(); auth.token = 'test-token'; auth.user = { id: '7', name: '操作员', account: 'tester', roles: [] }
+  auth.permissions = [permissions.truckList, ...(manage ? [permissions.truckStatus] : [])]
+  useAccessPreviewStore().initializeAfterLogin()
+  return mount(TruckOrderDetailView, { global: { plugins: [pinia, ElementPlus], stubs: { teleport: true } } })
+}
+async function click(wrapper: VueWrapper, label: string) {
+  const button = wrapper.findAll('button').find(item => item.text() === label)
+  expect(button, `button ${label}`).toBeDefined()
+  await button!.trigger('click'); await flushPromises()
+}
+async function confirm(wrapper: VueWrapper) {
+  wrapper.findComponent(AppDialog).vm.$emit('confirm'); await flushPromises()
+}
+const formModel = (wrapper: VueWrapper) => wrapper.findComponent(TruckOrderActions).findComponent({ name: 'ElForm' }).props('model')
+
+enableAutoUnmount(afterEach)
+beforeEach(() => {
+  vi.clearAllMocks()
+  vi.stubGlobal('ResizeObserver', class { observe() {} unobserve() {} disconnect() {} })
+  routing.route.params = { orderId: 'TR-TEST' }; routing.route.query = { customerId: '9007199254741999' }
+  vi.mocked(getUsTruckOrder).mockResolvedValue(order())
+})
+afterEach(() => vi.unstubAllGlobals())
+
+describe('truck review and fulfillment', () => {
+  it('loads customer scoped documents and runs review through receipt, allocation and delivery completion', async () => {
+    let current = order()
+    vi.mocked(executeUsTruckCommand).mockImplementation(async (_no, _customer, operation) => {
+      const next = { ...current, version: current.version + 1 }
+      switch (operation.command) {
+        case 'review': next.status = 'WAITING_INBOUND'; break
+        case 'receive-pallets':
+          next.status = 'WAITING_CONSOLIDATION'; next.palletCount = 2; next.receivedPalletCount = 2
+          next.pallets = [1, 2].map(sequenceNo => ({ id: `900719925474100${sequenceNo}`, sequenceNo, palletNo: `P-${sequenceNo}`, source: 'PDA_RECEIPT', status: 'RECEIVED', warehousePalletId: null, packageCount: 10, receivedAt: '2026-10-20T10:00:00' }))
+          break
+        case 'allocate-pallets': next.status = 'ALLOCATED'; next.allocatedPalletCount = 2; next.pallets = next.pallets.map(row => ({ ...row, status: 'ALLOCATED' })); break
+        case 'prepare-dispatch': next.status = 'PENDING_DISPATCH'; break
+        case 'dispatch': next.status = 'DISPATCHED'; break
+        case 'start-transit': next.status = 'IN_TRANSIT'; break
+        case 'complete': next.status = 'COMPLETED'; break
+      }
+      next.histories = [...current.histories, { operationType: operation.command === 'review' ? 'REVIEW' : operation.command.toUpperCase().replaceAll('-', '_'), fromStatus: current.status, toStatus: next.status, operatorId: '操作员7', remark: operation.payload.remark || null, createdAt: '2026-10-20T10:00:00' }]
+      current = next; return next
+    })
+    const wrapper = mountDetail(); await flushPromises()
+    expect(getUsTruckOrder).toHaveBeenCalledWith('TR-TEST', '9007199254741999')
+    expect(wrapper.text()).toContain('起运仓地址'); expect(wrapper.text()).toContain('审核与操作记录')
+    await click(wrapper, '审核'); formModel(wrapper).remark = '资料核对通过'; await confirm(wrapper)
+    expect(wrapper.text()).toContain('登记实收'); expect(wrapper.text()).toContain('资料核对通过')
+    await click(wrapper, '登记实收'); Object.assign(formModel(wrapper), { actualPalletCount: 2, packageCount: 20 }); await confirm(wrapper)
+    await click(wrapper, '分配托盘'); formModel(wrapper).palletIds = current.pallets.map(row => row.id); await confirm(wrapper)
+    for (const label of ['确认待派车', '确认已派车', '确认发运', '确认完成']) { await click(wrapper, label); await confirm(wrapper) }
+    expect(wrapper.findComponent(TruckOrderActions).findAll('button')).toHaveLength(0)
+    expect(current.status).toBe('COMPLETED')
+    expect(vi.mocked(executeUsTruckCommand).mock.calls.map(call => call[2].payload.version)).toEqual([1, 2, 3, 4, 5, 6, 7])
+    expect(vi.mocked(executeUsTruckCommand).mock.calls[2][2]).toMatchObject({ command: 'allocate-pallets', payload: { palletIds: ['9007199254741001', '9007199254741002'] } })
+  })
+
+  it('requires a rejection reason and displays the resulting rejected state', async () => {
+    const wrapper = mountDetail(); await flushPromises(); await click(wrapper, '审核')
+    formModel(wrapper).decision = 'REJECT'; await confirm(wrapper)
+    expect(executeUsTruckCommand).not.toHaveBeenCalled(); expect(wrapper.text()).toContain('请填写拒绝或取消原因')
+    formModel(wrapper).remark = '取送时间需重新确认'
+    vi.mocked(executeUsTruckCommand).mockResolvedValue(order({ status: 'REJECTED', version: 2 }))
+    await confirm(wrapper)
+    expect(executeUsTruckCommand).toHaveBeenCalledWith('TR-TEST', '9007199254741999', expect.objectContaining({ command: 'review', payload: expect.objectContaining({ decision: 'REJECT', remark: '取送时间需重新确认', version: 1 }) }))
+    expect(wrapper.findComponent(TruckOrderActions).findAll('button')).toHaveLength(0)
+  })
+
+  it('preserves one immutable request and retries it after an ambiguous failure, then refreshes the detail', async () => {
+    vi.mocked(executeUsTruckCommand).mockRejectedValueOnce(new ApiResponseError('订单版本冲突', 'A0409', 409, 'TRUCK-409')).mockResolvedValueOnce(order({ status: 'WAITING_INBOUND', version: 2 }))
+    const wrapper = mountDetail(); await flushPromises(); await click(wrapper, '审核')
+    formModel(wrapper).remark = '核对完成'; await confirm(wrapper)
+    expect(wrapper.text()).toContain('订单版本冲突')
+    expect(wrapper.findComponent({ name: 'ElForm' }).props('disabled')).toBe(true)
+    const original = structuredClone(vi.mocked(executeUsTruckCommand).mock.calls[0][2])
+    wrapper.findComponent(AppDialog).vm.$emit('update:modelValue', false); await flushPromises()
+    await click(wrapper, '审核'); await confirm(wrapper)
+    expect(vi.mocked(executeUsTruckCommand).mock.calls[1][2]).toEqual(original)
+    expect(wrapper.text()).toContain('登记实收')
+  })
+
+  it('locks duplicate submission until the original response arrives', async () => {
+    let finish!: (value: LocalTransportDetail) => void
+    vi.mocked(executeUsTruckCommand).mockImplementation(() => new Promise(resolve => { finish = resolve }))
+    const wrapper = mountDetail(); await flushPromises(); await click(wrapper, '审核'); await confirm(wrapper); await confirm(wrapper)
+    expect(executeUsTruckCommand).toHaveBeenCalledTimes(1)
+    expect(wrapper.findComponent(AppDialog).props('confirmLoading')).toBe(true)
+    finish(order({ status: 'WAITING_INBOUND', version: 2 })); await flushPromises()
+    expect(wrapper.text()).toContain('登记实收')
+  })
+
+  it('validates cumulative receipt totals without submitting invalid input', async () => {
+    vi.mocked(getUsTruckOrder).mockResolvedValue(order({ status: 'RECEIVING', palletCount: 3, receivedPalletCount: 2 }))
+    const wrapper = mountDetail(); await flushPromises(); await click(wrapper, '登记实收')
+    formModel(wrapper).actualPalletCount = 1; await confirm(wrapper)
+    expect(executeUsTruckCommand).not.toHaveBeenCalled(); expect(wrapper.text()).toContain('不能少于已实收托数')
+    Object.assign(formModel(wrapper), { actualPalletCount: 3, packageCount: -1 }); await confirm(wrapper)
+    expect(executeUsTruckCommand).not.toHaveBeenCalled()
+  })
+
+  it('requires received pallets and permits partial allocation using their string IDs', async () => {
+    const pallet = { id: '9007199254741007', sequenceNo: 1, palletNo: 'P-1', source: 'PDA_RECEIPT', status: 'RECEIVED', warehousePalletId: null, packageCount: 10, receivedAt: null }
+    vi.mocked(getUsTruckOrder).mockResolvedValue(order({ status: 'WAITING_CONSOLIDATION', palletCount: 2, receivedPalletCount: 2, pallets: [pallet] }))
+    const wrapper = mountDetail(); await flushPromises(); await click(wrapper, '分配托盘'); await confirm(wrapper)
+    expect(executeUsTruckCommand).not.toHaveBeenCalled()
+    formModel(wrapper).palletIds = [pallet.id]
+    vi.mocked(executeUsTruckCommand).mockResolvedValue(order({ status: 'PARTIALLY_ALLOCATED', version: 2, allocatedPalletCount: 1, pallets: [{ ...pallet, status: 'ALLOCATED' }] }))
+    await confirm(wrapper)
+    expect(wrapper.text()).toContain('部分分配'); expect(wrapper.text()).not.toContain('确认待派车')
+    expect(executeUsTruckCommand).toHaveBeenCalledWith('TR-TEST', '9007199254741999', expect.objectContaining({ command: 'allocate-pallets', payload: expect.objectContaining({ palletIds: [pallet.id] }) }))
+  })
+
+  it.each(['APPROVE', 'REJECT'] as const)('reviews pallet overage with %s', async decision => {
+    vi.mocked(getUsTruckOrder).mockResolvedValue(order({ status: 'PALLET_OVERAGE_REVIEW', palletCount: 2, receivedPalletCount: 3 }))
+    vi.mocked(executeUsTruckCommand).mockResolvedValue(order({ status: 'WAITING_CONSOLIDATION', version: 2 }))
+    const wrapper = mountDetail(); await flushPromises(); await click(wrapper, '超托审核')
+    Object.assign(formModel(wrapper), { decision, remark: '已核对超收货物' }); await confirm(wrapper)
+    expect(executeUsTruckCommand).toHaveBeenCalledWith('TR-TEST', '9007199254741999', expect.objectContaining({ command: 'review-pallet-overage', payload: expect.objectContaining({ decision }) }))
+  })
+
+  it('requires cancellation reason and submits only the cancellation status', async () => {
+    const wrapper = mountDetail(); await flushPromises(); await click(wrapper, '取消订单'); await confirm(wrapper)
+    expect(executeUsTruckCommand).not.toHaveBeenCalled()
+    formModel(wrapper).remark = '客户取消需求'; vi.mocked(executeUsTruckCommand).mockResolvedValue(order({ status: 'CANCELLED', version: 2 })); await confirm(wrapper)
+    expect(executeUsTruckCommand).toHaveBeenCalledWith('TR-TEST', '9007199254741999', expect.objectContaining({ command: 'cancel', payload: expect.objectContaining({ status: 'CANCELLED', remark: '客户取消需求' }) }))
+  })
+
+  it('keeps list-only users read-only and guards direct attempts to emit submit', async () => {
+    const wrapper = mountDetail(false); await flushPromises()
+    expect(wrapper.findComponent(TruckOrderActions).findAll('button')).toHaveLength(0)
+    wrapper.findComponent(AppDialog).vm.$emit('confirm'); await flushPromises()
+    expect(executeUsTruckCommand).not.toHaveBeenCalled()
+  })
+
+  it('keeps pool sourced orders on the existing fleet fulfillment path', async () => {
+    vi.mocked(getUsTruckOrder).mockResolvedValue(order({ fleetArrangement: {
+      sourceType: 'FLEET_CAPACITY_OFFER', businessType: 'US_TRUCK', businessOrderNo: 'TR-TEST', bookingNo: 'FB-TEST', tripNo: 'TRIP-TEST',
+      plannedDepartureAt: null, originWarehouseName: 'LA', destinationLabel: 'ONT', deliveryMode: 'SELF_DELIVERY', deliveryInstructions: null,
+      fulfillmentStage: 'WAITING_INBOUND', stageOccurredAt: null, agreedFreightAmount: null, currency: 'USD', incomingNo: null, dispatchNo: null,
+      deliveryNo: null, signedPackages: null, unsignedPackages: null, returnedPackages: null, exceptionSummary: null, readOnlyReason: '按拼车承运实际履约推进',
+    } }))
+    const wrapper = mountDetail(); await flushPromises()
+    expect(wrapper.text()).toContain('按拼车承运实际履约推进')
+    expect(wrapper.findComponent(TruckOrderActions).exists()).toBe(false)
+    expect(executeUsTruckCommand).not.toHaveBeenCalled()
+  })
+
+  it('shows a scoped error without requesting detail when customer is missing', async () => {
+    routing.route.query = {}; const wrapper = mountDetail(); await flushPromises()
+    expect(getUsTruckOrder).not.toHaveBeenCalled(); expect(wrapper.text()).toContain('缺少有效客户或订单信息')
+  })
+
+  it('retains error metadata and retries a failed detail read', async () => {
+    vi.mocked(getUsTruckOrder).mockRejectedValueOnce(new ApiResponseError('读取失败', 'A0409', 409, 'DETAIL-409')).mockResolvedValueOnce(order())
+    const wrapper = mountDetail(); await flushPromises()
+    expect(wrapper.text()).toContain('读取失败'); expect(wrapper.text()).toContain('DETAIL-409')
+    await wrapper.findComponent({ name: 'LoadErrorState' }).vm.$emit('retry'); await flushPromises()
+    expect(wrapper.text()).toContain('TR-TEST'); expect(wrapper.text()).toContain('审核与操作记录')
+  })
+})

src/modules/overseas-business/pages/TruckOrderDetailView.vue

@@ -0,0 +1,86 @@
+<script setup lang="ts">
+import '@/styles/adminDensity.css'
+import { computed, ref, watch } from 'vue'
+import { useRoute, useRouter } from 'vue-router'
+import { ArrowLeft } from '@lucide/vue'
+import AdminPage from '@/shared/components/AdminPage.vue'
+import DetailPageLayout from '@/shared/components/DetailPageLayout.vue'
+import DataTable, { type DataTableColumn } from '@/shared/components/DataTable.vue'
+import ApiErrorMeta from '@/shared/components/ApiErrorMeta.vue'
+import LoadErrorState from '@/shared/components/LoadErrorState.vue'
+import { getApiErrorDetails, type ApiErrorDetails } from '@/shared/api/http'
+import { getUsTruckOrder } from '../api/platformOverseasBusiness'
+import FleetArrangementSummary from '../components/FleetArrangementSummary.vue'
+import TruckOrderActions from '../components/TruckOrderActions.vue'
+import { truckStatusLabels } from '../truckWorkflow'
+import type { LocalTransportDetail, LocalTransportPallet, OverseasBusinessHistory } from '../types'
+
+const route = useRoute(), router = useRouter()
+const orderNo = computed(() => typeof route.params.orderId === 'string' ? route.params.orderId : '')
+const customerId = computed(() => typeof route.query.customerId === 'string' ? route.query.customerId : '')
+const detail = ref<LocalTransportDetail | null>(null), loading = ref(false)
+const error = ref<ApiErrorDetails | null>(null)
+let requestSequence = 0
+const dateTime = (value: string | null | undefined) => value ? value.replace('T', ' ').slice(0, 16) : '—'
+const statusLabel = (value: string | null) => value ? truckStatusLabels[value as keyof typeof truckStatusLabels] || value : '—'
+const fields = computed(() => detail.value ? [
+  ['客户编号', detail.value.customerId], ['车辆类型', detail.value.vehicleType ? ({ PALLET_15: '15拖', PALLET_30: '30拖' })[detail.value.vehicleType] : '—'],
+  ['起运地', detail.value.origin], ['起运地详细地址', detail.value.originAddress], ['起运地联系人', detail.value.originContactName], ['起运地联系电话', detail.value.originContactPhone],
+  ['目的地', detail.value.destination], ['目的地详细地址', detail.value.destinationAddress], ['目的地联系人', detail.value.destinationContactName], ['目的地联系电话', detail.value.destinationContactPhone],
+  ['取货时间', dateTime(detail.value.pickupAt)], ['送货时间', dateTime(detail.value.deliveryAt)],
+  ['申报件数', detail.value.packageCount], ['总重量（kg）', detail.value.totalWeightKg], ['总体积（m³）', detail.value.totalVolumeCbm],
+  ['预算总价', detail.value.budgetAmount == null ? '—' : `${detail.value.budgetAmount} ${detail.value.currency}`],
+  ['已确认托数', detail.value.palletCount], ['累计实收托数', detail.value.receivedPalletCount], ['已分配托数', detail.value.allocatedPalletCount],
+  ['创建时间', dateTime(detail.value.createdAt)], ['备注', detail.value.remark],
+] : [])
+const palletLabels: Record<string, string> = { PLANNED: '待实收', RECEIVED: '已实收', ALLOCATED: '已分配', OVERAGE_PENDING_REVIEW: '超托待审', OVERAGE_REJECTED: '超托拒收' }
+const palletColumns: DataTableColumn[] = [
+  { key: 'palletNo', prop: 'palletNo', label: '托盘编号', minWidth: 180 },
+  { key: 'status', label: '状态', width: 130, formatter: (row: LocalTransportPallet) => palletLabels[row.status] || row.status },
+  { key: 'packageCount', prop: 'packageCount', label: '实收件数', width: 120 },
+  { key: 'receivedAt', label: '实收时间', minWidth: 170, formatter: (row: LocalTransportPallet) => dateTime(row.receivedAt) },
+]
+const operations: Record<string, string> = { CREATE: '创建', UPDATE: '编辑', REVIEW: '订单审核', RECEIVE_PALLETS: '登记实收', REVIEW_PALLET_OVERAGE: '超托审核', ALLOCATE_PALLETS: '分配托盘', PREPARE_DISPATCH: '确认待派车', DISPATCH: '确认已派车', START_TRANSIT: '确认发运', COMPLETE: '确认完成', CANCEL: '取消订单' }
+const historyColumns: DataTableColumn[] = [
+  { key: 'createdAt', label: '操作时间', minWidth: 170, formatter: (row: OverseasBusinessHistory) => dateTime(row.createdAt) },
+  { key: 'operationType', label: '操作', minWidth: 130, formatter: (row: OverseasBusinessHistory) => operations[row.operationType || ''] || row.operationType || '—' },
+  { key: 'fromStatus', label: '原状态', width: 130, formatter: (row: OverseasBusinessHistory) => statusLabel(row.fromStatus) },
+  { key: 'toStatus', label: '新状态', width: 130, formatter: (row: OverseasBusinessHistory) => statusLabel(row.toStatus) },
+  { key: 'operatorId', prop: 'operatorId', label: '操作人', minWidth: 140 }, { key: 'remark', prop: 'remark', label: '审核意见／操作说明', minWidth: 240 },
+]
+async function load() {
+  const sequence = ++requestSequence
+  detail.value = null; error.value = null
+  if (!orderNo.value || !customerId.value || customerId.value === '0') {
+    loading.value = false; error.value = { message: '缺少有效客户或订单信息，请返回本土卡车列表重新打开' }; return
+  }
+  loading.value = true
+  try { const result = await getUsTruckOrder(orderNo.value, customerId.value); if (sequence === requestSequence) detail.value = result }
+  catch (cause) { if (sequence === requestSequence) error.value = getApiErrorDetails(cause, '本土卡车订单加载失败，请稍后重试') }
+  finally { if (sequence === requestSequence) loading.value = false }
+}
+watch([orderNo, customerId], load, { immediate: true })
+</script>
+
+<template>
+  <AdminPage class="admin-density"><DetailPageLayout aria-label="本土卡车订单详情">
+    <template #header><div class="truck-detail-header"><el-button @click="router.push({ name: 'overseas-business-trucks' })"><ArrowLeft :size="16" />返回列表</el-button><h1>本土卡车订单 {{ detail?.orderNo || orderNo }}</h1></div></template>
+    <LoadErrorState v-if="error" title="本土卡车订单暂时无法加载" :message="error.message" :loading="loading" @retry="load"><template #details><ApiErrorMeta :details="error" /></template></LoadErrorState>
+    <el-skeleton v-else-if="loading" :rows="8" animated />
+    <template v-else-if="detail">
+      <section class="truck-detail-section"><div class="truck-detail-header"><h2>{{ statusLabel(detail.status) }}</h2><el-button @click="load">刷新订单</el-button></div>
+        <FleetArrangementSummary v-if="detail.fleetArrangement" :arrangement="detail.fleetArrangement" />
+        <template v-else><p>审核通过 → 实收托盘 → 分配托盘 → 待派车 → 已派车 → 运输中 → 完成</p><TruckOrderActions :detail="detail" @updated="detail = $event" /></template>
+      </section>
+      <section class="truck-detail-section"><h2>订单资料</h2><el-descriptions :column="3" border><el-descriptions-item v-for="[label, value] in fields" :key="String(label)" :label="String(label)">{{ value ?? '—' }}</el-descriptions-item></el-descriptions></section>
+      <section class="truck-detail-section"><h2>托盘记录</h2><DataTable :data="detail.pallets" :columns="palletColumns" empty-text="暂无托盘记录，独立订单首次实收后生成托盘" /></section>
+      <section class="truck-detail-section"><h2>审核与操作记录</h2><DataTable :data="detail.histories" :columns="historyColumns" empty-text="暂无操作记录" /></section>
+    </template>
+  </DetailPageLayout></AdminPage>
+</template>
+
+<style scoped>
+.truck-detail-header { display: flex; align-items: center; gap: 12px; flex-wrap: wrap; }
+.truck-detail-header h1, .truck-detail-header h2 { margin: 0; }
+.truck-detail-section { margin-bottom: 16px; }
+</style>

src/modules/overseas-business/routes.test.ts

@@ -10,6 +10,7 @@ describe('overseas business routes', () => {
       ['overseas-business/purchases/:purchaseId/edit', permission.purchaseEdit],
       ['overseas-business/trucks', permission.truckList],
       ['overseas-business/trucks/new', permission.truckCreate],
+      ['overseas-business/trucks/:orderId', permission.truckList],
       ['overseas-business/trucks/:orderId/edit', permission.truckEdit],
       ['overseas-business/looseboards', permission.looseboardList],
       ['overseas-business/looseboards/new', permission.looseboardCreate],
@@ -17,10 +18,10 @@ describe('overseas business routes', () => {
     ])
   })
 
-  it('does not invent excluded create or detail routes', () => {
+  it('adds the requested truck detail without opening unrelated routes', () => {
     const paths = overseasBusinessRoutes.map((route) => route.path)
     expect(paths).not.toContain('overseas-business/purchases/new')
-    expect(paths).not.toContain('overseas-business/trucks/:orderId')
+    expect(paths).toContain('overseas-business/trucks/:orderId')
     expect(paths).not.toContain('overseas-business/looseboards/:orderId')
     expect(JSON.stringify(overseasBusinessRoutes)).not.toContain('permissionAnyOf')
   })

src/modules/overseas-business/routes.ts

@@ -34,6 +34,12 @@ export const overseasBusinessRoutes = [
     props: { domain: 'truck' },
     meta: { title: '新增本土卡车订单', description: '创建海外本土卡车订单', permission: permission.truckCreate, showPageHeading: false },
   },
+  {
+    path: 'overseas-business/trucks/:orderId',
+    name: 'overseas-business-truck-detail',
+    component: () => import('./pages/TruckOrderDetailView.vue'),
+    meta: { title: '本土卡车订单详情', description: '审核及处理本土卡车订单', permission: permission.truckList, showPageHeading: false },
+  },
   {
     path: 'overseas-business/trucks/:orderId/edit',
     name: 'overseas-business-truck-edit',

src/modules/overseas-business/truckWorkflow.ts

@@ -0,0 +1,46 @@
+import type { LocalTransportDetail, LocalTransportStatus } from './types'
+
+export const truckStatusLabels: Record<LocalTransportStatus, string> = {
+  PENDING_REVIEW: '待审核', WAITING_INBOUND: '待入仓', RECEIVING: '收货中', WAITING_CONSOLIDATION: '待合托',
+  PALLET_OVERAGE_REVIEW: '超托待审', PARTIALLY_ALLOCATED: '部分分配', ALLOCATED: '已分配',
+  PENDING_DISPATCH: '待派车', DISPATCHED: '已派车', IN_TRANSIT: '运输中', COMPLETED: '已完成', REJECTED: '已拒绝', CANCELLED: '已取消',
+}
+export const truckCommandLabels = {
+  review: '审核', 'receive-pallets': '登记实收', 'review-pallet-overage': '超托审核', 'allocate-pallets': '分配托盘',
+  'prepare-dispatch': '确认待派车', dispatch: '确认已派车', 'start-transit': '确认发运', complete: '确认完成', cancel: '取消订单',
+} as const
+export type TruckCommand = keyof typeof truckCommandLabels
+export interface TruckCommandBase { version: number; idempotencyKey: string; remark?: string }
+export type TruckOperation =
+  | { command: 'review' | 'review-pallet-overage'; payload: TruckCommandBase & { decision: 'APPROVE' | 'REJECT' } }
+  | { command: 'receive-pallets'; payload: TruckCommandBase & { actualPalletCount: number; packageCount?: number; palletPackageCounts?: number[] } }
+  | { command: 'allocate-pallets'; payload: TruckCommandBase & { palletIds: string[] } }
+  | { command: 'prepare-dispatch' | 'dispatch' | 'start-transit' | 'complete'; payload: TruckCommandBase }
+  | { command: 'cancel'; payload: TruckCommandBase & { status: 'CANCELLED' } }
+
+const nextCommands: Partial<Record<LocalTransportStatus, TruckCommand>> = {
+  PENDING_REVIEW: 'review', WAITING_INBOUND: 'receive-pallets', RECEIVING: 'receive-pallets',
+  PALLET_OVERAGE_REVIEW: 'review-pallet-overage', WAITING_CONSOLIDATION: 'allocate-pallets',
+  PARTIALLY_ALLOCATED: 'allocate-pallets', ALLOCATED: 'prepare-dispatch', PENDING_DISPATCH: 'dispatch',
+  DISPATCHED: 'start-transit', IN_TRANSIT: 'complete',
+}
+const cancellable = new Set<LocalTransportStatus>(['PENDING_REVIEW', 'WAITING_INBOUND', 'RECEIVING', 'PALLET_OVERAGE_REVIEW', 'WAITING_CONSOLIDATION', 'PARTIALLY_ALLOCATED', 'ALLOCATED', 'PENDING_DISPATCH'])
+
+/** 拼车来源只读，独立单据只能执行当前状态对应的具名命令。 */
+export function availableTruckCommands(order: Pick<LocalTransportDetail, 'status' | 'fleetArrangement'>): TruckCommand[] {
+  if (order.fleetArrangement) return []
+  const next = nextCommands[order.status]
+  return [...(next ? [next] : []), ...(cancellable.has(order.status) ? ['cancel' as const] : [])]
+}
+
+export const truckCommandHints: Record<TruckCommand, string> = {
+  review: '请核对车型、路线、两端联系信息、取送时间和货物资料。通过后进入待入仓，拒绝后结束本次申请。',
+  'receive-pallets': '按实际收货填写截至本次的累计实收托数。首次实收确定本单托数，后续超出已确认托数需要超托审核。',
+  'review-pallet-overage': '通过后将超收托盘纳入本单；拒绝后将超收托盘标记为拒收，按原已确认托数继续。',
+  'allocate-pallets': '选择本单已实收且未分配的托盘，可分批分配；全部已接收托盘分配完成后才能进入待派车。',
+  'prepare-dispatch': '确认全部已接收托盘已分配完成，将本单交由调度安排车辆。',
+  dispatch: '请在车辆安排已实际完成后确认，本单将进入已派车。',
+  'start-transit': '请在车辆已实际发运后确认，本单将进入运输中。',
+  complete: '请在运输及交付已实际完成后确认。确认完成后不能撤回。',
+  cancel: '取消后本单不能继续履约，请填写取消原因并核对已有收货和托盘记录。',
+}