feat: add overseas return operations

tests/project-contract.test.mjs

@@ -32,7 +32,7 @@ test('overseas workbench contains confirmed warehouse and phase-five outbound do
 	const [data, session, runtime] = await Promise.all([
 		read('../src/data/overseas-workbench.js'), read('../src/stores/session.js'), read('../src/config/runtime.js')
 	])
-	for (const label of ['入仓作业', '出库履约', '排车拣货', '出库作业', '库内作业', '换标作业', '现场查询']) assert.match(data, new RegExp(label))
+	for (const label of ['入仓作业', '拆柜收货', '退货入库', '退货合箱', '出库履约', '排车拣货', '出库作业', '库内作业', '换标作业', '现场查询']) assert.match(data, new RegExp(label))
 	for (const excluded of ['集装箱拣货', '装柜取证', '海外派送', '派送单', '客户回访']) assert.doesNotMatch(data, new RegExp(excluded))
 	assert.match(session, /overseas-pda-auth-session/)
 	assert.match(runtime, /VITE_OVERSEAS_API_BASE_URL/)
@@ -145,6 +145,42 @@ test('Chinese English and Spanish locale selection is persisted from profile wit
 	assert.match(inbound, /warehouse-profile/)
 })
 
+test('return receipt is a real PDA flow backed by the dedicated return APIs', async () => {
+	const [pages, workbench, page, api, warehouseWork] = await Promise.all([
+		read('../src/pages.json'), read('../src/data/overseas-workbench.js'),
+		read('../src/pages/return-receipt/return-receipt.vue'), read('../src/api/return-receipt.js'),
+		read('../src/stores/warehouse-work.js')
+	])
+	assert.match(pages, /pages\/return-receipt\/return-receipt/)
+	assert.match(workbench, /key: 'returnReceipt'[^\n]*available: true[^\n]*route: '\/pages\/return-receipt\/return-receipt'/)
+	for (const action of ['startReturnReceipt', 'findReturnSkuCandidates', 'confirmReturnReceipt']) assert.match(page, new RegExp(action))
+	for (const path of ['/start', '/sku-candidates', '/confirm']) assert.match(api, new RegExp(path.replaceAll('/', '\\/')))
+	assert.match(page, /startScanBroadcast/)
+	assert.match(page, /startedBy: this\.startedBy/)
+	assert.match(page, /idempotencyKey: key\.value/)
+	assert.match(page, /requestId[\s\S]*traceId/)
+	assert.match(warehouseWork, /returnReceipt:[^\n]*pendingKeys/)
+	assert.doesNotMatch(page, /customerId/)
+})
+
+test('return packing is a separate same-customer inventory operation', async () => {
+	const [pages, workbench, page, api, warehouseWork] = await Promise.all([
+		read('../src/pages.json'), read('../src/data/overseas-workbench.js'),
+		read('../src/pages/return-packing/return-packing.vue'), read('../src/api/return-packing.js'),
+		read('../src/stores/warehouse-work.js')
+	])
+	assert.match(pages, /pages\/return-packing\/return-packing/)
+	assert.match(workbench, /key: 'returnPacking'[^\n]*available: true[^\n]*route: '\/pages\/return-packing\/return-packing'/)
+	for (const action of ['findPackingOrders', 'mergeReturnCartons']) assert.match(page, new RegExp(action))
+	for (const path of ['/packing/orders', '/cartons/merge', '/cartons/']) assert.match(api, new RegExp(path.replaceAll('/', '\\/')))
+	assert.match(page, /startScanBroadcast/)
+	assert.match(page, /customerKey[\s\S]*不同客户的退货单不能合箱/)
+	assert.match(page, /idempotencyKey: key\.value/)
+	assert.match(page, /requestId[\s\S]*traceId/)
+	assert.match(warehouseWork, /returnPacking:[^\n]*pendingKeys/)
+	assert.doesNotMatch(page.match(/<template>([\s\S]*?)<\/template>/)?.[1] || '', /customerId|warehouseId/)
+})
+
 test('home reuses the persisted warehouse profile instead of requesting it on every show', async () => {
 	const [home, inbound, operation] = await Promise.all([read('../src/pages/home/home.vue'), read('../src/api/inbound.js'), read('../src/pages/operation/operation.vue')])
 	assert.match(home, /if \(!this\.user\?\.warehouseCode \|\| !this\.user\?\.warehouseName\) this\.loadWarehouseProfile\(\)/)