feat: complete customer overseas business flows

AGENTS.md

@@ -51,7 +51,8 @@
 | 装柜完成后的退税报关资料 | `src/modules/first-leg/views/FirstLegOrdersView.vue` 的“报关资料”、`components/CustomsDocumentsDialog.vue`、`api/customs.ts` | 只显示登录客户在同柜的退税入仓码；报关开始前可上传、替换、调整同一资料覆盖的一个或多个入仓码及删除误传，全部写入携带幂等键和版本；开始后只读冻结资料，整柜完成后才能下载平台回传的一对一完成文件。Backend `firstleg/customs/container/`、`customs-v1.yaml`，二进制归 `file/` |
 | 统一订单展示 | `src/modules/order-management/` | `src/modules/first-leg/` 与对应后端订单契约 |
 | 客户财务账单、入仓码联查、收款、未收余额与客户确认 | `src/modules/finance/`；确认与明细入口 `views/FinanceBillsView.vue`、`api/finance.ts`，入仓码通过 `src/modules/first-leg/public.ts` 复用 `InboundCodeAssociationDialog` | Backend `finance/`；账单行只显示服务端 `inboundCode` 并按登录客户查询业务关系，缺失显示“—”，不得回退内部 ID。收款方式由服务端枚举映射中文。出账或已出账调整后为 `PENDING_CONFIRMATION`，客户确认提交登录成员、`expectedVersion` 和幂等键 |
-| 跨境候选能力 | `src/modules/cross-border/` | 先核对 `routes.ts` 的发布状态与阶段范围，不自动扩展实现 |
+| 海外采购、美国本土卡与美本土散板 | `src/modules/cross-border/routes.ts`、`components/BusinessOrdersView.vue`、`api/businessOrders.ts` | 三个路由均为 `active`，客户范围只取 Token；Backend `lastleg-service/` 的 `procurement/`、`trucking/`、`looseboard/` 客户接口 |
+| 海外仓入库订单 | `src/modules/order-management/routes.ts`、`views/InboundOrdersView.vue`、`api/inboundPlans.ts` | `orders/inbound` 为只读列表/详情，权限 `merchant:warehouse:inbound:list`；不展示或提交内部 ID |
 | 海外仓贴标、仓储转运、货物废弃、退货换标 | `src/modules/overseas-warehouse/routes.ts`、`views/WarehouseServiceView.vue`、`api/warehouseServices.ts` | 四个路由均为 `active`；Backend `lastleg-service/` 的 `relabel/`、`transfer/`、`discard/`，请求统一经 `src/api/overseasHttp.ts` 与 `gateway-overseas/` |
 
 ## 租户、认证与数据安全
@@ -96,14 +97,14 @@ pnpm build
 
 ## 全量验收脚本
 
-- Client 全量验收唯一入口为 `../../baiyue-firstleg/scripts/client-test-env-acceptance.mjs`；二期专项场景才单独执行 `client-phase2-test-env-acceptance.mjs`，不替代完整入口。
+- Client 全量验收唯一入口为 `../../baiyue-firstleg/scripts/client-test-env-acceptance.mjs`；入库测量与计费专项场景才单独执行 `client-phase2-test-env-acceptance.mjs`，不替代完整入口。
 - 入口通过测试环境 HTTP 验证注册/审核、客户隔离、订单、入库计费、文件、财务和权限链路，会创建或修改测试数据，必须获得当前对话明确授权。
 - `pnpm test/typecheck` 和 `frontend-full-regression.ps1` 仅是本地质量检查，不代表 Client 服务已完成全量验收。
 - HTTP 验收通过后，由人工使用开发验收账号逐页检查真实接口调用、客户可见字段、原型、权限、错误态、空态和 `1920×1080` 桌面布局，并将截图发送给 AI 分析；未收到人工截图时标记为待人工确认，不追加 AI 截图或窄屏浏览器验收。
 
 ## Client 全量验收快速索引
 
-当前按客户侧全量业务闭环验收。阶段文档仍用于核对功能来源和验收证据，不再限制本次验收的模块范围；按“模块 `routes.ts` → 页面/组件 → `api`、store、contracts”定位。本表只描述 Client 页面与客户可见契约，服务端实现详见后端模块指引。
+当前按客户侧全量业务闭环验收。业务域文档用于核对功能来源和验收证据，不限制本次验收的模块范围；按“模块 `routes.ts` → 页面/组件 → `api`、store、contracts”定位。本表只描述 Client 页面与客户可见契约，服务端实现详见后端模块指引。
 
 | 验收域 | Client 范围与代码入口 | 验收首读 |
 |---|---|---|

README.md

@@ -35,7 +35,7 @@ pnpm test
 
 依赖和 `pnpm-lock.yaml` 均保存在当前前端项目中，不需要在仓库根目录安装 Node 依赖。
 
-一期路由：登录、注册、工作台、我的信息、企业资料、企业成员、角色权限和头程订单。登录、注册、退出、令牌刷新、个人资料、修改密码、企业资料、企业资质、权限资源、角色列表/新增/授权和成员完整维护已经接入一期后端接口；开发代理通过 `API_PROXY_TARGET` 与 `OVERSEAS_API_PROXY_TARGET` 分别配置国内、海外 Gateway。登录使用后端约定的用户名和 8–72 位密码，注册成功后可立即登录，企业资料审核只影响订单提交资格。
+订单与客户路由：登录、注册、工作台、我的信息、企业资料、企业成员、角色权限、头程订单、海外采购、美国本土卡、美本土散板以及海外仓入库订单。跨境下单支持真实列表、详情和新增，海外入库支持当前客户列表与详情；均经海外 Gateway 的客户接口访问，客户范围只取 Token，不提交客户 ID。开发代理通过 `API_PROXY_TARGET` 与 `OVERSEAS_API_PROXY_TARGET` 分别配置国内、海外 Gateway。登录使用后端约定的用户名和 8–72 位密码，注册成功后可立即登录，企业资料审核只影响订单提交资格。
 
 认证会话保存 Access Token 和轮换后的 Refresh Token，并对并发 401 请求执行单次刷新。刷新或会话上下文加载遇到临时网络故障、超时等非认证错误时保留当前有效 Token，只有服务端明确返回 401/会话失效才清理登录状态。客户端只接受 `app_code` 为 `MERCHANT` 的 JWT；页面权限通过当前用户授权接口实时加载，不从 JWT 携带或解析角色权限。前端权限仅用于导航和交互控制，服务端仍须按用户、客户和权限编码完成最终授权。
 
@@ -45,6 +45,6 @@ pnpm test
 
 企业资料和资质列表使用真实租户接口，覆盖 `PROFILE_REQUIRED`、`PENDING`、`ACTIVE`、`REJECTED`、`DISABLED` 五种企业状态。企业名称、法定名称和联系人信息支持真实保存；营业执照、法人身份证为必填资质，货代资质证书和银行开户许可证为选填资质，均使用文件服务分别上传，接受 PDF、JPG、PNG 且不超过 5MB；两项必填资质齐全后可显式提交审核，文件预览通过当前商户 Token 临时下载并在关闭弹窗后释放。
 
-头程订单列表、详情、仓库查询、创建/编辑草稿和提交已经接入真实 API，并显式映射后端 `transportMode`、`containerMode` 和订单状态。创建与提交请求携带幂等键，`merchant:order:create`、`merchant:order:edit`、`merchant:order:submit` 分别映射到独立前端操作权限。页面补齐渠道、提货方式、报关模式、目的仓类型、包装类型等后端必填字段；API 模式先清空本地记录，请求失败不会回退模拟成功。FBA 和海外仓按公共仓类型筛选，选择后由仓库主数据生成目的仓字段，不再要求客户重复选择收货单位；私人仓才填写并按当前用户缓存收件资料。只有“我司提货”需要填写提货联系人和地址，其他送货方式不发送发货方快照，订单也不再依赖往来单位 `customerId`。快递信息仍由平台维护、客户只读。订单取消不属于本轮本地一期验收，客户端不暴露取消写操作。订单产品状态仍按已确认的七状态执行，不设置“已驳回”；若兼容旧接口数据收到 `REJECTED`，只按待审核展示且不开放编辑。
+头程订单列表、详情、仓库查询、创建/编辑草稿和提交已经接入真实 API，并显式映射后端 `transportMode`、`containerMode` 和订单状态。创建与提交请求携带幂等键，`merchant:order:create`、`merchant:order:edit`、`merchant:order:submit` 分别映射到独立前端操作权限。页面补齐渠道、提货方式、报关模式、目的仓类型、包装类型等后端必填字段；API 模式先清空本地记录，请求失败不会回退模拟成功。FBA 和海外仓按公共仓类型筛选，选择后由仓库主数据生成目的仓字段，不再要求客户重复选择收货单位；私人仓才填写并按当前用户缓存收件资料。只有“我司提货”需要填写提货联系人和地址，其他送货方式不发送发货方快照，订单也不再依赖往来单位 `customerId`。快递信息仍由平台维护、客户只读。订单取消不属于本轮本地订单与客户验收，客户端不暴露取消写操作。订单产品状态仍按已确认的七状态执行，不设置“已驳回”；若兼容旧接口数据收到 `REJECTED`，只按待审核展示且不开放编辑。
 
 联调远端 Gateway 时，进程环境变量优先于 `.env` 文件。浏览器国内业务统一请求同源 `/api`，海外业务请求同源 `/overseas-api`，由代理分别转发并确保最终路径只有一个 `/api` 前缀。联调时可只读检查同工作区的 `baiyue-firstleg/` Controller、DTO、Service、Repository 和回归脚本，用于发现后端拉取后的契约变化，但不修改后端仓库。

shared/AGENTS.md

@@ -19,12 +19,12 @@
 - 当前开发阶段按目标模型直接修改；破坏性修改必须同步更新当前应用全部消费者、测试和接口映射，不保留旧模型兼容分支。
 - 本包没有独立质量脚本；变更后运行父应用声明的类型检查、测试或构建命令。
 
-## 一期/二期/三期契约索引
+## 订单与客户/入库测量与计费/国内货柜履约契约索引
 
-- 一期共享模型服务客户认证、企业资料/成员权限和头程订单；修改订单状态、仓库摘要、资质或权限枚举前，先核对阶段契约并搜索 `src/modules/` 全部消费者。
-- 二期仅承接客户可见的到仓与计费结果。`WAIT_SPLIT + APPROVED + CONFIRMED` 为当前终点；内部测量明细、备注和文件权限不得通过共享类型绕过。
-- 三期仅在服务端字段、权限和 OpenAPI 已稳定，且确有多个 Client 模块复用时才新增共享导出；先读 `../../../docs/三期/三期开工门禁.md`。只建客户可见的柜次、进度、授权回执和船期类型，不通过 shared 暴露照片、锁码或后台内部资料。
+- 订单与客户共享模型服务客户认证、企业资料/成员权限和头程订单；修改订单状态、仓库摘要、资质或权限枚举前，先核对阶段契约并搜索 `src/modules/` 全部消费者。
+- 入库测量与计费仅承接客户可见的到仓与计费结果。`WAIT_SPLIT + APPROVED + CONFIRMED` 为当前终点；内部测量明细、备注和文件权限不得通过共享类型绕过。
+- 国内货柜履约仅在服务端字段、权限和 OpenAPI 已稳定，且确有多个 Client 模块复用时才新增共享导出；先读 `../../../docs/国内货柜履约/国内货柜履约开工门禁.md`。只建客户可见的柜次、进度、授权回执和船期类型，不通过 shared 暴露照片、锁码或后台内部资料。
 
 定位规则：从 `src/index.ts` 的导出开始，反查模块 `api`、store 和 `contracts.ts` 消费者；字段含义不明确时回到服务端 DTO/OpenAPI，不在 shared 中扩展业务语义。
 
-阶段文档入口（路径相对本文件所在目录）：一期 `../../../docs/一期/README.md`；二期 `../../../docs/二期/README.md` 与 `../../../docs/二期/二期需求优化版-v2-测量计费入库主流程.md`；三期 `../../../docs/三期/README.md`、`../../../docs/三期/三期开发规划.md` 和 `../../../docs/三期/三期需求确认表.md`。范围与契约以阶段确认和设计文档为准，原型只作补充。
+业务域文档入口（路径相对本文件所在目录）：订单与客户 `../../../docs/订单与客户/README.md`；入库测量与计费 `../../../docs/入库测量与计费/README.md` 与 `../../../docs/入库测量与计费/入库测量与计费需求优化版-v2-测量计费入库主流程.md`；国内货柜履约 `../../../docs/国内货柜履约/README.md`、`../../../docs/国内货柜履约/国内货柜履约开发规划.md` 和 `../../../docs/国内货柜履约/国内货柜履约需求确认表.md`。范围与契约以正式确认和设计文档为准，原型只作补充。

src/components.d.ts

@@ -19,6 +19,7 @@ declare module 'vue' {
     DataTable: typeof import('./components/common/DataTable.vue')['default']
     ElAlert: typeof import('element-plus/es')['ElAlert']
     ElButton: typeof import('element-plus/es')['ElButton']
+    ElCard: typeof import('element-plus/es')['ElCard']
     ElCheckbox: typeof import('element-plus/es')['ElCheckbox']
     ElCheckboxGroup: typeof import('element-plus/es')['ElCheckboxGroup']
     ElDatePicker: typeof import('element-plus/es')['ElDatePicker']

src/modules/cross-border/api/businessOrders.ts

@@ -0,0 +1,164 @@
+import { overseasApiRequest } from '@/api/overseasHttp'
+
+export interface PageResult<T> {
+  records: T[]
+  page: number
+  size: number
+  total: number
+  pages: number
+}
+
+export type CrossBorderBusinessKind = 'procurement' | 'trucking' | 'looseboard'
+
+export interface BusinessOrderQuery {
+  page: number
+  size: number
+  orderNo?: string
+  status?: string
+  routeKeyword?: string
+  productName?: string
+  purchaseCategory?: string
+  transportType?: string
+  transportMode?: string
+  requestedFrom?: string
+  requestedTo?: string
+  createdFrom?: string
+  createdTo?: string
+}
+
+export interface ProcurementSummary {
+  orderNo: string
+  purchaseCategory: string
+  productName: string
+  productSpecification: string | null
+  purchaseQuantity: number
+  budgetUnitPrice: number | null
+  currency: string | null
+  inboundQuantity: number
+  outboundQuantity: number
+  inventoryQuantity: number
+  status: string
+  version: number
+  createdAt: string
+  updatedAt: string
+}
+
+export interface ProcurementDetail {
+  summary: ProcurementSummary
+  productUrl: string | null
+  receivingAddress: string | null
+  contactName: string
+  contactPhone: string
+  domesticCarrier: string | null
+  domesticTrackingNo: string | null
+  overseasCarrier: string | null
+  overseasTrackingNo: string | null
+  estimatedArrivalAt: string | null
+  remark: string | null
+  reviewRemark: string | null
+}
+
+export interface ProcurementCreate {
+  purchaseCategory: string
+  productName: string
+  productSpecification?: string
+  productUrl?: string
+  purchaseQuantity: number
+  budgetUnitPrice?: number
+  currency?: string
+  receivingAddress?: string
+  contactName: string
+  contactPhone: string
+  remark?: string
+  idempotencyKey: string
+}
+
+export interface TransportSummary {
+  orderNo: string
+  transportType: string
+  transportMode?: string
+  palletRequired?: string
+  origin: string
+  destination: string
+  containerType: string | null
+  palletCount?: number
+  packageCount: number
+  totalWeightKg: number
+  totalVolumeCbm: number
+  budgetAmount: number | null
+  currency: string | null
+  contactName: string | null
+  contactInfo: string | null
+  requestedDate: string | null
+  status: string
+  version: number
+  createdAt: string
+  updatedAt: string
+}
+
+export interface TransportDetail {
+  summary: TransportSummary
+  originAddress: string | null
+  destinationAddress: string | null
+  remark: string | null
+}
+
+export interface TransportCreate {
+  transportType: string
+  transportMode?: string
+  palletRequired?: string
+  origin: string
+  originAddress?: string
+  destination: string
+  destinationAddress?: string
+  containerType?: string
+  palletCount?: number
+  packageCount: number
+  totalWeightKg: number
+  totalVolumeCbm: number
+  budgetAmount?: number
+  currency?: string
+  contactName?: string
+  contactInfo?: string
+  requestedDate?: string
+  remark?: string
+  idempotencyKey: string
+}
+
+export interface TransportUpdate extends Omit<TransportCreate, 'idempotencyKey'> {
+  version: number
+}
+
+const endpointByKind: Record<CrossBorderBusinessKind, string> = {
+  procurement: '/merchant/v1/last-leg/overseas-procurements',
+  trucking: '/merchant/v1/last-leg/us-truck-orders',
+  looseboard: '/merchant/v1/last-leg/local-looseboard-orders',
+}
+
+function normalizePage<T>(data: PageResult<T>): PageResult<T> {
+  return { ...data, page: Number(data.page), size: Number(data.size), total: Number(data.total), pages: Number(data.pages) }
+}
+
+export function listBusinessOrders<T>(kind: CrossBorderBusinessKind, params: BusinessOrderQuery) {
+  return overseasApiRequest<PageResult<T>>({ method: 'GET', url: endpointByKind[kind], params }).then(normalizePage)
+}
+
+export function getBusinessOrder<T>(kind: CrossBorderBusinessKind, orderNo: string) {
+  return overseasApiRequest<T>({ method: 'GET', url: `${endpointByKind[kind]}/${encodeURIComponent(orderNo)}` })
+}
+
+export function createProcurement(payload: ProcurementCreate) {
+  return overseasApiRequest<ProcurementDetail>({ method: 'POST', url: endpointByKind.procurement, data: payload })
+}
+
+export function createTransport(kind: 'trucking' | 'looseboard', payload: TransportCreate) {
+  return overseasApiRequest<TransportDetail>({ method: 'POST', url: endpointByKind[kind], data: payload })
+}
+
+export function updateTransport(kind: 'trucking' | 'looseboard', orderNo: string, payload: TransportUpdate) {
+  return overseasApiRequest<TransportDetail>({
+    method: kind === 'trucking' ? 'PATCH' : 'PUT',
+    url: `${endpointByKind[kind]}/${encodeURIComponent(orderNo)}`,
+    data: payload,
+  })
+}

src/modules/cross-border/businessOrders.test.mjs

@@ -0,0 +1,39 @@
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import test from 'node:test'
+
+const api = readFileSync(new URL('./api/businessOrders.ts', import.meta.url), 'utf8')
+const routes = readFileSync(new URL('./routes.ts', import.meta.url), 'utf8')
+const view = readFileSync(new URL('./components/BusinessOrdersView.vue', import.meta.url), 'utf8')
+
+test('activates all three customer cross-border pages with frozen permissions', () => {
+  for (const [path, permission] of [
+    ['cross-border/procurement', 'merchant:cross-border:procurement'],
+    ['cross-border/domestic-trucking', 'merchant:cross-border:domestic-trucking'],
+    ['cross-border/pallet-shipping', 'merchant:cross-border:pallet-shipping'],
+  ]) {
+    assert.match(routes, new RegExp(`path: '${path}'[\\s\\S]*?release: 'active'[\\s\\S]*?permission: '${permission}'`))
+  }
+  assert.doesNotMatch(view, /PrototypeFeatureView|mock|customerId|tenantId/i)
+})
+
+test('uses only merchant overseas endpoints and keeps retry idempotency stable', () => {
+  assert.match(api, /overseas-procurements/)
+  assert.match(api, /us-truck-orders/)
+  assert.match(api, /local-looseboard-orders/)
+  assert.doesNotMatch(api, /\/platform\/|\/internal\/|customerId|tenantId/)
+  assert.match(view, /const stableSubmitKey = submitKey\.value \|\| idempotencyKey\(\)/)
+  assert.match(view, /submitKey\.value = stableSubmitKey/)
+  assert.match(view, /idempotencyKey: stableSubmitKey/g)
+})
+
+test('covers list detail create loading error empty pagination and actions-first contracts', () => {
+  assert.match(view, /mode\.value = 'detail'/)
+  assert.match(view, /mode\.value = 'list'/)
+  assert.match(view, /mode = 'create'/)
+  assert.match(view, /v-loading="loading"/)
+  assert.match(view, /type="error"/)
+  assert.match(view, /empty-text="暂无订单"/)
+  assert.match(view, /<el-pagination/)
+  assert.match(view, /<el-table-column label="操作"[^>]*fixed="left"/)
+})

src/modules/cross-border/components/BusinessOrdersView.vue

@@ -0,0 +1,355 @@
+<script setup lang="ts">
+import { computed, onMounted, reactive, ref } from 'vue'
+import { ElMessage, type FormInstance, type FormRules } from 'element-plus'
+import {
+  createProcurement,
+  createTransport,
+  getBusinessOrder,
+  listBusinessOrders,
+  type CrossBorderBusinessKind,
+  type ProcurementDetail,
+  type ProcurementSummary,
+  type TransportDetail,
+  type TransportSummary,
+} from '../api/businessOrders'
+
+const props = defineProps<{ kind: CrossBorderBusinessKind }>()
+
+type BusinessRow = ProcurementSummary | TransportSummary
+type BusinessDetail = ProcurementDetail | TransportDetail
+type PageMode = 'list' | 'create' | 'detail'
+
+interface ColumnDefinition { key: string; label: string; width?: number }
+
+interface BusinessForm {
+  purchaseCategory: string
+  productName: string
+  productSpecification: string
+  productUrl: string
+  purchaseQuantity: number
+  transportMode: string
+  palletRequired: string
+  transportType: string
+  origin: string
+  originAddress: string
+  destination: string
+  destinationAddress: string
+  containerType: string
+  palletCount: number
+  packageCount: number
+  totalWeightKg: number
+  totalVolumeCbm: number
+  budgetAmount?: number
+  currency: string
+  contactName: string
+  contactInfo: string
+  requestedDate: string
+  receivingAddress: string
+  remark: string
+}
+
+const configuration = computed(() => ({
+  procurement: {
+    title: '海外采购',
+    description: '查询并管理海外采购订单',
+    columns: [
+      { key: 'orderNo', label: '订单号', width: 180 },
+      { key: 'purchaseCategory', label: '采购品类', width: 130 },
+      { key: 'productName', label: '商品名称', width: 160 },
+      { key: 'productSpecification', label: '商品规格', width: 160 },
+      { key: 'purchaseQuantity', label: '采购数量', width: 100 },
+      { key: 'budgetUnitPrice', label: '预算单价', width: 110 },
+      { key: 'status', label: '状态', width: 120 },
+      { key: 'createdAt', label: '创建时间', width: 170 },
+    ] satisfies ColumnDefinition[],
+  },
+  trucking: {
+    title: '美国本土卡',
+    description: '查询并管理美国本土卡订单',
+    columns: transportColumns(false),
+  },
+  looseboard: {
+    title: '美本土散板',
+    description: '查询并管理美本土散板订单',
+    columns: transportColumns(true),
+  },
+})[props.kind])
+
+function transportColumns(looseboard: boolean): ColumnDefinition[] {
+  return [
+    { key: 'orderNo', label: '订单编号', width: 180 },
+    ...(looseboard ? [{ key: 'transportMode', label: '运输方式', width: 120 }, { key: 'palletRequired', label: '是否打盘', width: 100 }] : []),
+    { key: 'transportType', label: '运输类型', width: 130 },
+    { key: 'origin', label: '起运地', width: 150 },
+    { key: 'destination', label: '目的地', width: 150 },
+    { key: 'containerType', label: '柜型', width: 100 },
+    { key: 'totalWeightKg', label: '总重量(kg)', width: 120 },
+    { key: 'budgetAmount', label: '预算总价', width: 110 },
+    { key: 'requestedDate', label: '要求时间', width: 120 },
+    { key: 'status', label: '状态', width: 130 },
+  ]
+}
+
+const mode = ref<PageMode>('list')
+const loading = ref(false)
+const submitting = ref(false)
+const submitKey = ref('')
+const error = ref('')
+const rows = ref<BusinessRow[]>([])
+const detail = ref<BusinessDetail | null>(null)
+const formRef = ref<FormInstance>()
+const query = reactive({ page: 1, size: 20, orderNo: '', routeKeyword: '', status: '', productName: '', purchaseCategory: '' })
+const total = ref(0)
+
+const form = reactive<BusinessForm>(emptyForm())
+const rules: FormRules<BusinessForm> = {
+  purchaseCategory: [{ required: true, message: '请输入采购品类', trigger: 'blur' }],
+  productName: [{ required: true, message: '请输入商品名称', trigger: 'blur' }],
+  purchaseQuantity: [{ required: true, type: 'number', min: 1, message: '采购数量至少为 1', trigger: 'change' }],
+  origin: [{ required: true, message: '请输入起运地', trigger: 'blur' }],
+  destination: [{ required: true, message: '请输入目的地', trigger: 'blur' }],
+  palletCount: [{ required: true, type: 'number', min: 1, message: '托盘数至少为 1', trigger: 'change' }],
+  contactName: [{ required: true, message: '请输入联系人', trigger: 'blur' }],
+  contactInfo: [{ required: true, message: '请输入联系电话或联系方式', trigger: 'blur' }],
+  requestedDate: [{ required: true, message: '请选择要求时间', trigger: 'change' }],
+}
+
+const detailFields = computed(() => {
+  if (!detail.value) return []
+  const summary = detail.value.summary
+  if (props.kind === 'procurement') {
+    const current = detail.value as ProcurementDetail
+    return [
+      ['订单号', summary.orderNo], ['采购品类', read(summary, 'purchaseCategory')],
+      ['商品名称', read(summary, 'productName')], ['商品规格', read(summary, 'productSpecification')],
+      ['采购数量', read(summary, 'purchaseQuantity')], ['预算单价', money(read(summary, 'budgetUnitPrice'), read(summary, 'currency'))],
+      ['联系人', current.contactName], ['联系电话', current.contactPhone],
+      ['收货地址', current.receivingAddress], ['商品链接', current.productUrl],
+      ['国内运单', joinText(current.domesticCarrier, current.domesticTrackingNo)],
+      ['海外运单', joinText(current.overseasCarrier, current.overseasTrackingNo)],
+      ['状态', statusLabel(summary.status)], ['备注', current.remark],
+    ]
+  }
+  const current = detail.value as TransportDetail
+  return [
+    ['订单编号', summary.orderNo], ['运输方式', read(summary, 'transportMode')],
+    ['是否打盘', yesNo(read(summary, 'palletRequired'))], ['运输类型', transportTypeLabel(read(summary, 'transportType'))],
+    ['起运地', read(summary, 'origin')], ['起运地址', current.originAddress],
+    ['目的地', read(summary, 'destination')], ['目的地址', current.destinationAddress],
+    ['柜型', read(summary, 'containerType')], ['托盘数', read(summary, 'palletCount')],
+    ['件数', read(summary, 'packageCount')], ['总重量(kg)', read(summary, 'totalWeightKg')],
+    ['总体积(m³)', read(summary, 'totalVolumeCbm')], ['预算总价', money(read(summary, 'budgetAmount'), read(summary, 'currency'))],
+    ['联系人', read(summary, 'contactName')], ['联系方式', read(summary, 'contactInfo')],
+    ['要求时间', read(summary, 'requestedDate')], ['状态', statusLabel(summary.status)], ['备注', current.remark],
+  ]
+})
+
+function emptyForm(): BusinessForm {
+  return {
+    purchaseCategory: '', productName: '', productSpecification: '', productUrl: '', purchaseQuantity: 1,
+    transportMode: 'SHARED_TRUCK', palletRequired: 'NO', transportType: 'PORT_PICKUP', origin: '', originAddress: '',
+    destination: '', destinationAddress: '', containerType: '', palletCount: 1, packageCount: 0,
+    totalWeightKg: 0, totalVolumeCbm: 0, currency: 'USD', contactName: '', contactInfo: '', requestedDate: '',
+    receivingAddress: '', remark: '',
+  }
+}
+
+function resetForm() { Object.assign(form, emptyForm()); submitKey.value = ''; formRef.value?.clearValidate() }
+function read(source: object, key: string) { return Reflect.get(source, key) as unknown }
+function text(value: unknown) { return value === null || value === undefined || value === '' ? '—' : String(value) }
+function joinText(...values: unknown[]) { const result = values.filter(Boolean).join(' / '); return result || '—' }
+function money(amount: unknown, currency: unknown) { return amount === null || amount === undefined ? '—' : `${text(currency)} ${Number(amount).toFixed(2)}` }
+function dateTime(value: unknown) { return value ? new Date(String(value)).toLocaleString('zh-CN', { hour12: false }) : '—' }
+function yesNo(value: unknown) { return value === 'YES' ? '是' : value === 'NO' ? '否' : text(value) }
+function transportTypeLabel(value: unknown) { return ({ PORT_PICKUP: '港口提柜', WAREHOUSE_TO_WAREHOUSE: '仓到仓', WAREHOUSE_TO_DOOR: '仓到门' } as Record<string, string>)[String(value)] || text(value) }
+function transportModeLabel(value: unknown) { return ({ SHARED_TRUCK: '拼车', PRIORITY_CONSOLIDATION: '优先拼载' } as Record<string, string>)[String(value)] || text(value) }
+function statusLabel(value: unknown) {
+  return ({ PENDING_REVIEW: '待审核', APPROVED: '已通过', REJECTED: '已拒绝', PENDING_ACCEPTANCE: '待接单', PROCESSING: '处理中', IN_TRANSIT: '运输中', COMPLETED: '已完成', CANCELLED: '已取消' } as Record<string, string>)[String(value)] || text(value)
+}
+function displayCell(candidate: unknown, key: string) {
+  const row = candidate as BusinessRow
+  const value = read(row, key)
+  if (key === 'status') return statusLabel(value)
+  if (key === 'transportType') return transportTypeLabel(value)
+  if (key === 'transportMode') return transportModeLabel(value)
+  if (key === 'palletRequired') return yesNo(value)
+  if (key === 'createdAt') return dateTime(value)
+  if (key === 'budgetUnitPrice' || key === 'budgetAmount') return money(value, read(row, 'currency'))
+  return text(value)
+}
+function idempotencyKey() { return globalThis.crypto?.randomUUID?.() || `client-${Date.now()}-${Math.random().toString(16).slice(2)}` }
+function errorMessage(cause: unknown) { return cause instanceof Error ? cause.message : '请求失败，请稍后重试' }
+
+async function load() {
+  loading.value = true
+  error.value = ''
+  try {
+    const params = {
+      page: query.page, size: query.size, orderNo: query.orderNo || undefined, status: query.status || undefined,
+      routeKeyword: query.routeKeyword || undefined, productName: query.productName || undefined,
+      purchaseCategory: query.purchaseCategory || undefined,
+    }
+    const result = props.kind === 'procurement'
+      ? await listBusinessOrders<ProcurementSummary>('procurement', params)
+      : await listBusinessOrders<TransportSummary>(props.kind, params)
+    rows.value = result.records
+    total.value = result.total
+  } catch (cause) {
+    error.value = errorMessage(cause)
+    rows.value = []
+    total.value = 0
+  } finally { loading.value = false }
+}
+
+function resetQuery() {
+  Object.assign(query, { page: 1, orderNo: '', routeKeyword: '', status: '', productName: '', purchaseCategory: '' })
+  void load()
+}
+
+async function openDetail(candidate: unknown) {
+  const row = candidate as BusinessRow
+  loading.value = true
+  error.value = ''
+  try {
+    detail.value = props.kind === 'procurement'
+      ? await getBusinessOrder<ProcurementDetail>('procurement', row.orderNo)
+      : await getBusinessOrder<TransportDetail>(props.kind, row.orderNo)
+    mode.value = 'detail'
+  } catch (cause) { ElMessage.error(errorMessage(cause)) }
+  finally { loading.value = false }
+}
+
+async function submit() {
+  if (!await formRef.value?.validate().catch(() => false)) return
+  submitting.value = true
+  const stableSubmitKey = submitKey.value || idempotencyKey()
+  submitKey.value = stableSubmitKey
+  try {
+    if (props.kind === 'procurement') {
+      await createProcurement({
+        purchaseCategory: form.purchaseCategory, productName: form.productName,
+        productSpecification: form.productSpecification || undefined, productUrl: form.productUrl || undefined,
+        purchaseQuantity: form.purchaseQuantity, budgetUnitPrice: form.budgetAmount,
+        currency: form.currency || undefined, receivingAddress: form.receivingAddress || undefined,
+        contactName: form.contactName, contactPhone: form.contactInfo, remark: form.remark || undefined,
+        idempotencyKey: stableSubmitKey,
+      })
+    } else {
+      const base = {
+        transportType: form.transportType, origin: form.origin, originAddress: form.originAddress || undefined,
+        destination: form.destination, destinationAddress: form.destinationAddress || undefined,
+        containerType: form.containerType || undefined, packageCount: form.packageCount,
+        totalWeightKg: form.totalWeightKg, totalVolumeCbm: form.totalVolumeCbm,
+        budgetAmount: form.budgetAmount, currency: form.currency || undefined,
+        contactName: form.contactName || undefined, contactInfo: form.contactInfo || undefined,
+        requestedDate: form.requestedDate || undefined, remark: form.remark || undefined,
+        idempotencyKey: stableSubmitKey,
+      }
+      await createTransport(props.kind, props.kind === 'trucking'
+        ? { ...base, palletCount: form.palletCount }
+        : { ...base, transportMode: form.transportMode, palletRequired: form.palletRequired })
+    }
+    ElMessage.success('订单提交成功')
+    mode.value = 'list'
+    resetForm()
+    await load()
+  } catch (cause) { ElMessage.error(errorMessage(cause)) }
+  finally { submitting.value = false }
+}
+
+onMounted(() => void load())
+</script>
+
+<template>
+  <section v-loading="loading" class="business-orders" :aria-busy="loading">
+    <header class="page-head">
+      <div>
+        <h2>{{ mode === 'detail' ? `${configuration.title}订单详情` : mode === 'create' ? `${configuration.title}下单` : configuration.title }}</h2>
+        <p>{{ mode === 'list' ? configuration.description : mode === 'create' ? '请填写订单信息，带 * 项为必填项' : `订单号：${detail?.summary.orderNo || '—'}` }}</p>
+      </div>
+      <el-button v-if="mode !== 'list'" @click="mode = 'list'">返回列表</el-button>
+      <el-button v-else type="primary" @click="resetForm(); mode = 'create'">新增下单</el-button>
+    </header>
+
+    <template v-if="mode === 'list'">
+      <el-alert v-if="error" :title="error" type="error" show-icon :closable="false">
+        <template #default><el-button size="small" @click="load">重新加载</el-button></template>
+      </el-alert>
+      <el-card shadow="never" class="filter-card">
+        <el-form inline @submit.prevent="query.page = 1; load()">
+          <el-form-item label="订单号"><el-input v-model.trim="query.orderNo" clearable placeholder="请输入订单号" /></el-form-item>
+          <el-form-item v-if="kind === 'procurement'" label="采购品类"><el-input v-model.trim="query.purchaseCategory" clearable placeholder="请输入采购品类" /></el-form-item>
+          <el-form-item v-if="kind === 'procurement'" label="商品名称"><el-input v-model.trim="query.productName" clearable placeholder="请输入商品名称" /></el-form-item>
+          <el-form-item v-else label="运输路线"><el-input v-model.trim="query.routeKeyword" clearable placeholder="起运地或目的地" /></el-form-item>
+          <el-form-item label="状态"><el-input v-model.trim="query.status" clearable placeholder="请输入状态" /></el-form-item>
+          <el-form-item><el-button type="primary" native-type="submit">查询</el-button><el-button @click="resetQuery">重置</el-button></el-form-item>
+        </el-form>
+      </el-card>
+      <el-card shadow="never">
+        <el-table :data="rows" empty-text="暂无订单" border>
+          <el-table-column label="操作" width="90" fixed="left"><template #default="scope"><el-button link type="primary" @click="openDetail(scope.row)">查看</el-button></template></el-table-column>
+          <el-table-column v-for="column in configuration.columns" :key="column.key" :label="column.label" :width="column.width" show-overflow-tooltip>
+            <template #default="scope">{{ displayCell(scope.row, column.key) }}</template>
+          </el-table-column>
+        </el-table>
+        <el-pagination v-model:current-page="query.page" v-model:page-size="query.size" class="pagination" :total="total" :page-sizes="[10, 20, 50, 100]" layout="total, sizes, prev, pager, next" @change="load" />
+      </el-card>
+    </template>
+
+    <el-card v-else-if="mode === 'detail'" shadow="never">
+      <dl class="detail-grid">
+        <div v-for="field in detailFields" :key="String(field[0])"><dt>{{ field[0] }}</dt><dd>{{ text(field[1]) }}</dd></div>
+      </dl>
+    </el-card>
+
+    <el-card v-else shadow="never" class="form-card">
+      <el-form ref="formRef" :model="form" :rules="rules" label-width="120px">
+        <template v-if="kind === 'procurement'">
+          <el-form-item label="采购品类" prop="purchaseCategory"><el-input v-model.trim="form.purchaseCategory" maxlength="128" placeholder="请输入采购品类" /></el-form-item>
+          <el-form-item label="商品名称" prop="productName"><el-input v-model.trim="form.productName" maxlength="255" placeholder="请输入商品名称" /></el-form-item>
+          <el-form-item label="商品规格"><el-input v-model.trim="form.productSpecification" maxlength="500" placeholder="请输入规格、型号等信息" /></el-form-item>
+          <el-form-item label="商品链接"><el-input v-model.trim="form.productUrl" maxlength="2000" placeholder="请输入商品链接" /></el-form-item>
+          <el-form-item label="采购数量" prop="purchaseQuantity"><el-input-number v-model="form.purchaseQuantity" :min="1" placeholder="请输入数量" /></el-form-item>
+          <el-form-item label="收货地址"><el-input v-model.trim="form.receivingAddress" maxlength="1000" placeholder="请输入收货地址" /></el-form-item>
+        </template>
+        <template v-else>
+          <el-form-item v-if="kind === 'looseboard'" label="运输方式"><el-radio-group v-model="form.transportMode"><el-radio-button value="SHARED_TRUCK">拼车</el-radio-button><el-radio-button value="PRIORITY_CONSOLIDATION">优先拼载</el-radio-button></el-radio-group></el-form-item>
+          <el-form-item v-if="kind === 'looseboard'" label="是否打盘"><el-radio-group v-model="form.palletRequired"><el-radio-button value="NO">否</el-radio-button><el-radio-button value="YES">是</el-radio-button></el-radio-group></el-form-item>
+          <el-form-item label="运输类型"><el-select v-model="form.transportType"><el-option label="港口提柜" value="PORT_PICKUP" /><el-option label="仓到仓" value="WAREHOUSE_TO_WAREHOUSE" /><el-option label="仓到门" value="WAREHOUSE_TO_DOOR" /></el-select></el-form-item>
+          <el-form-item label="起运地" prop="origin"><el-input v-model.trim="form.origin" maxlength="255" placeholder="请输入起运地" /></el-form-item>
+          <el-form-item label="起运地址"><el-input v-model.trim="form.originAddress" maxlength="500" placeholder="请输入详细起运地址" /></el-form-item>
+          <el-form-item label="目的地" prop="destination"><el-input v-model.trim="form.destination" maxlength="255" placeholder="请输入目的地" /></el-form-item>
+          <el-form-item label="目的地址"><el-input v-model.trim="form.destinationAddress" maxlength="500" placeholder="请输入详细目的地址" /></el-form-item>
+          <el-form-item label="柜型"><el-input v-model.trim="form.containerType" maxlength="32" placeholder="请输入柜型" /></el-form-item>
+          <el-form-item v-if="kind === 'trucking'" label="托盘数" prop="palletCount"><el-input-number v-model="form.palletCount" :min="1" placeholder="请输入托盘数" /></el-form-item>
+          <el-form-item label="件数"><el-input-number v-model="form.packageCount" :min="0" placeholder="请输入件数" /></el-form-item>
+          <el-form-item label="总重量(kg)"><el-input-number v-model="form.totalWeightKg" :min="0" :precision="2" placeholder="请输入总重量" /></el-form-item>
+          <el-form-item label="总体积(m³)"><el-input-number v-model="form.totalVolumeCbm" :min="0" :precision="3" placeholder="请输入总体积" /></el-form-item>
+          <el-form-item label="要求时间" :prop="kind === 'trucking' ? 'requestedDate' : undefined"><el-date-picker v-model="form.requestedDate" type="date" value-format="YYYY-MM-DD" /></el-form-item>
+        </template>
+        <el-form-item :label="kind === 'procurement' ? '预算单价' : '预算金额'"><el-input-number v-model="form.budgetAmount" :min="0" :precision="2" placeholder="请输入预算金额" /><el-select v-model="form.currency" class="currency"><el-option label="USD" value="USD" /><el-option label="CNY" value="CNY" /></el-select></el-form-item>
+        <el-form-item label="联系人" prop="contactName"><el-input v-model.trim="form.contactName" maxlength="128" placeholder="请输入联系人" /></el-form-item>
+        <el-form-item label="联系方式" prop="contactInfo"><el-input v-model.trim="form.contactInfo" maxlength="128" placeholder="请输入电话、微信或邮箱" /></el-form-item>
+        <el-form-item label="备注"><el-input v-model="form.remark" type="textarea" :rows="4" maxlength="1000" show-word-limit placeholder="请输入其他要求" /></el-form-item>
+        <el-form-item><el-button @click="mode = 'list'">取消</el-button><el-button type="primary" :loading="submitting" @click="submit">提交订单</el-button></el-form-item>
+      </el-form>
+    </el-card>
+  </section>
+</template>
+
+<style scoped>
+.business-orders { display: grid; gap: 18px; }
+.page-head { display: flex; align-items: center; justify-content: space-between; gap: 24px; }
+.page-head h2 { margin: 0; color: #111827; font-size: 26px; }
+.page-head p { margin: 7px 0 0; color: #64748b; font-size: 14px; }
+.filter-card :deep(.el-form-item) { margin-bottom: 0; }
+.filter-card :deep(.el-input) { width: 190px; }
+.pagination { justify-content: flex-end; margin-top: 18px; }
+.detail-grid { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); margin: 0; }
+.detail-grid div { min-width: 0; padding: 18px 20px; border-right: 1px solid #ebeef5; border-bottom: 1px solid #ebeef5; }
+.detail-grid dt { margin-bottom: 7px; color: #8492a6; font-size: 13px; }
+.detail-grid dd { margin: 0; overflow-wrap: anywhere; color: #1f2937; line-height: 1.55; }
+.form-card :deep(.el-form) { max-width: 860px; }
+.form-card :deep(.el-input), .form-card :deep(.el-textarea), .form-card :deep(.el-select) { width: 100%; }
+.form-card .currency { width: 110px; margin-left: 12px; }
+</style>

src/modules/cross-border/routes.ts

@@ -9,7 +9,7 @@ export const crossBorderModule = {
       path: 'cross-border/procurement',
       name: 'cross-border-procurement',
       component: () => import('./views/ProcurementView.vue'),
-      release: 'prototype',
+      release: 'active',
       meta: { title: '海外采购', description: '管理海外采购订单', permission: 'merchant:cross-border:procurement' },
       navigation: { key: 'cross-border-procurement', icon: Package },
     },
@@ -17,7 +17,7 @@ export const crossBorderModule = {
       path: 'cross-border/domestic-trucking',
       name: 'cross-border-domestic-trucking',
       component: () => import('./views/DomesticTruckingView.vue'),
-      release: 'prototype',
+      release: 'active',
       meta: { title: '美国本土卡', description: '创建美国本土卡车运输订单', permission: 'merchant:cross-border:domestic-trucking' },
       navigation: { key: 'cross-border-domestic-trucking', icon: Truck },
     },
@@ -25,7 +25,7 @@ export const crossBorderModule = {
       path: 'cross-border/pallet-shipping',
       name: 'cross-border-pallet-shipping',
       component: () => import('./views/PalletShippingView.vue'),
-      release: 'prototype',
+      release: 'active',
       meta: { title: '美本土散板', description: '创建美国本土散板运输订单', permission: 'merchant:cross-border:pallet-shipping' },
       navigation: { key: 'cross-border-pallet-shipping', icon: Ship },
     },

src/modules/cross-border/views/DomesticTruckingView.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import PrototypeFeatureView from '@/components/common/PrototypeFeatureView.vue'
+import BusinessOrdersView from '../components/BusinessOrdersView.vue'
 </script>
 
-<template><PrototypeFeatureView title="美国本土卡" description="创建美国本土卡车运输订单" /></template>
+<template><BusinessOrdersView kind="trucking" /></template>

src/modules/cross-border/views/PalletShippingView.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import PrototypeFeatureView from '@/components/common/PrototypeFeatureView.vue'
+import BusinessOrdersView from '../components/BusinessOrdersView.vue'
 </script>
 
-<template><PrototypeFeatureView title="美本土散板" description="创建美国本土散板运输订单" /></template>
+<template><BusinessOrdersView kind="looseboard" /></template>

src/modules/cross-border/views/ProcurementView.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import PrototypeFeatureView from '@/components/common/PrototypeFeatureView.vue'
+import BusinessOrdersView from '../components/BusinessOrdersView.vue'
 </script>
 
-<template><PrototypeFeatureView title="海外采购" description="管理海外采购订单" /></template>
+<template><BusinessOrdersView kind="procurement" /></template>

src/modules/dashboard/views/DashboardView.test.mjs

@@ -25,12 +25,15 @@ test('isolates recoverable dashboard failures without hiding successful sections
   assert.doesNotMatch(source, /<template v-else>\s*<section class="quick-order-band">/)
 })
 
-test('matches the prototype business overview while keeping real order routing and data', () => {
+test('matches the prototype business overview and routes each card to its real business page', () => {
   assert.match(source, /选择业务，快速下单/)
   assert.match(source, /海外采购/)
   assert.match(source, /美国本土卡/)
   assert.match(source, /美本土散板/)
-  assert.match(source, /void router\.push\('\/orders\/first-leg\/create'\)/)
+  assert.match(source, /route: '\/cross-border\/procurement'/)
+  assert.match(source, /route: '\/cross-border\/domestic-trucking'/)
+  assert.match(source, /route: '\/cross-border\/pallet-shipping'/)
+  assert.match(source, /auth\.hasPermission\(business\.permission\)/)
   assert.match(source, /order\.status === 'DELIVERED'/)
   assert.match(source, /currentMonthOrderCount/)
   assert.match(source, /提交订单后，专属客户经理将在 24 小时内与您联系/)

src/modules/dashboard/views/DashboardView.vue

@@ -40,7 +40,6 @@ const loadErrorItems = computed(() =>
   })),
 )
 const canViewOrders = computed(() => auth.hasPermission('order:first-leg:list'))
-const canCreateOrders = computed(() => auth.hasPermission('order:first-leg:create'))
 const accountName = computed(() => {
   if (!companyUnavailable.value && tenant.company.companyName) return tenant.company.companyName
   return auth.user?.tenantName || auth.user?.name || '企业客户'
@@ -67,18 +66,24 @@ const businessCards = [
     description: '采购代购 · 验货质检 · 集中发货',
     icon: ShoppingCart,
     tone: 'blue',
+    route: '/cross-border/procurement',
+    permission: 'merchant:cross-border:procurement',
   },
   {
     title: '美国本土卡',
     description: '港口提柜 · 仓到仓 · 仓到门',
     icon: Truck,
     tone: 'green',
+    route: '/cross-border/domestic-trucking',
+    permission: 'merchant:cross-border:domestic-trucking',
   },
   {
     title: '美本土散板',
     description: '拼车拼载 · 打盘服务 · 灵活派送',
     icon: PanelsTopLeft,
     tone: 'teal',
+    route: '/cross-border/pallet-shipping',
+    permission: 'merchant:cross-border:pallet-shipping',
   },
 ] as const
 
@@ -111,16 +116,12 @@ async function loadDashboardData() {
   }
 }
 
-function openBusinessOrder() {
-  if (canCreateOrders.value) {
-    void router.push('/orders/first-leg/create')
+function openBusinessOrder(business: typeof businessCards[number]) {
+  if (auth.hasPermission(business.permission)) {
+    void router.push(business.route)
     return
   }
-  if (canViewOrders.value) {
-    void router.push('/orders/first-leg')
-    return
-  }
-  ElMessage.warning('当前账号暂无头程订单权限，请联系企业管理员。')
+  ElMessage.warning(`当前账号暂无${business.title}权限，请联系企业管理员。`)
 }
 
 function showSupportMessage(type: 'service' | 'faq' | 'quote') {
@@ -164,7 +165,7 @@ onMounted(() => void loadDashboardData())
             type="button"
             class="business-card"
             :class="`business-card--${business.tone}`"
-            @click="openBusinessOrder"
+            @click="openBusinessOrder(business)"
           >
             <span class="business-card__icon" aria-hidden="true">
               <component :is="business.icon" :size="29" :stroke-width="2.4" />
@@ -174,7 +175,7 @@ onMounted(() => void loadDashboardData())
               <small>{{ business.description }}</small>
             </span>
             <span class="business-card__action">
-              {{ canCreateOrders ? '开始下单' : canViewOrders ? '查看订单' : '暂无权限' }}
+              {{ auth.hasPermission(business.permission) ? '开始下单' : '暂无权限' }}
               <ArrowRight :size="18" aria-hidden="true" />
             </span>
           </button>

src/modules/order-management/api/inboundPlans.ts

@@ -0,0 +1,73 @@
+import { overseasApiRequest } from '@/api/overseasHttp'
+
+export interface PageResult<T> { records: T[]; page: number; size: number; total: number; pages: number }
+export interface InboundPlanQuery {
+  page: number
+  size: number
+  planNo?: string
+  inboundCode?: string
+  status?: string
+  destinationWarehouseCode?: string
+  appointmentStatus?: string
+  dispatchStatus?: string
+  createdFrom?: string
+  createdTo?: string
+}
+export interface InboundPlanSummary {
+  planNo: string
+  inboundCode: string
+  orderType: string | null
+  warehouseCode: string | null
+  warehouseName: string | null
+  fbaWarehouseCode: string | null
+  packageCount: number
+  pickedPackageCount: number
+  volumeCbm: number | null
+  palletCount: number
+  status: string
+  appointmentNo: string | null
+  appointmentStatus: string | null
+  appointmentAt: string | null
+  expectedLoadingAt: string | null
+  dispatchStatus: string | null
+  createdAt: string
+  version: number
+}
+export interface InboundPlanLine {
+  inboundCode: string
+  fbaWarehouseCode: string | null
+  destinationWarehouseCode: string | null
+  destinationWarehouseName: string | null
+  volumeCbm: number
+  requiredPackageCount: number
+  plannedPalletCount: number
+}
+export interface InboundPlanPallet {
+  palletNo: string
+  destinationWarehouseCode: string | null
+  destinationWarehouseName: string | null
+  capacityCbm: number
+  allocatedVolumeCbm: number
+}
+export interface InboundPlanDetail {
+  planNo: string
+  containerNo: string | null
+  status: string
+  lineCount: number
+  palletCount: number
+  totalVolumeCbm: number
+  expectedPackageCount: number
+  pickedPackageCount: number
+  lines: InboundPlanLine[]
+  pallets: InboundPlanPallet[]
+  version: number
+}
+
+export async function listInboundPlans(params: InboundPlanQuery) {
+  const result = await overseasApiRequest<PageResult<InboundPlanSummary>>({ method: 'GET', url: '/merchant/v1/last-leg/inbound-plans', params })
+  return { ...result, page: Number(result.page), size: Number(result.size), total: Number(result.total), pages: Number(result.pages) }
+}
+
+export function getInboundPlan(planNo: string) {
+  return overseasApiRequest<InboundPlanDetail>({ method: 'GET', url: `/merchant/v1/last-leg/inbound-plans/${encodeURIComponent(planNo)}` })
+}

src/modules/order-management/inboundOrders.test.mjs

@@ -0,0 +1,25 @@
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import test from 'node:test'
+
+const api = readFileSync(new URL('./api/inboundPlans.ts', import.meta.url), 'utf8')
+const routes = readFileSync(new URL('./routes.ts', import.meta.url), 'utf8')
+const view = readFileSync(new URL('./views/InboundOrdersView.vue', import.meta.url), 'utf8')
+
+test('activates the customer-scoped overseas inbound list and detail', () => {
+  assert.match(routes, /path: 'orders\/inbound'[\s\S]*?release: 'active'[\s\S]*?permission: 'merchant:warehouse:inbound:list'/)
+  assert.match(api, /\/merchant\/v1\/last-leg\/inbound-plans/)
+  assert.match(api, /encodeURIComponent\(planNo\)/)
+  assert.doesNotMatch(api, /\/platform\/|\/internal\/|customerId|tenantId/)
+})
+
+test('keeps actions first and exposes filters loading errors empty state pagination and business identifiers', () => {
+  assert.match(view, /<el-table-column label="操作"[^>]*fixed="left"/)
+  for (const token of ['planNo', 'inboundCode', 'destinationWarehouseCode', 'appointmentStatus', 'dispatchStatus', 'createdDates']) assert.match(view, new RegExp(token))
+  assert.match(view, /v-loading="loading"/)
+  assert.match(view, /type="error"/)
+  assert.match(view, /empty-text="暂无入库订单"/)
+  assert.match(view, /<el-pagination/)
+  assert.match(view, /detail\.planNo/)
+  assert.doesNotMatch(view, /planId|orderId|warehouseId|customerId/)
+})

src/modules/order-management/routes.ts

@@ -17,7 +17,7 @@ export const orderManagementModule = {
       path: 'orders/inbound',
       name: 'orders-inbound',
       component: () => import('./views/InboundOrdersView.vue'),
-      release: 'prototype',
+      release: 'active',
       meta: { title: '入库订单列表', description: '查询海外仓入库订单', permission: 'merchant:warehouse:inbound:list' },
       navigation: { key: 'orders-inbound', icon: Package },
     },

src/modules/order-management/views/InboundOrdersView.vue

@@ -1,5 +1,137 @@
 <script setup lang="ts">
-import PrototypeFeatureView from '@/components/common/PrototypeFeatureView.vue'
+import { onMounted, reactive, ref } from 'vue'
+import { ElMessage } from 'element-plus'
+import { getInboundPlan, listInboundPlans, type InboundPlanDetail, type InboundPlanSummary } from '../api/inboundPlans'
+
+const loading = ref(false)
+const error = ref('')
+const rows = ref<InboundPlanSummary[]>([])
+const detail = ref<InboundPlanDetail | null>(null)
+const total = ref(0)
+const query = reactive({
+  page: 1, size: 20, planNo: '', inboundCode: '', destinationWarehouseCode: '', status: '',
+  appointmentStatus: '', dispatchStatus: '', createdDates: [] as string[],
+})
+
+function text(value: unknown) { return value === null || value === undefined || value === '' ? '—' : String(value) }
+function dateTime(value: unknown) { return value ? new Date(String(value)).toLocaleString('zh-CN', { hour12: false }) : '—' }
+function statusLabel(value: unknown) {
+  return ({ PENDING: '待处理', PROCESSING: '处理中', COMPLETED: '已完成', CANCELLED: '已取消', UNAPPOINTED: '未预约', SUCCESS: '预约成功', FAILED: '预约失败', SCHEDULED: '已排车', UNSCHEDULED: '未排车' } as Record<string, string>)[String(value)] || text(value)
+}
+function errorMessage(cause: unknown) { return cause instanceof Error ? cause.message : '请求失败，请稍后重试' }
+
+async function load() {
+  loading.value = true
+  error.value = ''
+  try {
+    const result = await listInboundPlans({
+      page: query.page, size: query.size, planNo: query.planNo || undefined, inboundCode: query.inboundCode || undefined,
+      destinationWarehouseCode: query.destinationWarehouseCode || undefined, status: query.status || undefined,
+      appointmentStatus: query.appointmentStatus || undefined, dispatchStatus: query.dispatchStatus || undefined,
+      createdFrom: query.createdDates[0] ? `${query.createdDates[0]}T00:00:00` : undefined,
+      createdTo: query.createdDates[1] ? `${query.createdDates[1]}T23:59:59` : undefined,
+    })
+    rows.value = result.records
+    total.value = result.total
+  } catch (cause) {
+    error.value = errorMessage(cause)
+    rows.value = []
+    total.value = 0
+  } finally { loading.value = false }
+}
+
+function resetQuery() {
+  Object.assign(query, { page: 1, planNo: '', inboundCode: '', destinationWarehouseCode: '', status: '', appointmentStatus: '', dispatchStatus: '', createdDates: [] })
+  void load()
+}
+
+async function openDetail(candidate: unknown) {
+  const row = candidate as InboundPlanSummary
+  loading.value = true
+  try { detail.value = await getInboundPlan(row.planNo) }
+  catch (cause) { ElMessage.error(errorMessage(cause)) }
+  finally { loading.value = false }
+}
+
+onMounted(() => void load())
 </script>
 
-<template><PrototypeFeatureView title="入库订单列表" description="查询海外仓入库订单" /></template>
+<template>
+  <section v-loading="loading" class="inbound-orders" :aria-busy="loading">
+    <header class="page-head">
+      <div><h2>{{ detail ? '入库订单详情' : '入库订单列表' }}</h2><p>{{ detail ? `计划号：${detail.planNo}` : '查询当前企业在海外仓的入库计划与作业进度' }}</p></div>
+      <el-button v-if="detail" @click="detail = null">返回列表</el-button>
+    </header>
+
+    <template v-if="!detail">
+      <el-alert v-if="error" :title="error" type="error" show-icon :closable="false"><template #default><el-button size="small" @click="load">重新加载</el-button></template></el-alert>
+      <el-card shadow="never" class="filter-card">
+        <el-form inline @submit.prevent="query.page = 1; load()">
+          <el-form-item label="计划号"><el-input v-model.trim="query.planNo" clearable placeholder="请输入计划号" /></el-form-item>
+          <el-form-item label="入仓码"><el-input v-model.trim="query.inboundCode" clearable placeholder="请输入入仓码" /></el-form-item>
+          <el-form-item label="目的仓"><el-input v-model.trim="query.destinationWarehouseCode" clearable placeholder="请输入仓库代码" /></el-form-item>
+          <el-form-item label="作业状态"><el-input v-model.trim="query.status" clearable placeholder="请输入状态" /></el-form-item>
+          <el-form-item label="预约状态"><el-select v-model="query.appointmentStatus" clearable placeholder="全部"><el-option label="未预约" value="UNAPPOINTED" /><el-option label="待处理" value="PENDING" /><el-option label="成功" value="SUCCESS" /><el-option label="失败" value="FAILED" /><el-option label="已取消" value="CANCELLED" /></el-select></el-form-item>
+          <el-form-item label="排车状态"><el-select v-model="query.dispatchStatus" clearable placeholder="全部"><el-option label="未排车" value="UNSCHEDULED" /><el-option label="已排车" value="SCHEDULED" /></el-select></el-form-item>
+          <el-form-item label="创建时间"><el-date-picker v-model="query.createdDates" type="daterange" value-format="YYYY-MM-DD" range-separator="至" start-placeholder="开始日期" end-placeholder="结束日期" /></el-form-item>
+          <el-form-item><el-button type="primary" native-type="submit">查询</el-button><el-button @click="resetQuery">重置</el-button></el-form-item>
+        </el-form>
+      </el-card>
+      <el-card shadow="never">
+        <el-table :data="rows" border empty-text="暂无入库订单">
+          <el-table-column label="操作" width="90" fixed="left"><template #default="scope"><el-button link type="primary" @click="openDetail(scope.row)">查看</el-button></template></el-table-column>
+          <el-table-column prop="planNo" label="计划号" min-width="180" show-overflow-tooltip />
+          <el-table-column prop="inboundCode" label="入仓码" min-width="170" show-overflow-tooltip />
+          <el-table-column label="海外仓" min-width="160" show-overflow-tooltip><template #default="scope">{{ text(scope.row.warehouseName || scope.row.warehouseCode) }}</template></el-table-column>
+          <el-table-column label="目的仓" min-width="150" show-overflow-tooltip><template #default="scope">{{ text(scope.row.fbaWarehouseCode) }}</template></el-table-column>
+          <el-table-column prop="packageCount" label="计划箱数" width="100" />
+          <el-table-column prop="pickedPackageCount" label="已拣箱数" width="100" />
+          <el-table-column prop="palletCount" label="托盘数" width="90" />
+          <el-table-column label="状态" width="120"><template #default="scope">{{ statusLabel(scope.row.status) }}</template></el-table-column>
+          <el-table-column label="预约状态" width="120"><template #default="scope">{{ statusLabel(scope.row.appointmentStatus) }}</template></el-table-column>
+          <el-table-column label="排车状态" width="110"><template #default="scope">{{ statusLabel(scope.row.dispatchStatus) }}</template></el-table-column>
+          <el-table-column label="创建时间" width="180"><template #default="scope">{{ dateTime(scope.row.createdAt) }}</template></el-table-column>
+        </el-table>
+        <el-pagination v-model:current-page="query.page" v-model:page-size="query.size" class="pagination" :total="total" :page-sizes="[10, 20, 50, 100]" layout="total, sizes, prev, pager, next" @change="load" />
+      </el-card>
+    </template>
+
+    <template v-else>
+      <el-card shadow="never">
+        <dl class="detail-grid">
+          <div><dt>计划号</dt><dd>{{ detail.planNo }}</dd></div><div><dt>集装箱号</dt><dd>{{ text(detail.containerNo) }}</dd></div>
+          <div><dt>状态</dt><dd>{{ statusLabel(detail.status) }}</dd></div><div><dt>入仓码数</dt><dd>{{ detail.lineCount }}</dd></div>
+          <div><dt>托盘数</dt><dd>{{ detail.palletCount }}</dd></div><div><dt>总体积(m³)</dt><dd>{{ detail.totalVolumeCbm }}</dd></div>
+          <div><dt>计划箱数</dt><dd>{{ detail.expectedPackageCount }}</dd></div><div><dt>已拣箱数</dt><dd>{{ detail.pickedPackageCount }}</dd></div>
+        </dl>
+      </el-card>
+      <el-card shadow="never" header="入仓明细">
+        <el-table :data="detail.lines" border empty-text="暂无入仓明细">
+          <el-table-column prop="inboundCode" label="入仓码" min-width="180" /><el-table-column prop="destinationWarehouseCode" label="目的仓代码" min-width="140" />
+          <el-table-column prop="destinationWarehouseName" label="目的仓名称" min-width="160" /><el-table-column prop="requiredPackageCount" label="计划箱数" width="100" />
+          <el-table-column prop="plannedPalletCount" label="计划托数" width="100" /><el-table-column prop="volumeCbm" label="体积(m³)" width="110" />
+        </el-table>
+      </el-card>
+      <el-card shadow="never" header="托盘明细">
+        <el-table :data="detail.pallets" border empty-text="暂无托盘">
+          <el-table-column prop="palletNo" label="托盘码" min-width="180" /><el-table-column prop="destinationWarehouseCode" label="目的仓" min-width="150" />
+          <el-table-column prop="capacityCbm" label="容量(m³)" width="120" /><el-table-column prop="allocatedVolumeCbm" label="已分配体积(m³)" width="140" />
+        </el-table>
+      </el-card>
+    </template>
+  </section>
+</template>
+
+<style scoped>
+.inbound-orders { display: grid; gap: 18px; }
+.page-head { display: flex; align-items: center; justify-content: space-between; gap: 24px; }
+.page-head h2 { margin: 0; color: #111827; font-size: 26px; }
+.page-head p { margin: 7px 0 0; color: #64748b; font-size: 14px; }
+.filter-card :deep(.el-form-item) { margin-bottom: 12px; }
+.filter-card :deep(.el-input), .filter-card :deep(.el-select) { width: 190px; }
+.pagination { justify-content: flex-end; margin-top: 18px; }
+.detail-grid { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); margin: 0; }
+.detail-grid div { padding: 18px 20px; border-right: 1px solid #ebeef5; border-bottom: 1px solid #ebeef5; }
+.detail-grid dt { margin-bottom: 7px; color: #8492a6; font-size: 13px; }
+.detail-grid dd { margin: 0; overflow-wrap: anywhere; color: #1f2937; }
+</style>

src/navigation/clientNavigation.test.mjs

@@ -53,13 +53,17 @@ test('keeps only implemented navigation groups visible', () => {
         title: '头程物流',
         children: ['订单列表', '快速下单'],
       },
+      {
+        title: '出海下单',
+        children: ['海外采购', '美国本土卡', '美本土散板'],
+      },
       {
         title: '海外仓',
         children: ['贴标申请', '仓储转运', '货物废弃', '退货换标'],
       },
       {
         title: '订单管理',
-        children: ['派送订单列表'],
+        children: ['入库订单列表', '派送订单列表'],
       },
       {
         title: '财务结算',
@@ -95,10 +99,14 @@ test('flattens visible leaves with unique paths', () => {
     '/',
     '/orders/first-leg',
     '/first-leg/quick-order',
+    '/cross-border/procurement',
+    '/cross-border/domestic-trucking',
+    '/cross-border/pallet-shipping',
     '/overseas-warehouse/labeling',
     '/overseas-warehouse/storage-transfer',
     '/overseas-warehouse/cargo-disposal',
     '/overseas-warehouse/return-relabel',
+    '/orders/inbound',
     '/orders/delivery',
     '/finance/bills',
     '/company/profile',
@@ -317,7 +325,7 @@ test('keeps the dashboard route permission synchronized with navigation', () =>
   assert.match(dashboardRoute, /permission: 'dashboard:view'/)
 })
 
-test('keeps prototype views cataloged while allowing implemented order and overseas warehouse pages', () => {
+test('keeps only the unified my-orders placeholder cataloged while activating implemented business pages', () => {
   const routerSource = [
     'first-leg',
     'cross-border',
@@ -339,7 +347,7 @@ test('keeps prototype views cataloged while allowing implemented order and overs
   ]
 
   for (const [path, view] of routes) {
-    if (path === 'first-leg/quick-order' || path.startsWith('overseas-warehouse/') || path === 'orders/delivery') {
+    if (path === 'first-leg/quick-order' || path.startsWith('cross-border/') || path.startsWith('overseas-warehouse/') || path === 'orders/inbound' || path === 'orders/delivery') {
       assert.match(routerSource, new RegExp(`path: '${path}'[\\s\\S]*?\\./views/${view.replace('.', '\\.')}[\\s\\S]*?release: 'active'[\\s\\S]*?permission:`))
       assert.equal(getNavigationLeaves(clientNavigation).some((item) => item.path === `/${path}`), true)
       continue