chore: initial commit

2026-07-30 17:59:42 +08:00
commit 155f06846d
62 changed files with 7852 additions and 0 deletions
@@ -0,0 +1,108 @@
+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,
+  })
+})