feat: connect plan-level preload confirmation

src/modules/loading-lists/api/platformLoadingLists.test.ts

@@ -2,6 +2,7 @@ import { beforeEach, describe, expect, it, vi } from 'vitest'
 import { http } from '@/shared/api/http'
 import {
   getConfirmedLoadingList,
+  confirmPreloadPlan,
   uploadLoadingDeclaration,
   completeLoadingDeclaration,
   getPreloadPlan,
@@ -15,7 +16,7 @@ const preloadSummary = {
   containerBookingId: 1900000000000000004n as unknown as string,
   preloadNo: 'PL-001',
   containerNo: 'MSCU1234567',
-  internalContainerNo: 'YG-001',
+  cabinetNo: 'YG-001',
   customers: [{ accountId: 1900000000000000002n as unknown as string, customerName: '测试客户' }],
   warehouseId: 1900000000000000003n as unknown as string,
   warehouseName: '义乌仓',
@@ -29,6 +30,20 @@ const preloadSummary = {
   totalGrossWeightKg: 1200,
   createdAt: '2026-08-10T10:00:00',
   version: 3,
+  readiness: {
+    preloadPushed: true,
+    containerNoReady: true,
+    preloadLinkCount: 1,
+    confirmedPreloadCount: 0,
+    oceanBookingId: 1900000000000000005n as unknown as string,
+    oceanBookingStatus: 'RELEASED',
+    pdaTaskId: null,
+    pdaTaskStatus: null,
+    confirmationStatus: 'PENDING',
+    canConfirm: true,
+    readyForPda: false,
+    blockingReasons: [],
+  },
 }
 
 const detail = {
@@ -54,6 +69,7 @@ describe('platform loading lists API', () => {
     expect(result.total).toBe(1)
     expect(result.records[0]?.planId).toBe('1900000000000000001')
     expect(result.records[0]?.containerBookingId).toBe('1900000000000000004')
+    expect(result.records[0]?.readiness.oceanBookingId).toBe('1900000000000000005')
     expect(result.records[0]?.customers[0]?.accountId).toBe('1900000000000000002')
   })
 
@@ -92,6 +108,42 @@ describe('platform loading lists API', () => {
     expect(loaded.summary.status).toBe('COMPLETED')
   })
 
+  it('confirms the whole preload plan with expectedVersion and the caller operation id', async () => {
+    const post = vi.spyOn(http, 'post').mockResolvedValue({
+      code: '200', message: 'ok', data: {
+        planId: 1900000000000000001n,
+        containerBookingId: 1900000000000000004n,
+        confirmationStatus: 'CONFIRMED',
+        version: 4,
+        readiness: {
+          ...preloadSummary.readiness,
+          confirmedPreloadCount: 1,
+          confirmationStatus: 'CONFIRMED',
+          canConfirm: false,
+          readyForPda: true,
+          pdaTaskId: 1900000000000000006n,
+          pdaTaskStatus: 'PENDING',
+          blockingReasons: ['PRELOAD_ALREADY_CONFIRMED'],
+        },
+      },
+    })
+
+    const result = await confirmPreloadPlan('1900000000000000001', 3, 'confirm-operation-1')
+
+    expect(post).toHaveBeenCalledWith(
+      '/platform/v1/first-leg/loading-plans/1900000000000000001/confirm',
+      { expectedVersion: 3 },
+      { headers: { 'Idempotency-Key': 'confirm-operation-1' } },
+    )
+    expect(result).toMatchObject({
+      planId: '1900000000000000001',
+      containerBookingId: '1900000000000000004',
+      confirmationStatus: 'CONFIRMED',
+      version: 4,
+      readiness: { pdaTaskId: '1900000000000000006', readyForPda: true },
+    })
+  })
+
   it('uses stable plan and warehouse ids for customs document actions', async () => {
     const post = vi.spyOn(http, 'post').mockResolvedValue({ code: '200', message: 'ok', data: { id: 6, documentType: 'CUSTOMS_DECLARATION', fileId: 9, fileName: 'declaration.pdf', version: 2 } })
     const file = new File(['declaration'], 'declaration.pdf', { type: 'application/pdf' })