client-web/src/utils/firstLegOrder.test.mjs

import assert from 'node:assert/strict'
import test from 'node:test'
import { createFirstLegPartySnapshot, DEMO_FIRST_LEG_PARTIES } from '../data/firstLegParties.ts'
import {
  canClientCancelFirstLegOrder,
  canClientEditFirstLegOrder,
  createEmptyCargoItem,
  getFirstLegStatusLabel,
  getFirstLegTransportModeLabel,
  summarizeFirstLegCargo,
  validateFirstLegOrderDraft,
} from './firstLegOrder.ts'

function validDraft() {
  return {
    referenceNo: 'REF-001',
    transportMode: 'FCL',
    businessType: 'EXPORT',
    origin: '宁波',
    destination: '洛杉矶',
    receivingWarehouseId: 'WH005',
    expectedDepartureDate: '2026-08-08',
    shipperPartyId: 'CP001',
    shipperPartySnapshot: createFirstLegPartySnapshot(DEMO_FIRST_LEG_PARTIES[0], 'SHIPPER'),
    shipper: '示例贸易有限公司',
    consigneePartyId: 'CP003',
    consigneePartySnapshot: createFirstLegPartySnapshot(DEMO_FIRST_LEG_PARTIES[2], 'CONSIGNEE'),
    consignee: 'DEMO GLOBAL LLC',
    priority: 'NORMAL',
    customerRemark: '',
    tradeTerm: 'FOB',
    destinationCountryCode: 'US',
    destinationWarehouseName: 'ONT8',
    pickupMethod: 'SELF_EXPRESS',
    channelCode: 'SEA-US-FBA',
    channelName: '美国海运渠道',
    taxMode: 'BUY_DECLARATION',
    customsInspection: false,
    destinationType: 'FBA',
    amazonWarehouseCode: 'ONT8',
    shipmentId: 'FBA-001',
    items: [{ ...createEmptyCargoItem('cargo-1'), cargoNameCn: '家居用品', pieces: 100, grossWeightKg: 1200, volumeCbm: 3.5, containerType: '40HQ', containerCount: 1 }],
  }
}

test('uses the confirmed status and transport labels', () => {
  assert.equal(getFirstLegStatusLabel('BOOKED'), '已订舱')
  assert.equal(getFirstLegStatusLabel('IN_TRANSIT'), '运输中')
  assert.equal(getFirstLegTransportModeLabel('FCL'), '海运整箱 FCL')
})

test('only allows draft orders to be edited in the confirmed phase-one flow', () => {
  assert.equal(canClientEditFirstLegOrder('DRAFT'), true)
  assert.equal(canClientEditFirstLegOrder('PENDING_REVIEW'), false)
  assert.equal(canClientCancelFirstLegOrder('DRAFT'), true)
  assert.equal(canClientCancelFirstLegOrder('PENDING_REVIEW'), true)
  assert.equal(canClientCancelFirstLegOrder('ACCEPTED'), false)
  assert.equal(canClientCancelFirstLegOrder('BOOKED'), false)
})

test('validates the confirmed minimum submission fields', () => {
  assert.deepEqual(validateFirstLegOrderDraft(validDraft()), [])

  const invalid = validDraft()
  invalid.origin = ''
  invalid.receivingWarehouseId = ''
  invalid.items[0].grossWeightKg = 0
  invalid.items[0].containerType = ''
  invalid.items[0].containerCount = 0

  const errors = validateFirstLegOrderDraft(invalid)
  assert.ok(errors.includes('请填写起运地'))
  assert.ok(errors.includes('请选择平台收货仓'))
  assert.ok(errors.includes('第 1 条货物毛重必须大于 0'))
  assert.ok(errors.includes('第 1 条货物需要填写箱型和柜量'))
})

test('requires enabled-party snapshots and order addresses before submission', () => {
  const draft = validDraft()
  draft.shipperPartyId = ''
  draft.shipperPartySnapshot = null
  draft.consigneePartySnapshot.address = ''

  const errors = validateFirstLegOrderDraft(draft)
  assert.ok(errors.includes('请选择发货单位'))
  assert.ok(errors.includes('请填写本单收货地址'))
})

test('does not require container details for non-FCL cargo', () => {
  const draft = validDraft()
  draft.transportMode = 'AIR'
  draft.items[0].containerType = ''
  draft.items[0].containerCount = 0

  assert.deepEqual(validateFirstLegOrderDraft(draft), [])
})

test('summarizes cargo values from line items', () => {
  const first = validDraft().items[0]
  const second = { ...first, id: 'cargo-2', pieces: 40, packageCount: 4, grossWeightKg: 300, volumeCbm: 1.25 }

  assert.deepEqual(summarizeFirstLegCargo([first, second]), {
    pieces: 140,
    packageCount: 5,
    grossWeightKg: 1500,
    volumeCbm: 4.75,
  })
})